工具接入

这一组文档用于把 DouDi 接入常见客户端、代码工具、编辑器、自部署服务和 SDK。第一次配置不要同时改很多软件，先选一个目标工具，把 Key、Base URL、模型名跑通，再扩展到第二个工具。

新手先看

怎么选择工具

按聊天、写代码、VS Code、自部署和 SDK 场景选择入口。

创建 API Key

为每个软件单独创建 Key，方便限额、停用和排查消耗。

OpenAI Compatible

先弄懂 Base URL、API Key、Model 三个核心字段。

接入失败排查

按状态码、模型名、分组、接口格式和客户端差异定位。

通用填写规则

除非单页特别说明，OpenAI 兼容配置默认填写：

配置项	推荐值
Base URL	https://doudi.ai/v1
API Key	DouDi 控制台令牌页创建的 Key
模型名	从 DouDi 控制台复制完整模型 ID

部分客户端会自动补 /v1/chat/completions，因此它们只需要填写 https://doudi.ai。这类差异会写在对应教程里；不要把一个软件的地址规则照搬到另一个软件。

按场景进入

我想聊天、翻译、总结优先看 Chatbox、Cherry Studio、LobeHub、OpenCat 或 NextChat。

我想写代码、改项目优先看 Claude Code、Codex CLI、OpenCode、Trae、CodeBuddy、Zed Editor。

我在 VS Code 里工作优先看 Cline。GitHub Copilot 不能直接填写 DouDi Key。

工具矩阵

Claude Code终端里的代码协作，适合项目修改和命令行工作流。Codex CLI通过 config.toml 接入 DouDi provider 和 Responses API。OpenCode桌面端代码智能体，自定义提供商和模型配置。CC Switch切换 Codex / Responses 相关供应商配置。Claude CoworksClaude Desktop 第三方推理网关配置。Cherry Studio图形界面管理多个服务商、模型和默认会话。Chatbox日常聊天、翻译、总结和轻量代码问答。BotGem桌面聊天客户端，通过 Other Provider 接入。ClineVS Code 内的 OpenAI Compatible Agent 配置。Cursor编辑器内自定义 Base URL 或兼容 Provider。Zed Editor通过 AI provider 和 settings.json 管理模型。Trae自定义 OpenAI 兼容模型，适合代码问答和项目辅助。CodeBuddyIDE 模型面板中的自定义 API 模型。WorkBuddy通过本地模型配置文件接入 OpenAI 兼容协议。LobeHub / LobeChat网页聊天、自部署聊天入口和默认服务模型配置。NextChat轻量网页聊天、自部署入口和兼容 API 配置。OpenCat桌面或移动端客户端的 API Host 与模型配置。Open WebUI团队或个人自建网页聊天入口。LangChain / SDK脚本、应用后端、机器人和批量任务接入。LlamaIndex / SDK知识库、RAG 和索引应用。OpenClaw智能体类工具的自定义模型服务入口。GitHub Copilot说明官方 Copilot 为什么不能直接填写 DouDi Key。Hermes / OpenClaw 403代理、网关、权限和状态码排查。

全部教程

基础与排查

教程	适合场景
怎么选择工具	不确定该配置哪个软件
OpenAI Compatible	自写脚本、通用客户端、先验证 Key
工具接入常见问题排查	401、403、404、429、Reconnect、模型不存在

代码与 Agent 工具

工具	适合场景
Claude Code	Claude Code 工作流、命令行代码协作
Claude Coworks	Claude Desktop 第三方推理网关配置
Codex CLI	Codex 命令行、Responses API、自定义 provider
OpenCode	桌面端代码智能体、自定义提供商
CC Switch	切换 Codex / Responses 相关供应商配置
Zed Editor	Zed 编辑器内配置 AI provider
Trae	TraeCode 自定义 OpenAI 兼容模型
CodeBuddy	CodeBuddy IDE 自定义 API 模型
WorkBuddy	WorkBuddy 自定义模型配置

桌面聊天与网页客户端

工具	适合场景
Cherry Studio	图形界面管理多个 Provider 和模型
Chatbox	日常聊天、翻译、总结、代码问答
BotGem	桌面聊天客户端自定义服务商
LobeHub / LobeChat	网页聊天或自部署聊天入口
OpenCat	桌面 / 移动端客户端配置
NextChat	网页聊天、自部署或轻量客户端

编辑器、平台与特殊场景

教程	说明
Cline	VS Code 内使用 OpenAI Compatible Provider
Cursor	Cursor 自定义 Provider 或 Base URL 配置
GitHub Copilot	说明为什么官方 Copilot 不能直接接入 DouDi
Open WebUI	自建网页聊天入口或团队使用
OpenClaw	OpenClaw 相关配置入口
Hermes / OpenClaw 403	403、代理和网关问题排查
LangChain / SDK	代码框架、OpenAI SDK、脚本开发
LlamaIndex / SDK	知识库、RAG 和索引应用

配置前检查

• 已经在 DouDi 控制台创建专用 API Key。
• 已经复制当前账号可用的完整模型 ID。
• 已经确认当前教程要求填写的是 https://doudi.ai 还是 https://doudi.ai/v1。
• 第一次测试只发送一句短消息，成功后再做长上下文、文件上传或批量任务。
• 截图、提问和提交 Issue 前已经隐藏 API Key。