Chuyển đến nội dung chính
Sử dụng hướng dẫn này để chạy Codex CLI với CometAPI làm model provider. Tài liệu tham khảo chính thức:
Khả năng khả dụng của model thay đổi thường xuyên. Các ví dụ bên dưới dùng your-model-id — hãy thay thế bằng một model ID hiện đang phù hợp cho lập trình từ trang Models của CometAPI.

​
Điều kiện tiên quyết

Yêu cầuChi tiết
OSmacOS 12+, Linux (Ubuntu 20.04+ / Debian 10+), hoặc Windows 11 qua WSL2
Node.js22+ (khuyến nghị LTS)
Gitkhuyến nghị 2.23+
CometAPI keyLấy tại CometAPI Dashboard (bắt đầu bằng sk-)

​
Cài đặt Codex CLI

npm i -g @openai/codex
Hoặc qua Homebrew: 
brew install --cask codex
Xác minh cài đặt: 
codex --version

​
Cấu hình CometAPI

Có hai cách để trỏ Codex tới CometAPI. Hãy chọn cách phù hợp nhất với quy trình làm việc của bạn.
Tùy chọn dễ nhất — chuyển hướng provider OpenAI tích hợp sẵn tới CometAPI chỉ với một dòng. Không cần định nghĩa provider tùy chỉnh.Tạo ~/.codex/config.toml:
model = "your-model-id"
openai_base_url = "https://api.cometapi.com/v1"

​
Lưu API key của bạn

Tạo ~/.codex/auth.json: 
{
  "OPENAI_API_KEY": "sk-your-cometapi-key"
}
Thay sk-your-cometapi-key bằng CometAPI key thực tế của bạn.
Tệp này là bắt buộc. Nếu không có mục OPENAI_API_KEY hợp lệ trong auth.json, Codex sẽ thoát với lỗi API key auth is missing a key.

​
Khởi động Codex

cd your-project
codex
Ở lần khởi động đầu tiên, Codex sẽ nhắc bạn chọn một theme và xác nhận các thiết lập an toàn.

​
Ghi đè model theo từng phiên

Chuyển sang model khác cho một lần chạy duy nhất mà không cần chỉnh sửa config.toml: 
codex --model your-model-id

​
Cách khác: biến môi trường

Thay vì dùng auth.json, hãy export key trực tiếp: 
export OPENAI_API_KEY="sk-your-cometapi-key"
codex
Cách này chỉ thiết lập key cho phiên terminal hiện tại. Để lưu lâu dài, thêm dòng export vào ~/.zshrc hoặc ~/.bashrc.

​
Khắc phục sự cố

Triệu chứngCách khắc phục
API key auth is missing a keyĐảm bảo ~/.codex/auth.json chứa "OPENAI_API_KEY": "sk-..."
Xuất hiện lời nhắc đăng nhập ngoài dự kiếnXóa ~/.codex/auth.json cũ và tạo lại bằng CometAPI key của bạn
Không tìm thấy modelKiểm tra trang Models để xem các model hiện khả dụng
Hết thời gian chờ kết nốiXác nhận openai_base_url hoặc base_url trong config.toml là https://api.cometapi.com/v1
Sự cố trên WindowsCodex yêu cầu WSL2 trên Windows — CMD/PowerShell gốc không được hỗ trợ