Skip to content

在 Codex 中使用 GPT 模型 ​

如果你想在 Codex CLI 或 Codex App 中使用 ClawPower 提供的 GPT 模型,可以通过 CC Switch 完成配置,不需要手动修改 Codex 配置文件。

这篇文档适合下面几类用户:

  • 想在 Codex CLI 中使用 ClawPower GPT 模型
  • 想在 Codex App 中使用 ClawPower GPT 模型
  • 希望通过可视化工具配置,不想手动编辑配置文件

配置前,请先准备一个 ClawPower 账号。API 密钥和模型会在后面的配置步骤中处理。

第三方工具说明

本文使用的 CC Switch 是第三方开源工具,不由 OpenAI 或 ClawPower 维护。工具版本更新后,页面名称和操作位置可能发生变化。

1. 安装 Codex CLI ​

Codex 官方安装页面提供多个选项。本文只使用 macOS 和 Windows 两种系统安装方式。

macOS ​

如果你使用的是 macOS,请打开终端,执行下面的命令:

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

Windows ​

如果你使用的是 Windows,请打开 PowerShell,执行下面的命令:

powershell
powershell -ExecutionPolicy Bypass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

检查是否安装成功 ​

安装完成后,重新打开终端或 PowerShell,然后执行:

bash
codex --version

能够正常显示版本号,就说明 Codex CLI 已经安装成功。

Codex CLI 版本检查结果

接着运行一次 Codex:

bash
codex

确认 Codex 可以正常启动后,退出当前会话。下一步继续安装 Codex App。

2. 下载 Codex App ​

Codex App 提供 macOS 和 Windows 版本,请打开官方下载页面:

https://chatgpt.com/zh-Hans-CN/download/

根据自己的系统,选择 macOS 或 Windows 下载。

Codex App 下载页面

安装完成后,打开一次 Codex App,确认可以正常启动,然后完全退出。

3. 下载 CC Switch ​

CC Switch 用来管理大模型供应商,不需要手动编辑配置文件。

请从 GitHub Releases 下载:

https://github.com/farion1231/cc-switch/releases

根据自己的系统选择安装包:

  • macOS:下载文件名中包含 .dmg 的安装包
  • Windows:下载文件名中包含 .exe 或 .msi 的安装包

CC Switch 下载页面

下载提示

请下载页面中的最新版本。截图中的版本号仅作示例,可能不是当前最新版本。

安装完成后,打开 CC Switch。

CC Switch Codex 供应商页面

4. 准备 ClawPower API 密钥和 GPT 模型 ​

创建 GPT 分组API 密钥 ​

创建API 密钥时,选择 GPT 精选分组。

API 密钥分组必须匹配

API 密钥分组必须支持你准备使用的 GPT 模型,否则会提示没有权限或模型不可用。

复制 GPT 模型 ID ​

打开 ClawPower 模型广场,复制准备使用的 GPT 模型 ID,例如 gpt-5.6-sol。

模型 ID 必须与模型广场显示的内容完全一致。

从 ClawPower 模型广场复制 GPT 模型 ID

5. 在 CC Switch 中配置 GPT 模型 ​

添加 ClawPower 供应商 ​

打开 CC Switch,进入 Codex 页面,然后点击右上角的「+」。

在 CC Switch 的 Codex 页面添加供应商

确认当前位于 Codex 供应商页面,然后选择「自定义配置」。

选择 Codex 自定义配置

填写基础配置 ​

按照下面的内容填写:

text
供应商名称:ClawPower
官网链接:https://clawpowerai.com
API Key:刚才创建的 ClawPower API 密钥
API 请求地址:https://api.clawpowerai.com
默认模型:从模型广场复制的 GPT 模型 ID,例如 gpt-5.6-sol
完整 URL 模式:关闭

填写 ClawPower 供应商基础配置

设置高级选项 ​

展开「高级选项」,按照下面的内容设置:

text
上游格式:Chat Completions(需开启路由)
提示词缓存路由:自动(推荐)

设置 Chat Completions 上游格式

向下滚动,勾选「应用通用配置」,然后点击右下角的「保存」。

应用通用配置并保存供应商

启动本地路由 ​

必须开启路由

选择 Chat Completions 后,需要打开 CC Switch 的路由总开关,并保持 CC Switch 运行。

开启 CC Switch 路由总开关和 Codex 路由

启用 ClawPower ​

回到 Codex 供应商列表,在刚刚添加的 ClawPower 供应商上点击「启用」。

启用 ClawPower 供应商

启用后,确认 ClawPower 是 Codex 当前使用的供应商。

6. 重新启动并验证 Codex ​

如果 Codex CLI 或 Codex App 正在运行,请先完全退出,然后重新打开。

使用 Codex CLI 验证 ​

进入需要使用的项目目录,运行:

bash
codex

查看当前模型是否为刚才配置的 GPT 模型,然后发送一个简单请求:

text
你好,请介绍一下当前项目。

能够正常返回结果,说明配置已经生效。

使用 Codex App 验证 ​

重新打开 Codex App,选择一个项目并创建新会话。确认当前模型后,发送一个简单请求。

Codex App 能够正常返回结果,就说明配置已经生效。

7. 常见问题 ​

Codex 仍然使用原来的模型 ​

确认 CC Switch 中已经启用 ClawPower,然后完全退出 Codex CLI 或 Codex App,再重新打开。

返回 401 或 API Key 错误 ​

重新复制 ClawPower API 密钥,确认:

  • API 密钥前后没有多余空格
  • API 密钥仍处于启用状态
  • CC Switch 中填写的是完整API 密钥

提示模型不存在或没有权限 ​

检查默认模型 ID 是否与模型广场完全一致,并确认当前API 密钥分组支持该模型。

修改配置后没有生效 ​

确认修改后的配置已经保存并启用。关闭已有的 Codex 会话,再重新启动。

联系加微信 clawpower