工具接入指南
适用角色：开发者、主用户、子用户 更新日期：2026-07-15
本章介绍如何在主流 AI 编程工具和 Agent 平台中接入平台的 API，让你在熟悉的开发环境中直接使用平台提供的模型。
接入原理
平台的 API 兼容 OpenAI 和 Anthropic 两套协议。大多数 AI 工具只需要修改两个配置就能接入：
- Base URL -- 把请求指向平台的 API 地址（替换默认的
api.openai.com或api.anthropic.com） - API Key -- 填入你在平台控制台创建的 Key（
sk-开头）
配置完成后，工具发出的请求会自动转发到平台，由平台完成模型路由和调用。
你需要准备什么
在配置任何工具之前，请先准备好以下信息：
| 项目 | 说明 | 在哪获取 |
|---|---|---|
| API Key | sk- 开头的密钥 |
控制台「API 密钥」页创建 |
| Base URL | 平台的 API 地址 | 控制台「API 密钥」页查看 |
| 模型名称 | 你要调用的模型（如 claude-sonnet-4-6） |
控制台「调用指南」或「默认模型配置」页查看 |
支持的工具一览
AI 编程工具（IDE / CLI）
| 工具 | 类型 | 协议 | 能否接入 | 说明 |
|---|---|---|---|---|
| Claude Code | CLI Agent | Anthropic | 可以 | 改环境变量即可，最简单 |
| Cursor | IDE | OpenAI | 可以 | Settings 中配置 Base URL |
| Cline | VS Code 插件 | OpenAI | 可以 | 插件设置面板配置 |
| Windsurf | IDE | OpenAI | 部分支持 | 原生 BYOK 仅限 Anthropic；需通过 Roo Code 插件接入 |
| Codex CLI | CLI Agent | OpenAI | 可以 | 改环境变量 |
| Aider | CLI 工具 | OpenAI | 可以 | 启动参数或环境变量 |
| Continue | VS Code/JetBrains 插件 | OpenAI | 可以 | config.json 配置 |
AI Agent / 工作流平台
| 工具 | 类型 | 协议 | 能否接入 | 说明 |
|---|---|---|---|---|
| Dify | Agent 平台 | OpenAI | 可以 | 模型供应商设置中配置 |
| n8n | 工作流平台 | OpenAI | 可以 | AI Agent 节点配置 |
| Coze | Bot 平台 | OpenAI | 可以 | 自定义模型配置 |
| LangChain / LiteLLM | 开发框架 | OpenAI | 可以 | 代码中设置 base_url |
AI 桌面应用
| 工具 | 协议 | 能否接入 | 说明 |
|---|---|---|---|
| Claude Desktop | Anthropic | 可以 | 配置文件修改 apiBaseUrl |
| ChatGPT Desktop | OpenAI | 可以 | Settings 中配置 |
国产 AI 编程工具
| 工具 | 厂商 | 能否接入 | 原因 |
|---|---|---|---|
| Qoder | 阿里 | 不能 | BYOK 仅支持 Z.AI/Kimi/MiniMax/阿里百炼的 Coding Plan，不支持自定义 OpenAI 兼容端点 |
| Trae | 字节 | 不能 | 绑定自家模型后端，不开放自定义端点 |
| CodeBuddy | 腾讯 | 不能 | 绑定腾讯云 |
| 通义灵码 | 阿里 | 不能 | 插件形态，用自家 Qwen 后端 |
| CodeGeeX | 智谱 | 不能 | 用自家 GLM 模型 |
国产 AI 编程工具目前大多绑定自家模型后端，不支持接入第三方 API 平台。如果你使用这些工具，可以继续使用它们自带的模型；需要调用平台模型时，使用上方支持的工具即可。
通用注意事项
-
Base URL 格式：不同工具对 URL 尾部的
/v1处理不同。有的需要带（如https://your-domain.com/v1），有的不需要。每个工具的文档中会具体说明。 -
模型名称要准确：
model字段填写的名称必须和平台实际提供的一致。建议从控制台「调用指南」页直接复制，避免手动输入出错。 -
协议匹配：
- 使用 Anthropic 协议的工具（Claude Code、Claude Desktop）：Base URL 指向平台的 Anthropic 兼容端点
- 使用 OpenAI 协议的工具（Cursor、Cline 等）：Base URL 指向平台的 OpenAI 兼容端点
-
Token 消耗提醒：AI Agent 类工具（Claude Code、Cursor Agent 等）在每个推理步骤都会重新发送累积的上下文，相同工作量下消耗的 Token 是普通聊天的 10 到 100 倍。建议先小额测试，确认费用预期后再大量使用。
-
安全提醒：API Key 等同密码。不要把 Key 提交到代码仓库、粘贴到公开论坛，或通过不安全的渠道传输。