MớiTrỏ bất kỳ agent nào về UberLLM — một key, mọi model, bằng giá niêm yết hoặc rẻ hơn.
UberLLM

Claude Code

Claude Code giao tiếp với UberLLM thông qua địa chỉ tương thích với Anthropic của nó, https://api.uberllm.dev. Với địa chỉ và khóa của bạn đã được thiết lập, các lệnh và công cụ của Claude Code hoạt động như trước đây, và các yêu cầu sẽ được tính vào số dư UberLLM của bạn.

Thiết lập thủ công

Không cần chạy gì ngoài chính Claude Code. Tạo một key trên trang key của bạn, sau đó:

export ANTHROPIC_BASE_URL=https://api.uberllm.dev
export ANTHROPIC_AUTH_TOKEN=ull_your_key
claude

Windows PowerShell:

$env:ANTHROPIC_BASE_URL = "https://api.uberllm.dev"
$env:ANTHROPIC_AUTH_TOKEN = "ull_your_key"
claude

Điều này chỉ có tác dụng trong terminal hiện tại. Để lưu nó vĩnh viễn trong shell profile của bạn, hãy lưu key vào một tệp mà chỉ bạn mới có thể đọc:

mkdir -p ~/.uberllm && chmod 700 ~/.uberllm
printf '%s\n' 'ull_your_key' > ~/.uberllm/key && chmod 600 ~/.uberllm/key

và đặt cái này vào ~/.claude/settings.json (mọi dự án) hoặc vào <project>/.claude/settings.local.json (một dự án):

{
  "apiKeyHelper": "cat ~/.uberllm/key",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.uberllm.dev"
  }
}

Hoặc sử dụng trình cài đặt

Trình cài đặt làm điều tương tự cho bạn và lấy khóa thông qua trình duyệt của bạn. Bạn có thể đọc nó trước nếu muốn: nó là văn bản thuần túy tại uberllm.dev/install/claude-code.sh.

  • SHA-256 của claude-code.sh: f5aa1c4610992d8f4ecc1b1cd777bc731c5fad9da6a38cac46989834b194d66c
  • SHA-256 của claude-code.ps1: 60d631b48e60a2e3f17e5eee19136d47a255f143627986e86b6ceb379858a3b9

Để kiểm tra trước khi chạy:

curl -fsSL https://uberllm.dev/install/claude-code.sh -o claude-code.sh
shasum -a 256 claude-code.sh   # compare with the hash above
sh claude-code.sh

Mọi dự án trên máy tính này:

curl -fsSL https://uberllm.dev/install/claude-code.sh | sh

Chỉ một dự án (chạy nó bên trong dự án; các dự án khác vẫn theo gói Anthropic của bạn):

curl -fsSL https://uberllm.dev/install/claude-code.sh | sh -s -- --project

Thêm một thư mục sau --project để thiết lập một dự án khác với dự án hiện tại.

Windows PowerShell (mọi dự án):

irm https://uberllm.dev/install/claude-code.ps1 | iex

Bạn không cần API key trước, và bạn không cần phải đăng nhập khi dán lệnh. Trình cài đặt mở một liên kết trong trình duyệt của bạn (https://uberllm.dev/cli/link?code=XXXX-XXXX) và in cùng một mã xác nhận trong terminal. Đăng nhập, kiểm tra mã khớp, và nhấn Approve.

Việc chấp thuận tạo một API key trên tài khoản của bạn và chuyển nó cho trình cài đặt đang chờ. Mã trong terminal của bạn không phải là bí mật: chỉ trình cài đặt đã bắt đầu yêu cầu mới có thể thu thập khóa, khóa được cấp chính xác một lần, và yêu cầu hết hạn sau 15 phút.

Nếu Claude Code chưa bao giờ được thiết lập trên máy tính này, hãy sử dụng cài đặt cho mọi dự án trước. Claude Code chỉ đọc cài đặt riêng của một dự án sau khi bạn tin tưởng thư mục đó, vì vậy một cài đặt hoàn toàn mới vẫn có thể yêu cầu bạn đăng nhập.

Để in khối cài đặt cho máy tính của bạn mà không ghi bất cứ điều gì:

curl -fsSL https://uberllm.dev/install/claude-code.sh | sh -s -- --print

Trình cài đặt ghi gì

Khóa được lưu vào một tệp mà chỉ bạn mới có thể đọc (chế độ thư mục 700, chế độ tệp 600):

Cài đặt Tệp khóa Tệp cài đặt
Mọi dự án ~/.uberllm/key ~/.claude/settings.json (hoặc $CLAUDE_CONFIG_DIR/settings.json)
Một dự án ~/.uberllm/key-<folder>-<number> <project>/.claude/settings.local.json

Tệp cài đặt nhận địa chỉ và một apiKeyHelper đọc tệp khóa. Bản thân khóa không bao giờ được ghi vào tệp cài đặt, vì vậy nó sẽ không xuất hiện trong bản sao lưu, kho lưu trữ dotfiles hoặc khi chia sẻ màn hình.

{
  "apiKeyHelper": "cat \"/Users/you/.uberllm/key\"",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.uberllm.dev",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1"
  }
}

Claude Code chạy apiKeyHelper để lấy khóa và gửi nó dưới dạng cả Authorization: Bearer và x-api-key, để nó hoạt động với một gateway như UberLLM. Nó giữ câu trả lời trong năm phút (CLAUDE_CODE_API_KEY_HELPER_TTL_MS thay đổi điều đó).

Trình cài đặt hợp nhất vào tệp hiện có của bạn thay vì thay thế nó, vì vậy các hook, quyền và máy chủ MCP được giữ nguyên, và nó sao chép tệp cũ vào <file>.bak-<timestamp> trước. Nó loại bỏ một ANTHROPIC_AUTH_TOKEN văn bản thuần túy do bản cài đặt cũ hơn để lại. Sau đó, nó thực hiện một yêu cầu thực sự thông qua gateway, vì vậy một thông báo thành công có nghĩa là yêu cầu đã được gửi đi.

Trình cài đặt Windows vẫn ghi khóa vào settings.json dưới dạng ANTHROPIC_AUTH_TOKEN.

Cài đặt nào được ưu tiên

Claude Code đọc các cài đặt theo thứ tự này, cài đặt đầu tiên được ưu tiên:

  1. Cài đặt được quản lý (do công ty của bạn đặt, nếu có)
  2. claude --settings <file>
  3. <project>/.claude/settings.local.json
  4. <project>/.claude/settings.json
  5. ~/.claude/settings.json

Một biến trong khối env của tệp cài đặt sẽ được ưu tiên hơn biến cùng tên trong shell của bạn trong hầu hết các phiên. Có hai trường hợp ngoại lệ quan trọng ở đây:

  • Khóa. Claude Code sử dụng ANTHROPIC_AUTH_TOKEN trước, sau đó là ANTHROPIC_API_KEY, rồi đến apiKeyHelper. Một token được xuất trong shell của bạn sẽ thay thế khóa đã lưu.
  • Mô hình. /model trong phiên được ưu tiên, sau đó là claude --model, rồi đến ANTHROPIC_MODEL, sau đó là cài đặt model. Một ANTHROPIC_MODEL của shell sẽ thắng cài đặt model.

Vì vậy, hãy xóa mọi biến ANTHROPIC_* khỏi shell và hồ sơ shell của bạn (~/.zshrc, ~/.bashrc) và giữ chúng trong tệp cài đặt. Trình cài đặt sẽ cảnh báo bạn khi nó tìm thấy một biến.

Sử dụng các mô hình khác

Mặc định không có gì được ghim: Claude Code yêu cầu các tên mô hình riêng của nó (opus, sonnet, haiku, claude-opus-5-5…) và UberLLM phục vụ các mô hình Claude tương tự. Để điều khiển Claude Code bằng DeepSeek, GLM, Qwen, GPT hoặc bất kỳ mô hình nào khác, hãy ánh xạ từng khe mô hình của Claude Code tới một ID mô hình UberLLM trong khối env:

Biến Nó thiết lập gì
ANTHROPIC_MODEL Mô hình mà phiên bắt đầu.
ANTHROPIC_DEFAULT_OPUS_MODEL opus có nghĩa là gì.
ANTHROPIC_DEFAULT_SONNET_MODEL sonnet có nghĩa là gì.
ANTHROPIC_DEFAULT_HAIKU_MODEL haiku có nghĩa là gì. Claude Code cũng sử dụng nó cho các công việc nền như tiêu đề và tóm tắt.
CLAUDE_CODE_SUBAGENT_MODEL Mô hình mà các subagent chạy trên. 
{
  "apiKeyHelper": "cat \"/Users/you/.uberllm/key\"",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.uberllm.dev",
    "ANTHROPIC_MODEL": "deepseek/deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek/deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek/deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek/deepseek-v4-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek/deepseek-v4-pro"
  }
}

Ánh xạ mọi khe. Một khe bị bỏ trống sẽ tiếp tục yêu cầu mô hình Claude, và bạn sẽ trả giá Claude cho nó.

Trình cài đặt thực hiện điều này cho bạn bằng một profile:

curl -fsSL 'https://uberllm.dev/install/claude-code.sh?profile=glm' | sh

Các profile là claude-native (mặc định, không ghim gì), glm, deepseek và gpt. Bất kỳ ID mô hình nào từ bảng mô hình đều hoạt động nếu bạn thiết lập các biến thủ công; GET https://api.uberllm.dev/v1/models liệt kê chúng.

Ngữ cảnh và nén

Claude Code chỉ biết kích thước ngữ cảnh của các mô hình Claude. Đối với bất kỳ mô hình nào khác, nó giả định 200,000 tokens và nén cuộc trò chuyện trước đó.

  • Nếu mô hình có ngữ cảnh 1-triệu-token (trang của nó trên uberllm.dev hiển thị ngữ cảnh), hãy thêm [1m] vào cuối ID của nó, ví dụ "ANTHROPIC_MODEL": "deepseek/deepseek-v4-pro[1m]" hoặc claude --model 'deepseek/deepseek-v4-pro[1m]'. Claude Code sau đó sẽ lập kế hoạch cho 1M.
  • Đối với bất kỳ kích thước nào khác, hãy đặt CLAUDE_CODE_MAX_CONTEXT_TOKENS thành ngữ cảnh của mô hình, ví dụ "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "400000".
  • Để chọn thời điểm nén: cài đặt autoCompactWindow (hoặc biến CLAUDE_CODE_AUTO_COMPACT_WINDOW) nhận một số lượng token từ 100,000 đến 1,000,000. CLAUDE_AUTOCOMPACT_PCT_OVERRIDE (1–100) nén sớm hơn, tại tỷ lệ đó của cửa sổ. autoCompactEnabled: false tắt nó đi.

Đặt ngữ cảnh lớn hơn khả năng của mô hình sẽ khiến các yêu cầu thất bại một khi cuộc trò chuyện vượt quá mô hình.

Có gì thay đổi

  • Thông tin đăng nhập claude.ai của bạn không được sử dụng. Các tính năng cần thông tin này, như kết nối claude.ai, /schedule và Điều khiển từ xa, sẽ không khả dụng trong phiên chạy trên UberLLM.
  • Chi phí Claude Code hiển thị không phải là hóa đơn của bạn. Claude Code tính toán chi phí trên máy tính của bạn dựa trên giá niêm yết của Anthropic và không hiển thị thông tin hữu ích nào cho các mô hình khác. Số tiền bạn thanh toán nằm trong Bảng điều khiển → Hoạt động. Hãy thêm số dư của bạn vào dòng trạng thái (bên dưới) để xem khi bạn làm việc.
  • Mã của bạn được gửi đến các nhà cung cấp mô hình bên thứ ba. Mọi thứ phiên làm việc đọc được đều được gửi đến mô hình, mô hình này được chạy bởi các nhà cung cấp mô hình bên thứ ba trên thị trường UberLLM. Không sử dụng nó trong kho lưu trữ chứa bí mật, thông tin xác thực hoặc dữ liệu khách hàng.

Số dư trong dòng trạng thái

curl -fsSL https://uberllm.dev/install/statusline.sh | sh -s -- --install

Điều này lưu một script nhỏ vào ~/.uberllm/statusline.sh và thêm nó làm statusLine của Claude Code trong ~/.claude/settings.json (thêm --project sau --install để đặt nó vào .claude/settings.local.json của dự án này thay thế). Dưới dấu nhắc lệnh, bạn sẽ thấy:

UberLLM $12.40 · $0.35 held · Opus

Đó là số dư khả dụng của bạn, số tiền đang được giữ cho các yêu cầu vẫn đang chạy và mô hình. Nó đọc GET /v1/balance bằng cùng một key mà Claude Code sử dụng, tối đa một lần mỗi phút. Nó chỉ cần sh, curl và sed. Đọc nó trước tại uberllm.dev/install/statusline.sh.

Xác minh

Khởi động Claude Code và chạy /status: địa chỉ API là https://api.uberllm.dev. Sau đó, hỏi nó bất cứ điều gì; yêu cầu sẽ hiển thị trong Bảng điều khiển → Hoạt động trong vòng một phút.

Cùng một key phản hồi qua Messages API:

curl https://api.uberllm.dev/v1/messages \
  -H "Authorization: Bearer $(cat ~/.uberllm/key)" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-haiku-4-5","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'

Nếu một yêu cầu thất bại với Your apiKeyHelper script is failing, tệp key bị thiếu hoặc không thể đọc được: hãy chạy lại trình cài đặt.

Gỡ cài đặt và thu hồi

curl -fsSL https://uberllm.dev/install/claude-code.sh | sh -s -- --uninstall

Đối với cài đặt một dự án, hãy chạy nó bên trong dự án bằng lệnh sh -s -- --project --uninstall. Lệnh này sao lưu tệp cài đặt trước, chỉ xóa những gì nó đã thêm, và xóa tệp khóa đã lưu. Claude Code sẽ trở lại trạng thái đăng nhập Anthropic của bạn khi khởi động lần tới.

Việc gỡ cài đặt không thu hồi khóa; nó chỉ ngừng sử dụng khóa đó. Hãy xóa khóa trên trang khóa của bạn để đảm bảo nó không bao giờ có thể chi tiêu nữa. Hãy làm điều đó cho bất kỳ máy tính nào bạn không còn tin tưởng, hoặc nếu bạn đã chấp thuận một yêu cầu mà bạn không phải là người khởi tạo.