Trên trangURL gốc

← Tất cả ứng dụng · Mục Kết nối trên /docs

Anthropic + OpenAICấu hình tay

API CLI

Còn gọi: wizard · api-cli doctor · api-cli

API CLI: hướng dẫn cài trình cấu hình và kiểm tra kết nối ứng dụng.

Hướng dẫn đã xuất bản · Phiên bản ứng dụng: chưa xác minh

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.

Xem ghi chú / theo protocol

App này có ngoại lệ — đọc mục Ghi chú bên dưới trước khi dán.

Chuẩn bị

  1. Node.js ≥ 18 (khuyến nghị LTS)
  2. API key dạng sk-cad-… từ Dashboard → Keys
  3. Quyền ghi thư mục home (để tạo ~/.cadhayvn và patch config app)

Model khuyến nghị: claude-fable-5

Cách nhanh — lệnh / cấu hình

# Khuyến nghị — Win / macOS / Linux giống nhau
npm install -g API CLI@latest

# Mở wizard — dán API key khi được hỏi
api-cli

# Hoặc cấu hình một app cụ thể
api-cli configure claude -m claude-fable-5
api-cli configure codex -m gpt-5.6-sol
api-cli configure openclaw
api-cli configure cline

Bỏ file / điền Settings ở đâu

Filemacos
~/.cadhayvn/config.json
File do API CLI tạo (chmod 0600). Chứa API key đã lưu và base URL.
Không commit file này lên Git.
Filelinux
~/.cadhayvn/config.json
Giống macOS. Kiểm tra: ls -la ~/.cadhayvn/config.json
Filewindows
%USERPROFILE%\.cadhayvn\config.json
PowerShell: notepad $env:USERPROFILE\.cadhayvn\config.json
Chỉ sửa khi biết rõ — ưu tiên api-cli auth login / api-cli -k '…'.

Kiểm tra đã chạy đúng

  1. Chạy `api-cli doctor` — các tool đã cài phải hiện đã trỏ CadHayVN.
  2. Mở Dashboard → Sử dụng: sau một lệnh chat thử phải có dòng trừ tiền.
  3. `api-cli info` để xem base URL đang dùng.

Khắc phục sự cố

Triệu chứngNguyên nhânCách xử lý
npm install -g báo EACCES / permissionKhông có quyền ghi global npm prefix.Dùng nvm/fnm, hoặc cấu hình npm prefix user; tránh sudo trừ khi hiểu rủi ro.
doctor báo tool chưa cấu hìnhApp chưa cài hoặc config cũ chưa được patch.`api-cli configure <tool> -k '…'` hoặc `api-cli doctor --fix`.

Ghi chú

  • Base URL Anthropic: https://api.cadhayvn.com — OpenAI: https://api.cadhayvn.com/v1. API CLI tự chọn theo từng tool.
  • Repo: https://api.cadhayvn.com

Liên quan

Claude Code · Codex CLI · OpenClaw · Cline

Support