Codex CLI 使用教程

什么是 Codex CLI

Codex CLI 是 OpenAI 推出的命令行编程助手，能够理解代码库上下文并协助完成开发任务。

前置条件

安装 Codex CLI 前，请确保已完成环境准备：Git 和 Node.js 18+ 已安装。

安装 Codex CLI

npm install -g @openai/codex

配置 Baka API 中转

安装完成后，需要配置 Codex CLI 使用 Baka API 中转服务。

也可以使用 CC Switch 图形化管理 Codex 配置，支持一键切换提供商和配置请求头，效果与手动编辑配置文件一致。

步骤一：配置 config.toml

编辑 ~/.codex/config.toml（Windows 路径为 C:\Users\用户名\.codex\config.toml，如不存在则创建），添加以下配置：

model_provider = "bakastream"
model = "gpt-5.4"
model_reasoning_effort = "medium"
disable_response_storage = true

[model_providers.bakastream]
name = "bakastream"
base_url = "https://bakastream.icu/v1"
wire_api = "responses"
requires_openai_auth = true

base_url 末尾需要加 /v1，这是 Codex CLI 正确路由请求所必需的。

步骤二：配置 auth.json

编辑 ~/.codex/auth.json（Windows 路径为 C:\Users\用户名\.codex\auth.json），填入您的 Baka API Key：

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

auth.json 文件存储敏感凭据，请确保文件权限安全，不要提交到版本控制系统。

配置项说明

参数	说明
`model_provider`	指定使用的模型提供商
`model`	选择的模型名称
`model_reasoning_effort`	推理强度：`low`、`medium`、`high`
`disable_response_storage`	禁用响应存储
`base_url`	API 端点地址
`wire_api`	API 协议类型
`requires_openai_auth`	使用 OpenAI 格式的认证

支持的模型

模型	说明
`gpt-5.4`	GPT-5.4 基础版本
`gpt-5.4-openai-compact`	GPT-5.4 精简版本
`gpt-5.3-codex`	GPT-5.3 Codex 版本
`gpt-5.2-codex`	GPT-5.2 Codex 版本
`gpt-5.2`	GPT-5.2 基础版本
`gpt-5.1-codex-max`	GPT-5.1 Codex 增强版
`gpt-5.1-codex-mini`	GPT-5.1 Codex 精简版
`gpt-5.1-codex`	GPT-5.1 Codex 版本
`gpt-5.1`	GPT-5.1 基础版本
`gpt-5`	GPT-5 基础版本

模型可用性可能会变化，请访问控制台查看当前可用的模型列表。

验证连接

配置完成后，启动 Codex CLI 验证连接是否正常：

cd your-project
codex "你好，这是一条测试消息"

如果配置正确，您将通过 Baka API 中转收到回复。

故障排除

遇到问题请参阅常见问题页面。

快速检查：

确认 API Key 正确无误（以 sk- 开头）
检查 config.toml 中 base_url 为 https://bakastream.icu/v1
确保 auth.json 中的 Key 与控制台一致
在控制台确认账户余额充足
Codex 模型仅支持流式请求，这是正常行为

Codex CLI 教程