← Tất cả ứng dụng · Mục Kết nối trên /docs
Claude Code
Còn gọi: Claude CLI · claude
Claude Code: hướng dẫn cấu hình khóa API, model và nhà cung cấp trong terminal.
Hướng dẫn đã xuất bản · Phiên bản kiểm tra: 2.1.220 · Ngày kiểm tra:
Đã chạy ứng dụng thật với API mô phỏng cục bộ, kiểm tra cấu hình kết nối, xác thực và phản hồi streaming. Chưa xác minh trên production hoặc mọi tính năng, plugin và hệ điều hành.
Ví dụ chat, ping, invoke hoặc tạo nội dung có thể gửi yêu cầu thật và phát sinh phí. Kiểm tra model, số dư, đơn giá và mức tối thiểu trước khi chạy; GET /v1/models chỉ kiểm tra xác thực và danh mục. Đặt biến môi trường an toàn
URL gốc phải dán
SDK OpenAI thường dùng URL kết thúc bằng /v1; SDK Anthropic dùng URL gốc. Tránh thêm /v1 hai lần. Giao thức tương thích không bảo đảm mọi tính năng của nhà cung cấp.
https://api.cadhayvn.comChuẩn bị
- Đã cài lệnh `claude` (Claude Code)
- API key sk-cad-…
- Nếu từng login Anthropic: chạy `/logout` trong Claude Code trước
Model khuyến nghị: claude-fable-5
Cách nhanh — lệnh / cấu hình
npm install -g API CLI@latest
api-cli configure claude -m claude-fable-5
api-cli doctorBỏ file / điền Settings ở đâu
Tạo/sửa file JSON như tab settings.json. Backup trước khi sửa tay. Ưu tiên `api-cli configure claude` (có backup timestamp).
Kiểm tra base URL và model, không in API key: `node -e 'const fs=require("node:fs"),os=require("node:os"); const s=JSON.parse(fs.readFileSync(os.homedir()+"/.claude/settings.json","utf8")); console.log({baseURL:s.env?.ANTHROPIC_BASE_URL,model:s.env?.ANTHROPIC_MODEL})'`.PowerShell: `notepad $env:USERPROFILE\.claude\settings.json`. Dùng ANTHROPIC_AUTH_TOKEN (không phải ANTHROPIC_API_KEY).
Chỉ áp dụng một dự án. Đưa vào .gitignore nếu chứa key.
Kiểm tra đã chạy đúng
- `claude` mở được; gửi “ping”.
- `echo $ANTHROPIC_BASE_URL` (Unix) phải là https://api.cadhayvn.com
- Dashboard → Sử dụng có request mới.
Khắc phục sự cố
| Triệu chứng | Nguyên nhân | Cách xử lý |
|---|---|---|
| Cứ đòi đăng nhập Anthropic | Còn session OAuth cũ. | Trong Claude Code chạy `/logout`, đặt lại ANTHROPIC_AUTH_TOKEN, mở terminal mới. |
| 404 | BASE_URL có thừa /v1. | Phải là https://api.cadhayvn.com (không /v1). |
| 401 | Dùng nhầm ANTHROPIC_API_KEY hoặc key sai. | Dùng ANTHROPIC_AUTH_TOKEN=sk-cad-… |
Ghi chú
- Khuyến nghị một key riêng cho máy Claude Code.
- API CLI merge env an toàn hơn sửa tay cả file.
