跳转到主要内容
使用本指南通过 CometAPI 作为模型 provider 运行 Codex CLI。 官方参考：
模型可用性变化频繁。下面的示例使用 your-model-id —— 请将其替换为来自 CometAPI Models page 的当前适合编码的模型 ID。

​
前置要求

RequirementDetails
操作系统macOS 12+、Linux（Ubuntu 20.04+ / Debian 10+），或通过 WSL2 运行的 Windows 11
Node.js22+（推荐 LTS）
Git推荐 2.23+
CometAPI key从 CometAPI Dashboard 获取一个（以 sk- 开头）

​
安装 Codex CLI

npm i -g @openai/codex
或者通过 Homebrew： 
brew install --cask codex
验证安装： 
codex --version

​
配置 CometAPI

有两种方式让 Codex 指向 CometAPI。选择最适合你工作流的方式即可。
最简单的方式——只需一行即可将内置的 OpenAI provider 重定向到 CometAPI。 无需定义自定义 provider。创建 ~/.codex/config.toml：
model = "your-model-id"
openai_base_url = "https://api.cometapi.com/v1"

​
存储你的 API key

创建 ~/.codex/auth.json： 
{
  "OPENAI_API_KEY": "sk-your-cometapi-key"
}
将 sk-your-cometapi-key 替换为你实际的 CometAPI key。
此文件是必需的。 如果 auth.json 中没有有效的 OPENAI_API_KEY 条目， Codex 将退出并提示 API key auth is missing a key。

​
启动 Codex

cd your-project
codex
首次启动时，Codex 会提示你选择主题并确认安全设置。

​
按会话覆盖模型

无需编辑 config.toml，即可在单次运行中切换到其他模型： 
codex --model your-model-id

​
另一种方式：环境变量

除了使用 auth.json，你也可以直接导出 key： 
export OPENAI_API_KEY="sk-your-cometapi-key"
codex
这只会为当前终端会话设置该 key。若要持久生效，请将 export 这一行添加到 ~/.zshrc 或 ~/.bashrc。

​
故障排查

SymptomFix
API key auth is missing a key确保 ~/.codex/auth.json 包含 "OPENAI_API_KEY": "sk-..."
意外出现登录提示删除旧的 ~/.codex/auth.json 并使用你的 CometAPI key 重新创建
找不到模型查看 Models page 获取当前可用模型
连接超时确认 config.toml 中的 openai_base_url 或 base_url 为 https://api.cometapi.com/v1
Windows 问题Codex 在 Windows 上需要 WSL2——不支持原生 CMD/PowerShell