Tới nội dung
Bảng điều khiển

Tài liệu APIVN

Claude Code và Codex CLI

Cài hai trợ lý lập trình chạy trong terminal, rồi trỏ chúng về APIVN.

1. Claude Code

Cần khoá nhóm Claude.

Cài đặt

macOS / Linux (Terminal):

curl -fsSL https://claude.ai/install.sh | bash

Windows: cài Git for Windows trước vì Claude Code cần Git, sau đó mở PowerShell:

irm https://claude.ai/install.ps1 | iex

Đóng terminal, mở cửa sổ mới và gõ claude --version. Thấy số phiên bản là xong; không cần Node.js.

Tự cấu hình (không qua CC Switch)

Cách bền, chạy trên mọi hệ điều hành: tạo hoặc sửa tệp ~/.claude/settings.json (Windows: %USERPROFILE%\.claude\settings.json):

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://apivn.vn",
    "ANTHROPIC_AUTH_TOKEN": "sk-...your-key"
  }
}

Chỉ muốn thử trong cửa sổ terminal hiện tại thì đặt biến môi trường. macOS / Linux:

export ANTHROPIC_BASE_URL="https://apivn.vn"
export ANTHROPIC_AUTH_TOKEN="sk-...your-key"

Windows (PowerShell):

$env:ANTHROPIC_BASE_URL="https://apivn.vn"
$env:ANTHROPIC_AUTH_TOKEN="sk-...your-key"

Vào thư mục dự án, chạy claude, gửi một yêu cầu ngắn rồi mở Bảng điều khiển → Nhật ký API để thấy request và số tiền đã trừ.

2. Codex CLI

Cần khoá nhóm GPT.

Cài Node.js

Codex cần Node.js bản LTS. Máy đã có thì gõ node -v để kiểm tra rồi bỏ qua bước này.

Windows (PowerShell):

winget install OpenJS.NodeJS.LTS

macOS: tải bản LTS ở nodejs.org hoặc dùng Homebrew:

brew install node

Linux (Ubuntu/Debian):

curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

Cài Codex

Mở terminal mới và chạy:

npm install -g @openai/codex

Kiểm tra bằng codex --version.

Tự cấu hình (không qua CC Switch)

Tạo hoặc sửa tệp ~/.codex/config.toml:

model = "gpt-5.6-sol"
model_provider = "apivn"

[model_providers.apivn]
name = "APIVN"
base_url = "https://apivn.vn/v1"
env_key = "APIVN_API_KEY"
wire_api = "responses"

Đặt khoá rồi chạy codex trong thư mục dự án:

export APIVN_API_KEY="sk-...your-key"        # macOS / Linux
$env:APIVN_API_KEY="sk-...your-key"         # Windows PowerShell

Lệnh trên chỉ sống trong cửa sổ terminal hiện tại. Muốn giữ lâu dài: macOS / Linux thêm dòng export vào ~/.zshrc hoặc ~/.bashrc; Windows chạy setx APIVN_API_KEY "sk-...your-key" rồi mở terminal mới.

Muốn mô hình khác, đổi dòng model theo Mô hình, chọn trong nhóm GPT.

Lỗi thường gặp

  • command not found, không nhận lệnh: đóng terminal và mở cửa sổ mới. Vẫn lỗi thì cài lại công cụ.
  • EACCES, Permission denied khi npm install -g trên macOS hoặc Linux: đừng dùng sudo. Cài Node.js qua nvm để npm cài gói vào thư mục của bạn, hoặc chạy npm config set prefix ~/.npm-global rồi thêm ~/.npm-global/bin vào PATH.
  • timeout, ECONNREFUSED, lỗi chứng chỉ SSL: thường do proxy hoặc VPN. Tắt hẳn, mở terminal mới rồi thử lại.
  • 401, 403, 503: khoá sai, hết số dư, hoặc mô hình không thuộc nhóm của khoá. Xem Mã lỗi.