Codex CLI
将 OpenAI 官方 Codex CLI 接入 ShuYou，在终端通过 OpenAI 兼容接口调用 GPT 等模型。
使用前准备
- 安装 Node.js LTS（建议 v20+），执行
node -v、npm -v 验证。
- 在 ShuYou 控制台 创建 API Key。
ShuYou OpenAI 兼容 Base URL：https://api.shuyou.ai/v1
第一步：安装 Codex CLI
npm install -g @openai/codex
codex --version
第二步：配置 ShuYou
编辑 ~/.codex/config.toml（Windows：%USERPROFILE%\.codex\config.toml）：
model = "openai/gpt-4o"
model_reasoning_effort = "medium"
model_provider = "shuyou"
[model_providers.shuyou]
name = "ShuYou API"
base_url = "https://api.shuyou.ai/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"
export OPENAI_API_KEY="你的 ShuYou API Key"
~/.zshrc 或 ~/.bashrc 永久生效。$env:OPENAI_API_KEY = "你的 ShuYou API Key"
| 字段 | 说明 |
|---|
model | 默认模型 slug，见 ShuYou 模型列表 |
base_url | https://api.shuyou.ai/v1 |
wire_api | 必须为 responses（勿使用已弃用的 chat） |
第三步：验证
常见问题
401 / 403： 检查 OPENAI_API_KEY 及模型 slug 是否在 ShuYou 上可用。
配置未生效： 重启终端，检查 config.toml TOML 语法。
切换模型： 修改 config.toml 中的 model 后重启 Codex。
建议在专门的项目目录中使用 Codex CLI，避免在含密钥或系统目录中运行。
