CC-Switch Codex
Trang này hướng dẫn cách quản lý Codex Provider thông qua CC Switch. Thao tác này khác với việc cấu hình trực tiếp trên Codex client hoặc Codex CLI: trọng tâm ở đây là duy trì các provider trong CC Switch trước, sau đó áp dụng chúng vào Codex.
Thông tin chính thức Việc tải xuống và tài liệu hướng dẫn căn cứ theo trang web chính thức.
Nội dung trang này giải thích
Codex thường hoạt động thông qua các giao diện OpenAI hoặc tương thích với OpenAI, vì vậy hãy tập trung kiểm tra ba mục: Base URL, Key và tên model. Việc Base URL có cần bao gồm /v1 hay không phụ thuộc vào hiển thị trong trang quản trị của provider.
Xác nhận trước khi bắt đầu
| Mục cần xác nhận | Cách xem | Lý do |
|---|---|---|
| Codex có thể mở bình thường | Trước tiên hãy xác nhận Codex CLI hoặc client tương ứng có thể tự chạy được | CC Switch không cài đặt Codex cho bạn |
| Provider hỗ trợ giao diện tương thích OpenAI | Trang quản trị có thể hiển thị địa chỉ API, Base URL, độ tương thích OpenAI và các hướng dẫn khác | Codex cần có khả năng gửi yêu cầu đến giao diện tương thích |
| Model có thể sử dụng trong ngữ cảnh Codex | Tên model khả dụng có thể tìm thấy trong danh sách model ở trang quản trị | Không điền tên model Claude/Gemini vào Codex |
| Trạng thái Key bình thường | Token trong trang quản trị chưa hết hạn, không bị vô hiệu hóa và số dư bình thường | Hầu hết các lỗi 401 nên bắt đầu bằng việc kiểm tra Key |
Cách điền các trường thông tin
| Cài đặt | Cách điền | Lưu ý cho người mới bắt đầu |
|---|---|---|
| Provider Name | Điền tên của provider hoặc mục đích sử dụng | Ví dụ: 'Provider tương thích OpenAI chính' |
| Target Tool / Preset | Chọn Codex hoặc các preset liên quan đến OpenAI/Codex | Không chọn Claude Code hoặc Gemini |
| Base URL | Sao chép liên kết API do trang quản trị của provider cung cấp | Thường là địa chỉ API do provider cung cấp; việc có bao gồm /v1 hay không hãy làm theo ví dụ ở trang quản trị |
| API Key | Sao chép toàn bộ key đầy đủ | Không thêm dấu cách thừa ở đầu hoặc cuối, không sao chép nhầm tên ghi chú |
| Model Name | Sao chép chính xác từ danh sách model ở trang quản trị | Nếu việc lấy danh sách model thất bại, hãy thêm thủ công, vẫn sao chép chính xác tên từ trang quản trị |
Áp dụng cho Codex
- Mở CC Switch và chuyển đến khu vực quản lý Provider.
- Thêm một provider mới, hoặc chọn một provider tương thích OpenAI hiện có.
- Chọn Codex hoặc các preset liên quan đến OpenAI/Codex làm công cụ mục tiêu.
- Điền Base URL, API Key cùng tên model, sau đó lưu lại.
- Thực hiện Apply / Switch để áp dụng Provider này cho Codex.
- Đóng cửa sổ terminal hiện tại rồi mở lại, sau đó thử nghiệm lại.
Kiểm tra xem đã hoạt động chưa
Trước tiên hãy thử nghiệm yêu cầu bằng câu hỏi ngắn nhất để xem có thông suốt không. Sau khi kiểm tra thành công, hãy tiếp tục sử dụng trong dự án thực tế.
Kiểm tra tối thiểu Codex
codex "Please reply only: CC-Switch Codex is active" Nếu phản hồi báo model không tồn tại, trước tiên hãy kiểm tra lại tên model; nếu phản hồi là unauthorized, trước tiên hãy kiểm tra Key; nếu kết nối bị timeout, trước tiên hãy kiểm tra Base URL và kết nối mạng.
