Chuyển đến nội dung chính

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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 phải được cấu hình với cả hai tệp: ~/.codex/config.toml và ~/.codex/auth.json. Không sử dụng thiết lập chỉ có base URL cho tích hợp này.

​
Đ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 một key từ 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

Tạo hoặc chỉnh sửa ~/.codex/config.toml với cấu hình provider này: 
model_provider = "cometapi"
model = "gpt-5.5"

[model_providers.cometapi]
name = "CometAPI"
base_url = "https://api.cometapi.com/v1"
requires_openai_auth = true
Các khóa model_provider và model phải được giữ ở cấp cao nhất của tệp. Phần [model_providers.cometapi] xác định endpoint CometAPI.
Nếu bạn quản lý cài đặt Codex thông qua một kho lưu trữ dotfiles, hãy giữ bản sao trong dotfiles được đồng bộ với ~/.codex/config.toml. Codex đọc tệp từ ~/.codex/config.toml.

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

Tạo ~/.codex/auth.json: 
{
  "auth_mode": "apikey",
  "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. auth_mode phải là apikey, và OPENAI_API_KEY phải chứa CometAPI key của bạn.

​
Khởi động Codex

cd your-project
codex
Ở lần khởi chạy đầ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.

​
Khắc phục sự cố

Triệu chứngCách khắc phục
API key auth is missing a keySửa ~/.codex/auth.json. Tệp này phải chứa "auth_mode": "apikey" và "OPENAI_API_KEY": "sk-..."
Lời nhắc đăng nhập xuất hiện ngoài mong đợiTạo lại ~/.codex/auth.json với auth_mode được đặt là apikey, sau đó khởi động lại Codex
Codex vẫn sử dụng provider OpenAI mặc địnhSửa ~/.codex/config.toml. model_provider phải là cometapi
Yêu cầu không đến được CometAPISửa ~/.codex/config.toml. [model_providers.cometapi] phải bao gồm requires_openai_auth = true
Hết thời gian kết nối hoặc sai endpointSửa ~/.codex/config.toml. base_url phải là https://api.cometapi.com/v1
Không tìm thấy modelKiểm tra trang Models để xem các model khả dụng
Sự cố trên WindowsCodex yêu cầu WSL2 trên Windows — CMD/PowerShell gốc không được hỗ trợ