在 Codex CLI 中使用 TOKENOPEN API

通过 OpenAI Codex CLI 配合 TOKENOPEN API，让 Codex 调用平台模型能力

Codex CLI 是 OpenAI 官方推出的开源命令行编程 Agent，支持在终端中直接读写代码、执行命令，完成复杂的编程任务。通过将 API 端点替换为 TOKENOPEN，即可无缝使用平台上的各类模型。

第一步：安装 Codex CLI

前置要求：Node.js 22+

# 添加 NodeSource 源
sudo curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -

# 安装 Node.js
sudo apt-get install -y nodejs

验证 Node.js 安装：

node --version
npm --version

安装 Codex CLI：

npm install -g @openai/codex

安装完成后验证：

codex --version

方式一：Homebrew（推荐）

brew install --cask codex

方式二：npm

npm install -g @openai/codex

安装完成后验证：

codex --version

在 PowerShell 中运行：

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

或者通过 npm 安装：

npm install -g @openai/codex

安装完成后验证：

codex --version

Codex CLI 支持 macOS、Linux 及 Windows（原生或 WSL2），安装前请确认已安装 Node.js 22+。

第二步：配置 TOKENOPEN API

Codex CLI 通过配置文件 ~/.codex/config.toml 来管理 API 连接。

获取 API Key

配置 TOKENOPEN API

创建配置目录并编辑 ~/.codex/config.toml：

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

添加以下内容：

model_provider = "proxy"
model = "gpt-4o"
disable_response_storage = true

[model_providers.proxy]
name = "proxy"
base_url = "https://www.tokenopen.ai/v1"
wire_api = "responses"
requires_openai_auth = false
env_key = "OPENAI_API_KEY"

按 Esc，输入 :wq! 保存退出。

配置环境变量，将 API Key 写入当前会话：

export OPENAI_API_KEY="替换为你的 API Key"

如需永久生效，写入 ~/.bashrc（bash）或 ~/.profile：

echo 'export OPENAI_API_KEY="替换为你的 API Key"' >> ~/.bashrc
source ~/.bashrc

创建配置目录并编辑 ~/.codex/config.toml：

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

添加以下内容：

model_provider = "proxy"
model = "gpt-4o"
disable_response_storage = true

[model_providers.proxy]
name = "proxy"
base_url = "https://www.tokenopen.ai/v1"
wire_api = "responses"
requires_openai_auth = false
env_key = "OPENAI_API_KEY"

按 Esc，输入 :wq! 保存退出。也可以用 TextEdit 打开编辑：

open -e ~/.codex/config.toml

配置环境变量，将 API Key 写入当前会话：

export OPENAI_API_KEY="替换为你的 API Key"

如需永久生效，写入 ~/.zshrc（macOS 默认 Shell）：

echo 'export OPENAI_API_KEY="替换为你的 API Key"' >> ~/.zshrc
source ~/.zshrc

在 PowerShell 中运行以下命令，自动创建配置文件：

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

@'
model_provider = "proxy"
model = "gpt-4o"
disable_response_storage = true

[model_providers.proxy]
name = "proxy"
base_url = "https://www.tokenopen.ai/v1"
wire_api = "responses"
requires_openai_auth = false
env_key = "OPENAI_API_KEY"
'@ | Set-Content -Path "$env:USERPROFILE\.codex\config.toml" -Encoding UTF8

配置环境变量，将 API Key 写入当前会话：

$env:OPENAI_API_KEY = "替换为你的 API Key"

如需永久生效（写入用户环境变量）：

[System.Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "替换为你的 API Key", "User")

也可以用记事本手动编辑配置文件：

notepad "$env:USERPROFILE\.codex\config.toml"

第三步：使用 Codex CLI

配置完成后，在项目目录中运行以下命令启动 Codex：

codex

启动 Codex CLI

首次启动设置

首次运行时，Codex 会询问是否信任当前目录：

首次启动

选项 1：允许 Codex 在当前目录执行
选项 2：退出

切换模型

进入交互界面后，输入 /model 切换模型：

切换模型

系统会提示选择推理强度（Reasoning Level）：

选择推理强度

TOKENOPEN 支持的 GPT 主流模型（部分示例）：

模型标识	说明
`gpt-5.5`	GPT-5.5，最新旗舰模型
`gpt-5.4`	GPT-5.4，均衡性能与成本
`gpt-5.4-mini`	GPT-5.4 Mini，低延迟轻量模型
`gpt-5.4-nano`	GPT-5.4 Nano，超低成本极速模型

完整模型列表及价格请查看模型广场页面。

开始对话

模型设置完成后，即可在提示框中输入任务描述，按 Enter 发送：

开始使用

常用命令

命令	说明
`/model`	切换模型和推理强度
`/init`	创建 AGENTS.md 配置文件
`/status`	查看当前会话配置和 Token 用量
`/approvals`	设置哪些操作无需审批
`/review`	审查并查找代码变更中的问题

非交互模式

如需快速执行任务而不进入交互模式，可使用以下方式：

# 执行单次任务
codex exec "为当前目录的 README.md 生成中文版本"

# 以非交互模式运行
codex -p "用 Python 写一个冒泡排序算法"

Codex CLI 支持读取、修改本地文件，并可执行终端命令，可用于代码审查、重构、生成测试用例等场景。建议在 Git 仓库中使用，以便追踪 Codex 的变更。