第三方工具接入

适用角色：开发者更新日期：2026-07-02

CloudRouter 兼容 OpenAI / Anthropic 协议，因此能接入绝大多数支持"自定义 Base URL"的 AI 工具与框架。本文按命令行工具 → AI 编程 IDE/插件 → 应用开发框架三类，给出主流工具的配置方法。

API 地址为 https://api.cloudrouter.online，路由前缀 /v1，认证用 Authorization: Bearer sk-xxx。

填写口径速记：绝大多数工具只需三件事——① Base URL 填 https://api.cloudrouter.online/v1；② API Key 填 CloudRouter 的 sk- 开头 Key（由组织在控制台创建并分发）；③ 模型名填调用指南页提供的调用名，裸名（如 claude-sonnet-4-6）或带指纹（如 5MHXZWKA/gpt-4o）均可，详见调用指南与双路由。 Anthropic 协议端点的真实路径是 /v1/messages：用官方 SDK 的工具（如 Claude Code）只需把 Base URL 填到域名根 https://api.cloudrouter.online，SDK 会自动补 /v1/messages；若工具要求直接填完整 Base URL，则填 https://api.cloudrouter.online/v1。本文未列出的工具，直接套用通用接入原则即可。

命令行工具（CLI）

一、Claude Code

Claude Code 是 Anthropic 官方 CLI 工具，通过环境变量注入 CloudRouter 配置。

在 shell 配置文件（~/.zshrc 或 ~/.bashrc）中设置：

bash

export ANTHROPIC_BASE_URL="https://api.cloudrouter.online"
export ANTHROPIC_API_KEY="YOUR_API_KEY"

保存后执行 source ~/.zshrc 生效，然后正常使用 claude 命令即可。

模型档位：Claude Code 中通过 /model 切换 Opus / Sonnet / Haiku 三档，CloudRouter 会按映射关系路由到对应模型，具体可用模型以控制台「调用指南」为准。

提示：价格请以「模型广场」或控制台「购买」页展示为准。

二、Codex CLI

OpenAI Codex CLI 走 OpenAI 兼容协议，通过环境变量配置：

bash

export OPENAI_BASE_URL="https://api.cloudrouter.online/v1"
export OPENAI_API_KEY="YOUR_API_KEY"

或在 ~/.codex/config.toml 中指定自定义 provider 的 base_url 与模型名，再以该 provider 启动。模型名见调用指南，裸名或带指纹均可。

三、Aider

Aider 原生支持 OpenAI 兼容端点，推荐用环境变量：

bash

export OPENAI_API_BASE="https://api.cloudrouter.online/v1"
export OPENAI_API_KEY="YOUR_API_KEY"

# 模型名加 openai/ 前缀走兼容端点
aider --model openai/claude-sonnet-4-6

也可用命令行开关 --openai-api-base / --openai-api-key，或写进 .aider.conf.yml。

⚠️ 关键点：指向兼容端点时，模型名必须加 openai/ 前缀，否则 Aider 会按内置 provider 解析。若用带指纹调用名，写法形如 openai/5MHXZWKA/gpt-4o（openai/ 由 Aider 用于选 provider、会被剥离后把 5MHXZWKA/gpt-4o 透传给 CloudRouter）。该三段写法建议先小流量实测；若指纹未生效，回退用裸名 openai/claude-sonnet-4-6（走这把 Key 绑定的路由分组）。

AI 编程 IDE / 插件

下列 VSCode 系插件（Cline / Roo Code / Kilo Code / Continue 等）配置高度一致：在「OpenAI Compatible / 自定义 provider」里填 Base URL + API Key + 模型调用名即可。模型调用名见调用指南，裸名或带指纹均可。

四、Cursor

Cursor 支持自定义 OpenAI API 配置。

打开 Cursor 设置 → Models
找到 OpenAI API Key 配置项，填入 CloudRouter 的 API Key
展开 Override OpenAI Base URL，填入：https://api.cloudrouter.online/v1
在模型列表中添加调用指南提供的调用名（裸名或带指纹均可），保存并验证连接

Cursor 与 VSCode 同源，配置体系一致。

五、Cline（VSCode 插件）

点击 Cline 面板右上角设置图标
API Provider 选择 OpenAI Compatible
Base URL 填 https://api.cloudrouter.online/v1
API Key 填 CloudRouter 的 Key
Model ID 填调用指南提供的调用名（如 claude-sonnet-4-6，或带指纹 5MHXZWKA/gpt-4o）

💡 若主要用 Claude 模型并希望完整的原生工具调用（读写文件、执行命令），也可把 Provider 选为 Anthropic，Base URL 填 https://api.cloudrouter.online（不带 /v1）。

六、Roo Code / Kilo Code（VSCode 插件）

两者均为 Cline 衍生，配置流程相同：

打开插件设置面板（齿轮图标）
API Provider 选 OpenAI Compatible
填 Base URL https://api.cloudrouter.online/v1、API Key、Model（调用名见调用指南，裸名或带指纹均可）
保存

⚠️ Roo Code 仅支持原生工具调用（native tool calling），请选择支持 tool calling 的模型。Kilo Code 的 Base URL 支持填完整路径（含 /chat/completions），更灵活。

七、Continue（VSCode / JetBrains 插件）

编辑 ~/.continue/config.yaml，把 CloudRouter 作为 provider: openai 的端点：

yaml

models:
  - name: CloudRouter Sonnet
    provider: openai
    model: claude-sonnet-4-6
    apiBase: https://api.cloudrouter.online/v1
    apiKey: YOUR_API_KEY
    roles:
      - chat
      - edit

model 处填调用指南提供的调用名（裸名或带指纹均可）。多个模型共用同一 Base URL / Key 时，可用 YAML 锚点（& / <<: *）减少重复。

八、Zed 编辑器

Zed 原生支持自定义 OpenAI 兼容 provider，编辑 settings.json：

json

{
  "language_models": {
    "openai_compatible": {
      "cloudrouter": {
        "api_url": "https://api.cloudrouter.online/v1",
        "available_models": [
          {
            "name": "claude-sonnet-4-6",
            "display_name": "CloudRouter Sonnet",
            "max_tokens": 128000
          }
        ]
      }
    }
  }
}

name 处填调用指南提供的调用名（裸名或带指纹均可）。API Key 在 provider 设置 UI 中填写（存入系统钥匙串），或设置环境变量 CLOUDROUTER_API_KEY（由 provider ID 大写加 _API_KEY 生成）。

⚠️ api_url 不要带结尾斜杠，且需正确包含 /v1。

九、Windsurf

Windsurf 原生 BYOK 仅支持 Anthropic 模型。若要接入 CloudRouter 的 OpenAI 兼容端点，推荐在 Windsurf 内安装 Cline / Roo Code / Continue 任一插件，再按上文对应章节配置 Base URL + Key 即可。

若你的 Windsurf 版本暴露了自定义 Base URL 输入框，则可直接填 https://api.cloudrouter.online/v1；若只接受官方 Key、无 Base URL 输入框，说明该版本仅支持官方 BYOK，需走插件方案。

十、其他 VSCode 系工具

Void、Tabby 等支持「OpenAI 兼容 provider / 自定义 Base URL」的编辑器，配置逻辑与上述插件一致：在其 provider 设置中填入 Base URL https://api.cloudrouter.online/v1、API Key 与模型调用名即可。

应用开发框架

十一、LangChain

用 ChatOpenAI 指向 CloudRouter：

python

from langchain_openai import ChatOpenAI

llm = ChatOpenAI(
    model="claude-sonnet-4-6",
    api_key="YOUR_API_KEY",
    base_url="https://api.cloudrouter.online/v1"
)

print(llm.invoke("你好").content)

安装：pip install langchain-openai

十二、LiteLLM

LiteLLM 把 CloudRouter 作为 OpenAI 兼容 provider：

python

import litellm

resp = litellm.completion(
    model="openai/claude-sonnet-4-6",          # openai/ 前缀走兼容端点
    api_key="YOUR_API_KEY",
    base_url="https://api.cloudrouter.online/v1",
    messages=[{"role": "user", "content": "你好"}]
)
print(resp.choices[0].message.content)

安装：pip install litellm

十三、Dify

Dify 中以「OpenAI-API-compatible」模型供应商接入：

进入 Dify → 设置 → 模型供应商
选择 OpenAI-API-compatible
填写：
- API Key：CloudRouter 的 Key
- API Base URL：https://api.cloudrouter.online/v1
- 模型名称：调用指南提供的调用名（如 claude-sonnet-4-6，或带指纹）
保存后即可在 Dify 应用中选用该模型

十四、n8n / 其他低代码平台

n8n、Flowise 等低代码/工作流平台多内置「OpenAI」或「OpenAI 兼容」节点，把节点凭据中的 Base URL 改为 https://api.cloudrouter.online/v1、API Key 填 CloudRouter 的 Key 即可，模型名填调用指南提供的调用名。

通用接入原则

任何支持以下配置的工具都能接入 CloudRouter：

配置项	填什么
API Base URL / 接口地址	OpenAI 协议填 `https://api.cloudrouter.online/v1`；Anthropic 协议端点为 `/v1/messages`（官方 SDK 填域名根，会自动补全）
API Key	CloudRouter 的 `sk-` 开头 Key（由组织在控制台创建并分发）
模型名称	控制台「调用指南」提供的调用名，裸名或带指纹均可
协议类型	选 "OpenAI 兼容" 或 "Anthropic 兼容"
认证 Header	`Authorization: Bearer sk-xxx`（也兼容 `x-api-key`、`x-goog-api-key`）

常见排查：

报 401 / Invalid API Key → 检查 Key 是否填错、是否带了多余空格
报 404 / Model Not Found → 检查模型调用名是否为调用指南中的有效调用名
带指纹报"分组不可达" → 该分组不在你的可用范围或当前不可用，见调用指南与双路由
连接失败 → 检查 Base URL 是否正确、是否漏写或多写 /v1、结尾是否多了斜杠

只需修改一个 API 地址和 Key，无需改动任何业务代码——这正是 CloudRouter 兼容性的价值。

下一步

搞清楚 model 字段写法 → 调用指南与双路由
遇到报错 → 错误码与排障
模型偶发输出外语 → Claude 语言漂移说明

联系我们

电子邮箱：support_cloudrouter@clouditera.com
QQ 社群：712273971
平台网址：cloudrouter.online

第三方工具接入 ​

命令行工具（CLI） ​

一、Claude Code ​

二、Codex CLI ​

三、Aider ​

AI 编程 IDE / 插件 ​

四、Cursor ​

五、Cline（VSCode 插件） ​

六、Roo Code / Kilo Code（VSCode 插件） ​

七、Continue（VSCode / JetBrains 插件） ​

八、Zed 编辑器 ​

九、Windsurf ​

十、其他 VSCode 系工具 ​

应用开发框架 ​

十一、LangChain ​

十二、LiteLLM ​

十三、Dify ​

十四、n8n / 其他低代码平台 ​

通用接入原则 ​

下一步 ​

联系我们 ​

第三方工具接入

命令行工具（CLI）

一、Claude Code

二、Codex CLI

三、Aider

AI 编程 IDE / 插件

四、Cursor

五、Cline（VSCode 插件）

六、Roo Code / Kilo Code（VSCode 插件）

七、Continue（VSCode / JetBrains 插件）

八、Zed 编辑器

九、Windsurf

十、其他 VSCode 系工具

应用开发框架

十一、LangChain

十二、LiteLLM

十三、Dify

十四、n8n / 其他低代码平台

通用接入原则

下一步

联系我们