在编辑器中使用 Wegoo

VS Code 用户可以使用官方扩展；Cursor 和 Windsurf 用户可以在集成终端运行 Codex 或 Claude Code。

连接 Wegoo · VS Code 扩展 · Cursor / Windsurf 终端 · 远程环境

还没有 Wegoo 账号

打开注册页，填写用户名、密码、确认密码和电子邮件。点击 发送验证码并填回验证码，勾选用户协议，点击 创建账户。成功后用用户名或电子邮件登录。

未收到验证码时，检查邮箱拼写和垃圾邮件，并使用最新收到的验证码。已有账号可直接登录。

尚未安装 WegooSwitch

下载 WegooSwitchv1.0.38

Windows（x64）绿色版安装包

前往发布页下载

Windows x64 用户运行 安装包完成安装，或将 绿色版解压后打开。升级旧版时，先关闭应用再运行新版安装包。

1. 连接 Wegoo

以下适用于 Windows 本机。macOS、Linux、WSL 或 SSH 远程环境使用本页的手动配置。

打开 WegooSwitch，点击左侧 Wegoo。
填写邮箱和密码，点击 登录 Wegoo；已经登录时点击 一键同步最新模型。
在左侧选择 Codex或 Claude Code。工具尚未安装时，点击 一键安装并等待结束。
在目标分组上点击卡片右侧的切换图标，确认卡片显示 使用中。
完全退出编辑器后再打开，在项目终端运行 codex或 claude即可使用。

图中分组和状态为演示数据。

2. 使用 VS Code 扩展

安装准备使用的官方扩展：

工具	VS Code 扩展
Codex	OpenAI 发布的 Codex 扩展
Claude Code	Anthropic 发布的 Claude Code 扩展

安装后重新打开 VS Code 即可使用。

Codex CLI 和 IDE 扩展使用用户目录中的同一套服务配置。切换模型后，重新打开扩展会话。

3. 使用 Cursor 或 Windsurf 终端

完成上面的连接步骤后，重新打开 Cursor 或 Windsurf，在项目的集成终端运行 codex或 claude即可使用。

这里的配置只用于启动的 Codex 或 Claude Code。Cursor 内置聊天、Agent 和 Windsurf Cascade 的服务设置仍由对应编辑器管理。

配置排查

找不到命令时，先在系统终端运行相同命令。系统终端正常时，完全退出编辑器再打开。扩展报错时，在扩展所在环境运行 codex或 claude，用终端结果检查配置。

macOS、Linux 和远程环境

先在实际运行工具的环境中安装 Codex 或 Claude Code，确认对应命令可用。本机、WSL 和 SSH 远程环境有各自的用户配置目录；扩展运行在哪里，就在哪里完成以下配置。

已有可用密钥时，确认它所属的分组和目标模型后继续。

创建密钥并选择模型

登录模型广场，搜索目标模型，记下完整模型 ID、支持的分组和接口。
打开 API 密钥，点击 创建 API 密钥。填写名称，在分组中选择刚确认的分组；数量保持 1。
设置 过期时间。需要限制消耗时，关闭 无限配额并填写额度；0 表示没有可用额度。点击 保存更改。
新密钥出现在列表后，打开行末菜单，点击 复制密钥。

图中名称和分组为演示数据。

无限配额只是不单独限制这把密钥的额度，使用仍消耗账户余额。完整密钥不要放进截图或公开代码。

示例中用到 MODEL_ID 时，替换为该分组可用的完整模型名称；用到 YOUR_API_KEY 时，替换为完整密钥。

配置 Codex

选择支持 Responses 接口的模型。

在终端打开用户配置文件。文件夹不存在时，下面的命令会创建它。

macOS / LinuxWindows PowerShell

bash

mkdir -p ~/.codex
nano ~/.codex/config.toml

powershell

New-Item -ItemType Directory -Force "$env:USERPROFILE\.codex" | Out-Null
notepad "$env:USERPROFILE\.codex\config.toml"

文件为空时，粘贴下面的全部内容，把 MODEL_ID 换成刚确认的完整模型名称。

toml

model_provider = "wegoo"
model = "MODEL_ID"

[model_providers.wegoo]
name = "Wegoo"
base_url = "https://ai.wegoo.site/v1"
wire_api = "responses"
env_key = "WEGOO_API_KEY"

文件已有内容时： 先另存一份备份。将文件顶部、第一个 [章节名] 之前的 model_provider 和 model 改成示例中的值；没有这两项就加在顶部。已有 [model_providers.wegoo] 时修改该节的对应字段，没有时将这一节加到文件末尾。其他设置保留，每个同名字段只写一次。

在 nano 中按 Ctrl+O、回车保存，再按 Ctrl+X 退出。记事本中保存为 config.toml，选择 所有文件和 UTF-8，确认文件名没有多出 .txt。

在同一终端设置密钥并启动：

macOS / LinuxWindows PowerShell

bash

export WEGOO_API_KEY="YOUR_API_KEY"
codex

powershell

$env:WEGOO_API_KEY = "YOUR_API_KEY"
codex

环境变量只对当前终端及其启动的程序生效。配置中的模型可用时优先选择 gpt-6-astra，其次 gpt-5.6-sol。

字段依据 Codex 官方配置参考。

配置 Claude Code

选择支持 Claude Messages 接口的模型。

编辑用户目录的 .claude/settings.json，Windows 对应 %USERPROFILE%\.claude\settings.json。已有文件时合并 env 字段，保留其他设置：

json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai.wegoo.site",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_MODEL": "MODEL_ID"
  }
}

重新打开终端运行 claude。分组若限制客户端类型，请使用其允许的客户端。配置文件含完整密钥，请保存在用户目录，勿提交到项目仓库。

配置完成后，重新打开扩展或编辑器。通过环境变量设置密钥时，先退出原有 VS Code 进程，再从设置好变量的终端执行 code .，确保它能读取密钥。

在编辑器中使用 Wegoo ​

1. 连接 Wegoo ​

2. 使用 VS Code 扩展 ​

3. 使用 Cursor 或 Windsurf 终端 ​

配置排查 ​

macOS、Linux 和远程环境 ​