Cấu hình Codex CLI dùng API key RocketKey: ~/.codex/config.toml và wire_api responses

Codex CLI đọc cấu hình provider từ file ~/.codex/config.toml (cấp user) và đọc key từ một biến môi trường. Mọi đoạn dưới đây dùng key giả sk-rk-YOUR_KEY_HERE.

1. Thêm provider vào config.toml

Mở (hoặc tạo) ~/.codex/config.toml — trên Windows là %USERPROFILE%\.codex\config.toml — và thêm:

model_provider = "rocketkey"

[model_providers.rocketkey]
name = "RocketKey"
base_url = "https://rocketkeyapi.indexes.social/v1"
env_key = "ROCKETKEY_API_KEY"
wire_api = "responses"

• Thứ tự trong file quan trọng: model_provider (và model nếu có) là khoá cấp cao nhất, phải nằm trước dòng [bảng] đầu tiên của file, tức là ở đầu file. Đặt chúng sau một dòng như [profiles.x] thì TOML coi chúng thuộc bảng đó và Codex không dùng RocketKey. Khối [model_providers.rocketkey] thì đặt ở đâu sau đó cũng được.
• wire_api = "responses": Codex gọi API Responses, RocketKey hỗ trợ đầy đủ.
• env_key: tên biến môi trường chứa key, Codex không đọc key trực tiếp từ file.
• Muốn chọn model mặc định, thêm dòng model = "<model id>" ngay dưới model_provider (cũng trước dòng [bảng] đầu tiên), lấy model ID từ trang Model.

2. Đặt biến môi trường chứa key

export ROCKETKEY_API_KEY='sk-rk-YOUR_KEY_HERE'

$env:ROCKETKEY_API_KEY = 'sk-rk-YOUR_KEY_HERE'

set ROCKETKEY_API_KEY=sk-rk-YOUR_KEY_HERE

Thêm dòng đặt biến vào shell profile (~/.bashrc, ~/.zshrc, hoặc biến môi trường của Windows) để không phải đặt lại mỗi lần mở terminal.

3. Kiểm tra

Chạy codex trong thư mục dự án và gửi một yêu cầu ngắn. Nếu gặp lỗi:

• 401: biến ROCKETKEY_API_KEY chưa được đặt trong cửa sổ đang chạy Codex, hoặc key sai. Xem lỗi 401.
• 404 model not found: model ID trong config.toml không có trong danh sách. Xem lỗi 404.
• 402: hết hạn mức ngày. Xem lỗi 402.