Dùng khóa của bạn trong Codex CLI

Cấu hình model provider tùy chỉnh trong ~/.codex/config.toml với wire_api = responses, rồi chọn mô hình.

Codex là tác nhân lập trình của OpenAI (CLI và bản desktop). Nó hỗ trợ nhà cung cấp mô hình tùy chỉnh — trỏ một provider về OLETOKEN thì nó dùng khóa và hạn mức mô hình OLETOKEN của bạn.

Trước khi bắt đầu

Bạn đã tạo khóa API và lưu lại khóa đầy đủ.
Bạn đã chọn một model ID từ chợ mô hình.
Đã cài Node.js và npm.

Cấu hình

Một provider tùy chỉnh bắt buộc phải nằm trong ~/.codex/config.toml ở cấp người dùng. model_provider và model_providers trong .codex/config.toml ở cấp dự án sẽ bị bỏ qua.

model = "gpt-5.6-terra"
model_provider = "oletoken"

[model_providers.oletoken]
name = "OleToken"
base_url = "https://<your-base-url>/v1"
env_key = "OLETOKEN_API_KEY"
wire_api = "responses"

Trường	Ý nghĩa
`model`	Model ID mặc định
`model_provider`	Trỏ tới provider được định nghĩa bên dưới
`base_url`	Địa chỉ tương thích OpenAI, bao gồm `/v1` (Codex gọi `{base_url}/responses`)
`env_key`	Tên biến môi trường chứa khóa — bản thân khóa không nằm trong tệp
`wire_api`	Hiện chỉ hỗ trợ `responses`

Export khóa rồi khởi chạy:

export OLETOKEN_API_KEY="YOUR_API_KEY"   # thêm vào ~/.zshrc hoặc ~/.bashrc để giữ lâu dài
npm i -g @openai/codex
codex

Hộp thoại Bắt đầu nhanh trên trang khóa API cho phép tải về đúng script đó với khóa, mô hình và Base URL của bạn đã được điền sẵn: nó nối thêm phần còn thiếu và, nếu config.toml đã có model / model_provider, thì chỉ in ra khối cần ghép để bạn tự gộp thay vì ghi đè tệp của bạn.

Xử lý sự cố

Triệu chứng	Nguyên nhân và cách xử lý
401	`OLETOKEN_API_KEY` chưa được export hoặc mang giá trị sai — `env_key` chỉ nêu tên biến, khóa phải thực sự tồn tại trong môi trường
404	`base_url` thiếu `/v1`
Provider bị bỏ qua	Cấu hình đang nằm trong `.codex/config.toml` ở cấp dự án; hãy chuyển nó sang `~/.codex/config.toml`
Không tìm thấy mô hình	ID không có trên trang này; hãy sao chép từ chợ mô hình
Số dư không đủ	Nạp tiền trước

wire_api chỉ hỗ trợ responses, nên Codex gửi yêu cầu tới {base_url}/responses — hãy đảm bảo Base URL của bạn có mở endpoint đó (nhận 401 khi không có khóa nghĩa là đường dẫn tồn tại).