接入 Codex

Codex 是 OpenAI 推出的智能开发工具，能够理解项目上下文，并根据自然语言需求编写和修改代码、排查故障、运行测试及维护项目。借助插件和外部工具，Codex 还可协助完成涉及浏览器、应用界面和多模态内容的复杂任务。

Codex 提供桌面版和命令行版两种本地使用方式。目前，桌面版 Codex 已整合到 ChatGPT Desktop 中，支持 Windows 和 macOS；Codex CLI 支持 Windows、macOS 和 Linux。

更多命令和使用说明，请查看 Codex CLI 官方文档和 Codex 官网。

Codex 可通过 Better Gate 客户端、CC Switch 或手动配置接入 Better Gate。请选择其中一种方式，不要同时使用，以免不同工具写入的配置相互覆盖。

1 安装 Codex

1.1 安装桌面版（Windows、macOS）

打开 ChatGPT Desktop 官方下载页。
下载并安装 ChatGPT Desktop。

1.2 安装 Codex CLI（Windows、macOS、Linux）

先安装 Node.js，然后打开终端，运行：

npm install -g @openai/codex
codex --version

安装完成后，请至少启动一次 Codex，确认程序可以正常运行。开始配置 Better Gate 前，请完整退出 Codex Desktop，并停止所有正在运行的 Codex CLI 会话。

2 准备 Better Gate 配置

登录 Better Gate 控制台。
确认账户有可用余额（组织成员需确认自己的成员额度够用）。
打开“API Keys”，点击“创建 Key”。
填写 Key 名称，路由方式保持默认的“智能路由”就行，它会自动挑可用渠道；只有需要固定渠道时才选“指定渠道分组”。组织管理员为成员创建 Key，记得勾选“分配给成员”。
点击创建，复制并保存好完整的 API Key。

3 选择接入方式

3.1 通过 Better Gate 客户端接入 Codex (推荐)

下载并安装 Better Gate 客户端：

系统	下载地址
Windows	下载 Better Gate Windows 客户端
macOS	下载 Better Gate macOS 客户端

安装并启动客户端，点击“登录”。
浏览器打开授权页面后，确认当前账号并点击“授权并继续”，随后返回客户端。

Better Gate 客户端主界面

通过客户端接入 Codex：

完整退出 Codex Desktop 和 Codex CLI。
找到 Codex 卡片，点击“一键接入”（已接入过时按钮显示“配置接入”，打开的是同一个弹窗）。
在弹窗中选择用于 Codex 的 API Key；如果列表未更新，点击“刷新密钥”。
点击“接入”，进入模型选择步骤：选“接入 Claude / GPT 系列模型”（推荐）直接使用原生模型；选“接入其他系列模型”可以把 Claude 系列模型原生转发进 Codex，无需额外的角色映射配置。
确认选择后点击“接入”/“重新接入”，等待配置完成。
重新打开 Codex，发送一条简短消息进行测试，然后前往 Better Gate 控制台的用量页面，确认是否出现对应的请求记录。

不再需要 Better Gate 时，可以在弹窗中点击对应密钥旁的“取消接入”：客户端会恢复 Codex 的官方登录与配置，工作区的 API Key 不会被删除。

3.2 通过 CC Switch 接入 Codex

前往 CC Switch Releases 下载并安装 CC Switch。

添加 Better Gate 供应商：

完整退出 Codex Desktop 和 Codex CLI。
打开 CC Switch，在顶部工具栏中选择“Codex”。
点击右上角的“+”添加供应商。
选择“自定义供应商”。

添加自定义供应商时，请填写以下内容：

字段	值
供应商名称	`Better Gate`
官网链接	`https://better-gate.com/`，可选
API Key	你的 Better Gate API Key
API 请求地址或 Base URL	`https://gateway.better-gate.com/v1`

保存配置后，在 Better Gate 卡片中点击“启用”，然后重新启动 Codex。发送一条简短消息进行测试，并在 Better Gate 控制台的用量页面确认对应的请求记录。

3.3 手动配置 Codex

Codex 配置文件的默认路径如下：

macOS、Linux：~/.codex/config.toml
Windows：%USERPROFILE%\.codex\config.toml

创建或编辑 config.toml，写入以下内容：

model_provider = "better-gate"
model = "YOUR_MODEL_ID"
model_reasoning_effort = "high"

[model_providers.better-gate]
name = "Better Gate"
base_url = "https://gateway.better-gate.com/v1"
env_key = "BETTER_GATE_API_KEY"
wire_api = "responses"

将 YOUR_MODEL_ID 替换为 Better Gate 控制台中的真实模型 ID，然后按操作系统设置 API Key 环境变量。

macOS zsh

echo 'export BETTER_GATE_API_KEY="YOUR_BETTER_GATE_API_KEY"' >> ~/.zshrc
source ~/.zshrc

Linux bash

echo 'export BETTER_GATE_API_KEY="YOUR_BETTER_GATE_API_KEY"' >> ~/.bashrc
source ~/.bashrc

Windows PowerShell

[Environment]::SetEnvironmentVariable(
  "BETTER_GATE_API_KEY",
  "YOUR_BETTER_GATE_API_KEY",
  "User"
)

Windows 环境变量设置完成后，请关闭所有 Codex 窗口和终端，然后重新打开终端。运行 Codex 并发送一条简短消息，再前往 Better Gate 控制台的用量页面确认对应的请求记录。

On this page