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.
Kiểm tra ngày 2026-11-13
Bạn cần chuẩn bị gì
- Claude Code đã được cài, với
claudenằ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_URLtrỏ 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_TOKENgửi key dưới dạngAuthorization: Bearer.ANTHROPIC_API_KEYdùng thay được và gửi key dưới dạngx-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.
export ANTHROPIC_BASE_URL="https://api.uplinkswitch.com/v1"
export ANTHROPIC_AUTH_TOKEN="sk-uplink-live-..."
claudeLư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_MODELvàANTHROPIC_DEFAULT_HAIKU_MODEL. Đặt chúng thành các ID nhưclaude-opus-5-5,claude-sonnet-5-5vàclaude-haiku-5-5. - Đừng để key trong
.claude/settings.jsoncủ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.
| Model | Input | Input đã cache | Output | Context |
|---|---|---|---|---|
| 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.00 | 1,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.00 | 1,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.00 | 1,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.00 | 1,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.50 | 1,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.00 | 1,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.00 | 1,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.00 | 1,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.00 | 1,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.00 | 1,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.00 | 1,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.00 | 1,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.00 | 200,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 -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ùngANTHROPIC_AUTH_TOKEN.
Câu hỏi thường gặp
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