Claude Code
Claude Code giao tiếp với MartLLM thông qua địa chỉ tương thích với Anthropic của nó,
https://api.martllm.com. 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ư MartLLM 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.martllm.com
export ANTHROPIC_AUTH_TOKEN=ull_your_key
claude
Windows PowerShell:
$env:ANTHROPIC_BASE_URL = "https://api.martllm.com"
$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.martllm.com"
}
}
Hoặc sử dụng trình cài đặt
Nếu bạn có Node.js, một lệnh sẽ thiết lập Claude Code và các công cụ lập trình khác trên máy của bạn (Codex CLI, OpenCode và nhiều hơn nữa) với cùng cài đặt như trình cài đặt bên dưới:
npx uberllm init
Xem uberllm init để biết nó thay đổi những gì và cách hoàn tác.
Trình cài đặt cũng 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 martllm.com/install/claude-code.sh.
- SHA-256 của
claude-code.sh:34646d5a83e25a1c19057a6bca6aeaaf0118e0e43704d5dbb01e49ab15eb625f - SHA-256 của
claude-code.ps1:5caaa5f15f3e846c535e6668687fe9e0bdcf1e4f9a8a370af09a5137005f44b4
Để kiểm tra trước khi chạy:
curl -fsSL https://martllm.com/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://martllm.com/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://martllm.com/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 ngoài dự án hiện tại.
Windows PowerShell (mọi dự án):
irm https://martllm.com/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 sẽ mở một liên kết trong trình duyệt của bạn (https://martllm.com/cli/link?code=XXXX-XXXX) và in cùng mã xác nhận trong terminal. Đăng nhập, kiểm tra mã khớp, và nhấn Phê duyệt.
Việc phê duyệt sẽ 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://martllm.com/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.martllm.com",
"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ư
MartLLM. 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:
- Cài đặt được quản lý (do công ty của bạn đặt, nếu có)
claude --settings <file><project>/.claude/settings.local.json<project>/.claude/settings.json~/.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_TOKENtrước, sau đó làANTHROPIC_API_KEY, rồi đếnapiKeyHelper. Một token được xuất trong shell của bạn sẽ thay thế khóa đã lưu. - Mô hình.
/modeltrong phiên được ưu tiên, sau đó làclaude --model, rồi đếnANTHROPIC_MODEL, sau đó là cài đặtmodel. MộtANTHROPIC_MODELcủa shell sẽ thắng cài đặtmodel.
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à MartLLM 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 MartLLM 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.martllm.com",
"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://martllm.com/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.martllm.com/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 martllm.com 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ặcclaude --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_TOKENSthà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ếnCLAUDE_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: falsetắ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
- Không sử dụng tài khoản đăng nhập claude.ai của bạn. Các tính năng cần đến tài khoản này, như claude.ai connector,
/schedulevà Remote Control, sẽ không khả dụng trong phiên làm việc chạy trên MartLLM. - Chi phí Claude Code hiển thị không phải là hóa đơn của bạn. Claude Code tự tính chi phí này trên máy của bạn dựa trên giá niêm yết của Anthropic, và nó không hiển thị thông tin chính xác cho các model khác. Khoản tiền bạn thực trả nằm ở Dashboard → API Keys → API Usage. Hãy thêm số dư vào thanh trạng thái (bên dưới) để tiện theo dõi trong lúc làm việc.
- Code của bạn được gửi tới các nhà cung cấp model bên thứ ba. Mọi nội dung mà phiên làm việc đọc được đều sẽ gửi tới model do các nhà cung cấp bên thứ ba vận hành trên thị trường MartLLM. Đừng dùng tính năng này trong các repository chứa secret, 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://martllm.com/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:
MartLLM $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 martllm.com/install/statusline.sh.
Kiểm tra
Khởi động Claude Code và chạy /status: địa chỉ API là
https://api.martllm.com. Sau đó, hãy hỏi bất kỳ điều gì; yêu cầu sẽ xuất hiện trong
Dashboard → API Keys → API Usage trong vòng một phút.
Cùng một key này cũng phản hồi qua Messages API:
curl https://api.martllm.com/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 yêu cầu gặp lỗi Your apiKeyHelper script is failing, file chứa 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://martllm.com/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.