跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.crazyrouter.com/llms.txt

Use this file to discover all available pages before exploring further.

Codex CLI 是 OpenAI 的终端编码代理工具，适合在本地仓库中做代码修改、审查、批量重构和命令协作。对接 Crazyrouter 时，推荐使用当前官方支持的 config.toml 自定义 provider 方式，而不是旧版配置思路。

​
概览

通过 ~/.codex/config.toml 配置自定义 provider，Codex CLI 可以把请求发到 Crazyrouter：
  • 推荐协议：OpenAI-compatible API
  • 走的接口类型：Responses API
  • Base URL：https://crazyrouter.com/v1
  • 认证变量：OPENAI_API_KEY
  • 推荐默认模型：gpt-5.4
如果你之前只用过 ChatGPT 登录方式，接 Crazyrouter 时请切换到 API Key + 自定义 provider 配置。这样模型、日志、额度和计费都更可控。

查看 Codex 一键配置仓库

如果你想直接使用脚本写入环境变量和 Codex 配置，可以查看 crazyrouter-codex-cli 仓库。

​
适合谁用

  • 想把 Crazyrouter 接到终端代理式编码工作流的人
  • 想在本地仓库里做批量修改、代码审查和自动执行的人
  • 想把 Codex、Cursor、Claude Code 的流量拆分计费的人
  • 想优先使用当前已验证过的最新 OpenAI 模型做终端代理编码的人

​
使用协议

推荐协议：OpenAI-compatible API Codex CLI 当前推荐通过自定义 model_provider 使用 OpenAI 兼容 provider，并指定：
  • base_url = "https://crazyrouter.com/v1"
  • wire_api = "responses"
Crazyrouter 支持 /v1/responses，因此 Codex CLI 这条接法可以直接走 Responses API。但当前这条路径按 GPT 模型理解即可，Claude 不支持 POST /v1/responses。

​
系统要求与前置条件

项目说明
Crazyrouter 账号先在 crazyrouter.com 注册
Crazyrouter token建议为 Codex 单独创建一个 sk-... token
Git建议 git 2.23+
Node.js建议 Node.js 20+
Codex CLI建议当前稳定版
可用模型至少放行一个适合编码的模型，如 gpt-5.4
建议初始白名单：
  • gpt-5.4

​
按操作系统的完整安装路径

​
Windows 推荐路径

Codex 在 Windows 上最简单的路径是：Git + Node.js + npm 全局安装 Codex + PowerShell 配置环境变量。 推荐顺序：
  1. 安装 Git
  2. 安装 Node.js LTS
  3. 用 npm 安装 Codex CLI
  4. 用 PowerShell 写入 OPENAI_API_KEY
  5. 用 PowerShell 写入 $HOME/.codex/config.toml
推荐验证命令： 
git --version
node -v
npm -v
codex --version
where.exe git
where.exe node
where.exe codex
如果 codex --version 找不到命令，先关闭并重新打开 PowerShell，再试一次。

​
macOS 推荐路径

macOS 上最顺手的路径通常是：Homebrew + Git + Node.js + brew 或 npm 安装 Codex CLI + ~/.zshrc 持久化环境变量。 推荐顺序：
  1. 安装 Xcode Command Line Tools
  2. 安装 Homebrew（如果你还没有）
  3. 安装 Git、Node.js
  4. 安装 Codex CLI
  5. 写入 ~/.zshrc
  6. 写入 ~/.codex/config.toml
推荐验证命令： 
git --version
node -v
npm -v
codex --version
which git
which node
which codex

​
Codex CLI 安装备选路径

除了包管理器，Codex 官方仓库也提供 GitHub Releases 二进制包。对大多数用户来说，仍然优先推荐：
  • Windows：npm install -g @openai/codex
  • macOS：brew install --cask codex 或 npm install -g @openai/codex
如果你想用脚本自动写入 Crazyrouter 相关配置，可以查看 crazyrouter-codex-cli。该仓库提供 Windows、macOS 和 Linux 的一键配置脚本；本文档仍保留完整手动配置步骤，便于你审查每一项配置。

​
从零开始完整安装

1

第 1 步：安装 Git

如果你还没有 Git，先装 Git，并补齐全局身份配置。
winget install --id Git.Git -e --source winget
git --version
建议顺手执行：
git config --global user.name "Your Name"
git config --global user.email "you@example.com"
git config --global init.defaultBranch main
2

第 2 步：安装 Node.js 20+

Codex CLI 是 Node.js 工具。先确认 Node 和 npm 已就绪。
winget install OpenJS.NodeJS.LTS
node -v
npm -v
如果你的发行版默认安装版本太旧，请升级到更高版本后再继续。
3

第 3 步：安装 Codex CLI

推荐直接使用 npm 全局安装：
npm install -g @openai/codex
codex --version
where.exe codex
4

第 4 步：在 Crazyrouter 创建 Codex 专用 token

在 Crazyrouter 后台创建一个名为 codex 的 token，第一次只建议放行：
  • gpt-5.4
这样首次排障更简单，也更容易控费。
5

第 5 步：先设置临时环境变量

Codex 通过 provider 配置读取 OPENAI_API_KEY。先在当前终端设置：
export OPENAI_API_KEY=sk-xxx
echo $OPENAI_API_KEY
6

第 6 步：把 API Key 写入持久环境变量

日常使用建议写入 shell 配置文件或系统用户环境变量。
echo 'export OPENAI_API_KEY=sk-xxx' >> ~/.bashrc
source ~/.bashrc
7

第 7 步：写入 Codex 配置文件 ~/.codex/config.toml

Codex CLI 启动时会读取 ~/.codex/config.toml。
mkdir -p ~/.codex
cat > ~/.codex/config.toml <<'EOF'
model = "gpt-5.4"
model_provider = "crazyrouter"

[model_providers.crazyrouter]
name = "Crazyrouter"
base_url = "https://crazyrouter.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

[profiles.crazyrouter]
model = "gpt-5.4"
model_provider = "crazyrouter"
approval_policy = "on-request"
sandbox_mode = "workspace-write"
EOF
配置完后可以检查：
cat ~/.codex/config.toml
8

第 8 步：准备 Git 仓库并做首个快照

如果目录还不是 Git 仓库：
git init
git add .
git commit -m "chore: initial snapshot before Codex"
如果已经是现有仓库，至少先看一下：
git status
9

第 9 步：启动 Codex 并完成第一次验证

进入仓库目录后，可以先做一次最小验证：
cd /path/to/your/project
codex --profile crazyrouter "Reply only OK"
成功后再进入交互模式：
codex --profile crazyrouter
第一次验证建议按下面顺序：
  1. Reply only OK
  2. Read the repository structure only. Do not edit files.
  3. Find the highest-risk file in this repo and explain why, but do not change anything.

​
推荐模型配置

使用场景推荐模型原因
默认主力编码gpt-5.42026 年 3 月 23 日已在生产环境实测成功，适合作为 Codex / Responses API 主基线
如果你需要 Claude，请走 Claude 原生 POST /v1/messages 或 OpenAI 兼容 POST /v1/chat/completions，不要把 Claude 配到 Codex 这条 wire_api = "responses" 路线上。

​
国产模型原生支持情况

基于 2026-05-15 的生产复测，Crazyrouter 上通过 原生 POST /v1/responses 并且能被 Codex CLI 正常消费的国产模型，当前只建议按下面口径公开：
模型当前结论说明
kimi-k2.5推荐/v1/responses SSE 可完整返回 response.completed，Codex 简单回复和读文件均通过
kimi-k2.6推荐与 kimi-k2.5 同档，当前可作为国产模型主力候选
qwen3.6-plus推荐当前通过原生 Responses 与 Codex 真实客户端验证，但仍建议继续观察 reasoning item 与渠道稳定性
MiniMax-M2.7暂不推荐最小 Responses 探针已出现 convert_request_failed，读文件任务仍会断在 response.completed 前
deepseek-v4-pro暂不推荐Claude Code 可用，但 Codex 这条 Responses 路由仍会出现 500 / 高需求 / 重连失败
glm-5.1暂不推荐当前生产 Responses 原生路由落到不支持该模型的上游，Codex 会报 stream closed before response.completed
如果你想在 Codex 中试国产模型，建议先把 token 白名单缩到：
  • gpt-5.4
  • kimi-k2.5
  • kimi-k2.6
  • qwen3.6-plus
不建议把 MiniMax-M2.7、deepseek-v4-pro、glm-5.1 直接加入 Codex 默认白名单，除非你明确接受实验性行为和断流重试。

​
切到国产模型的方式

保持 base_url = "https://crazyrouter.com/v1" 和 wire_api = "responses" 不变，只替换 model 字段即可。例如： 
model = "kimi-k2.5"
model_provider = "crazyrouter"

[model_providers.crazyrouter]
name = "Crazyrouter"
base_url = "https://crazyrouter.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

[profiles.crazyrouter]
model = "kimi-k2.5"
model_provider = "crazyrouter"
approval_policy = "on-request"
sandbox_mode = "workspace-write"
第一次切到国产模型时，建议仍按这个顺序验证：
  1. Reply only OK
  2. Read the repository structure only. Do not edit files.
  3. Read agent.md and reply with exactly the first Markdown heading text.

​
Token 设置最佳实践

设置建议说明
专用 token必须Codex 不要和 Cursor、Claude Code 共用 token
模型白名单强烈建议只开放 Codex 真正会调用的模型
IP 限制固定出口环境建议开启个人设备经常换网络时谨慎使用
配额上限强烈建议Codex 代理式执行容易快速消耗额度
环境隔离建议本机开发、远程服务器、CI 使用不同 token
泄露处理立即轮换shell 历史、配置备份或共享屏幕暴露 token 后应立即更换

​
验证清单

  • git --version 正常
  • node -v 正常
  • codex --version 正常
  • OPENAI_API_KEY 已正确设置
  • ~/.codex/config.toml 已写入 model_provider = "crazyrouter"
  • base_url 已设置为 https://crazyrouter.com/v1
  • wire_api 已设置为 responses
  • 第一条请求成功返回
  • Crazyrouter 后台日志能看到对应请求
  • token 配额和模型白名单符合预期

​
常见错误与修复

现象常见原因修复方式
codex: command not foundCLI 没装成功，或全局 npm 目录不在 PATH重装 Codex，并确认 npm 全局 bin 已进入 PATH
401 unauthorizedOPENAI_API_KEY 错误、过期或复制带空格重新生成 token 并重新设置环境变量
403 / model not allowedtoken 没有放行当前模型在 Crazyrouter token 设置里放行对应模型
404base_url 写错，或漏了 /v1改成 https://crazyrouter.com/v1
请求结构报错wire_api 不是 responses改成 wire_api = "responses"
CLI 能启动但请求不走 Crazyroutermodel_provider 没切到 crazyrouter检查 config.toml 的 provider 配置
Git 改动难以审查没先做仓库快照先提交初始快照，再让 Codex 做真实修改
成本增长太快长上下文、多轮工具调用或多个仓库共用一个 token拆 token、限额，并缩小模型白名单

​
性能与成本建议

  • 首次接入先用小仓库验证，不要一上来就在超大仓库跑全量任务
  • 默认主力建议 gpt-5.4，先把 GPT / Responses 这条主路径跑通
  • 把 Codex 与 IDE 工具拆开记账，便于定位高消耗来源
  • 对高风险仓库或 CI 场景设置更严格的 token 配额
  • 每次遇到异常高消耗，先回看 Crazyrouter 日志确认是不是多轮代理行为导致

​
FAQ

​
Codex CLI 应该写哪个 Base URL？

写成 https://crazyrouter.com/v1。

​
Windows 上推荐用 PowerShell 还是 Git Bash？

首次配置时优先按文档里的 PowerShell 路线走，最容易和用户级环境变量、$HOME/.codex/config.toml 保持一致。

​
为什么这里要配置 wire_api = "responses"？

因为 Codex CLI 当前的自定义 provider 推荐通过 Responses API 工作，而 Crazyrouter 支持 /v1/responses。

​
为什么这里不再推荐 Claude？

因为 Claude 当前仅支持 POST /v1/messages 和 POST /v1/chat/completions，不支持 POST /v1/responses。Codex 这条接法固定走 wire_api = "responses"，因此不应该把 Claude 当成这条线路的推荐模型。

​
第一次为什么建议先做 Git 快照？

因为 Codex 是会改文件、会运行命令的代理。先做快照，review 和回滚都会轻松很多。

​
如果我已经 codex login 过，还需要配 API Key 吗？

需要。对接 Crazyrouter 时，仍然应使用 OPENAI_API_KEY 和自定义 provider 配置。

​
第一个推荐模型是什么？

先用 gpt-5.4。
如果你想优先获得 OpenAI / Responses API 路线下最顺手的终端代理体验，Codex 应该按 GPT / Responses 路线配置；如果你想优先使用 Claude，请改看 Claude Code 或 Claude 原生接口文档。

查看 crazyrouter-codex-cli 仓库

查看一键配置脚本、README 和最新使用说明。