Codex

Trạng thái tích hợp
  • Giao thức đề xuất: OpenAI Responses
  • Ngày kiểm tra cấu hình: 15 tháng 7 năm 2026 (tài liệu tham chiếu cấu hình Codex chính thức)
  • Xác minh khi chạy: Đang chờ xác minh

Các nhà cung cấp tùy chỉnh của Codex sử dụng giao thức Responses. Hãy chọn model GetRouter hỗ trợ /v1/responses.

Lưu khóa API

export GETROUTER_API_KEY="YOUR_API_KEY"

Thêm biến này vào cấu hình môi trường an toàn của shell nếu cần. Không ghi trực tiếp khóa vào config.toml.

Cấu hình Codex

Chỉnh sửa ~/.codex/config.toml:

model = "MODEL_ID"
model_provider = "getrouter"

[model_providers.getrouter]
name = "GetRouter"
base_url = "https://getrouter.ai/v1"
env_key = "GETROUTER_API_KEY"
wire_api = "responses"

Thay MODEL_ID bằng chính xác model ID từ Danh sách model. Giữ nguyên các cài đặt Codex không liên quan.

Warning

Không dùng wire_api = "chat". Các nhà cung cấp tùy chỉnh hiện tại của Codex sử dụng Responses. Model chỉ hỗ trợ Chat Completions không phù hợp với cấu hình này.

Xác minh

  1. Khởi động lại Codex từ shell đã thiết lập GETROUTER_API_KEY.
  2. Xác nhận Codex hiển thị đúng model/nhà cung cấp mong đợi.
  3. Bắt đầu bằng một câu hỏi không gây thay đổi trong kho mã.
  4. Xác nhận yêu cầu xuất hiện trong nhật ký sử dụng GetRouter.
  5. Chỉ sau đó mới kiểm tra chỉnh sửa, gọi công cụ, ngữ cảnh dài hoặc cài đặt suy luận cao hơn.

Lỗi thường gặp

  • Thiếu biến môi trường: khởi chạy Codex từ shell có xuất GETROUTER_API_KEY.
  • Lỗi 404 tại /responses: dùng base_url = "https://getrouter.ai/v1"; không tự nối thêm /responses.
  • Không tìm thấy model: sao chép chính xác model ID và xác nhận khóa được phép dùng model đó.
  • Phản hồi hoặc sự kiện công cụ không được hỗ trợ: tuyến kết nối của model/nhà cung cấp đã chọn có thể chưa hỗ trợ đầy đủ sự kiện công cụ Responses; hãy thử model khác có hỗ trợ Responses.
  • Codex vẫn dùng nhà cung cấp khác: kiểm tra cấu hình đang hoạt động và model_provider ở cấp cao nhất.

Xem Khắc phục sự cố tích hợp trước khi chia sẻ thông tin chẩn đoán.