跳到主要内容
快速上手API 参考接入与支持
工具接入

Codex CLI 接入指南

按主站快速开始完整整理，并按 OpenAI 官方配置规则纠正 Codex CLI 的 provider 写法，覆盖 Windows、macOS、Linux 下的安装、配置、启动和排障。

Codex CLI 接入指南

这页保留主站快速开始里的完整 Codex 教程，主站原页不会删除。
另外补一条重要纠偏：OpenAI 官方文档明确说明，requires_openai_auth = true 时会忽略 env_key。所以文档站这里不再把两者同时写进同一份 provider 配置。

先记住这 2 个配置点​

  • 配置文件：~/.codex/config.toml
  • 令牌变量：ANIDEAAI_OAI_KEY

如果你之前已经用 codex login 登录过 OpenAI，旧凭据通常会缓存在 ~/.codex/auth.json 或系统凭据存储里。这不是主配置文件，但排障时要记得检查。

标准 provider 配置​

把下面内容写进 ~/.codex/config.toml：

model_provider = "anideaai"
model = "gpt-5.3-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"
network_access = "enabled"
model_verbosity = "high"

[model_providers.anideaai]
name = "anideaai"
base_url = "https://anideaai.com/v1"
wire_api = "responses"
env_key = "ANIDEAAI_OAI_KEY"

不要再额外加 requires_openai_auth = true，否则 ANIDEAAI_OAI_KEY 会被忽略。

1. 安装 Codex​

Windows 直接运行仍偏实验性，更推荐用 WSL。

直接安装：

npm install -g @openai/codex
codex --version

推荐方式，先装 WSL 再在 WSL 里安装：

# 以管理员身份打开 PowerShell
wsl --install

进入 WSL 后执行：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
source ~/.bashrc
nvm install 22
npm install -g @openai/codex
codex --version

2. 写入配置文件​

如果你按推荐走 WSL，把文件写进 WSL 的 ~/.codex/config.toml。
如果你坚持直接在 PowerShell 里运行，则放到 $HOME\\.codex\\config.toml。

3. 设置 API Key​

当前会话临时生效：

$env:ANIDEAAI_OAI_KEY = "sk-xxxxx"

如果你用 CMD：

set ANIDEAAI_OAI_KEY=sk-xxxxx

用户级永久生效：

[System.Environment]::SetEnvironmentVariable("ANIDEAAI_OAI_KEY", "sk-xxxxx", [System.EnvironmentVariableTarget]::User)

检查变量：

echo $env:ANIDEAAI_OAI_KEY
[System.Environment]::GetEnvironmentVariable("ANIDEAAI_OAI_KEY", [System.EnvironmentVariableTarget]::User)

清除变量：

Remove-Item Env:ANIDEAAI_OAI_KEY -ErrorAction Ignore
[System.Environment]::SetEnvironmentVariable("ANIDEAAI_OAI_KEY", $null, [System.EnvironmentVariableTarget]::User)
set ANIDEAAI_OAI_KEY=

4. 启动 Codex​

cd C:\path\to\your\project
codex

5. Claude Code 一键代配 Codex​

如果你已经在用 Claude Code，可以把下面这段提示词贴进去，让它帮你自动完成配置：

请帮我配置 Codex CLI，按以下步骤操作：

1. 检测当前操作系统和 shell 类型
2. 检查是否已安装 codex，如未安装则用 npm install -g @openai/codex 安装
3. 创建 ~/.codex/ 目录（如不存在）
4. 智能合并 ~/.codex/config.toml：
   - 如果文件已存在，保留用户的 [projects]、[mcp_servers] 等自定义配置段
   - 仅更新/添加顶层字段和 [model_providers.anideaai] 段
   - 需要写入的配置：
     model_provider = "anideaai"
     model = "gpt-5.3-codex"
     model_reasoning_effort = "high"
     disable_response_storage = true
     preferred_auth_method = "apikey"
     network_access = "enabled"
     model_verbosity = "high"

     [model_providers.anideaai]
     name = "anideaai"
     base_url = "https://anideaai.com/v1"
     wire_api = "responses"
     env_key = "ANIDEAAI_OAI_KEY"
5. 设置环境变量 ANIDEAAI_OAI_KEY=sk-xxxxx
6. 运行 codex 验证配置
7. 如果任何步骤失败，输出错误信息并提供回退方案

6. 常见问题​

Codex 仍走默认 provider：

先检查 model_provider = "anideaai" 是否真的写进了配置文件。
再检查是不是还留着 requires_openai_auth = true。

旧登录缓存抢占：

先运行 codex logout。
如果你用的是文件缓存，再检查 ~/.codex/auth.json。

快速排错顺序​

  1. 先检查 config.toml 是否真的切到了 model_provider = "anideaai"
  2. 再检查 ANIDEAAI_OAI_KEY 是否生效
  3. 如果还不对，再排查旧的 codex login 缓存
这页有帮助吗？
本页目录