Docs / Công cụ & SDK

Claude Code

Cấu hình Claude Code CLI dùng key của Apimodelhub — settings.json hoặc biến môi trường.

Cài Claude Code

# Cách chính thức (npm, cần Node 18+):
npm install -g @anthropic-ai/claude-code

# hoặc script native của Anthropic (macOS/Linux):
curl -fsSL https://claude.ai/install.sh | bash

claude --version

Cài xong thì cấu hình endpoint. Có hai cách, chọn MỘT — đặt cả hai thì rất khó debug vì không biết cái nào đang thắng.

Cách 1: ~/.claude/settings.json (khuyến nghị)

File này giữ cấu hình vĩnh viễn và không phụ thuộc shell đang mở. Trên Windows là %USERPROFILE%\.claude\settings.json.

~/.claude/settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.apimodelhub.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-spk-...",
    "ANTHROPIC_MODEL": "claude-sonnet-5-5",
    "ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-4-5"
  }
}

Sửa file xong phải khởi động lạiClaude Code đọc settings.json MỘT LẦN lúc process khởi động. Sửa file mà phiên đang chạy thì không có tác dụng — thoát ra chạy lại claude (trong VS Code thì reload window).

Cách 2: biến môi trường

~/.zshrc hoặc ~/.bashrc

export ANTHROPIC_BASE_URL=https://api.apimodelhub.com
export ANTHROPIC_AUTH_TOKEN=sk-spk-...
# BẮT BUỘC — id model phải là id chúng tôi bán (xem GET /v1/models):
# Claude Code mặc định gửi id riêng của Anthropic (vd claude-sonnet-4-5-20250929)
# và id đó trả 404, không phải lỗi key.
export ANTHROPIC_MODEL=claude-sonnet-5-5
export ANTHROPIC_SMALL_FAST_MODEL=claude-haiku-4-5
# Nếu bạn đã có ANTHROPIC_API_KEY cho tài khoản Anthropic, đừng đặt cả hai:
# hai credential cùng tồn tại thì 401 rất khó lần ra nguyên nhân.

Dùng ANTHROPIC_AUTH_TOKEN (không phải ANTHROPIC_API_KEY) vì đây là key của bên thứ ba: AUTH_TOKEN đi vào header Authorization: Bearer, còn API_KEY đi vào x-api-key. Cả hai header đều được chấp nhận ở https://api.apimodelhub.com. Nhưng đừng đặt cả hai trong cùng một máy: khi còn key Anthropic thật, bạn sẽ không biết credential nào đang được dùng và 401 trông như lỗi cấu hình.

404 model: sai id, không phải sai keyChúng tôi không đoán model gần giống — đoán sai là bán Opus với giá Haiku. Nên model "..." is not available nghĩa là id không có trong bảng giá: đặt ANTHROPIC_MODEL (và ANTHROPIC_SMALL_FAST_MODEL cho tác vụ phụ) theo đúng id trong GET /v1/models.

Tối ưu chi phíClaude Code đốt phần lớn token ở cache read (đọc lại context cũ), và cache read rẻ hơn input khoảng 10 lần. Đừng xoá context giữa phiên chỉ để "tiết kiệm" — làm vậy thường tốn hơn vì phải gửi lại toàn bộ từ đầu ở giá input.

Kiểm tra nhanh

Chạy claude, gõ /status: dòng base URL phải là https://api.apimodelhub.com. Nếu báo 401, gần như luôn là key sai hoặc biến môi trường chưa được nạp vào shell hiện tại (sửa file cấu hình không có tác dụng cho shell đang mở).

echo $ANTHROPIC_BASE_URL     # phải là https://api.apimodelhub.com
echo ${ANTHROPIC_AUTH_TOKEN:0:10}   # phải bắt đầu bằng sk-spk-
curl -s https://api.apimodelhub.com/v1/models -H "x-api-key: $ANTHROPIC_AUTH_TOKEN" | head -c 200