Codex CLI

Thiết lập provider Responses và khóa API trong shell cho Codex CLI.

Cài đặt và chuẩn bị

  1. Cài Node.js rồi dùng lệnh bên dưới cài CLI Codex chính thức. Chạy codex --version trong terminal mới.
  2. Tạo khóa tại routerra.ai → Khóa API. Chọn ID chính xác từ Mô hình có hỗ trợ Responses API và gọi công cụ; mô hình chỉ hỗ trợ Chat Completions không dùng được cấu hình này.
npm install -g @openai/codex
codex --version

Khai báo provider TOML

  1. Sửa ~/.codex/config.toml (Windows: %USERPROFILE%\.codex\config.toml) và hợp nhất TOML, tránh trùng bảng provider. model_provider phải khớp routerra; env_key là tên biến môi trường, không phải khóa bí mật. Thay YOUR_MODEL_ID.
  2. Đặt ROUTERRA_API_KEY trong cùng shell khởi chạy codex. Biến chỉ tồn tại trong shell đó; lưu vào hồ sơ shell nếu cần. Provider này dùng khóa riêng thay cho đăng nhập ChatGPT. Khởi động lại Codex sau khi sửa TOML.
model = "YOUR_MODEL_ID"
model_provider = "routerra"

[model_providers.routerra]
name = "routerra.ai"
base_url = "https://routerra.ai/v1"
env_key = "ROUTERRA_API_KEY"
wire_api = "responses"

Chạy với khóa provider

Lỗi thiếu biến nghĩa là Codex không nhận ROUTERRA_API_KEY; hãy chạy từ terminal đã đặt khóa. Với 404 tại /responses, kiểm tra URL và giao thức: chỉ một /v1 và wire_api = "responses". Nếu văn bản hoạt động nhưng liệt kê tệp thất bại, chọn mô hình có công cụ. Kiểm tra yêu cầu trong mức sử dụng routerra.ai; chỉ khởi động CLI chưa xác nhận định tuyến.

export ROUTERRA_API_KEY="YOUR_API_KEY"
codex

Dành cho Windows PowerShell:

$env:ROUTERRA_API_KEY = "YOUR_API_KEY"
codex