AI 编程工具接入指南
选择对应的 AI 编程工具，查看自定义模型服务的配置、使用与测试方法。
本文合并整理 OpenCode、Hermes、Cursor、VS Code GitHub Copilot、Claude Code、Codex App、CodeBuddy 和 Trae 的自定义模型接入方式，并包含 CC-Switch 辅助配置工具的使用方法。
不同工具所要求的接口协议可能不同。接入前应先确认模型服务提供的是 OpenAI Chat Completions、OpenAI Responses API、Anthropic Messages API，还是其他兼容协议。
安全提醒
API Key 相当于账号密码。请勿将真实 Key
写入公开文档、提交到代码仓库或发送给无关人员。本文中的
${YOUR_API_KEY} 和 ${YOUR_MODEL_ID}
等 ${...} 内容都是需要你替换的占位符；Base URL
已根据当前站点环境直接显示，无需自行猜测或替换。复制配置时，不要保留花括号和美元符号。
接入信息
开始测试前，请从模型服务平台获取以下信息：
直接获取接入信息
前往本站 API Key 管理 创建并复制 API Key；前往 模型广场 查看可用模型并复制模型 ID。
| 配置项 | 示例 | 说明 |
|---|---|---|
| API Base URL | https://api.do.top/v1 | 当前站点使用的模型服务地址，可直接复制 |
| API Key | ${YOUR_API_KEY} | 需替换为你在平台创建的访问密钥，不要原样填写 |
| 模型 ID | ${YOUR_MODEL_ID} | 替换为真实模型 ID，例如 GLM-5.2 或 Qwen3.6-27B |
| 工具类型 | CLI / 桌面版 | 不同客户端对自定义模型支持程度不同 |
| API 协议 | Chat Completions / Responses / Anthropic Messages | 必须与客户端调用方式兼容 |
测试结论概览
| 工具或组件 | 接入方式 | 本次整理结论 |
|---|---|---|
| OpenCode | CLI 配置文件、CLI 连接、桌面端自定义提供商 | 支持接入外部模型 |
| Hermes | 交互式命令或配置文件 | 支持 OpenAI Chat Completions 兼容服务 |
| Cursor | Models 页面配置 API Key、Base URL 和模型 ID | 支持，但功能入口可能受版本或账号权限影响 |
| VS Code GitHub Copilot | OAI Compatible Provider for Copilot 扩展 | 可通过扩展接入 OpenAI 兼容服务 |
| Claude Code | 环境变量、配置文件或桌面端第三方推理 | 存在协议、HTTPS 和 URL 自动拼接限制，需结合网关兼容性验证 |
| CC-Switch | 可视化管理和切换供应商配置 | 可用于辅助配置 Codex、Claude Code 等客户端 |
| Codex App | 通过 CC-Switch 配置 OpenAI Responses API 供应商 | 需要服务端支持 Responses API，或使用协议转换服务 |
| CodeBuddy | 客户端内置自定义提供商 | 支持填写 API 地址、密钥和模型名称 |
| Trae | 客户端内置自定义模型 | 支持 OpenAI 兼容格式；模型能力开关需按实际情况设置 |