Dùng Claude Code với API key riêng: cấu hình ANTHROPIC_BASE_URL từng bước

Claude Code gọi model qua đâu?

Claude Code nói giao thức Anthropic Messages. Mặc định nó gửi request tới máy chủ của Anthropic bằng tài khoản Claude hoặc API key Anthropic. Biến ANTHROPIC_BASE_URL chuyển toàn bộ request sang một gateway khác, còn ANTHROPIC_AUTH_TOKEN là giá trị Claude Code gửi trong header Authorization: Bearer.

STEYG Code phục vụ đúng giao thức đó tại https://steyg.one/api. Request được chuyển nguyên vẹn (cache_control, thinking, tool use giữ nguyên), chỉ trường model được chuẩn hoá về id trong danh mục. Chi phí trừ vào ngân sách USD trả trước bằng VND, dùng chung với Cursor, Cline hay Codex CLI nếu các tool đó cùng một key.

Cấu hình bằng biến môi trường

Tạo API key trong trang STEYG Code và lưu nó ở chỗ an toàn (keychain, trình quản lý mật khẩu hoặc file .env không commit) dưới tên STEYG_CODE_API_KEY. Sau đó đặt các biến dưới đây trong terminal trước khi chạy claude. Model id trong khối lệnh được lấy từ danh mục đang bán lúc tải trang.

Gateway chỉ nhận model id có trong danh mục STEYG Code. Claude Code dùng ba alias opus, sonnet, haiku và chạy một số tác vụ nền bằng alias haiku; alias nào chưa được gán thì Claude Code gửi id model mặc định của Anthropic, và id đó bị từ chối nếu không có trong danh mục. Vì vậy hãy gán đủ cả ba.

export ANTHROPIC_BASE_URL="https://steyg.one/api"
export ANTHROPIC_AUTH_TOKEN="$STEYG_CODE_API_KEY"
export ANTHROPIC_MODEL="claude-opus-5-5"
export ANTHROPIC_DEFAULT_OPUS_MODEL="claude-opus-5-5"
export ANTHROPIC_DEFAULT_SONNET_MODEL="claude-opus-5-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-opus-5-5"
export ANTHROPIC_SMALL_FAST_MODEL="claude-opus-5-5"

Lưu cấu hình lâu dài trong settings.json

Biến export chỉ sống trong một phiên terminal và không tới được background agent của Claude Code. Khi kết nối đã chạy, chuyển cấu hình vào khối env của ~/.claude/settings.json: file trong thư mục home của bạn, áp cho mọi project. Khi cùng một biến có ở cả shell và khối env, Claude Code dùng giá trị trong file settings.

Thay chỗ giữ key bằng API key thật. Không bao giờ ghi key vào .claude/settings.json của project: file đó được commit và chia sẻ với mọi người clone repository. Cần cấu hình riêng một project thì dùng .claude/settings.local.json và chắc chắn file đó nằm trong .gitignore.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://steyg.one/api",
    "ANTHROPIC_AUTH_TOKEN": "<API key STEYG Code của bạn>",
    "ANTHROPIC_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-opus-5-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-opus-5-5"
  }
}

Chọn model và ước tính chi phí mỗi bước

Mỗi lượt làm việc, Claude Code gửi lại gần hết ngữ cảnh của phiên. Phần lặp lại được phục vụ từ cache với đơn giá cache hit, thấp hơn input thường nhiều lần, nên cache quyết định phần lớn hoá đơn. Bảng dưới tính một bước minh hoạ gồm 150.000 token cache hit, 30.000 token input mới và 4.000 token output, theo đơn giá đang áp.

Đây là giả định để so sánh model với nhau, không phải số đo của bạn; chi phí thật của từng request nằm trong usage của dashboard. Dùng model rẻ cho alias haiku và chỉ dùng model đắt cho phiên chính là cách giảm chi phí nhanh nhất.

Thử kết nối trước khi mở Claude Code

Gửi một request rất nhỏ từ chính terminal vừa export các biến. Nhận về JSON có trường content nghĩa là base URL và key đều đúng; nếu lỗi, nguyên nhân chỉ có thể nằm ở hai giá trị đó chứ chưa phải ở cấu hình Claude Code.

curl -sS "$ANTHROPIC_BASE_URL/v1/messages" \
  -H "Authorization: Bearer $ANTHROPIC_AUTH_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-opus-5-5","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'

Kiểm tra trong Claude Code và xử lý lỗi thường gặp

Chạy claude và gõ /status: dòng Anthropic base URL phải là https://steyg.one/api, dòng Auth token phải nêu ANTHROPIC_AUTH_TOKEN. Không thấy dòng base URL nghĩa là biến chưa tới phiên đang chạy. Nếu Claude Code vẫn báo lỗi, đối chiếu với các trường hợp dưới đây.

• 401: key sai, đã bị xoá, hoặc ANTHROPIC_AUTH_TOKEN chưa được đặt trong phiên đang chạy.
• 402: ngân sách đã hết. Gateway dừng thay vì tính vượt; mua thêm ngân sách hoặc nâng gói, key giữ nguyên.
• “Requested model … is not available in STEYG Code”: id trong dấu nháy là thứ Claude Code đã gửi, thường do một alias chưa được gán (ANTHROPIC_DEFAULT_SONNET_MODEL, ANTHROPIC_DEFAULT_HAIKU_MODEL) hoặc id gõ sai. GET /api/v1/models trả danh sách id mà key của bạn được gọi.
• Claude Code vẫn đòi đăng nhập: đặt ANTHROPIC_AUTH_TOKEN bằng export trong shell hoặc trong ~/.claude/settings.json; khối env trong settings của project chỉ được áp sau bước tin cậy thư mục.
• Cảnh báo có hai nguồn xác thực: máy vẫn lưu đăng nhập tài khoản Claude. Chạy /logout để chỉ dùng key STEYG Code.
• Lỗi 5xx hoặc request treo lâu: xem uptime từng model tại trang tình trạng hệ thống trước khi đổi cấu hình.

Giới hạn cần biết

Trỏ Claude Code sang gateway khác có vài hệ quả nên biết trước:

• Khi dùng key của gateway, Claude Code tắt các tính năng gắn với tài khoản claude.ai như Remote Control và nhập bằng giọng nói; MCP tool search cũng tắt mặc định khi ANTHROPIC_BASE_URL không trỏ tới Anthropic.
• Số dư và chi phí chính xác nằm ở STEYG Code (dashboard hoặc GET /api/v1/usage), không ở tài khoản Claude của bạn.
• Muốn thử trước khi trả tiền: tài khoản mới có $5 ngân sách dùng thử trong 7 ngày, không cần thẻ.
• Cấu hình Cursor, Cline và Codex CLI với cùng key: xem tài liệu API và bài cấu hình Cursor, Cline, Claude Code.