工具接入指南
适用角色：开发者、主用户、子用户 更新日期：2026-08-06
第三方工具接入本平台时，关键是先判断它要求填写 Base URL，还是完整的请求地址。字段名称会随工具版本变化，但实际连接信息只有以下几项。
先准备这四项
| 配置项 | 填写内容 |
|---|---|
| API Key | 控制台创建的 sk- 开头 API Key |
| 模型调用名 | 从控制台「调用指南」复制，例如 deepseek-v4-flash |
| OpenAI Compatible Base URL | https://<接口地址> |
| Messages Compatible Base URL | https://<接口地址> |
以控制台「API Key」页展示的接口地址为准。
API Key 在控制台左侧「API Key」页创建。创建之后还要在「API Key → 编辑 → 路由分组」为它绑定分组：未绑定分组的 Key 用模型名称调用会直接返回 403，错误信息为 API Key is not assigned to any group and cannot be used.。
字段写着 Base URL、API Base 或 Provider URL 时，通常填写 Base URL。字段明确写着 Endpoint、Request URL 或完整接口地址时，OpenAI Compatible 请求填写：
https://<接口地址>/v1/chat/completionsMessages Compatible 请求填写：
https://<接口地址>/v1/messages不要把完整接口地址填进 Base URL 字段，否则客户端可能再次追加路径，形成重复端点。Base URL 统一使用上表中的根地址。
按使用方式选择教程
代码和终端
| 工具 | 接入方式 | 教程 |
|---|---|---|
| Claude Code | Messages Compatible | Claude Code |
| Codex CLI | 自定义 Provider | Codex CLI |
| Aider | OpenAI Compatible | Aider |
| OpenCode | OpenAI Compatible Provider | OpenCode |
| Qwen Code / CodeWhale | 视当前版本选择自定义 Provider | Qwen Code 与 CodeWhale |
| LangChain / LiteLLM | SDK 参数 | LangChain 与 LiteLLM |
IDE 和编码插件
| 工具 | 接入方式 | 教程 |
|---|---|---|
| Cursor | 自定义 OpenAI Base URL，受版本能力影响 | Cursor |
| Cline | OpenAI Compatible Provider | Cline |
| Roo Code / Kilo Code | OpenAI Compatible Provider | Roo Code / Kilo Code |
| Continue | 本地 YAML 配置 | Continue |
| Trae / Zed / Windsurf | 原生入口或兼容插件 | Trae、Zed 与 Windsurf |
对话、Agent 和工作流
| 类型 | 工具与教程 |
|---|---|
| 桌面与 Web 聊天 | Chatbox、Cherry Studio、Open WebUI、LobeChat 与 NextChat |
| 消息渠道与 Agent | ChatGPT-on-WeChat、OpenClaw、Hermes Agent |
| 应用和自动化 | Dify 与 Coze、n8n 与 Flowise |
| 网页翻译 | 沉浸式翻译 |
如何判断接入成功
先发送一条只包含短文本的请求，再检查控制台「使用记录」。记录中的 API Key、模型和分组与工具配置一致，说明请求已经经过本平台。
编码 Agent 还要增加一次工具调用测试，例如读取一个无敏感信息的文件。聊天正常而文件操作失败，通常说明连接已经成功，但模型能力、工具权限或客户端设置还需调整。
401 优先检查 Key；403 先确认 API Key 是否已绑定路由分组（未绑定分组是最常见成因），再检查 Key 状态、分组权限和计费来源；404 检查最终请求路径和模型调用名。详细处理见 错误码与排障。
本目录中的图片来自对应软件的实际界面。为适配本文，截图中的服务名称、接口地址和模型调用名已替换为本平台配置，API Key 等敏感信息已脱敏；菜单名称和位置可能随软件版本变化。