Dùng Claude Code với API key của RelaySwitch
Claude Code đọc endpoint từ ANTHROPIC_BASE_URL và key từ ANTHROPIC_AUTH_TOKEN. Trỏ hai biến này về RelaySwitch thì mỗi lượt chạy được trừ vào số dư trả trước của bạn theo giá từng token, không cần tài khoản claude.ai và không cần gói thuê bao.
01Hai biến môi trường trên macOS, Linux và WSL
Claude Code nói chuyện bằng định dạng Messages của Anthropic và lấy địa chỉ gửi request từ ANTHROPIC_BASE_URL. Biến thứ hai, ANTHROPIC_AUTH_TOKEN, là key mà địa chỉ đó chấp nhận; nó được gửi đi dưới dạng Authorization: Bearer. Đặt cả hai trong terminal rồi chạy claude.
Câu hỏi hay gặp nhất là Base URL có thêm /v1 ở cuối hay không. Ở đây cách nào cũng chạy: gateway chấp nhận đường dẫn mà Claude Code tự ghép vào sau địa chỉ, kể cả khi /v1 bị lặp.
export ANTHROPIC_BASE_URL="https://api.relayswitch.io/v1"export ANTHROPIC_AUTH_TOKEN="sk-relay-..."claude02Windows PowerShell
Trên Windows, đặt cùng hai biến đó trong PowerShell. Lưu ý chung cho mọi hệ điều hành: biến đặt trong terminal chỉ có hiệu lực với cửa sổ đang mở, và trình soạn thảo mở từ Dock hay Start menu không đọc được biến bạn vừa export.
$env:ANTHROPIC_BASE_URL = "https://api.relayswitch.io/v1"$env:ANTHROPIC_AUTH_TOKEN = "sk-relay-..."claude03Lưu cấu hình vào settings.json
Để không phải đặt lại biến mỗi lần mở terminal, ghi hai biến vào khối env của ~/.claude/settings.json. File này áp dụng cho mọi project và mọi cách khởi động Claude Code. Khi cùng một biến có ở cả terminal lẫn file cấu hình, file cấu hình được ưu tiên.
- Đừng ghi key vào
.claude/settings.jsontrong thư mục project: file đó sinh ra để commit và chia sẻ cùng code. Muốn cấu hình riêng cho một project thì dùng.claude/settings.local.json. - Extension Claude Code trong VS Code đọc thiết lập riêng của nó,
claudeCode.environmentVariables, trong user settings của VS Code. ANTHROPIC_API_KEYdùng thay choANTHROPIC_AUTH_TOKENđược, nhưng chỉ đặt một trong hai. Request mang hai key khác nhau sẽ bị từ chối với mã 400.- Chỉ đặt Base URL là chưa đủ: thiếu biến chứa key, Claude Code vẫn tiếp tục dùng phiên đăng nhập claude.ai đã lưu.
04Thử key bằng curl trước khi mở Claude Code
Gửi một request Messages tối thiểu thẳng tới gateway, bỏ qua Claude Code. Nhận về mã 200 kèm một đoạn JSON nghĩa là địa chỉ và key đều đúng; nếu lỗi ở bước này thì vấn đề nằm ở key hoặc số dư, không phải ở cấu hình Claude Code.
curl -i https://api.relayswitch.io/v1/messages \ -H "Authorization: Bearer sk-relay-..." \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{"model": "claude-fable-5.1", "max_tokens": 16, "messages": [{"role": "user", "content": "Reply with ok"}]}'05Xác nhận trong Claude Code bằng /status
Chạy claude, gửi một câu bất kỳ rồi gõ /status. Trang Status phải có dòng Anthropic base URL trỏ về RelaySwitch và một dòng Auth token cho biết key đến từ biến nào. Thiếu dòng base URL nghĩa là biến chưa tới được tiến trình này; thấy tài khoản đăng nhập thay cho Auth token nghĩa là biến chứa key chưa có hiệu lực.
Request xuất hiện trong trang Usage của console sau vài giây, mỗi dòng có model, số token tính tiền và số tiền. Hướng dẫn đầy đủ từng biến, kèm phần xử lý lỗi, nằm ở bài hướng dẫn Claude Code (trang tiếng Anh).
06Giá các model Claude
Bảng dưới là 13 model Claude đang có trong catalog, giá đọc trực tiếp khi trang được dựng. Đây là giá trừ vào số dư, tính bằng USD cho mỗi triệu token; giá cached input của từng model có ở trang Models (tiếng Anh).
| Model | Nhà phát triển | Input | Output | Context |
|---|---|---|---|---|
| Claude Fable 5.1claude-fable-5.1 | Anthropic | $6.00 | $30.00 | 1,000,000 |
| Claude Fable 5.2claude-fable-5.2 | Anthropic | $4.00 | $20.00 | 1,000,000 |
| Claude Fable 5claude-fable-5 | Anthropic | $3.00 | $15.00 | 1,000,000 |
| Claude Opus 5.5claude-opus-5-5 | Anthropic | $2.716 | $9.70 | 1,000,000 |
| Claude Sonnet 4.6claude-sonnet-4-6 | Anthropic | $1.80 | $9.00 | 1,000,000 |
| Claude Opus 4.6claude-opus-4-6 | Anthropic | $1.80 | $7.50 | 1,000,000 |
| Claude Opus 4.7claude-opus-4-7 | Anthropic | $1.80 | $7.50 | 1,000,000 |
| Claude Opus 4.8claude-opus-4-8 | Anthropic | $1.80 | $7.50 | 1,000,000 |
| Claude Opus 5claude-opus-5 | Anthropic | $1.80 | $7.50 | 1,000,000 |
| Claude Haiku 4.5claude-haiku-4-5 | Anthropic | $0.60 | $3.00 | 200,000 |
| Claude Sonnet 5claude-sonnet-5 | Anthropic | $1.20 | $3.00 | 1,000,000 |
| Claude Sonnet 5.5claude-sonnet-5-5 | Anthropic | $1.20 | $3.00 | 1,000,000 |
| Claude Haiku 5.5claude-haiku-5-5 | Anthropic | $0.0582 | $0.1455 | 1,000,000 |
USD cho mỗi triệu token
07Chọn opus, sonnet hay haiku
Lệnh /model trong Claude Code chuyển giữa ba alias: opus dành cho việc khó nhất, sonnet cho công việc hằng ngày, haiku nhanh và có giá thấp hơn, đồng thời được Claude Code dùng cho các tác vụ nền. Mỗi alias trỏ tới id nào là do ba biến ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL và ANTHROPIC_DEFAULT_HAIKU_MODEL quyết định; id Claude nào trong bảng giá cũng điền được.
Chênh lệch chi phí chủ yếu đến từ giá output và giá cached input. Claude Code gửi lại toàn bộ hội thoại ở mỗi lượt và đánh dấu để dùng prompt cache; phần token đọc từ cache được tính theo giá cached của model, chỉ bằng một phần giá input.
Id của GPT, Gemini hay DeepSeek cũng trả lời được trong Claude Code: gateway chuyển request Messages sang định dạng OpenAI của model đó rồi chuyển câu trả lời ngược lại. Anthropic không hỗ trợ Claude Code trên model ngoài Claude, nên tool use ở các model đó có thể kém mượt hơn.
08Đặt ngân sách riêng cho Claude Code
Một coding agent tự gửi liên tiếp rất nhiều request, nên khi có sự cố thì tiền đi rất nhanh. Hãy tạo một key riêng cho Claude Code trong console và đặt cho nó một ngân sách bằng USD: chạm ngân sách, key trả về 402 và dừng lại, phần số dư còn lại của tài khoản không bị đụng tới. Bạn cũng có thể giới hạn key đó chỉ gọi được vài id Claude đã chọn. Cách đặt từng giới hạn có ở trang Claude API key.
Con số chi phí mà Claude Code tự 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 của console và trong biên nhận của từng request.
Câu hỏi thường gặp
- Dùng API key thì có cần tài khoản claude.ai hay gói thuê bao không?
- Không. Khi đã đặt ANTHROPIC_AUTH_TOKEN, request mang key này chứ không mang phiên đăng nhập claude.ai, và hạn mức của gói thuê bao không tham gia vào. Tài khoản nằm ở RelaySwitch, mở bằng email.
- ANTHROPIC_BASE_URL có cần thêm /v1 ở cuối không?
- Có hay không đều được. Các ví dụ trên trang này dùng https://api.relayswitch.io/v1. Claude Code tự ghép /v1/messages vào sau địa chỉ và gateway xử lý được trường hợp /v1 bị lặp.
- Đã đặt biến môi trường mà Claude Code vẫn bắt đăng nhập, vì sao?
- Biến chưa tới được tiến trình đang chạy. Hãy ghi hai biến vào khối env của ~/.claude/settings.json rồi chạy /status để xem có dòng Anthropic base URL hay không. Nếu lúc khởi động có cảnh báo về hai nguồn thông tin đăng nhập, chạy /logout để chỉ giữ lại key.
- Một phiên code tốn khoảng bao nhiêu tiền?
- Không có con số cố định: chi phí phụ thuộc vào model và số token của từng lượt. Phần lớn input của một phiên là ngữ cảnh gửi lặp lại, được tính theo giá cached khi trúng cache. Cache mặc định giữ trong 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ộ ngữ cảnh một lần. Số tiền thực tế nằm trong biên nhận của từng request.
- Gặp lỗi 401, 402 hoặc 404 thì xử lý thế nào?
- 401 là key sai, đã bị thu hồi, hoặc nằm trong một biến mà Claude Code không đọc; kiểm tra bằng /status. 402 là hết số dư hoặc key đã chạm ngân sách đặt trên nó; nạp thêm hoặc nâng ngân sách của key. 404 là id model không có trong catalog, thường do gõ sai trong các biến chọn model.
- Không có thẻ quốc tế thì trả tiền bằng gì?
- Bằng crypto: USDT, USDC, BTC, ETH, SOL, tối thiểu $10. Số dư tính bằng USD và không hết hạn. Có thẻ thì trả bằng thẻ, Apple Pay hoặc Google Pay.
Hai biến môi trường là xong
Trỏ ANTHROPIC_BASE_URL về https://api.relayswitch.io/v1, trả theo token từ số dư trả trước, nạp bằng thẻ hoặc crypto.