Codex 安装与配置指南
OpenAI Codex 完整使用说明书
概述
本指南将引导您完成 Codex 的注册、安装与配置全流程，分为以下三个主要步骤：
- 注册账号并获取 API 密钥
- 安装 Codex 命令行工具
- 配置 Codex 连接自定义服务
⚠️ 提示：如果您已安装 Codex，可跳过第二步，直接阅读第三步「配置 Codex」。
第一步：注册账号并获取密钥
在开始安装前，您需要先在TokenRouter完成注册并获取 API 密钥。
操作步骤
• 访问TokenRouter网站，按照页面提示完成账号注册。
• 注册完成后，网页左侧选择进入「令牌管理」页面。
• 创建一个新的令牌，令牌分组选择default。
• 复制令牌的密钥，并妥善保存——后续配置步骤中将会用到。
📌 重要：密钥保存到安全的地方（例如备忘录或密码管理器）。
第二步：安装 Codex
Codex 通过 npm（Node.js 包管理器）进行安装，请按以下步骤操作。
2.1 安装 Node.js
Codex 依赖 Node.js 运行环境，请先确认已安装。若尚未安装，请访问以下地址下载：
https://nodejs.org/zh-cn/download
下载完成后按照安装向导完成安装即可。
2.2 通过 npm 安装 Codex
Node.js 安装完成后，打开命令行窗口：
• Windows：按 Win + R，输入 cmd，回车打开命令提示符
• macOS / Linux：打开「终端」应用
在命令行中输入以下命令并回车：
npm i -g @openai/codex
等待安装完成后，输入以下命令验证安装是否成功：
codex
💡 首次启动时会弹出登录提示，此时直接关闭窗口即可——登录将在配置步骤完成后生效。
第三步：配置 Codex
配置文件用于指定 Codex 使用的模型和 API 服务地址。请根据您的操作系统找到对应的配置目录。
3.1 找到配置目录
| 操作系统 | 配置目录路径 |
|---|---|
| Windows | C:\Users\你的用户名.codex |
| Linux / WSL / macOS | ~/.codex |
3.2 编辑 config.toml
进入配置目录，找到 config.toml 文件。
情况一：文件不存在
新建一个名为 config.toml 的文件，将以下全部内容复制粘贴进去：
approval_policy = "never" model = "gpt-5.4" model_reasoning_effort = "xhigh" approvals_reviewer = "user" model_provider = "cliproxyapi" [model_providers.cliproxyapi] name = "cliproxyapi" base_url = "https://www.tokenrouter.tech/v1" wire_api = "responses"
情况二：文件已存在
在文件的最顶部（第一行），添加以下内容：
model_provider = "cliproxyapi" [model_providers.cliproxyapi] name = "cliproxyapi" base_url = "https://www.tokenrouter.tech/v1" wire_api = "responses"
⚠️ 注意：以上内容必须添加到文件最顶部，而非末尾，否则配置不生效。
3.3 创建或更新 auth.json
在同一配置目录下，找到或新建 auth.json 文件（若文件已存在，请先清空其内容），将以下内容填入：
{ "OPENAI_API_KEY": "sk-dummy"
}
🔑 请将 sk-dummy 替换为您在第一步中获取并保存的真实 API 密钥。sk-dummy 只是占位符，填入真实密钥后才能正常连接服务。
第四步：验证安装
完成以上全部配置后，打开命令行，输入以下命令启动 Codex：
codex
启动后会出现初始化设置界面，所有选项一路按回车使用默认值，直到可以开始输入聊天内容。
如果你已经安装过桌面版，请你注意，所有的配置必须重新启动软件才会重新读取，所以如果出现401 invalid token之类的错误，桌面版请右下角exit退出后台运行的Codex，再重新打开。
测试连接
在对话框中输入以下内容测试是否配置成功：
你好
若收到正常回复，则说明配置成功。如果没有回复，可以输入以下命令查看状态：
/status
✅ 如果 /status 命令输出的配置信息与您填写的内容一致，则代表配置完全正确。
附录：Codex GUI 图形界面版本
Codex 除命令行版本外，还提供了图形界面（GUI）版本，操作更加直观。完成上述所有配置后，即可直接下载使用。
下载地址：
https://openai.com/zh-Hans-CN/codex/
GUI 版本无需额外配置，安装后会自动读取已有的 config.toml 和 auth.json 配置文件。