# مرور سازگاری ابزارها

> **آخرین بازبینی**: 2026-09-18 · 📄 بر اساس مستندات رسمی (26 صفحه ابزار زیر در همان روز بازبینی شدند؛ قابلیت‌های پروتکل از [نقاط پایانی و مسیرهای API](/docs/getting-started/endpoints-and-api-paths) استخراج شده است)

> افزوده‌شده در 2026-10-13: پنج ردیف دیگر — Qwen Code، Kimi Code CLI، goose، LobeChat و Open WebUI. این‌ها در برابر مستندات رسمی هر ابزار بررسی شدند؛ هیچ کلید آزمایشی استفاده نشد، بنابراین هر کدام 📄 دارند (Kimi Code CLI از آن پس در 2026-11-10 با QCode آزمایش شده است؛ ردیف آن را ببینید). «26 صفحه ابزار» بالا به بازبینی 2026-09-18 اشاره دارد. magpie، T3 Code و DeepSeek Harness بعداً اضافه شدند، و ZCode، Qoder، CodeBuddy، MiniMax Code، LobsterAI و AutoClaw در 2026-11-10 (تاریخ‌های آخرین بازبینی آن‌ها را ببینید؛ ✅ در آن ستون نسخه آزمایش‌شده با QCode را نشان می‌دهد)؛ اکنون جدول 40 ردیف دارد.

## چگونه این جدول را بخوانیم

قاعده سه پروتکل این است: **مدل‌های 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 استفاده می‌کنند؛ QCode در حال حاضر مدل‌های Gemini را ارائه نمی‌دهد. کلاینتی که فقط پروتکل OpenAI را پیاده‌سازی می‌کند **نمی‌تواند از Claude در QCode استفاده کند**. ستون «Claude» دقیقاً از همان استنتاج پیروی می‌کند؛ جزئیات در صفحه هر ابزار آمده است.

## ماتریس سازگاری

| ابزار | پروتکل‌های پشتیبانی‌شده | Claude | محل پیکربندی | آخرین بازبینی | مستندات |
|---|---|:--:|---|---|---|
| CC Switch | همه پیکربندی‌های CLI بالا را مدیریت می‌کند | ✅ | در خود برنامه (فایل‌های `~/.claude/`، `~/.codex/` را می‌نویسد) | 2026-11-09 | [CC Switch](/docs/ide/cc-switch) |
| magpie | Anthropic / OpenAI Chat / Responses (دروازه محلی 127.0.0.1:3425) | ✅ | `magpie provider add` یا یک لینک واردکردن؛ magpie فایل‌های `~/.claude/settings.json`، `~/.codex/config.toml` را می‌نویسد | 2026-11-10 (✅ 0.1.3533 آزمایش‌شده) | [magpie](/docs/ide/magpie) |
| Codex CLI | OpenAI Responses / Chat | ❌ | `~/.codex/config.toml` | 2026-09-18 | [Codex](/docs/ide/codex) |
| Claude Desktop | Anthropic | ✅ | در خود برنامه: پیکربندی استنتاج شخص ثالث | 2026-09-18 | [Claude Desktop](/docs/ide/claude-desktop) |
| OpenCode | Anthropic / OpenAI | ✅ | `~/.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) |
| LobsterAI (NetEase Youdao) | سازگار با Anthropic (Messages) / سازگار با OpenAI (Chat Completions، Responses) | ✅ | در خود برنامه: تنظیمات → مدل سفارشی → + افزودن سفارشی | 2026-11-10 | [LobsterAI](/docs/ide/lobsterai) |
| AutoClaw (Zhipu) | فقط OpenAI Chat | ❌ | در خود برنامه: تنظیمات → مدل‌ها و API → افزودن مدل سفارشی | 2026-11-10 | [AutoClaw](/docs/ide/autoclaw) |
| Hermes Agent | Anthropic / OpenAI Chat / Responses | ✅ | `~/.hermes/config.yaml` | 2026-09-18 | [Hermes Agent](/docs/ide/hermes-agent) |
| WorkBuddy | فقط OpenAI Chat (مسیر کامل `https://api.qcode.cc/openai/v1/chat/completions`) | ❌ | مدل سفارشی درون برنامه (چین: `workbuddy/models.json`؛ بین‌المللی: `~/.workbuddy-ai/models.json`) | 2026-11-10 | [WorkBuddy](/docs/ide/workbuddy) |
| CodeBuddy (IDE / CLI) | OpenAI Chat (CLI نیز Responses) | ❌ | `~/.codebuddy/models.json` (پروژه: `<project-root>/.codebuddy/models.json`)؛ CLI نیز `CODEBUDDY_BASE_URL` | 2026-11-10 (✅ CLI 2.182.0 آزمایش‌شده) | [CodeBuddy](/docs/ide/codebuddy) |
| 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 (مسیر عمومی) | بستگی به عامل متصل‌شده دارد | ✅ | متغیرهای محیطی / پیکربندی خود عامل | 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) |
| ZCode (Zhipu، دسکتاپ + CLI) | Anthropic / OpenAI Chat / Responses (Responses: فقط CLI) | ✅ | دسکتاپ: تنظیمات -> تنظیمات مدل → افزودن ارائه‌دهنده؛ CLI: `~/.zcode/v2/provider_config.json` | 2026-11-10 (✅ CLI 0.17.1 آزمایش‌شده) | [ZCode](/docs/ide/zcode) |
| Qoder (دسکتاپ / CLI) | سازگار با Anthropic / سازگار با OpenAI (Chat Completions API یا Responses API) | ✅ | تنظیمات دسکتاپ → مدل‌ها → افزودن مدل → سفارشی؛ CLI: `/model` → سفارشی | 2026-11-10 | [Qoder](/docs/ide/qoder) |
| Cursor | بازنویسی Base URL OpenAI / Anthropic (فیلدهایی که در مرکز راهنما فهرست نشده‌اند؛ کارکنان Cursor در انجمن رسمی تأیید کرده‌اند) | ✅ | تنظیمات → مدل‌ها → کلیدهای API | 2026-09-18 | [Cursor](/docs/ide/cursor) |
| Cline | Anthropic / سازگار با OpenAI | ✅ | پنل تنظیمات افزونه | 2026-09-18 | [Cline](/docs/ide/cline) |
| Cherry Studio | OpenAI / Anthropic / Responses | ✅ | تنظیمات → سرویس‌های مدل | 2026-09-18 | [Cherry Studio](/docs/ide/cherry-studio) |
| IDE‌های JetBrains | افزونه Claude Code (Anthropic) | ✅ | مشترک با پیکربندی CLI `claude` | 2026-09-18 | [JetBrains](/docs/ide/jetbrains) |
| Devin Desktop (پیش‌تر Windsurf) | میزبانی ACP برای Claude Code | ✅ | تنظیمات میزبان + متغیرهای محیطی عامل | 2026-09-18 | [Devin Desktop](/docs/ide/devin-desktop) |
| Gemini CLI (سازمانی پولی) | Gemini بومی | ❌ | Base URL در متغیر محیطی | 2026-09-18 | [Gemini CLI](/docs/ide/gemini) |
| Kilo Code | API ارائه‌دهنده: Anthropic Messages / سازگار با OpenAI / OpenAI Responses | ✅ | تنظیمات → ارائه‌دهندگان → ارائه‌دهنده سفارشی | 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 (URL پروکسی) + سازگار با OpenAI | ✅ | تنظیمات اتصال API درون برنامه | 2026-09-18 | [SillyTavern](/docs/ide/sillytavern) |
| Roo Code | Anthropic / OpenAI (مخزن بایگانی شده) | ✅ | پنل تنظیمات افزونه | 2026-09-18 | [Roo Code](/docs/ide/roo-code) |
| Qwen Code | سازگار با Anthropic / OpenAI | ✅ | `~/.qwen/settings.json` (`modelProviders`) | 2026-10-13 | [Qwen Code](/docs/ide/qwen-code) |
| Kimi Code CLI | Anthropic Messages / OpenAI Chat / OpenAI Responses | ✅ | `~/.kimi-code/config.toml` (`[providers.<name>]`) | 2026-11-10 (✅ 2.5.2 آزمایش‌شده) | [Kimi Code CLI](/docs/ide/kimi-code) |
| MiniMax Code (دسکتاپ / mcode CLI) | Anthropic Messages / OpenAI Chat / OpenAI Responses | ✅ | CLI: `mcode provider add` (فایل `~/.minimax/config.yaml` را می‌نویسد)؛ دسکتاپ: تنظیمات → مصرف و مدل → افزودن مدل | 2026-11-10 (✅ mcode 0.7.6 آزمایش‌شده) | [MiniMax Code](/docs/ide/minimax-code) |
| goose | سازگار با Anthropic / OpenAI / Ollama (ارائه‌دهنده سفارشی) | ✅ | `goose configure`؛ `ANTHROPIC_HOST`، `OPENAI_HOST` + `OPENAI_BASE_PATH` | 2026-10-13 | [goose](/docs/ide/goose) |
| LobeChat | سازگار با Anthropic / OpenAI (URL پروکسی) | ✅ | تنظیمات برنامه → ارائه‌دهندگان هوش مصنوعی؛ میزبانی شخصی با `ANTHROPIC_PROXY_URL`، `OPENAI_PROXY_URL` | 2026-10-13 | [LobeChat](/docs/ide/lobechat) |
| Open WebUI | فقط OpenAI Chat Completions | ❌ | تنظیمات → مدیریت → اتصال‌ها؛ `OPENAI_API_BASE_URL` | 2026-10-13 | [Open WebUI](/docs/ide/open-webui) |
| T3 Code | Anthropic (نمونه Claude) | ✅ | تنظیمات > ارائه‌دهندگان → متغیرهای محیطی | 2026-11-09 | [T3 Code](/docs/ide/t3code) |
| DeepSeek Harness (dsh) | Anthropic / OpenAI Chat | ✅ | تنظیمات → مدل‌ها → API مدل سفارشی | 2026-11-09 | [dsh](/docs/ide/deepseek-harness) |

## ابزارهایی که نمی‌توانند نقطه پایانی سفارشی بگیرند

این محصولات **هیچ** فیلدی برای Base URL دلخواه ارائه نمی‌دهند؛ بنابراین QCode را نمی‌توان به آن‌ها متصل کرد و ما هیچ راهنمای راه‌اندازی‌ای برای آن‌ها منتشر نمی‌کنیم:

- **Qoder IDE**: صفحه مدل‌های سفارشی آن فقط ارائه‌دهندگان از پیش تعیین‌شده را فهرست می‌کند (Alibaba Cloud Model Studio، DeepSeek، Z.ai، Kimi، MiniMax، Xiaomi MIMO) و فیلدی برای Base URL سفارشی ندارد ([مستندات رسمی](https://docs.qoder.com/user-guide/chat/custom-models)). برنامه دسکتاپ Qoder و Qoder CLI از همین خانواده Base URL سفارشی را می‌پذیرند؛ جدول بالا و [Qoder](/docs/ide/qoder) را ببینید.
- **Devin (cloud)**: سرویس SaaS بسته، بدون Base URL سفارشی؛ Devin Desktop دسکتاپ از مسیر ACP استفاده می‌کند (در جدول).
- **iFlow CLI**: در تاریخ 2026-04-17 توسط ارائه‌دهنده‌اش متوقف شد.

## URL سفارشی را می‌پذیرد، اما هنوز صفحه‌ای ندارد

- **Junie** (عامل JetBrains): قابلیت BYOK درون IDE فقط ارائه‌دهندگان ثابت را فهرست می‌کند — OpenAI / Anthropic / Google / xAI / OpenRouter / Copilot ([صفحه رسمی](https://junie.jetbrains.com/docs/byok.html)) — اما **پروفایل‌های مدل سفارشی در Junie CLI هر `baseUrl`‌ای را می‌پذیرند**: فایل JSON در `$JUNIE_HOME/models/*.json` یا `.junie/models/*.json` پروژه قرار می‌گیرد و `apiType` یکی از `Anthropic` / `OpenAICompletion` / `OpenAIResponses` / `Google` است ([مستندات رسمی](https://junie.jetbrains.com/docs/custom-llm-models.html)). مقدار `baseUrl` آن باید **URL کامل درخواست** باشد — Junie هیچ مسیری اضافه نمی‌کند. ما هنوز صفحه اختصاصی‌ای برای آن ننوشته‌ایم؛ نقاط پایانی و شناسه‌های مدل در [نقاط پایانی و قالب‌های API](/docs/getting-started/endpoints-and-api-paths) آمده است.

## فقط مدل‌های GPT / چینی، بدون Claude

کلاینت‌هایی که تنها پروتکل OpenAI Chat Completions را پیاده‌سازی می‌کنند با GPT و خانواده‌های GLM / Kimi / DeepSeek / Qwen درست کار می‌کنند، اما فراخوانی مدل‌های Claude خطای `model_not_available_on_endpoint` را برمی‌گرداند (این بررسی پیش از احراز هویت انجام می‌شود). هر ردیفی که در ستون Claude علامت ❌ دارد از همین نوع است (WorkBuddy، CodeBuddy، AutoClaw، Codex…)؛ `models.json` در **CodeBuddy** به‌طور پیش‌فرض روی OpenAI Chat تنظیم شده و URL کامل `/chat/completions` را در `url` قرار می‌دهد و CLI آن نیز از Responses پشتیبانی می‌کند — [CodeBuddy](/docs/ide/codebuddy) را ببینید. همچنین: نقطه پایانی استنتاج سفارشی **Warp** فقط از OpenAI Chat پشتیبانی می‌کند و درخواست‌هایش از طریق سرورهای Warp رله می‌شوند؛ **Chatbox** بر پایه راهنمای کاربری رسمی‌اش در این گروه قرار گرفته است، راهنمایی که هنگام افزودن ارائه‌دهنده سفارشی تنها دو نوع API را نشان می‌دهد — سازگار با OpenAI API برای مدل‌های GPT و سازگار با Google Gemini برای مدل‌های Gemini. مستندات مخزن رسمی نیز `Claude` را به‌عنوان یکی از انواع API ارائه‌دهنده فهرست می‌کند (برچسب انگلیسی رابط کاربری «Claude API Compatible» است) و ورودی‌های سفارشی به `CustomClaude` نگاشت می‌شوند، اما هیچ‌یک از این دو منبع نمی‌گوید برای این نوع، API Host و API Path چگونه باید پر شوند؛ بنابراین این صفحه هیچ ادعایی درباره Claude از طریق Chatbox در هیچ جهتی مطرح نمی‌کند.

## مستندات مرتبط

- [نقاط پایانی و مسیرهای API](/docs/getting-started/endpoints-and-api-paths) — مرجع اصلی تطبیق پروتکل × خانواده مدل
- [اشتراک‌ها در برابر کلیدهای API در برابر کلیدهای QCode](/docs/reference/subscription-vs-api-key)
- [رفع اشکال](/docs/reference/troubleshooting)
- [پرسش‌های متداول](/docs/reference/faq)