Chạy Claude Code bằng API key của riêng bạn

Đặt hai biến môi trường là Claude Code chạy trên key UplinkSwitch của bạn. Cùng công cụ, cùng model, giá hiện tại.

Lấy API key

Kiểm tra ngày 2026-11-13

Bạn cần chuẩn bị gì

  • Claude Code đã được cài, với claude nằm trong PATH của bạn.
  • Một key UplinkSwitch lấy từ console, đã nạp số dư. Credit trả trước từ $10 bằng thẻ, WeChat Pay, Apple Pay, Google Pay hoặc crypto.

Hai biến

  • ANTHROPIC_BASE_URL trỏ Claude Code tới UplinkSwitch. Dán nguyên cả phần /v1. Gateway chấp nhận đường dẫn mà Claude Code ghép từ đó.
  • ANTHROPIC_AUTH_TOKEN gửi key dưới dạng Authorization: Bearer. ANTHROPIC_API_KEY dùng thay được và gửi key dưới dạng x-api-key. Chỉ đặt một trong hai, đừng đặt cả hai.
  • Request mang hai key khác nhau sẽ bị từ chối với mã 400.
  • Chỉ có base URL thì chưa đủ. Thiếu một trong hai biến key, Claude Code vẫn dùng phiên đăng nhập claude.ai đã lưu.
shell
export ANTHROPIC_BASE_URL="https://api.uplinkswitch.com/v1"
export ANTHROPIC_AUTH_TOKEN="sk-uplink-live-..."
claude

Lưu cố định trong settings.json

Thêm cả hai biến vào ~/.claude/settings.json dưới mục env là chúng áp dụng cho mọi dự án. .claude/settings.local.json áp dụng cho một dự án.

  • Ba biến nữa chỉ định model đứng sau các alias: ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL và ANTHROPIC_DEFAULT_HAIKU_MODEL. Đặt chúng thành các ID như claude-opus-5-5, claude-sonnet-5-5 và claude-haiku-5-5.
  • Đừng để key trong .claude/settings.json của dự án. File đó được tạo ra để commit và chia sẻ.
  • Khi lệnh export trong shell và file settings cùng đặt một biến, file settings được ưu tiên.
  • Tiện ích mở rộng VS Code đọc thông tin xác thực từ thiết lập riêng của nó, claudeCode.environmentVariables, trong user settings của VS Code.

Chọn model

Các alias opus, sonnet và haiku trỏ tới bất cứ model nào ba biến model chỉ định. Đặt biến Haiku cũng chuyển các tác vụ nền như đặt tiêu đề phiên sang model đó. Đổi model trong phiên bằng /model, lúc khởi động bằng claude --model claude-opus-5-5, hoặc cho một phiên bằng ANTHROPIC_MODEL.

Claude Code dùng định dạng API của Anthropic, và mọi model chat ở đây đều được phục vụ theo định dạng đó, gồm cả GPT, Gemini, DeepSeek, Kimi và các bản build không kiểm duyệt. Bất kỳ ID chat nào trong danh sách model cũng dùng được trong các biến đó và được trả lời dưới dạng phản hồi Messages, kể cả tool call.

Chi phí Claude Code trên key này

Bảng hiển thị các model Claude theo mỗi một triệu token, lấy trực tiếp từ danh mục, bên cạnh giá niêm yết Anthropic công bố. Mọi model Claude trên key đều có ở trang giá API Claude.

Claude Code gửi toàn bộ cuộc hội thoại ở mỗi lượt và đánh dấu nó cho prompt cache. Token đọc từ cache được tính theo giá cache, chỉ bằng một phần giá input. Cache mặc định tồn tại năm phút, nên lượt đầu tiên sau một quãng nghỉ dài hơn sẽ trả giá input cho toàn bộ context một lần.

Chi phí Claude Code hiển thị là ước tính của riêng nó theo giá niêm yết của Anthropic. Số tiền bạn thực trả nằm ở trang Usage trong console.

ModelInputInput đã cacheOutputContext
Claude Fable 5.2claude-fable-5.2Anthropic$4.00Giá niêm yết $8.00$0.10Giá niêm yết $0.20$20.00Giá niêm yết $40.001,000,000
Claude Fable 5.1claude-fable-5.1Anthropic$6.00Giá niêm yết $10.00$2.00Giá niêm yết $0.25$30.00Giá niêm yết $50.001,000,000
Claude Opus 5.5claude-opus-5-5Anthropic$2.716Giá niêm yết $4.00$0.1455Giá niêm yết $0.20$9.70Giá niêm yết $20.001,000,000
Claude Sonnet 5.5claude-sonnet-5-5Anthropic$1.20Giá niêm yết $2.00$0.075Giá niêm yết $0.10$3.00Giá niêm yết $10.001,000,000
Claude Haiku 5.5claude-haiku-5-5Anthropic$0.0582Giá niêm yết $0.10$0.01Giá niêm yết $0.01$0.1455Giá niêm yết $0.501,000,000
Claude Fable 5claude-fable-5Anthropic$3.00Giá niêm yết $10.00$0.30Giá niêm yết $1.00$15.00Giá niêm yết $50.001,000,000
Claude Opus 5claude-opus-5Anthropic$1.80Giá niêm yết $5.00$0.16Giá niêm yết $0.50$7.50Giá niêm yết $25.001,000,000
Claude Sonnet 5claude-sonnet-5Anthropic$1.20Giá niêm yết $2.00$0.12Giá niêm yết $0.20$3.00Giá niêm yết $10.001,000,000
Claude Opus 4.8claude-opus-4-8Anthropic$1.80Giá niêm yết $5.00$0.16Giá niêm yết $0.50$7.50Giá niêm yết $25.001,000,000
Claude Opus 4.7claude-opus-4-7Anthropic$1.80Giá niêm yết $5.00$0.16Giá niêm yết $0.50$7.50Giá niêm yết $25.001,000,000
Claude Opus 4.6claude-opus-4-6Anthropic$1.80Giá niêm yết $5.00$0.16Giá niêm yết $0.50$7.50Giá niêm yết $25.001,000,000
Claude Sonnet 4.6claude-sonnet-4-6Anthropic$1.80Giá niêm yết $3.00$0.18Giá niêm yết $0.30$9.00Giá niêm yết $15.001,000,000
Claude Haiku 4.5claude-haiku-4-5Anthropic$0.60Giá niêm yết $1.00$0.06Giá niêm yết $0.10$3.00Giá niêm yết $5.00200,000

USD cho mỗi một triệu token

Kiểm tra xem đã chạy chưa

Gửi một tin nhắn nhỏ. Với -i, curl in ra các header của phản hồi: x-uplink-request-id là tên của request và x-uplink-charge là chi phí của nó tính bằng USD.

Sau đó chạy claude. Request hiện trong console sau vài giây. Trong Claude Code, /status hiển thị dòng Anthropic base URL với địa chỉ UplinkSwitch và một dòng ghi tên biến key bạn đã đặt. Nếu thiếu dòng base URL thì biến chưa tới được phiên làm việc.

curl
curl -i https://api.uplinkswitch.com/v1/messages \
  -H "Authorization: Bearer sk-uplink-live-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model": "claude-fable-5.2", "max_tokens": 16, "messages": [{"role": "user", "content": "Reply with ok"}]}'

Lỗi và cách sửa

  • invalid_api_key (401): key sai hoặc đã bị thu hồi, hoặc nằm trong một biến mà Claude Code không đọc. Kiểm tra /status.
  • insufficient_balance (402): nạp tiền trong console. monthly_limit_reached (402) nghĩa là key đã chạm hạn mức chi tiêu hằng tháng đặt cho nó.
  • model_not_found (404): ID không có trong danh sách model. Kiểm tra lỗi gõ trong các biến model.
  • Claude Code yêu cầu đăng nhập dù lệnh curl thử chạy được: đặt key bằng lệnh export trong shell hoặc trong ~/.claude/settings.json. File settings của dự án chỉ có hiệu lực sau bước thiết lập lần đầu và lời nhắc trust.
  • Cảnh báo lúc khởi động nêu hai nguồn thông tin xác thực: phiên đăng nhập đã lưu và biến đều đang bật. Chạy /logout để chỉ giữ lại key.
  • ANTHROPIC_API_KEY đã đặt nhưng bị bỏ qua: nó cần được chấp thuận một lần. Bật Use custom API key trong /config, hoặc dùng ANTHROPIC_AUTH_TOKEN.

Câu hỏi thường gặp

Có. Mọi model chat ở đây đều được phục vụ theo định dạng Anthropic, nên một ID của GPT, Gemini, DeepSeek hay bản không kiểm duyệt dùng được trong các biến model và được trả lời dưới dạng phản hồi Messages, kể cả tool call.

Có. Input đã cache được tính theo giá cache. Trong bản ghi của một request, số token cache read lớn hơn không nghĩa là caching đã hoạt động.

Remote Control và nhập liệu bằng giọng nói cần đăng nhập claude.ai, nên chúng tắt khi một biến key đang được đặt. MCP tool search bị tắt trên host không phải của Anthropic, và đặt ENABLE_TOOL_SEARCH=true sẽ bật lại.

Bỏ đặt ANTHROPIC_BASE_URL và ANTHROPIC_AUTH_TOKEN, và xóa chúng khỏi settings.json nếu bạn đã thêm vào đó.

Trang Usage trong console cho biết số tiền bạn đã trả. Với một request, tra theo request id của nó. Bản ghi liệt kê token input, token cache read, token output và khoản phí tính bằng USD, và xuất hiện trong log sau khoảng một phút.

Credit trả trước từ $10 trong console, bằng thẻ, WeChat Pay, Apple Pay, Google Pay hoặc crypto, không cần thuê bao. Mỗi lần nạp tiền khóa giá của bạn trong 30 ngày.

Lấy key cho Claude Code

Hai biến, trả trước từ $10, không thuê bao, khóa giá 30 ngày cho mỗi lần nạp tiền.

Lấy API key
Join on Telegram