Skip to content

在 VS Code 中使用 GPT 模型 ​

如果你想在 VS Code 中使用 ClawPower 提供的 GPT 模型,可以安装 Codex 扩展,再通过 CC Switch 完成配置,不需要手动修改 Codex 配置文件。

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

  • 想在 VS Code 中使用 ClawPower GPT 模型
  • 已经在使用 Codex,希望直接在编辑器中完成编程任务
  • 希望通过可视化工具配置,不想手动编辑配置文件

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

第三方工具说明

本文使用的 CC Switch 是第三方开源工具,不由 OpenAI、Microsoft 或 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 版本检查结果

2. 下载 VS Code ​

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

https://code.visualstudio.com/

根据自己的系统选择下载:

  • macOS:选择适合当前 Mac 芯片的版本
  • Windows:选择适合当前电脑架构的安装程序

VS Code 官方下载页面

下载页面会根据当前电脑的系统自动显示对应版本。上图使用的是 macOS,所以页面显示「Download for macOS」;如果你使用 Windows,页面会自动显示对应的 Windows 版本。

下载完成后,按照安装程序提示完成安装,然后打开 VS Code。

3. 安装 Codex 扩展 ​

打开 VS Code,点击左侧的「扩展」图标,在搜索框中输入:

text
Codex

找到 OpenAI 发布的 Codex 扩展,然后点击「安装」。

安装完成后,确认 VS Code 左侧活动栏中已经出现 Codex 图标。

在 VS Code 中安装 Codex 扩展

4. 下载 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 供应商页面

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

创建 GPT 分组API 密钥 ​

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

API 密钥分组必须匹配

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

复制 GPT 模型 ID ​

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

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

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

6. 在 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 的路由总开关,并开启 Codex 路由。使用过程中需要保持 CC Switch 运行。

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

启用 ClawPower ​

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

启用 ClawPower 供应商

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

7. 在 VS Code 中验证 GPT 模型 ​

如果 VS Code 正在运行,请完全退出,然后重新打开。

打开一个项目,点击左侧活动栏中的 Codex 图标,然后创建一个新会话。

在输入框中发送一个简单请求:

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

能够正常返回结果,就说明 ClawPower GPT 模型已经在 VS Code 中生效。

在 VS Code 的 Codex 面板中发送测试请求

8. 常见问题 ​

VS Code 中没有 Codex 图标 ​

打开扩展页面,确认 Codex 扩展已经安装并处于启用状态。安装完成后,重新启动 VS Code。

Codex 仍然使用原来的模型 ​

确认 CC Switch 中已经启用 ClawPower,然后完全退出 VS Code,再重新打开。

返回 401 或 API Key 错误 ​

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

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

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

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

修改配置后没有生效 ​

确认修改后的配置已经保存并启用,同时检查 CC Switch 的路由总开关和 Codex 路由是否已经打开。关闭已有的 VS Code Codex 会话,再重新启动 VS Code。

联系加微信 clawpower