Codex CLI

Thiết lập OpenAI Codex CLI với CometAPI: cấu hình openai_base_url hoặc một provider tùy chỉnh trong config.toml, lưu API key của bạn trong auth.json và bắt đầu lập trình với một model hiện có.

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:

• Codex CLI README
• Codex Authentication
• Codex Advanced Configuration

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ầu	Chi tiết
OS	macOS 12+, Linux (Ubuntu 20.04+ / Debian 10+), hoặc Windows 11 qua WSL2
Node.js	22+ (khuyến nghị LTS)
Git	khuyến nghị 2.23+
CometAPI key	Lấ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.

Đơn giản: openai_base_url

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"

Provider có tên

Định nghĩa một provider có tên là cometapi. Hữu ích khi bạn muốn chuyển đổi giữa nhiều provider bằng --profile hoặc model_provider.

Tạo ~/.codex/config.toml:

model = "your-model-id"
model_provider = "cometapi"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
env_key = "OPENAI_API_KEY"

env_key cho Codex biết biến môi trường nào chứa API key của bạn. Codex đọc giá trị của OPENAI_API_KEY khi chạy — đây không phải là key thực tế của bạn.

​

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ứng	Cá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ến	Xóa ~/.codex/auth.json cũ và tạo lại bằng CometAPI key của bạn
Không tìm thấy model	Kiểm tra trang Models để xem các model hiện khả dụng
Hết thời gian chờ kết nối	Xác nhận openai_base_url hoặc base_url trong config.toml là https://api.cometapi.com/v1
Sự cố trên Windows	Codex yêu cầu WSL2 trên Windows — CMD/PowerShell gốc không được hỗ trợ