Codex CLI 接入

难度 ⌨️ 进阶（需要用命令行 / 终端）　|　接口格式 OpenAI / Responses　|　base_url https://byesu.com/v1

接入信息 · 填这几样

接口地址https://byesu.com/v1

API 密钥sk-xxxxxxxx去控制台创建 →

推荐模型gpt-5.5

接口格式 OpenAI 兼容 · 模型名以 控制台 实际为准

Codex 是 OpenAI 官方的命令行编程助手。它默认连 OpenAI，我们只要把它指向半页酥，再填上你的 Key 就能用。

开始之前

先到 控制台 → 令牌 创建一个 API Key（详见 快速开始）。下文出现的 sk-xxxx 都替换成你自己的 Key。

第 1 步：安装 Codex

如果还没装，任选一种：

npm（跨平台）

npm install -g @openai/codex

Homebrew（macOS）

brew install codex

装好后验证：

codex --version

第 2 步：配置（二选一）

方式一：一键脚本（最快，推荐）

接口地址我们已经帮你写进脚本了 —— 运行后只要粘贴你的 API Key（sk-xxxx），它会自动配好 ~/.codex/config.toml 和 auth.json（含 wire_api=responses、disable_response_storage 这些必填项，不用你操心）。配好直接跳到第 3 步。

Windows

iex (irm 'https://docs.byesu.com/setup/codex.ps1')

macOS / Linux

curl -fsSL https://docs.byesu.com/setup/codex.sh | bash

方式二：手动配置

Codex 的配置在 ~/.codex/ 目录下，需要两个文件。

① ~/.codex/config.toml —— 指定模型与接入点：

model = "gpt-5.5"                  # 当前最新最强；也可填控制台里其它模型名
model_provider = "byesu"
model_reasoning_effort = "high"    # 思考强度：minimal / low / medium / high
disable_response_storage = true    # ★ 接第三方网关必须加，否则可能报错

[model_providers.byesu]
name = "byesu"
base_url = "https://byesu.com/v1"
wire_api = "responses"             # ★ 必须是 responses，Codex 走 /v1/responses

② ~/.codex/auth.json —— 存放你的 Key：

{
  "OPENAI_API_KEY": "sk-你的令牌"
}

🤔 不知道怎么创建这两个文件？（点开看）

Windows：在 C:\Users\你的用户名\.codex\ 下，用"记事本"分别新建 config.toml 和 auth.json（另存为时保存类型选"所有文件"；没有 .codex 文件夹就在地址栏手动建一个）。

macOS / Linux：终端里执行 mkdir -p ~/.codex && open -e ~/.codex/config.toml（Linux 把 open -e 换成 nano），auth.json 同理。

四个最容易错的地方

1. wire_api 必须是 responses（不是 chat），否则报 404 / 接口不对。
2. base_url 结尾是 /v1，别多加 /responses。
3. 别忘了 disable_response_storage = true，否则接网关可能报错。
4. auth.json 里的字段名就是 OPENAI_API_KEY（即使填的是半页酥令牌）。

第 3 步：跑起来验证

随便进一个项目目录，启动：

codex

然后让它做点小事，比如输入「列出当前目录的文件」。能正常回答，就接通了 ✅

小贴士

调整思考强度

model_reasoning_effort 控制模型"想多久"：

• minimal / low：快、省钱，适合简单改动
• medium：默认平衡
• high：复杂重构、难题，质量最高但更慢更贵

换模型

直接改 config.toml 里的 model 那一行，换成控制台里任意可用模型名即可。想要 Codex 专门优化的版本，可填 gpt-5.3-codex-spark。

卡住了？

对照 常见错误 & 解决 排查，最常见的几个：

• 报 401 / invalid token → auth.json 里的 Key 填错或位置不对（详情）
• 报 余额不足 → 去控制台充值（详情）
• 报 无可用渠道 → 这个模型不在你的分组里，换个模型（详情）