ThreeRouter
使用教程

1. 打开 VS Code 后先选择任意项目文件夹进入工作区。
2. 打开左侧插件扩展界面进入扩展面板。
3. 搜索 "Codex"，出现结果后点击安装。
4. 安装完成后会出现 Codex 的图标。
5. 注意：若之前使用官方或其他平台登录过，请先退出登录，再进行重新配置！

使用官方终端：安装官方 Codex CLI 终端

npm i -g @openai/codex

不使用 CC Switch 配置方法（Windows）

配置 config.toml

创建 (如果不存在) 或编辑 C:\Users\{用户名}\.codex\config.toml：

model_provider = "Deepseek"
model = "deepseek-v4"
review_model = "deepseek-v4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.Deepseek]
name = "Deepseek"
base_url = "https://api.threerouter.com"
wire_api = "responses"
requires_openai_auth = true

配置 auth.json

创建 (如果不存在) 或编辑 C:\Users\{用户名}\.codex\auth.json：

{
  "OPENAI_API_KEY": "替换为您的API Key"
}

官方扩展目前走的是 Google Cloud (GCP) 路线，所以必须登录自己 Google 账号选择项目空间才可使用。因此不可使用官方扩展。

💻 使用官方终端：安装官方 Gemini CLI 终端

npm install -g @google/gemini-cli

不使用 CC Switch 配置方法（Windows）

配置 .env

创建 (如果不存在) 或编辑 C:\Users\{用户名}\.gemini\.env：

GEMINI_API_KEY=替换为您自己的API-KEY 【不要带引号等特殊符号】
GOOGLE_GEMINI_BASE_URL=https://api.threerouter.com

配置 settings.json

创建 (如果不存在) 或编辑 C:\Users\{用户名}\.gemini\settings.json：

{
  "security": {
    "auth": {
      "selectedType": "gemini-api-key"
    }
  }
}

OpenCode 比较特殊，适合没有固定使用模型的用户使用。目前官方扩展并不完善不推荐使用。

使用官方终端：安装官方 OpenCode CLI 终端

npm i -g opencode-ai

不使用 CC Switch 配置方法（Windows）

配置 opencode.json

创建 (如果不存在) 或编辑 C:\Users\{用户名}\.config\opencode\opencode.json：

{
  "provider": {
    "gemini": {
      "options": {
        "baseURL": "https://api.threerouter.com/v1beta",
        "apiKey": "替换为您自己的API-KEY"
      },
      "npm": "@ai-sdk/google",
      "models": {
        "deepseek-v4": {
          "name": "DeepSeek-V4",
          "limit": {
            "context": 1048576,
            "output": 65536
          },
          "modalities": {
            "input": ["text", "image"],
            "output": ["text"]
          }
        }
      }
    }
  },
  "$schema": "https://opencode.ai/config.json"
}

Trae 是一款支持多种 AI 模型的 IDE，可以通过以下步骤配置 ThreeRouter：

添加自定义模型

在 Trae 中添加自定义模型配置：

模型配置

配置 OpenAI 类型的模型连接：

配置完成后进行测试：

1. 打开 API 密钥界面，复制自己的 API-key。（一定要根据您需要的模型来选择不同的分组）
2. 打开小龙虾的配置文件：C:\Users\{用户名}\.openclaw\openclaw.json

"models": {
  "mode": "merge",
  "providers": {
    "unity2": {
      "baseUrl": "https://api.threerouter.com/v1",
      "apiKey": "替换为您的API-KEY",
      "api": "openai-completions",
      "models": [
        {
          "id": "deepseek-v4",
          "name": "deepseek-v4",
          "contextWindow": 200000,
          "maxTokens": 8192
        }
      ]
    }
  }
}

找到配置文件的 "models" 键，将里面的内容替换为上面的即可。一定不要动其他的配置内容。配置更改后，控制台输入 openclaw gateway restart 重启即可。

1. 打开 API 密钥界面，复制自己的 API-key。（一定要根据您需要的模型来选择不同的分组）
2. 打开爱马仕的配置文件：~/.hermes/config.yaml

model:
  default: deepseek-v4
  provider: custom
  base_url: "https://api.threerouter.com/v1"
  api_key: "输入您的API-KEY"

找到配置文件后，将 model 和 model 下的内容替换为上面的内容即可。不要动其他的，一定注意格式。保存后使用指令 hermes gateway restart 重启即可。

/compact [instructions]  # 您可以添加说明

# 恢复最近的对话
claude --continue

# 显示交互式对话选择器
claude --resume

> 我需要使用 OAuth2 为我们的 API 实现一个新的身份验证系统。深入思考在我们的代码库中实现这一点的最佳方法。

> 思考这种方法中潜在的安全漏洞

> 更深入地思考我们应该处理的边缘情况

CC Switch 切换模型方法

使用 CC Switch 可以方便地在不同模型之间切换，以下是两种常用的切换方法：

常见的斜杠命令

图像生成（生图）功能

ThreeRouter 支持通过 API 调用图像生成模型，以下是使用步骤：

步骤1：打开测试密钥页面，确认生图功能可用：

步骤2：发送生图请求，查看生成结果：

步骤3：使用 curl 脚本调用生图 API：

步骤4：使用 Python 脚本调用生图 API：

充值

充值入口功能：

邀请好友福利

邀请好友注册可获得额外奖励：

真假官方中转对比

以下是真官方中转和假官方中转的对比，帮助您识别可靠的中转服务：

真官方中转报错截图：

假官方中转不返回报错：

假官方中转照常对话：

npm安装教程

部分工具需要通过 npm 安装，以下是 npm 安装下载页面，

Window 系统：

下载地址：https://nodejs.org/en/download/

验证：打开一个新的控制台终端，输入:npm --version ,有输出版本号即安装完毕。

Macos / Linux 系统：

       # Download and install fnm:
curl -o- https://fnm.vercel.app/install | bash

# Download and install Node.js:
fnm install 24

# Verify the Node.js version:
node -v # Should print "v24.15.0".

# Verify npm version:
npm -v # Should print "11.12.1".

GPT-Image-2 图片生成

ThreeRouter 支持通过 OpenAI 提供的 OpenAI GPT-Image-2 图片生成能力。您可以使用标准的 OpenAI /v1/images/generations 接口调用。

支持的模型：

• gpt-image-2 - 文生图

账号配置

和别的大模型相同使用方式：

• Base URL： https://api.threerouter.com/v1/images/generations
• API Key： 您的 ThreeRouter API key密钥
• 模型白名单： gpt-image-2

文生图示例

curl -X POST "https://api.threerouter.com/v1/images/generations" \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "a cute cat astronaut on a pastel background"
  }'

返回格式

默认返回图片 URL。由于 ThreeRouter 返回的是 OSS 链接，部分浏览器可能因 Referer 限制无法直接访问，建议在服务端下载使用。

{
  "created": 1234567890,
  "data": [
    {
      "url": "https://img.oss-us-west-1.aliyuncs.com/images/xxx.png"
    }
  ]
}
curl -I -H "User-Agent: Mozilla/5.0" "https://img.oss-us-west-1.aliyuncs.com/images/zzz.png"

返回 Base64

如果前端无法直接访问 OSS 链接，可以设置 response_format 为 b64_json，返回图片的 base64 编码：

curl -X POST "https://api.threerouter.com/v1/images/generations" \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "a cute cat astronaut on a pastel background",
    "response_format": "b64_json"
  }'

注意事项

• 图片生成是异步任务，通常需要 30-90 秒，请耐心等待。
• 当前仅支持通过 /v1/images/generations 接口调用。
• 如果生图接口不接受返回值 url，可尝试使用 response_format 字段并设置为 b64_json，返回图片的 base64 编码。