Hướng dẫn triển khai Codex
Tải CC Switch cho máy tính của bạn, nhập khóa API của Guishu AI và kiểm tra phản hồi đầu tiên trong Codex CLI.
1. Tải và mở CC Switch
Bạn dùng CC Switch để thiết lập kết nối API và dùng Codex CLI để trò chuyện trong terminal. Trước tiên, hãy chọn bộ cài CC Switch 4.0.25 phù hợp với máy tính của bạn.
- Windows x64 · Tải bản MSI Chọn bản này cho hầu hết máy dùng bộ xử lý Intel hoặc AMD. Nhấp đúp vào tệp
.msi, hoàn tất cài đặt rồi mở CC Switch từ menu Start. - Windows ARM64 · Tải bản MSI Mở Settings → System → About. Chọn bản này nếu mục System type cho biết máy dùng bộ xử lý ARM.
- macOS · Tải bản DMG Máy Mac dùng chip Intel và chip Apple dùng chung bộ cài. Mở tệp
.dmg, kéo CC Switch vào thư mục Applications rồi mở ứng dụng từ đó. - Linux · Chọn gói cài đặt Mở rộng mục Assets rồi chọn kiến trúc theo kết quả của
uname -m(aarch64tương ứng vớiarm64). Chọn.debcho Ubuntu hoặc Debian,.rpmcho Fedora.
Đã tải tệp khác? v3.12.2-en.md là ghi chú phát hành. Nếu giải nén xong mà chỉ thấy CC-SWITC.14, bạn cứ tải bộ cài phù hợp ở trên, không cần đổi đuôi tệp. Các phiên bản khác có trên trang phát hành chính thức.
2. Cài đặt Codex CLI
Trên Windows, mở Command Prompt. Trên macOS hoặc Linux, mở Terminal. Nếu đã cài Codex, hãy chạy codex --version. Khi thấy số phiên bản, bạn có thể chuyển sang bước 3.
Nếu đây là lần cài đầu tiên, hãy cài Node.js LTS, mở lại terminal rồi chạy lần lượt hai lệnh bên dưới. Lệnh thứ hai sẽ hiển thị codex-cli kèm số phiên bản.
npm install -g @openai/codex@latest
codex --version3. Thêm Guishu AI vào CC Switch
Chọn Codex ở thanh bên trái, mở thẻ Direct (kết nối trực tiếp) rồi nhấn Add Provider (+). Trong mục All, chọn Custom Configuration.
| Trường trên màn hình | Giá trị cần nhập |
|---|---|
| Provider Name | Nhập “Guishu AI” để dễ tìm trong danh sách. |
| API Request URL | Nhập https://api.llm-token.cn/v1, giữ nguyên phần /v1 ở cuối. |
| API Key | Dán toàn bộ khóa API bạn nhận từ Guishu AI. |
| Default Model | Trong danh sách mô hình, sao chép ID của một mô hình mà khóa được phép dùng và có hỗ trợ Responses API, chẳng hạn gpt-6.1-terra. |
Nhấn Add ở cuối trang. Quay lại danh sách Direct và nhấn Switch trên thẻ Guishu AI. Nếu trước đó bạn dùng chế độ định tuyến hoặc tổng hợp, nút này có tên Back to direct and use. Khi thẻ hiển thị In use, bạn có thể mở Codex.
4. Kiểm tra phản hồi đầu tiên trong terminal
Thoát phiên Codex đang mở. Trong terminal, chuyển đến thư mục dự án rồi chạy codex. Nếu chưa có dự án, bạn có thể tạo một thư mục trống bằng các lệnh sau:
mkdir my-codex-project
cd my-codex-project
codexTrong Codex, nhập “Chỉ trả lời OK”. Khi nhận được phản hồi, bạn đã gửi yêu cầu thành công. Lần kiểm tra này sẽ dùng hạn mức của khóa API.
Chưa nhận được phản hồi? Nếu gặp lỗi 401, hãy dán lại khóa API và kiểm tra xem khóa đã được kích hoạt chưa. Nếu mô hình không khả dụng, kiểm tra ID mô hình mặc định và quyền truy cập của khóa. Nếu báo không tìm thấy điểm cuối, hãy kiểm tra URL có kết thúc bằng /v1 hay không, rồi vào Advanced Options và kiểm tra Upstream Format đã đặt thành OpenAI Responses chưa.
Tùy chọn: Chỉnh sửa tệp cấu hình thủ công
Nếu đã nhận được phản hồi sau khi thiết lập bằng CC Switch, bạn có thể dừng ở đây. Để cấu hình thủ công, hãy chỉnh sửa hai tệp dưới đây trong %USERPROFILE%\.codex\ trên Windows hoặc ~/.codex/ trên macOS và Linux. Tạo thư mục nếu chưa có. Nếu đã có tệp cấu hình, hãy sao lưu trước khi sửa và giữ nguyên các thiết lập khác.
config.toml — Điền nhà cung cấp, URL và một mô hình mà khóa của bạn được phép dùng.
model_provider = "gpt-agent"
model = "gpt-6.1-terra"
[model_providers.gpt-agent]
name = "LLM API Gateway"
base_url = "https://api.llm-token.cn/v1"
wire_api = "responses"
requires_openai_auth = trueauth.json — Thay giá trị mẫu bằng khóa API của Guishu AI, lưu tệp rồi mở lại Codex như ở bước 4.
{
"OPENAI_API_KEY": "YOUR_API_KEY"
}