Codex API安装与配置指南

Codex 安装与配置指南

OpenAI Codex 完整使用说明书

概述

本指南将引导您完成 Codex 的注册、安装与配置全流程，分为以下三个主要步骤：

1. 注册账号并获取 API 密钥
2. 安装 Codex 命令行工具
3. 配置 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 配置文件。