Tới nội dung
Đăng nhậpTạo tài khoản

Tài liệu APIVN

Nối APIVN bằng CC Switch

CC Switch tự ghi khoá và địa chỉ API vào Codex (trong ứng dụng ChatGPT) hoặc Claude Code.

Sơ đồ: tạo khoá trên APIVN, nhập vào CC Switch một chạm, rồi dùng trong Codex hoặc Claude Code
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.

1. Cài công cụ bạn định dùng (một lần)

Chọn một trong ba. Máy đã có sẵn thì bỏ qua, sang bước 2.

Ứng dụng ChatGPT: chạy Codex không cần terminal

Tải ứng dụng ChatGPT cho máy tính tại chatgpt.com/download, cài và đăng nhập tài khoản ChatGPT như thường lệ. Không cần cài thêm gì khác.

Claude Code

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.

Codex CLI trong terminal (tuỳ chọn)

Chỉ cần nếu bạn muốn chạy Codex trong terminal thay vì ứng dụng ChatGPT.

Cài Node.js bản LTS, mở terminal mới và chạy:

npm install -g @openai/codex

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

Cài bị lỗi? Xem lỗi thường gặp.

2. Cài CC Switch

CC Switch là phần mềm miễn phí, mã nguồn mở. Nó ghi khoá và địa chỉ API của APIVN vào cấu hình Claude Code hoặc Codex, thay bạn sửa file.

⬇ Tải CC Switch bản mới nhất

  • Windows: chọn file CC-Switch-…-Windows.msi
  • macOS: chọn file CC-Switch-…-macOS.dmg hoặc chạy brew install --cask cc-switch
  • Linux: chọn file .deb, .rpm hoặc .AppImage

Cài xong, mở CC Switch một lần để hệ điều hành nhận liên kết nhập một chạm.

3. Nhập khoá APIVN bằng một chạm

  1. Đăng nhập apivn.vn → Khóa API. Dùng khoá sẵn có (nhóm Tự động) là được cho cả Claude Code lẫn Codex.
  2. Ở dòng khoá vừa tạo bấm ⋯ → CC Switch, hoặc bấm Kết nối bằng CC Switch ở trang Tổng quan.
  3. Chọn ứng dụng Codex (ứng dụng ChatGPT hoặc Codex CLI) hoặc Claude (Claude Code). Mô hình đã điền sẵn. Bấm Mở CC Switch.
  4. Trình duyệt hỏi có mở CC Switch không, chọn Mở. Trong CC Switch bấm Import.
Menu ba chấm ở dòng khoá: Sao chép khóa, Sao chép thông tin kết nối, CC Switch, Trò chuyện, Xóa
Menu ⋯ ở dòng khoá: CC Switch cho Codex hoặc Claude Code, Trò chuyện → Cherry Studio để chat.
Hộp Nhập vào CC Switch: chọn ứng dụng Codex, mô hình gpt-5.6-sol, bấm Mở CC Switch
Chọn ứng dụng khớp nhóm khoá (khoá GPT → Codex), giữ mô hình gợi ý rồi bấm Mở CC Switch.

4. Dùng thôi

Ứng dụng ChatGPT (Codex)

  1. Nếu ứng dụng ChatGPT đang mở, thoát hẳn (Quit) rồi mở lại để nó đọc cấu hình mới. Nhập vào CC Switch trước, mở ứng dụng sau.
  2. Chọn Codex, chọn thư mục dự án.
  3. Gửi một yêu cầu ngắn rồi mở Nhật ký sử dụng trên APIVN để xem token và số tiền.
Nhật ký sử dụng: mỗi lượt gọi có thời gian, mô hình, số token và chi phí
Nhật ký sử dụng: mỗi lượt gọi ghi mô hình, token vào/ra và số tiền đã trừ.

Claude Code hoặc Codex CLI (terminal)

  1. Mở một terminal mới; cửa sổ mở từ trước vẫn giữ cấu hình cũ.
  2. Vào thư mục dự án: cd đường-dẫn-tới-dự-án.
  3. Gõ claude hoặc codex. Lần đầu Claude Code hỏi chọn giao diện và có tin thư mục này không, chọn xong là chạy.
  4. Gửi một yêu cầu ngắn rồi mở Nhật ký sử dụng trên APIVN để xem token và số tiền.

Muốn chuyển qua lại giữa APIVN và nhà cung cấp khác: chọn provider trong CC Switch, hoặc bấm tên provider ở biểu tượng CC Switch trên khay hệ thống.

Thêm bằng tay (khi nút một chạm không mở được)

Trong CC Switch bấm + (Add Provider), chọn cấu hình tuỳ chỉnh rồi điền:

Ứng dụngAPI EndpointAPI Key
Claude Codehttps://apivn.vnKhoá sẵn có của bạn
Codexhttps://apivn.vn/v1Cùng khoá đó

Lỗi thường gặp

  • Gõ claude hoặc codex mà báo không tìm thấy lệnh (command not found): chưa cài công cụ, hoặc chưa mở terminal mới. Làm lại bước 1.
  • Bấm “Mở CC Switch” mà không có gì xảy ra: kiểm tra đã cài CC Switch chưa, mở ứng dụng một lần rồi thử lại. Vẫn không được thì thêm bằng tay như trên.
  • Vẫn chạy cấu hình cũ: với ứng dụng ChatGPT, thoát hẳn rồi mở lại; với terminal, đóng cửa sổ đang mở và mở cửa sổ mới. Đổi nhà cung cấp trong CC Switch cũng phải làm bước này.
  • Lỗi 401: khoá sai, hết hạn hoặc đã tắt. Lỗi 403: hết số dư. Lỗi 503 hoặc model_not_found: gõ nhầm model ID, hoặc bạn đang dùng một khoá tự gắn nhóm cụ thể để gọi mô hình ngoài nhóm đó — khoá Tự động không vướng lỗi này. Xem Mã lỗi.
Hỏi hỗ trợ