Tới nội dung
Đăng nhậpTạo tài khoả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.

Cài nhanh bằng 1 lệnh

Máy đã có Claude Code, Codex hoặc OpenCode? Lệnh apivn đăng nhập giúp bạn và tự điền cấu hình cho cả ba, không phải chép khoá hay sửa tệp nào bằng tay. Lệnh này không cài các công cụ đó; chưa có thì cài theo các mục bên dưới trước.

macOS / Linux (Terminal):

curl -fsSL https://apivn.vn/cli/install.sh | sh

Windows (PowerShell):

irm https://apivn.vn/cli/install.ps1 | iex

Sau khi bấm Enter:

  1. Lệnh tải đúng bản cho máy bạn, đối chiếu mã SHA-256 (lệch là dừng, không cài), đặt vào ~/.apivn/bin và thêm thư mục đó vào PATH.
  2. Trình duyệt tự mở trang xác nhận trên apivn.vn (chưa đăng nhập thì đăng nhập trước). Terminal hiện một mã dạng XXXX-XXXX; mã trên trang phải trùng mã đó.
  3. Nhóm chọn sẵn là Tự động: một khoá gọi được mọi mô hình. Muốn Claude Code hay Codex chạy nhóm khác thì bấm Tự chọn nhóm.
  4. Bấm Đồng ý. Lệnh nhận khoá mới (nằm ở trang Khoá API, tên bắt đầu bằng APIVN CLI), ghi cấu hình cho Claude Code (~/.claude/settings.json), Codex (~/.codex/config.toml, máy đã có Codex thì hỏi trước; đang đăng nhập ChatGPT thì mặc định giữ nguyên) và OpenCode (~/.config/opencode/opencode.json), rồi gọi thử một lượt để báo khoá đã chạy.

Hoàn tác: apivn restore trả các tệp cấu hình về như trước lần chạy gần nhất (gõ thêm lần nữa thì lùi tiếp). Khoá đã tạo vẫn nằm ở trang Khoá API, không dùng nữa thì xoá ở đó.

Lệnh hay dùng: apivn status xem công cụ đang trỏ vào đâu · apivn list các hồ sơ theo nhóm · apivn use <nhóm> đổi nhóm cho lệnh claude (thêm --codex để đổi cho Codex) · apivn kiem-tra soát lỗi cấu hình · apivn cap-nhat nạp mô hình mới mà không đăng nhập lại.

1. Claude Code

Video 1 phút: đặt địa chỉ và khoá APIVN cho Claude Code trong Terminal (khoá trong video là khoá mẫu).

Khoá sẵn có của bạn ở nhóm Tự động dùng được ngay, không phải tạo khoá riêng.

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ý sử dụng để thấy request và số tiền đã trừ.

2. Codex CLI

Vẫn dùng chính khoá sẵn có ở nhóm Tự động, không phải tạo khoá khác.

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. Codex hợp nhất với các mô hình GPT, nhưng khoá của bạn gọi được cả những mô hình khác.

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 gõ nhầm model ID. Xem Mã lỗi.
Hỏi hỗ trợ