跳到主要内容

Codex

Codex 是 OpenAI 提供的 AI 编程工具。Bita API 提供 OpenAI Responses 兼容接口，可以在 Codex 中添加为自定义模型服务商。

Codex 需要 Responses 接口

Codex 自定义服务商使用 Responses API，不支持直接改成 Chat Completions。请从模型广场选择支持 Response 端点的模型。

准备工作​

开始前，请准备：

  • 已安装的 Codex CLI。
  • 一个处于启用状态、仍有可用额度的 Bita API 密钥。
  • 密钥所属分组可以使用、且支持 Responses 的模型 ID。

如果尚未准备好，请阅读创建 API 密钥和选择模型。

安装 Codex​

macOS 与 Linux​

使用官方独立安装程序：

curl -fsSL https://chatgpt.com/codex/install.sh | sh

Windows​

Windows 用户可以先从 Node.js 官方网站下载安装长期支持版，然后在 PowerShell 或命令提示符中安装 Codex：

npm install -g @openai/codex

安装完成后检查版本：

codex --version

保存 API 密钥​

Codex 推荐让自定义服务商从环境变量读取密钥。本页使用：

BITA_API_KEY

macOS 与 Linux​

根据当前 Shell，把下面一行添加到 ~/.zshrc 或 ~/.bashrc：

export BITA_API_KEY="YOUR_BITA_API_KEY"

保存后关闭并重新打开终端。

Windows​

  1. 在开始菜单搜索并打开 编辑账户的环境变量。
  2. 在“用户变量”区域点击 新建。
  3. 变量名填写 BITA_API_KEY。
  4. 变量值填写完整的 Bita API 密钥。
  5. 保存后完全关闭并重新打开终端或编辑器。

YOUR_BITA_API_KEY 需要替换为控制台创建的完整密钥。

配置自定义服务商​

打开 Codex 的用户配置文件：

系统配置文件
macOS、Linux~/.codex/config.toml
Windows%USERPROFILE%\.codex\config.toml

如果目录或文件不存在，可以手动创建。将下面内容写入 config.toml：

config.toml
model_provider = "bita-api"
model = "YOUR_CODEX_MODEL_ID"
model_reasoning_effort = "medium"

[model_providers.bita-api]
name = "Bita API"
base_url = "https://www.bita-api.com/v1"
env_key = "BITA_API_KEY"
wire_api = "responses"

将 YOUR_CODEX_MODEL_ID 替换为模型广场中支持 Responses 的实际模型 ID。

配置项含义：

配置项说明
model_provider选择下方定义的 bita-api 服务商
modelCodex 默认使用的模型 ID
model_reasoning_effort推理强度；模型不支持时可以删除该行
base_urlBita API 的 OpenAI 兼容 Base URL，需要包含 /v1
env_key告诉 Codex 从 BITA_API_KEY 读取密钥
wire_api使用 OpenAI Responses 协议
不要设置 requires_openai_auth = true

Bita API 是自定义服务商，应通过 env_key 读取密钥。Codex 在 requires_openai_auth = true 时会改用 OpenAI 登录凭据并忽略 env_key，可能导致请求携带错误的密钥。

配置文件必须放在用户目录​

自定义服务商属于本机配置，必须写在用户级 ~/.codex/config.toml。项目中的 .codex/config.toml 不能覆盖 model_provider 和 model_providers，不要把上述服务商配置放进项目仓库。

如果原文件中已经存在其他设置，请保留原有内容，只添加或修改本页涉及的字段。TOML 中同一个键不能重复定义。

启动并验证​

进入项目目录后运行：

cd your-project
codex

进入 Codex 后：

  1. 使用 /status 查看当前配置。
  2. 确认服务商为 Bita API。
  3. 确认当前模型 ID 与 config.toml 一致。
  4. 发送一条简单任务，例如“介绍这个项目的目录结构”。
  5. 在 Bita API 控制台的使用日志中确认请求已经产生。

只为当前启动临时指定另一个模型：

codex --model YOUR_OTHER_MODEL_ID

临时指定的模型仍然必须支持 Responses，并属于当前密钥分组。

推理强度​

默认示例使用：

model_reasoning_effort = "medium"

Codex 支持的推理强度会随模型能力变化。常见取值包括 minimal、low、medium、high 和 xhigh。如果模型返回不支持该参数，可以降低等级，或删除 model_reasoning_effort 让服务端使用默认值。

使用 Codex IDE 扩展​

Codex CLI 和 IDE 扩展共享用户级 config.toml。在扩展中，可以点击右上角的齿轮图标，然后选择 Codex Settings → Open config.toml 打开同一份配置。

修改 config.toml 或系统环境变量后，应完全关闭并重新打开编辑器。如果模型选择器中没有 Bita API 模型，可以先通过 model 设置默认模型，再重启扩展。

常见问题​

现象建议检查
提示缺少 BITA_API_KEY环境变量名称是否完全一致；设置后是否重启终端或编辑器
返回 401环境变量中是否为完整密钥；是否错误设置了 requires_openai_auth = true
返回 403密钥状态、有效期、额度、模型限制和分组权限
返回 404base_url 应为 https://www.bita-api.com/v1，不要填写完整的 /responses 路径
提示模型不存在模型 ID 是否与模型广场完全一致，密钥分组是否包含该模型
提示接口或协议不支持当前模型可能只支持 Chat Completions；换用标记为 Response 的模型
提示推理参数不支持降低 model_reasoning_effort，或删除该配置项
修改配置后没有生效配置是否写在用户级文件；完全退出 Codex 后重新启动
TOML 解析失败检查重复键、引号和表名；可以运行 codex --strict-config 查看无效字段
请求失败但本地信息不足查看 Bita API 使用日志中的接口、模型和错误信息

Codex 会持续更新，配置字段以 Codex CLI和配置参考为准。

如果希望通过图形界面管理和切换多个 Codex 服务商，也可以使用 CC Switch。

下一步：OpenCode。