why01 API 文档

主题

Codex CLI 部署

Codex CLI 是 OpenAI 官方的命令行 AI 编码 agent——和 Claude Code 类似的形态：终端里读代码、改文件、执行任务，但底层调 OpenAI 模型（GPT-5 / GPT-5 系列等）。

前置条件 ​

1. 安装 Codex CLI ​

bash
npm install -g @openai/codex

国内 npm 慢先换镜像：

bash
npm config set registry https://registry.npmmirror.com
npm install -g @openai/codex

验证：

bash
codex --version

TIP

Codex 也有 Homebrew 安装方式（macOS）：brew install codex。两种装一个就行。

2. 配置 Codex 指向 why01 ​

Codex 通过 ~/.codex/config.toml 文件配置上游 endpoint。最稳的姿势是定义一个 自定义 model_provider 指向 why01。

创建 / 编辑 ~/.codex/config.toml ​

toml
model_provider = "why01"
model = "gpt-5"   # 或你账户实际能用的 OpenAI 模型，按控制台模型页填

[model_providers.why01]
name = "why01"
base_url = "https://s1.why01.top/v1"
env_key = "WHY01_API_KEY"
wire_api = "responses"   # 如调用报错说不识别 responses，改成 "chat"
toml
model_provider = "why01"
model = "gpt-5"

[model_providers.why01]
name = "why01"
base_url = "https://s1.why01.top/v1"
env_key = "WHY01_API_KEY"
wire_api = "responses"

env_key = "WHY01_API_KEY" 表示 Codex 会从环境变量 WHY01_API_KEY 里读 key。

设置环境变量 WHY01_API_KEY ​

bash
# 加到 ~/.zshrc 或 ~/.bashrc
export WHY01_API_KEY=sk-你的key
source ~/.zshrc
powershell
[Environment]::SetEnvironmentVariable("WHY01_API_KEY", "sk-你的key", "User")
# 关闭所有终端窗口重开才生效

3. 启动 ​

进入项目目录：

bash
cd ~/your-project
codex

进交互界面后输入需求即可。

4. 验证走 why01 ​

跑完一次任务后到 why01 控制台 → 日志 看最近几分钟有没有 GPT 系列模型的调用记录——有 = 接通。

wire_api 选 responses 还是 chat ​

Codex 支持两种 OpenAI 协议格式：

wire_api 值走哪条路径适用
responses/v1/responses（OpenAI 新版 Responses API）上游模型支持 Responses API 时；GPT-5 系建议这个
chat/v1/chat/completions（经典 ChatCompletions）上游不支持 Responses API，或频繁报"找不到 endpoint" 时退到这个

优先试 responses，报错再切 chat。本站具体哪条路径稳取决于上游渠道实现。

常见问题 ​

启动报 401 ​

按这个顺序排：

  1. 检查 WHY01_API_KEY 是不是真的设进去了：echo $WHY01_API_KEY（Windows PowerShell：$env:WHY01_API_KEY）
  2. 确认 Key 未禁用 / 未过期（控制台「令牌管理」）
  3. 确认 config.toml 里 env_key = "WHY01_API_KEY" 拼写一致（Codex 大小写敏感）

启动报 404 model_not_found ​

config.toml 里的 model = "..." 写错了名字。改成你 控制台模型页 当前能看到的 OpenAI 系模型名——便宜的 mini 系、主力档、顶级档名字各不同，永远从控制台复制，不要按记忆敲。

报错 Unsupported endpoint /v1/responses 或类似 ​

切 wire_api = "chat"，再启动一次。

Codex 已经配过 OpenAI 官方账号怎么办 ​

~/.codex/config.toml 里同时存在多个 model_providers 没问题，只看 model_provider = "..." 顶级字段指向哪个就走哪个。在 why01 和 openai 之间切：

toml
model_provider = "why01"      # 走本站
# model_provider = "openai"   # 走 OpenAI 官方

或者运行时临时切：

bash
codex --provider openai     # 仅本次走官方

Codex 怎么计费 ​

和 Claude Code 一样按 token 实际用量算。建议：

  • 先用 控制台模型页 里的便宜档（mini 系列）试通流程
  • 监控控制台「日志」用量
  • 给 Agent 单独建一个 Key 并 设额度上限，跑飞了只烧这一个 Key 的预算

下一步 ​