本教程介绍 Codex CLI 的通用安装方式，以及如何将模型请求发送到算无忧统一接口。模型名称和令牌分组请以控制台当前展示为准。
第三方网关并不代表 OpenAI 官方服务。请先确认使用场景、数据处理方式和账号权限符合你的安全要求。

​
环境准备

建议使用当前 Node.js LTS 版本。先在终端检查： 
node --version
npm --version
Windows 用户还建议安装 Git for Windows，便于使用 Git Bash 和项目命令。

​
安装 Codex CLI

npm install -g @openai/codex
codex --version
如果安装后提示找不到 codex，请关闭终端并重新打开，再检查 npm 全局命令目录是否已经加入系统 PATH。

​
创建算无忧令牌

  1. 登录算无忧控制台。
  2. 进入“令牌管理”，创建一个用于 Codex 的令牌。
  3. 选择控制台当前提供的 Codex 兼容分组。
  4. 调用 GET /v1/models，确认令牌可以看到准备使用的 Codex 模型。

​
配置文件位置

系统配置目录
WindowsC:\Users\你的用户名\.codex
macOS / Linux~/.codex
目录中需要两个文件：auth.json 保存 API 令牌，config.toml 保存模型和服务地址。

​
auth.json

{
  "OPENAI_API_KEY": "sk-你的算无忧令牌"
}

​
config.toml

model_provider = "suanwuyou"
model = "控制台中的 Codex 模型名称"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.suanwuyou]
name = "算无忧"
base_url = "https://suanwuyou.com.cn/v1"
wire_api = "responses"
model 必须替换为当前令牌实际可用的模型 ID。model_reasoning_effort 是否支持以及可选范围取决于模型和当前 Codex 版本。

​
启动和验证

保存配置后关闭并重新打开终端，进入代码项目： 
cd 你的项目目录
codex
如果出现 401，先检查 auth.json；如果提示模型不存在，重新检查令牌分组和模型 ID；如果出现 404，检查 base_url 是否重复包含 /v1。

​
更简单的配置方式

不希望手动编辑 JSON 和 TOML 时，可以使用CCSwitch 配置 Codex，通过图形界面管理供应商和 API 令牌。

Codex 官方开发者文档

查看 Codex 当前版本的官方安装、功能和安全说明。