# 工具兼容总览

> **最后核实**：2026-09-18 · 📄 依据官方文档（下表 26 个工具页同日逐页核实，协议能力推导自 [接入点与 API 格式](/docs/getting-started/endpoints-and-api-paths)）

## 怎么用这张表

四条协议腿与模型家族的关系是：**Claude 系只能走 Anthropic 腿（Base URL `https://api.qcode.cc/api`）**；GPT 系走 OpenAI 的 Chat（`https://api.qcode.cc/openai/v1`）与 Responses 腿；GLM / Kimi / DeepSeek / Qwen 等国产模型走 Anthropic 或 OpenAI Chat 腿；Gemini 系走 Gemini 原生腿。工具只支持 OpenAI 协议 ⇒ 在 QCode 上**用不了 Claude**。「Claude」列即按此推导，逐页细节以各工具页为准。

## 兼容矩阵

| 工具 | 支持的协议 | Claude | 配置位置 | 最后核实 | 文档 |
|---|---|:--:|---|---|---|
| CC Switch | 管理上述 CLI 的全部配置 | ✅ | 应用内（写入 `~/.claude/`、`~/.codex/`） | 2026-09-18 | [CC Switch](/docs/ide/cc-switch) |
| Codex CLI | OpenAI Responses / Chat | ❌ | `~/.codex/config.toml` | 2026-09-18 | [Codex](/docs/ide/codex) |
| Claude Desktop | Anthropic | ✅ | 应用内 Configure Third-Party Inference | 2026-09-18 | [Claude Desktop](/docs/ide/claude-desktop) |
| OpenCode | Anthropic / OpenAI / Gemini | ✅ | `~/.config/opencode/opencode.json` | 2026-09-18 | [OpenCode](/docs/ide/opencode) |
| OpenClaw | Anthropic / OpenAI Chat / Responses | ✅ | `~/.openclaw/openclaw.json` | 2026-09-18 | [OpenClaw](/docs/ide/openclaw) |
| Hermes Agent | Anthropic / OpenAI Chat / Responses | ✅ | `~/.hermes/config.yaml` | 2026-09-18 | [Hermes Agent](/docs/ide/hermes-agent) |
| WorkBuddy | 仅 OpenAI Chat | ❌ | 应用内自定义模型 | 2026-09-18 | [WorkBuddy](/docs/ide/workbuddy) |
| Antigravity CLI | Gemini 原生 | ❌ | settings.json + 环境变量 | 2026-09-18 | [Antigravity](/docs/ide/antigravity) |
| CodeWhale（原 DeepSeek-TUI） | Anthropic / OpenAI Chat | ✅ | `~/.codewhale/config.toml` | 2026-09-18 | [CodeWhale](/docs/ide/deepseek-tui) |
| Zed | ACP / Anthropic 兼容 / OpenAI 兼容 | ✅ | `settings.json`（language_models） | 2026-09-18 | [Zed](/docs/ide/zed) |
| ACP 宿主（通用路径） | 取决于挂载的 agent | ✅ | agent 自身的环境变量/配置 | 2026-09-18 | [ACP 总览](/docs/ide/acp) |
| VS Code | 视扩展：Claude Code 扩展（Anthropic）、Copilot 自定义端点（三协议） | ✅ | `~/.claude/config.json` / `chatLanguageModels.json` | 2026-09-18 | [VS Code](/docs/ide/vscode) |
| GitHub Copilot（VS Code / CLI） | Messages / Chat Completions / Responses | ✅ | `chatLanguageModels.json` / 环境变量 | 2026-09-18 | [GitHub Copilot](/docs/ide/github-copilot) |
| Trae | 内置自定义模型：Anthropic Messages / OpenAI Chat Completions；另有 Claude Code 扩展 | ✅ | 设置 → 模型（添加模型）/ 扩展设置 + `~/.claude/` | 2026-09-18 | [Trae](/docs/ide/trae) |
| Cursor | Override OpenAI / Anthropic Base URL（帮助中心未列该字段，官方论坛由 Cursor 员工确认存在） | ✅ | Settings → Models → API Keys | 2026-09-18 | [Cursor](/docs/ide/cursor) |
| Cline | Anthropic / OpenAI Compatible | ✅ | 扩展设置面板 | 2026-09-18 | [Cline](/docs/ide/cline) |
| Cherry Studio | OpenAI / Anthropic / Responses / Gemini | ✅ | 设置 → 模型服务 | 2026-09-18 | [Cherry Studio](/docs/ide/cherry-studio) |
| JetBrains IDE | Claude Code 插件（Anthropic） | ✅ | `claude` CLI 配置共享 | 2026-09-18 | [JetBrains](/docs/ide/jetbrains) |
| Devin Desktop（原 Windsurf） | ACP 挂 Claude Code | ✅ | 宿主设置 + agent 环境变量 | 2026-09-18 | [Devin Desktop](/docs/ide/devin-desktop) |
| Gemini CLI（企业付费） | Gemini 原生 | ❌ | 环境变量 base URL | 2026-09-18 | [Gemini CLI](/docs/ide/gemini) |
| Kilo Code | Provider API：Anthropic Messages / OpenAI Compatible / OpenAI Responses | ✅ | 设置 → Providers → Custom provider | 2026-09-18 | [Kilo Code](/docs/ide/kilo-code) |
| Crush | Anthropic / OpenAI | ✅ | `~/.config/crush/crush.json` | 2026-09-18 | [Crush](/docs/ide/crush) |
| Droid（Factory） | Anthropic / OpenAI | ✅ | `~/.factory/settings.json` | 2026-09-18 | [Droid](/docs/ide/droid) |
| Aider | Anthropic / OpenAI（LiteLLM 路由） | ✅ | CLI 参数 / `~/.aider.conf.yml` | 2026-09-18 | [Aider](/docs/ide/aider) |
| SillyTavern | Anthropic Messages（反向代理地址）+ OpenAI 兼容 | ✅ | 应用内 API 连接设置 | 2026-09-18 | [SillyTavern](/docs/ide/sillytavern) |
| Roo Code | Anthropic / OpenAI（仓库已归档） | ✅ | 扩展设置面板 | 2026-09-18 | [Roo Code](/docs/ide/roo-code) |

## 不支持自定义端点的工具

以下产品**没有**可填任意 Base URL 的入口，无法接 QCode，我们不为它们写接入指南：

- **Qoder**：只接官方目录内厂商 key，不能填任意第三方 Base URL（[官方文档](https://docs.qoder.com/ja/user-guide/chat/custom-models)）。
- **Devin 云端版**：闭源 SaaS，无自定义 Base URL。本地桌面的 Devin Desktop 走 ACP 路径，见上表。
- **iFlow CLI**：官方已于 2026-04-17 停止服务。

## 能填自定义地址、但我们暂未出单页的工具

- **Junie**（JetBrains 的 agent）：IDE 内的 BYOK 确实只列 OpenAI / Anthropic / Google / xAI / OpenRouter / Copilot 这些固定厂商（[官方页](https://junie.jetbrains.com/docs/byok.html)），但 **Junie CLI 的自定义模型 profile 可以填任意 `baseUrl`**：JSON 文件放在 `$JUNIE_HOME/models/*.json` 或项目内的 `.junie/models/*.json`，`apiType` 取 `Anthropic` / `OpenAICompletion` / `OpenAIResponses` / `Google` 之一（[官方文档](https://junie.jetbrains.com/docs/custom-llm-models.html)）。它的 `baseUrl` 要写成**完整的请求地址**，Junie 不会补路径。我们暂未为它写单页，端点与模型 id 见 [接入点与 API 格式](/docs/getting-started/endpoints-and-api-paths)。

## 只能用 GPT / 国产、用不了 Claude 的工具

只实现 OpenAI Chat Completions 协议的客户端，在 QCode 上能正常用 GPT 系与 GLM / Kimi / DeepSeek / Qwen，但调 Claude 模型会直接收到 `model_not_available_on_endpoint`（该校验在鉴权之前）。上表中 Claude 列为 ❌ 的工具都属于此类（WorkBuddy、Codex 等）。此外：**CodeBuddy** 的 `models.json` 只支持 OpenAI Chat 且要写完整 `/chat/completions` 地址；**Warp** 的自定义推理端点只支持 OpenAI Chat，且请求经 Warp 服务器转发；**Chatbox** 以 OpenAI 兼容接口为主，同样接不了 Claude 模型。

## 相关文档

- [接入点与 API 格式](/docs/getting-started/endpoints-and-api-paths) —— 协议 × 模型家族真源
- [订阅、官方 API 与 QCode Key](/docs/reference/subscription-vs-api-key)
- [故障排查指南](/docs/reference/troubleshooting)
- [常见问题 FAQ](/docs/reference/faq)