AI 编程工具接入指南

把主流 AI 编程工具的请求转发到 SuperRoute，享受国内直连 + 三档通道 + 统一计费。

为什么要接 SuperRoute？

档位 vs 模型关系（先看这个）

特殊场景：Claude Code 调用 GPT 模型

详见 CC Switch 章节 → 特殊场景。

CC Switch 统一配置（推荐）

CC Switch 是统一管理所有 AI 编程工具 API 配置的小工具。一次配置，Claude Code / Codex / JetBrains / Trae 等所有工具统一生效。

• 项目地址：https://github.com/farion1231/cc-switch

安装

前往 https://github.com/farion1231/cc-switch/releases 下载安装版或便携版

brew tap farion1231/ccswitch && brew install --cask cc-switch

brew tap farion1231/ccswitch && brew install cc-switch
# 也可以直接从 Releases 下载 AppImage / deb / rpm

通用配置流程（4 步）

渠道与模型对应关系

特殊场景：Claude Code 调 GPT 模型

如果你在 Claude Code 里使用 GPT 模型，请按照 SuperRoute 控制台为该 API Key 提供的协议配置客户端，并将 Base URL 填写为：https://api.superoute.uk。API Key 直接使用控制台生成的密钥，不要根据固定前缀判断。

CC Switch 常见问题

Claude Code

也支持手动配置。如果你不想装 CC Switch，直接看下面。

快速上手

# 设置环境变量（写入 ~/.bashrc 或 ~/.zshrc）
export ANTHROPIC_BASE_URL="https://api.superoute.uk"
export ANTHROPIC_API_KEY="在 SuperRoute 控制台生成的 API Key"

claude

配置参考（手动）

~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.superoute.uk",
    "ANTHROPIC_API_KEY": "在 SuperRoute 控制台生成的 API Key"
  },
  "model": "claude-sonnet-5"
}

桌面版

Anthropic 提供的桌面应用 Claude Code（macOS / Windows）。

设置 → Developer → Environment Variables 填入 ANTHROPIC_BASE_URL 和 ANTHROPIC_API_KEY。

进阶配置

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.superoute.uk",
    "ANTHROPIC_API_KEY": "在 SuperRoute 控制台生成的 API Key"
  },
  "model": "claude-sonnet-5",
  "max_tokens": 8000,
  "temperature": 1
}

Grok Search MCP（给 Claude Code 加联网搜索）

通过 MCP 把 Grok 搜索接到 Claude Code。

{
  "mcpServers": {
    "grok-search": {
      "command": "npx",
      "args": ["-y", "@xai/grok-search-mcp"],
      "env": {
        "XAI_API_KEY": "xai-xxxxxxxxxxxxxx"
      }
    }
  }
}

Codex CLI

也支持手动配置。如果你不想装 CC Switch，直接看下面。

快速上手

export OPENAI_BASE_URL="https://api.superoute.uk"
export OPENAI_API_KEY="在 SuperRoute 控制台生成的 API Key"
codex

配置参考（手动）

~/.codex/config.toml：

model = "gpt-5-6-luna"
model_provider = "superroute"

[model_providers.superroute]
base_url = "https://api.superoute.uk"

OpenClaw

OpenClaw 是本地 AI 代理网关，启动后有 Web UI，可以把 AI 模型接入飞书 / Telegram / Discord 渠道。

• 官方文档：https://docs.openclaw.ai/zh-CN
• Web UI：http://127.0.0.1:18789/

快速上手（推荐用 CC Switch）

npm install -g openclaw@latest
openclaw onboard --install-daemon

飞书渠道配置

把 OpenClaw 接到飞书机器人做通知 / 客服 / 群助手。完整 7 步：

测试连接

1. 在飞书里搜索你的机器人名字
2. 发一条消息
3. 机器人应该自动回复（通过 SuperRoute 转发的 Claude/GPT）

没回复？ 排查：

• 飞书「事件订阅」页面看「请求日志」是否有失败
• OpenClaw 日志（~/.openclaw/logs/）看是否有错
• 确认 App ID/Secret 没复制错

飞书侧运营建议

• 群聊使用：把机器人加到群，@机器人 即可对话（不需要私聊）
• 私聊使用：在飞书搜索机器人 → 发起对话
• 消息限制：飞书 API 有频率限制（每分钟 ~50 条），超了会被限流
• 图片/文件：飞书支持富媒体消息，OpenClaw 默认会转成文本（如果需要图片识别，配合 SuperRoute 的多模态能力）

完整文档以 OpenClaw 官方为准：https://docs.openclaw.ai/zh-CN

Cursor

AI-first IDE（VS Code fork）。

配置

Settings → Models → OpenAI API Key：

或编辑 ~/.cursor/settings.json：

{
  "cursor.aiProvider": "anthropic",
  "cursor.anthropicApiKey": "在 SuperRoute 控制台生成的 API Key",
  "cursor.anthropicBaseUrl": "https://api.superoute.uk",
  "cursor.defaultModel": "claude-sonnet-5"
}

Cline

VS Code 插件（开源可定制）。

配置

Cline → API Provider：

JetBrains 系列 IDE

IntelliJ IDEA、PyCharm、GoLand、WebStorm 等全家桶。

配置

1. Settings → Plugins → 装 AI Assistant
2. Settings → Tools → AI Assistant → Models → "+"
3. 选 Custom Provider，填：

Trae

字节跳动出品的 AI IDE，国内访问快、中文友好。

配置

1. 设置 → AI 模型 → 添加自定义提供商
2. 填：

外接调用 User-Agent 说明

用 CC Switch 不会出现这个坑。手动配置 OpenClaw / JetBrains / Trae 等外接工具时必须带 User-Agent，否则报 403。

常见 User-Agent 模板

配置位置

• CC Switch：选好供应商后自动填入
• OpenClaw / JetBrains / Trae：在 provider 高级设置里加 User-Agent Header
• 直接 SDK 调用：在 HTTP Header 里手动加

报 403 怎么办？

通用排查

相关页面