Cấu hình ZetaAPI trong Claude Code
Chuyển Claude Code (CLI chính thức của Anthropic) sang ZetaAPI trong 30 giây, hưởng 0,3×–0,4× giá chính thức, hỗ trợ prompt cache.
Cập nhật 2026-09-03
Khi nào dùng
Claude Code là CLI dòng lệnh chính thức của Anthropic; sau khi cài bằng npm i -g @anthropic-ai/claude-code bạn có thể gọi Claude tương tác trong bất kỳ thư mục cục bộ nào. ZetaAPI cung cấp endpoint /v1/messages tương thích hoàn toàn với API chính thức của Anthropic, nên việc chuyển thượng nguồn chỉ cần sửa hai biến môi trường.
Chuẩn bị
- Đã cài Node.js 18+ và CLI
@anthropic-ai/claude-code - Đã lấy API key ở bảng điều khiển ZetaAPI (bắt đầu bằng
sk-) - Số dư tài khoản > $1 (mức nạp tối thiểu)
Các bước cấu hình
1. Đặt biến môi trường
Thêm vào file cấu hình shell (~/.zshrc / ~/.bashrc):
export ANTHROPIC_BASE_URL="https://api.zetaapi.ai"
export ANTHROPIC_API_KEY="sk-key-zetaapi-cua-ban"Nạp lại cấu hình:
source ~/.zshrc2. Cài một dòng lệnh (tùy chọn)
Nếu không muốn sửa cấu hình shell thủ công, một dòng lệnh là đủ:
npx --prefer-online zetaapi@latest setup claude-codeLệnh này ghi ANTHROPIC_BASE_URL và ANTHROPIC_AUTH_TOKEN vào khối env của ~/.claude/settings.json (file hiện có sẽ được sao lưu thành settings.json.bak.<dấu thời gian>) và kiểm tra kết nối. Khi được hỏi, dán Install Token (lấy trong hộp thoại «Cấu hình kết nối» / «Kết nối công cụ mới» của console, bắt đầu bằng ze_inst_, hiệu lực 5 phút) hoặc dán thẳng API Key (sk-); với CI / chạy không tương tác, thêm --token=ze_inst_xxx hoặc đặt biến ZETAAPI_TOKEN.
3. Xác minh
Trong bất kỳ thư mục dự án nào, chạy:
claudeSau câu hỏi đầu tiên, bảng điều khiển sẽ hiện ngay lượng token và chi phí của lần gọi này.
Câu hỏi thường gặp
H: Vì sao tôi nhận 401 Unauthorized?
Kiểm tra ANTHROPIC_API_KEY là key ZetaAPI (bắt đầu bằng sk-), không phải key chính thức của Anthropic dạng sk-ant-.
Nếu bạn cấu hình bằng npx zetaapi setup, thông tin xác thực nằm ở env.ANTHROPIC_AUTH_TOKEN trong ~/.claude/settings.json — hãy kiểm tra khoá đó thay vì biến môi trường.
H: Có hỗ trợ prompt cache không?
Có. Claude Code mặc định bật ephemeral cache control; ZetaAPI chuyển tiếp nguyên hành vi cache, và đọc cache tính bằng 10% giá đầu vào — giống chính thức.
H: Vì sao context của Sonnet chỉ có 200K? Làm sao dùng hết 1M?
Khi Claude Code trỏ tới một địa chỉ API bên thứ ba, nó không thể tự xác minh đầu bên kia có hỗ trợ context 1 triệu token hay không, nên mặc định cấp phát 200K cho an toàn. Đây là hành vi của client, không phải giới hạn của ZetaAPI.
Chỉ cần chỉ định thủ công một lần trong phiên:
/model sonnet[1m]Bạn cũng có thể gõ /model để mở bộ chọn mô hình và chọn mục có nhãn 1M context. Ký hiệu [1m] chỉ là chỉ thị nội bộ của Claude Code — nó bị loại bỏ trước khi gửi request, nên tên mô hình mà ZetaAPI nhận được vẫn là claude-sonnet-5, không cần cấu hình gì thêm.
ZetaAPI đã chạy thực tế context hơn 600 nghìn token với Sonnet và khoảng 900 nghìn token với Opus. Lưu ý context siêu dài khiến mỗi lượt đều gửi lại toàn bộ lịch sử, làm lượng token tăng đáng kể — nên điều chỉnh cùng với ngưỡng compact ở mục dưới.
H: Có thể tắt tự động compact không?
Có. Thêm vào ~/.claude/settings.json:
"autoCompactEnabled": falseTuy nhiên nên tăng ngưỡng kích hoạt thay vì tắt hẳn:
/autocompact 500kGiá trị nhận từ 100K đến 1M và bị giới hạn bởi cửa sổ context của mô hình hiện tại. Với script hoặc CI, dùng biến môi trường CLAUDE_CODE_AUTO_COMPACT_WINDOW (chỉ nhận số thuần, ví dụ 500000); còn claude --autocompact 500k chỉ áp dụng cho một lần khởi chạy.
Sau khi tắt hẳn, khi context đầy Claude Code sẽ báo Prompt is too long và dừng hội thoại thay vì tóm tắt lịch sử rồi chạy tiếp. Nếu chỉ thấy compact chạy quá thường xuyên thì tăng ngưỡng vẫn thực dụng hơn là tắt.
H: Muốn quay lại chính thức cần gì?
Xóa hoặc chú thích ANTHROPIC_BASE_URL và đặt lại ANTHROPIC_API_KEY về key chính thức của Anthropic. Nếu bạn cấu hình bằng npx zetaapi setup, hãy xoá ANTHROPIC_BASE_URL và ANTHROPIC_AUTH_TOKEN khỏi khối env trong ~/.claude/settings.json (có bản sao lưu .bak.<dấu thời gian>).