Codex CLI 接入

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

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

开始之前

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

第 1 步：安装 Codex

如果还没装，任选一种：

npm（跨平台）

npm install -g @openai/codex

Homebrew（macOS）

brew install codex

装好后验证：

codex --version

第 2 步：写配置文件

Codex 的配置在 ~/.codex/config.toml（Windows 是 C:\Users\你的用户名\.codex\config.toml）。没有就新建一个，填入：

# ~/.codex/config.toml

model = "gpt-5.5"                # 当前最新最强；也可填控制台里其它模型名
model_provider = "byesu"
model_reasoning_effort = "high"  # 思考强度：minimal / low / medium / high

[model_providers.byesu]
name = "Byesu API"
base_url = "https://byesu.com/v1"
wire_api = "responses"           # ★ 必须是 responses，Codex 走的是 /v1/responses
env_key = "BYESU_API_KEY"        # Key 从这个环境变量读，见第 3 步

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

Windows：打开"记事本" → 把上面内容粘进去 → 另存为时：文件名填 config.toml、保存类型选"所有文件"、位置填 C:\Users\你的用户名\.codex\（没有 .codex 文件夹就在地址栏手动新建一个）。

macOS / Linux：打开"终端" → 粘贴这行回车，会自动建好文件夹并打开编辑器：

mkdir -p ~/.codex && open -e ~/.codex/config.toml   # Linux 把 open -e 换成 nano

把上面的配置粘进去保存即可。

三个最容易填错的地方

1. wire_api 必须是 responses（不是 chat），否则会报 404 / 接口不对。
2. base_url 结尾是 /v1，别多加 /responses。
3. model 要和控制台里的模型名一模一样，否则报"模型不存在"。

第 3 步：填入你的 API Key

上面 env_key = "BYESU_API_KEY" 表示 Codex 会从环境变量 BYESU_API_KEY 读取 Key。设置它：

macOS / Linux

# 写进 ~/.zshrc 或 ~/.bashrc，重开终端生效
export BYESU_API_KEY="sk-你的Key"

Windows PowerShell

# 永久写入用户环境变量
setx BYESU_API_KEY "sk-你的Key"
# 重开 PowerShell 后生效

第 4 步：跑起来验证

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

codex

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

小贴士

调整思考强度

model_reasoning_effort 控制模型"想多久"：

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

注：在 Codex 里用配置项 model_reasoning_effort 设置即可。如果你是自己写代码调 API，注意 /v1/responses 用 reasoning: { effort: "high" } 对象格式，而 /v1/chat/completions 用字符串 reasoning_effort: "high" —— 两者不要混用，详见 常见错误。

换模型

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

跑不通？

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

• 报 401 / invalid token → Key 填错或没生效（详情）
• 报 余额不足 → 去控制台充值（详情）
• 报 无可用渠道 → 这个模型不在你的分组里，换个模型或联系客服（详情）