配置 Codex CLI 接入 BytePass

Codex CLI 是 OpenAI 的开源终端编程工具。本教程教你如何将它连接到 BytePass。

预计耗时： 5 分钟（使用 CC-Switch 可缩短至 2 分钟内）

前置条件

• Node.js 22+ — 用 node --version 检查
• BytePass API Key — 在 bytepass.ai/keys 创建

安装 Codex CLI

npm install -g @openai/codex

配置

方式 1：从 BytePass 控制台一键导入（推荐）

如果你已安装 CC-Switch，直接到 bytepass.ai/keys 点击 「导入到 CCS」 按钮即可。CC-Switch 有专门的 Codex 标签页。

详见 CC-Switch 配置指南。

方式 2：配置文件

Codex 使用两个配置文件。编辑 ~/.codex/config.toml：

model_provider = "bytepass"
model = "gpt-5.4"

[model_providers.bytepass]
name = "bytepass"
base_url = "https://api.bytepass.ai"
wire_api = "responses"
requires_openai_auth = true

以及 ~/.codex/auth.json：

{
  "OPENAI_API_KEY": "sk-你的bytepass-key"
}

方式 3：环境变量

export OPENAI_BASE_URL="https://api.bytepass.ai/v1"
export OPENAI_API_KEY="sk-你的bytepass-key"

添加到 shell 配置文件（~/.zshrc 或 ~/.bashrc），然后重新加载。

验证

打开新终端，运行：

codex

输入消息，收到回复即配置成功。

常见问题

401 错误

检查 API Key 和 账户余额。

"model not found" 或空响应

确认你使用的模型在 BytePass 支持列表中。查看 模型页面。

配置不生效

编辑配置文件或环境变量后，请打开新终端。

下一步

• CC-Switch 配置工具 — 轻松管理多套配置
• Claude Code 配置教程 — 也想用 Claude？配置 Claude Code
• 使用技巧 — 优化工作流、减少 Token 消耗