APIZ
Đăng nhập

Tài liệu APIZ

Kết nối CC Switch trong 1 phút

CC Switch điền sẵn key và địa chỉ API cho Codex (dùng ngay trong app ChatGPT) hoặc Claude Code.

CC Switch không phải ứng dụng chat. Nó chỉ điền sẵn key và địa chỉ API cho Claude Code hoặc Codex, hai công cụ lập trình chạy trong terminal. Chỉ cần chat với AI? Dùng Cherry Studio, không cần terminal.

1. Chọn và cài công cụ (làm một lần)

Chọn công cụ bạn muốn dùng. Máy đã có rồi thì chuyển sang bước 2.

App ChatGPT: dùng Codex, không cần terminal (key nhóm GPT)

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

Claude Code (dùng key nhóm Claude)

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.

Codex CLI trong terminal (tùy chọn, key nhóm GPT)

Chỉ cần khi bạn muốn dùng Codex trong terminal thay vì app ChatGPT.

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

npm install -g @openai/codex

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

Gặp lỗi khi cài? Xem lỗi thường gặp.

2. Tải và cài CC Switch

CC Switch là ứng dụng miễn phí, mã nguồn mở. Nó ghi key và địa chỉ API của APIZ vào cấu hình của Claude Code hoặc Codex, nên bạn không phải tự 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 để máy nhận liên kết kết nối 1 chạm.

3. Kết nối APIZ bằng 1 chạm

  1. Đăng nhập api.apiz.vn → Khóa API. Tạo key nhóm Claude (cho Claude Code) hoặc nhóm GPT (cho Codex).
  2. Ở dòng key 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 (cho app ChatGPT hoặc Codex CLI, key nhóm GPT) hoặc Claude (cho Claude Code, key nhóm Claude). 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 key: CC Switch, và Trò chuyện → Cherry Studio
Ở dòng key bấm ⋯: CC Switch để dùng Codex/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 đúng nhóm key (key GPT → Codex), giữ mô hình gợi ý, bấm Mở CC Switch.

APIZ được thêm và bật ngay (nhãn In Use). Bạn không cần copy key hay sửa file cấu hình.

4. Bắt đầu dùng

App ChatGPT (Codex)

  1. App ChatGPT đang mở thì thoát hẳn (Quit) rồi mở lại, để app đọc cấu hình mới. Nhập vào CC Switch trước, mở app 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ý API trên APIZ để xem token và chi phí.
Nhật ký API: mỗi lượt gọi có thời gian, mô hình, số token và chi phí
Nhật ký API: mỗi lượt gọi ghi mô hình, số token vào/ra và chi phí.

Chi phí khi dùng app Codex: app gửi kèm nhiều ngữ cảnh (thường 40–90 nghìn token đầu vào mỗi lượt) và tự gọi thêm codex-auto-review để kiểm tra thao tác. Lần thử của APIZ: 8 phút làm việc với gpt-5.6-sol tốn khoảng 5.500 ₫, tức credit dùng thử chỉ đủ vài phút. Nạp số dư trước khi làm việc dài và theo dõi ở Nhật ký API.

Claude Code hoặc Codex CLI (terminal)

  1. Mở một terminal mới (terminal mở từ trước vẫn dùng 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 tưởng thư mục này không, chọn xong là dùng được.
  4. Gửi một yêu cầu ngắn rồi mở Nhật ký API trên APIZ để xem token và chi phí.

Muốn đổi qua lại giữa APIZ 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 thủ công (khi nút 1 chạm không mở được)

Trong CC Switch bấm + (Add Provider), chọn cấu hình tùy chỉnh rồi nhập:

Ứng dụngAPI EndpointAPI Key
Claude Codehttps://api.apiz.vnKey nhóm Claude
Codexhttps://api.apiz.vn/v1Key nhóm GPT

Không thêm /v1 hai lần. Mô hình phải thuộc nhóm của key, xem Mô hình & giá.

Lỗi thường gặp

  • Gõ claude hoặc codex 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, mở ứng dụng một lần rồi thử lại. Vẫn không được thì dùng cách thêm thủ công ở trên.
  • Vẫn dùng cấu hình cũ: với app ChatGPT, thoát hẳn app rồi mở lại; với terminal, đóng terminal đ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: key sai, hết hạn hoặc đã tắt. Lỗi 403: hết số dư. Lỗi 503 hoặc model_not_found: mô hình không thuộc nhóm của key, ví dụ dùng key nhóm Claude cho Codex. Xem Mã lỗi.