Claude Code, Codex, OpenCode và VS Code

1. Claude Code

Dùng key thuộc 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 (Claude Code cần Git), rồi mở PowerShell:

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

Đóng terminal, mở cửa sổ mới rồi gõ claude --version. Hiện số phiên bản là đã cài xong. Không cần Node.js.

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

Cách lưu lâu dài, dùng được 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://api.apiz.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://api.apiz.vn"
export ANTHROPIC_AUTH_TOKEN="sk-...your-key"

Windows (PowerShell):

$env:ANTHROPIC_BASE_URL="https://api.apiz.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 để xác nhận request và chi phí.

2. Codex CLI

Dùng key thuộc nhóm GPT.

Cài Node.js

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

Windows (PowerShell):

winget install OpenJS.NodeJS.LTS

macOS: tải bản LTS tại 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 rồi chạy:

npm install -g @openai/codex

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

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

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

model = "gpt-5.6-sol"
model_provider = "apiz"
model_context_window = 400000
model_auto_compact_token_limit = 250000

[model_providers.apiz]
name = "APIZ"
base_url = "https://api.apiz.vn/v1"
env_key = "APIZ_API_KEY"
wire_api = "responses"

Vì sao có 2 dòng model_context_window và model_auto_compact_token_limit? Khi dùng nhà cung cấp riêng, Codex không tự biết mô hình chứa được bao nhiêu nên có thể không tự rút gọn hội thoại. Phiên cứ dài mãi (kèm cả ảnh chụp màn hình), mỗi lượt chậm dần rồi bị ngắt. Hai dòng này bảo Codex tự rút gọn khi hội thoại chạm khoảng 250.000 token, giống khi dùng tài khoản OpenAI. Muốn rút gọn ngay, gõ /compact; việc mới thì gõ /new.

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

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

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

Muốn dùng mô hình khác, đổi dòng model theo Mô hình & giá (chọn mô hình thuộc nhóm GPT).

3. OpenCode

OpenCode là agent lập trình mã nguồn mở, chạy trong terminal. Nó dùng được mọi mô hình APIZ — Claude, GPT, Gemini, DeepSeek.

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

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

Cài OpenCode

Bản ứng dụng — dễ nhất, tải về rồi mở: macOS (chip Apple) · macOS (chip Intel) · Windows.

Bản dòng lệnh — cần khi dùng trong terminal hoặc VS Code.

macOS / Linux:

curl -fsSL https://opencode.ai/install | bash

Windows (dùng Scoop, không cần Node.js; chưa có Scoop thì cài trước tại scoop.sh):

scoop install opencode

Máy đã có Node.js thì dùng lệnh này cũng được: npm install -g opencode-ai

Kiểm tra bằng opencode --version. Cả hai bản dùng chung cấu hình mà lệnh APIZ ghi.

Tự cấu hình

Key mặc định thuộc nhóm Tự động và gọi được mọi mô hình (mỗi mô hình tính giá theo nhóm của nó), trừ nhóm Claude-Max phải tạo key riêng. Nên có thể dùng cùng một key Tự động cho mọi nhà cung cấp trong mẫu dưới đây; mẫu tách theo nhóm chỉ để dễ nhìn. Key nhóm riêng (Claude, GPT…) thì chỉ gọi được mô hình trong nhóm đó.

Tạo tệp ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "apiz-claude": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "APIZ Claude",
      "options": {
        "baseURL": "https://api.apiz.vn/v1",
        "apiKey": "sk-...key-nhom-Claude"
      },
      "models": {
        "claude-sonnet-5": { "name": "Claude Sonnet 5" },
        "claude-opus-5": { "name": "Claude Opus 5" }
      }
    },
    "apiz-gpt": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "APIZ GPT",
      "options": {
        "baseURL": "https://api.apiz.vn/v1",
        "apiKey": "sk-...key-nhom-GPT"
      },
      "models": {
        "gpt-6-astra": { "name": "GPT 6 Astra" }
      }
    }
  },
  "model": "apiz-claude/claude-sonnet-5"
}

Vào thư mục dự án rồi chạy opencode. Đổi mô hình trong phiên bằng lệnh /models.

4. Lệnh APIZ CLI

Nếu bạn cài bằng APIZ CLI thì có sẵn mấy lệnh này. Gõ apiz help để xem lại bất cứ lúc nào.

Key do CLI tạo xem và xoá được trong Khoá API trên bảng điều khiển.

5. Dùng trong VS Code

VS Code chỉ là trình soạn mã; AI chạy trong đó qua một tiện ích (extension). Chọn một cách dưới đây.

OpenCode (nhanh nhất)

1. Chạy lệnh APIZ. Nó tạo key cho mọi nhóm và ghi sẵn cấu hình OpenCode.

   macOS / Linux:

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

   Windows (PowerShell):

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

2. Cài OpenCode bản dòng lệnh. Trong VS Code, OpenCode chạy ở khung Terminal nên cần bản này; bản ứng dụng tải về không gắn vào VS Code.

   macOS / Linux:

   curl -fsSL https://opencode.ai/install | bash

   Windows (dùng Scoop, không cần Node.js; chưa có Scoop thì cài trước tại scoop.sh):

   scoop install opencode

   Máy đã có Node.js thì dùng lệnh này cũng được: npm install -g opencode-ai

3. Mở thư mục dự án trong VS Code, chọn menu Terminal → New Terminal, gõ opencode rồi Enter. Tiện ích OpenCode tự cài vào VS Code.

4. Gõ /models để chọn mô hình — mọi nhóm APIZ đều có trong danh sách. Rồi nói việc cần làm, tiếng nào cũng được.

Gõ opencode mà tiện ích không tự cài: trên macOS bấm Cmd + Shift + P, chọn Shell Command: Install 'code' command in PATH rồi mở Terminal mới; hoặc cài tay trong mục Extensions, tìm OpenCode (nhà phát hành SST). Không thấy mô hình APIZ: chạy opencode debug config để xem OpenCode đang đọc tệp cấu hình nào.

Cline

Cài Cline trong mục Extensions. Mở khung Cline, bấm biểu tượng bánh răng, chọn API Provider.

Key nhóm Claude — chọn kiểu Anthropic để dùng bộ nhớ đệm, rẻ hơn khi dự án lớn:

Danh sách Model không có mô hình bạn cần thì dùng cách dưới và gõ tay tên mô hình.

Key nhóm khác (GPT, Gemini, DeepSeek, Grok, China):

Roo Code đã ngừng phát triển từ 15/05/2026. Đang dùng Roo Code thì chuyển sang Cline hoặc Kilo Code, các ô nhập giống hệt.

Kilo Code

Cài Kilo Code trong mục Extensions. Vào Settings → Providers → Add custom provider, đặt tên tuỳ ý (ví dụ APIZ Claude), rồi chọn Provider API:

• Key nhóm Claude: Anthropic Messages, Base URL https://api.apiz.vn
• Key nhóm khác: OpenAI Compatible, Base URL https://api.apiz.vn/v1

Dán key. Kilo Code tự lấy danh sách mô hình của nhóm đó; danh sách không hiện thì gõ tay tên mô hình.

Claude Code (key nhóm Claude)

Cài tiện ích Claude Code (nhà phát hành Anthropic, cần VS Code 1.94 trở lên). Tiện ích dùng chung cấu hình với Claude Code dòng lệnh: lúc chạy lệnh APIZ đã chọn Claude Code thì chỉ việc mở khung Claude Code là dùng. Tự cấu hình thì làm theo mục 1.

• Vẫn hiện màn hình đăng nhập Anthropic: vào Settings → Extensions → Claude Code, bật Disable Login Prompt.
• Đừng bật chế độ ngữ cảnh 1M: Claude Code thêm [1m] vào tên mô hình và APIZ báo lỗi 503 “không dùng được với key nhóm Claude”.
• Cấu hình nằm ở ~/.claude/settings.json, app Claude trên máy tính cũng đọc tệp này: đổi ở đây thì Claude Code trong app Claude cũng đi qua APIZ.

Codex (key nhóm GPT)

Cài tiện ích Codex – OpenAI's coding agent (nhà phát hành OpenAI). Tiện ích dùng chung tệp ~/.codex/config.toml với Codex dòng lệnh: lúc chạy lệnh APIZ đã chọn Codex là xong, tự cấu hình thì làm theo mục 2.

• Sửa tệp cấu hình xong thì bấm Cmd/Ctrl + Shift + P, chọn Developer: Reload Window.
• Tiện ích báo lỗi 400 hoặc dùng mô hình OpenAI mặc định thay vì APIZ: mở Terminal, gõ codex để bắt đầu phiên — bản dòng lệnh dùng đúng cấu hình APIZ.
• Codex gửi rất nhiều ngữ cảnh mỗi lượt nên tốn token nhanh. Theo dõi chi phí ở Nhật ký API.

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 bằng 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 proxy, mở terminal mới rồi thử lại.
• 401, 403, 503: key sai, hết số dư, hoặc mô hình không thuộc nhóm của key. Xem Mã lỗi.
• 404 Invalid URL (POST /v1/v1/messages): ô địa chỉ kiểu Anthropic bị thừa /v1. Kiểu Anthropic nhập https://api.apiz.vn, kiểu OpenAI nhập https://api.apiz.vn/v1.