cách cấu hình API tùy chỉnh cho Codex CLI

Cấu hình nhanh

Lệnh cài đặt

npm install -g @openai/codex

Tệp cấu hình

~/.codex/config.toml

model_provider

qionggeme

base_url

https://qionggeme.com/v1

env_key

QIONGGEME_API_KEY

Đây là tên biến môi trường, không phải API Key dạng rõ.

wire_api

responses

Custom provider chính thức hiện phải dùng Responses.

Các bước cấu hình

1. 1

   Cài đặt Codex CLI

   Cài đặt toàn cục bằng gói npm chính thức:

   npm install -g @openai/codex

   Sau khi cài xong, chạy codex để mở ứng dụng dòng lệnh.

2. 2

   Ghi cấu hình vào ~/.codex/config.toml

   Tạo hoặc chỉnh sửa ~/.codex/config.toml rồi thêm cấu hình sau:

   model_provider = "qionggeme"
   model = "gpt-5.3-codex-spark"
   
   [model_providers.qionggeme]
   name = "穷哥么"
   base_url = "https://qionggeme.com/v1"
   env_key = "QIONGGEME_API_KEY"
   wire_api = "responses"

   Giá trị env_key là tên biến môi trường mà Codex sẽ đọc, không phải API Key. Không thêm trường api_key.

3. 3

   Đặt API Key trên macOS / Linux

   Trong terminal sẽ dùng để chạy Codex, đặt biến môi trường:

   export QIONGGEME_API_KEY="API Key qionggeme/穷哥么 của bạn"

   Nếu ghi vào tệp cấu hình shell, hãy nạp lại tệp hoặc mở terminal mới trước khi bắt đầu một phiên Codex mới.

4. 4

   Đặt API Key trong Windows PowerShell

   Chạy lệnh sau trong PowerShell:

   $env:QIONGGEME_API_KEY="API Key qionggeme/穷哥么 của bạn"

   Cách này có hiệu lực trong phiên PowerShell hiện tại. Hãy chạy codex trong chính cửa sổ đó. Nếu thay đổi biến hoặc cấu hình TOML, hãy kết thúc phiên Codex cũ rồi khởi động lại.

5. 5

   Khởi động lại phiên Codex và kiểm tra

   Sau khi thay đổi tệp cấu hình hoặc biến môi trường, hãy dừng Codex đang chạy rồi thực thi codex để tạo phiên mới. Nếu mô hình ví dụ không nằm trong danh sách mô hình của token hiện tại, hãy đổi sang Model ID tương thích Codex do bảng điều khiển trả về. Trang bảng giá mô hình chỉ là tài liệu tham khảo cho các mô hình chủ lực. Bạn chỉ cần sửa giá trị model ở đầu tệp TOML.

Ví dụ cấu hình

model_provider = "qionggeme"
model = "gpt-5.3-codex-spark"

[model_providers.qionggeme]
name = "穷哥么"
base_url = "https://qionggeme.com/v1"
env_key = "QIONGGEME_API_KEY"
wire_api = "responses"

# macOS / Linux
export QIONGGEME_API_KEY="API Key qionggeme/穷哥么 của bạn"

# Windows PowerShell
$env:QIONGGEME_API_KEY="API Key qionggeme/穷哥么 của bạn"

Khắc phục sự cố

Câu hỏi thường gặp