← 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:在终端中配置 API 密钥、模型与供应商。
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://thapi.cloudChuẩn bị
- 已安装 `claude` 命令(Claude Code)
- API key sk-thapi-…
- 如果以前登录过 Anthropic,请先在 Claude Code 中运行 `/logout`
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
按照 settings.json 标签页创建或编辑 JSON 文件。手动修改前请备份。优先使用 `api-cli configure claude`(会生成带时间戳的备份)。
检查基础 URL 和模型,不输出 API 密钥: `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`。使用 ANTHROPIC_AUTH_TOKEN,而非 ANTHROPIC_API_KEY。
仅对单个项目生效。如果包含密钥,请加入 .gitignore。
Kiểm tra đã chạy đúng
- `claude` 可以打开;发送“ping”。
- `echo $ANTHROPIC_BASE_URL` (Unix) phải là https://thapi.cloud
- Dashboard → 用量中出现新请求。
Khắc phục sự cố
| Triệu chứng | Nguyên nhân | Cách xử lý |
|---|---|---|
| 一直要求登录 Anthropic | 旧的 OAuth 会话仍然有效。 | 在 Claude Code 中运行 `/logout`,重新设置 ANTHROPIC_AUTH_TOKEN,然后打开新终端。 |
| 404 | BASE_URL 多了 /v1。 | Phải là https://thapi.cloud (không /v1). |
| 401 | 误用了 ANTHROPIC_API_KEY,或密钥不正确。 | 使用 ANTHROPIC_AUTH_TOKEN=sk-thapi-… |
Ghi chú
- 建议为运行 Claude Code 的设备使用单独的密钥。
- 使用 API CLI 合并 env 比手动编辑整个文件更安全。