OpenAI Codex 部署与配置指南：CLI、VS Code 和自定义 API

1. 安装 Codex CLI#

在 PowerShell 中执行：

npm install -g @openai/codex --registry=https://registry.npmmirror.com

验证安装：

codex --version

2. 创建配置目录#

Codex 的用户配置通常位于：

C:\Users\你的用户名\.codex

需要用到两个主要文件：

3. 配置自定义模型服务#

创建 .codex/config.toml：

model_provider = "apipaths"
model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true

[model_providers.apipaths]
name = "apipaths"
wire_api = "responses"
requires_openai_auth = true
base_url = "http://apipaths.com/v1"

这里有两个容易忽略的细节：

1. model_provider 的值需要与 [model_providers.apipaths] 的名称一致
2. base_url 是否包含 /v1，取决于服务商的接口说明

创建 .codex/auth.json：

{
  "OPENAI_API_KEY": "你的API密钥"
}

4. 启动 Codex#

进入项目目录：

cd D:\Projects\my-project
codex

建议第一次先执行只读任务：

请分析当前项目的目录结构、依赖、启动命令和测试方式，暂时不要修改文件。

1. 安装 CLI#

npm install -g @openai/codex

2. 使用环境变量#

使用 Bash 时：

echo 'export OPENAI_BASE_URL="http://apipaths.com/v1"' >> ~/.bashrc
echo 'export OPENAI_API_KEY="你的API密钥"' >> ~/.bashrc
source ~/.bashrc

启动：

codex

建议

对于需要固定模型、推理强度和服务商参数的场景，更推荐使用 ~/.codex/config.toml，环境变量适合快速测试或临时切换。

1. 准备 Node.js#

brew install node

2. 安装 Codex#

npm install -g @openai/codex

3. 配置环境变量#

macOS 默认使用 Zsh：

echo 'export OPENAI_BASE_URL="http://apipaths.com/v1"' >> ~/.zshrc
echo 'export OPENAI_API_KEY="你的API密钥"' >> ~/.zshrc
source ~/.zshrc

启动：

codex

1. 安装扩展#

在 VS Code 扩展市场中搜索：

Codex - OpenAI's coding agent

安装后，扩展会读取用户目录下的 Codex 配置。

2. 配置认证#

在 ~/.codex/auth.json 中写入：

{
  "OPENAI_API_KEY": "你的API密钥"
}

Windows 中的 ~ 对应：

C:\Users\你的用户名

3. 配置模型#

在 ~/.codex/config.toml 中配置：

model_provider = "apipaths"
model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true

[model_providers.apipaths]
name = "apipaths"
wire_api = "responses"
requires_openai_auth = true
base_url = "http://apipaths.com/v1"

修改配置后，建议重新加载 VS Code 窗口。

第一步：只读分析#

分析项目结构和问题原因，不要修改文件。

第二步：确认方案#

给出修改方案、涉及文件、风险和测试计划。

第三步：执行修改#

按照方案完成修改，保留现有代码风格，并运行相关测试。

第四步：检查结果#

总结修改内容、测试结果和仍然存在的风险。

这种方式可以减少误操作，也方便在大型项目中控制修改范围。

找不到 codex 命令#

npm config get prefix

确认 npm 全局可执行目录已经加入 PATH，然后重新打开终端。

认证失败#

检查以下项目：

• auth.json 是否为有效 JSON
• OPENAI_API_KEY 是否填写完整
• API 密钥是否仍然有效
• 自定义服务是否要求其他认证头

模型服务不可用#

重点检查：

• model_provider 与配置节名称是否一致
• base_url 是否需要 /v1
• wire_api 是否与服务商兼容
• 模型名称是否真实可用
• 是否被代理、防火墙或 DNS 阻断

配置修改没有生效#

关闭并重新打开终端；VS Code 中可以执行“重新加载窗口”。同时确认修改的是当前用户目录下的 .codex，而不是其他项目中的同名目录。