Hướng dẫn cài đặt

Hướng dẫn cài đặt nhà cung cấp

Xem các bước cài đặt và cách khắc phục sự cố theo công cụ.

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.

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ậnCách xemLý do
Codex có thể mở bình thườngTrước tiên hãy xác nhận Codex CLI hoặc client tương ứng có thể tự chạy đượcCC Switch không cài đặt Codex cho bạn
Provider hỗ trợ giao diện tương thích OpenAITrang 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ácCodex 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 CodexTê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ườngToken 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ườngHầ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 đặtCách điềnLư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ụngVí dụ: 'Provider tương thích OpenAI chính'
Target Tool / PresetChọn Codex hoặc các preset liên quan đến OpenAI/CodexKhông chọn Claude Code hoặc Gemini
Base URLSao chép liên kết API do trang quản trị của provider cung cấpThườ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 KeySao 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 NameSao 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

  1. Mở CC Switch và chuyển đến khu vực quản lý Provider.
  2. Thêm một provider mới, hoặc chọn một provider tương thích OpenAI hiện có.
  3. Chọn Codex hoặc các preset liên quan đến OpenAI/Codex làm công cụ mục tiêu.
  4. Điền Base URL, API Key cùng tên model, sau đó lưu lại.
  5. Thực hiện Apply / Switch để áp dụng Provider này cho Codex.
  6. Đó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.