常见工具接入攻略
通过方格入口选择编程 CLI、桌面客户端或 SDK，并按工具完成配置。
打开统一配置引导：先选模型，再选协议与匹配密钥。各应用的导入、手动填写和高级配置均在此完成。
先选择你正在使用的工具，再打开对应的详细指南。每张卡片都包含适用场景和下一步；桌面端会以两列方格展示，手机端会自动变为单列。
编程 CLI 工具
推荐：CC Switch
用图形界面管理 Claude Code、Codex 等服务商配置，可从 Toodoo AI API 密钥页一键导入。
Claude Code
用 Anthropic Messages 兼容入口在终端中进行代码理解、编辑和工具调用。
Codex CLI
在 config.toml 中添加自定义 Responses 服务商，适合希望保留 Codex 原生工作流的用户。
OpenCode
通过 OpenAI Compatible Provider 配置模型、服务商 ID 和 opencode.json。
Zcode
在 Zcode 的模型设置中添加自定义 OpenAI 兼容服务商。
客户端与工具
Cherry Studio
在桌面模型服务商设置中添加 Toodoo AI，适合直接进行多模型对话。
Trae Work
使用自定义模型和完整请求 URL，在工作区中调用 OpenAI Chat Completions。
Workbuddy
按当前版本的模型设置入口添加自定义服务商，并区分 Base URL 与完整端点。
SDK 接入
OpenAI SDK
在 Python 服务端程序中调用 OpenAI Chat Completions 兼容接口。
Anthropic SDK
通过 Anthropic Messages 接口调用支持该协议的模型。
所有工具都需要的三项配置
| 配置项 | 应该填写什么 | 常见错误 |
|---|---|---|
| Base URL | 按协议选择 https://toodooai.com/v1 或 https://toodooai.com。 | 把完整 /chat/completions 或 /messages 路径填进只接受 Base URL 的字段。 |
| API 密钥 | 在 Toodoo AI 创建的独立密钥。 | 把网页登录密码、带空格的复制内容或另一枚已停用密钥填入。 |
| 模型 ID | 从 GET /v1/models 或控制台复制的完整 ID。 | 只填写显示名称、删掉渠道前缀，或选择不属于当前分组的模型。 |
选择方式
- 需要一次配置多个编程工具：优先阅读 CC Switch。
- 只使用 Claude Code：阅读 Claude Code，Base URL 不要附加
/v1。 - 只使用 Codex CLI：阅读 Codex CLI，确认目标模型支持 Responses。
- 使用 OpenCode 或桌面客户端：阅读对应页面，确认工具实际要求的是 Base URL 还是完整请求 URL。
- 集成到后端服务：优先使用 SDK，并把密钥留在服务端，不要发送到浏览器。
验证顺序
- 先发送一句短文本，确认地址、密钥和模型 ID。
- 再尝试长上下文、图片、思考或工具调用等目标能力。
- 在 日志功能 中核对请求已到达，并记录状态码和用量。
基础文本请求成功，不等于当前模型支持目标工具的全部高级能力。遇到问题时，先用最小请求把平台问题与客户端问题分开。