Nối công cụ AI vào APIVN: địa chỉ, khoá và từng ứng dụng

Hai thứ cần điền

Mọi ứng dụng bên dưới đều chỉ hỏi bạn hai thứ: một địa chỉ và một khoá. Điền xong là chạy.

Kiểu	Địa chỉ điền vào ứng dụng	Dùng cho
OpenAI	`https://apivn.vn/v1`	Cline, Open WebUI, Codex, thư viện `openai` — hầu hết ứng dụng dùng đường này
Anthropic	`https://apivn.vn`	Claude Code, thư viện `anthropic`
Gemini	`https://apivn.vn`	Thư viện Google GenAI — tự thêm `/v1beta` phía sau

Riêng Cherry Studio điền https://apivn.vn, không thêm /v1: Cherry tự nối thêm, điền thừa sẽ thành /v1/v1 và báo lỗi 404.

Khoá nằm ở Bảng điều khiển → Khóa API, dạng sk-...; đăng ký xong là đã có sẵn một khoá, bạn không phải tạo.

Bạn đang có gì trong tay?

Thứ bạn đang có	Làm gì	Cần terminal
Muốn một ứng dụng chat như ChatGPT	Cherry Studio	Không
Đã cài ứng dụng ChatGPT trên máy	Codex qua CC Switch	Không
Đã cài app Claude Desktop	Claude Desktop qua CC Switch	Không
Đã cài Claude Code	Claude Code	Có
Đã cài Claude Code, Codex hoặc OpenCode, không muốn tự điền	Cài nhanh bằng 1 lệnh	Có
Đã cài Cline, Open WebUI hay ứng dụng khác	Ứng dụng khác	Không
Muốn tự viết code gọi API	Gọi API trực tiếp	Có

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:

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.
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ã đó.
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.
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.

CC Switch — nhanh nhất, không phải gõ gì

Video có lời đọc: dùng Claude Code với APIVN qua CC Switch (khoá trong video được che).

Video có lời đọc: dùng Codex (app ChatGPT hoặc Terminal) với APIVN qua CC Switch.

CC Switch là ứng dụng nhỏ tự điền địa chỉ và khoá vào Claude Code hoặc Codex. Trên Bảng điều khiển, bấm ⋯ → CC Switch ngay ở dòng khoá và chọn ứng dụng. Một khoá dùng được cho cả hai.

CC Switch không phải ứng dụng chat — nó chỉ nạp cấu hình. Muốn trò chuyện thì dùng Cherry Studio.

Hướng dẫn CC Switch đầy đủ →

Claude Code

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

Trợ lý lập trình của Anthropic, chạy trong terminal. Trỏ về APIVN bằng hai biến môi trường:

export ANTHROPIC_BASE_URL="https://apivn.vn"
export ANTHROPIC_AUTH_TOKEN="sk-...khoá-của-bạn"

Mở terminal mới rồi gõ claude. Hướng dẫn cài đặt đầy đủ →

Codex

Chạy được trong ứng dụng ChatGPT trên máy tính (không cần terminal) hoặc bằng Codex CLI. Cấu hình tay nằm ở ~/.codex/config.toml, địa chỉ là https://apivn.vn/v1.

Hướng dẫn cài đặt đầy đủ →

Claude Desktop

Video có lời đọc: dùng app Claude Desktop với APIVN qua CC Switch bản 3.20 trở lên.

Dùng app chat Claude Desktop bằng khoá APIVN, không cần dòng lệnh. Cần CC Switch bản 3.20 trở lên (bản cũ chưa có mục Claude Desktop).

Mở CC Switch, bấm biểu tượng Claude Desktop (thứ hai trên thanh phía trên), rồi bấm nút + màu cam.
Chọn Custom Config (bản tiếng Trung ghi là 自定义配置).
Điền Provider Name: APIVN; Website URL: https://apivn.vn; API Key: khoá APIVN của bạn; API Endpoint: https://apivn.vn (không thêm /v1). Connection Mode để nguyên Direct, danh sách mô hình để trống.
Bấm Add, rê chuột vào dòng APIVN, bấm Enable, rồi mở lại Claude Desktop.

Cherry Studio

Ứng dụng chat miễn phí cho Windows, macOS và Linux. Thêm một nhà cung cấp với một khoá là có cả Claude, GPT, Gemini, Grok, DeepSeek và GLM trong cùng một danh sách, đổi mô hình ngay giữa cuộc chat.

Ô trong Cherry	Điền
Provider Name	APIVN
API Key	Khoá của bạn
OpenAI – Base URL	`https://apivn.vn` (Cherry tự thêm `/v1`)

Hướng dẫn Cherry Studio đầy đủ →

Cline, Open WebUI và ứng dụng khác

Bất kỳ ứng dụng nào nhận nhà cung cấp kiểu OpenAI đều chạy được: điền https://apivn.vn/v1 vào ô Base URL, dán khoá, rồi nhập Model ID lấy từ Mô hình.

Cline, Open WebUI, OpenClaw →

Không chạy thì xem gì

401: khoá sai, đã tắt hoặc hết hạn — chép lại khoá.
403: hết số dư — xem Nạp tiền.
404: địa chỉ thừa /v1 hai lần.
model_not_found: gõ nhầm Model ID — tra ở Mô hình.

Đầy đủ ở Mã lỗi. Cần người thật thì nhắn Telegram hoặc qua trang Liên hệ — đừng gửi khoá cho ai.