Codex

1. 准备 Codex-Pro Key#

在令牌页面创建 Codex-Pro Key。本文使用 gpt-5.5，也可选择目录中其他明确支持 Responses、且在 Key 权限范围内的模型。

2. 安装 Codex CLI#

如果已有 Codex，先运行 codex --version 确认命令可用。通过 npm 安装需要先具备 Node.js 与 npm：

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

安装结束后提示找不到命令时，重新打开终端再试。Windows 若因 PowerShell 脚本执行策略无法启动，可使用 codex.cmd 执行同一命令。

3. 设置 API Key#

在准备启动 Codex 的终端运行：

$lensSecret = Read-Host 'LensAPI API Key' -AsSecureString
$env:LENSAPI_API_KEY = [System.Net.NetworkCredential]::new('', $lensSecret).Password
Remove-Variable lensSecret

printf 'LensAPI API Key: '
read -r -s LENSAPI_API_KEY
printf '\n'
export LENSAPI_API_KEY

4. 添加用户级配置#

配置文件位于 ~/.codex/config.toml。Windows 通常是 %USERPROFILE%\.codex\config.toml。下面命令会创建目录并打开配置文件：

New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex" | Out-Null
notepad "$env:USERPROFILE\.codex\config.toml"

mkdir -p ~/.codex
nano ~/.codex/config.toml

保留原有配置，在末尾添加下面的表。已存在同名 [model_providers.lensapi] 时直接修改原表，不要重复定义。

[model_providers.lensapi]
name = "LensAPI"
base_url = "https://lensapi.top/v1"
env_key = "LENSAPI_API_KEY"
wire_api = "responses"

env_key 指向上一步的环境变量，不需要把真实 Key 写进 TOML。请使用用户级配置文件；项目目录的配置不用于 provider 与认证重定向。

5. 启动与验证#

保存文件后，在同一终端进入你的项目目录，执行：

codex --model gpt-5.5 --config 'model_provider="lensapi"'

先发送一条简单请求：

请只回复“连接成功”，不要修改项目文件。

收到回复后，在使用日志确认请求时间、模型与费用，再测试实际代码阅读、修改和工具流程。

设为默认 provider#

确认可用后，如希望直接运行 codex 使用 LensAPI，可在 config.toml 的文件顶部、所有表头之前添加或修改：

model_provider = "lensapi"
model = "gpt-5.5"

不要重复定义同名顶层键。每次启动仍须让程序读取到密钥环境变量，也可由你信任的密钥管理工具注入。

常见问题#

字段与配置位置依据 Codex 配置参考和高级配置。