Docs / Công cụ & SDK

Codex CLI

Cấu hình Codex CLI của OpenAI với endpoint và model của Apimodelhub.

Cài Codex CLI

npm i -g @openai/codex@latest
codex --version

Codex đọc cấu hình trong ~/.codex/ (Windows: %USERPROFILE%\.codex). Extension VS Code dùng CÙNG thư mục này, nên cấu hình một lần là cả hai dùng được.

Cấu hình

~/.codex/config.toml

[model_providers.apimodelhub]
name = "Apimodelhub"
base_url = "https://api.apimodelhub.com/v1"
env_key = "APIMODELHUB_API_KEY"
wire_api = "chat"

[profiles.default]
model_provider = "apimodelhub"
model = "gpt-5.4"

export APIMODELHUB_API_KEY=sk-spk-...

env_key nghĩa là Codex đọc key từ biến môi trường có tên đó, chứ KHÔNG lưu key trong config.toml — nhờ vậy file cấu hình commit vào dotfiles được. Tên provider (apimodelhub) phải khác ba id Codex đã chiếm: openai, ollama, lmstudio.

Đừng đặt requires_openai_auth = trueKhoá đó bảo Codex dùng phiên đăng nhập OpenAI và BỎ QUA env_key — với endpoint của chúng tôi thì bạn sẽ nhận 401 dù key đúng. Cứ để trống và dùng env_key.

wire_api = "chat" hay "responses"?chat dùng /v1/chat/completions — ổn định nhất với mọi model chúng tôi bán, và ở đường này gateway tự đổi max_tokens sang max_completion_tokens cho model OpenAI mới. responses dùng /v1/responses (cũng được hỗ trợ nguyên văn); chọn nó khi bạn cần đúng ngữ nghĩa Responses API, nhưng khi đó bạn phải tự gửi đúng tên tham số (max_output_tokens, không phải max_tokens).

Sửa config xong phải chạy lại codexCodex đọc config.toml/auth.json lúc khởi động. Ctrl+C rồi chạy codex lại thì cấu hình mới có hiệu lực.

Chỉ dùng model trong bảng giá của chúng tôiMặc định của Codex là id của OpenAI (có thể kèm hậu tố), và id đó có thể không nằm trong bảng giá của chúng tôi — request trả 404 chứ không fallback. Đặt model theo id trong GET /v1/models.

Kiểm tra nhanh

curl -s https://api.apimodelhub.com/v1/models \
  -H "Authorization: Bearer $APIMODELHUB_API_KEY" | head -c 200
codex "say hi"