# راه‌اندازی Roo Code

> **⚠️ پروژه بایگانی‌شده**: مخزن GitHub [RooCodeInc/Roo-Code](https://github.com/RooCodeInc/Roo-Code) از تاریخ 2026-05-15 **بایگانی شده است (فقط‌خواندنی)** — هیچ به‌روزرسانی یا اصلاحی دیگر از سوی پروژه ارائه نمی‌شود. پیکربندی زیر هنوز برای نصب‌های موجود کار می‌کند و به‌عنوان مرجع است؛ برای یک پروژه خواهر که فعالانه نگهداری می‌شود، مهاجرت به [Kilo Code](/docs/ide/kilo-code) یا [Cline](/docs/ide/cline) را در نظر بگیرید.

> **آخرین بازبینی**: 2026-10-15 · 📄 بر اساس مستندات رسمی (وضعیت بایگانی از طریق GitHub API بررسی شده است؛ Roo Code دیگر نسخه‌ای منتشر نمی‌کند)

## در یک نگاه

| مورد | جزئیات |
|---|---|
| مدل‌های قابل استفاده | Claude ✅ (ارائه‌دهنده Anthropic + Base URL سفارشی) · GPT ✅ · مدل‌های چینی ✅ (سازگار با OpenAI) · Gemini ❌ |
| پروتکل و Base URL | Anthropic: `https://api.qcode.cc/api` · OpenAI: `https://api.qcode.cc/openai/v1` |
| محل پیکربندی | پنل تنظیمات افزونه VS Code (ارائه‌دهنده API / چک‌باکس Base URL) |
| مستندات رسمی | [مخزن Roo Code](https://github.com/RooCodeInc/Roo-Code) |

[Roo Code](https://github.com/RooCodeInc/Roo-Code) یک افزونه متن‌باز کدنویسی با هوش مصنوعی برای VS Code است که از [Cline](/docs/ide/cline) فورک شده است؛ [Kilo Code](/docs/ide/kilo-code) نیز به‌نوبه خود از آن فورک شده است — این سه، صفحه‌های تنظیمات تقریباً یکسانی دارند، بنابراین این صفحه بین آن‌ها قابل انتقال است.

## کدام پروتکل

| مدل موردنظر | ارائه‌دهنده API | Base URL |
|---|---|---|
| Claude | `Anthropic` | `https://api.qcode.cc/api` |
| GPT / چهار خانواده چینی | `OpenAI Compatible` | `https://api.qcode.cc/openai/v1` |

🔴 **از OpenAI Compatible برای دسترسی به Claude استفاده نکنید** — نقطه پایانی OpenAI در QCode مدل‌های Claude را با `model_not_available_on_endpoint` رد می‌کند. [نقاط پایانی و مسیرهای API](/docs/getting-started/endpoints-and-api-paths) را ببینید.

## نصب

**Roo Code** را در مارکت‌پلیس VS Code جست‌وجو کنید، یا دستورالعمل‌های [مخزن پروژه](https://github.com/RooCodeInc/Roo-Code) را دنبال کنید.

## پیکربندی Claude (ارائه‌دهنده Anthropic)

1. **تنظیمات** (آیکون چرخ‌دنده) را در نوار کناری Roo Code باز کنید
2. **ارائه‌دهنده API** را روی **Anthropic** قرار دهید
3. کلید QCode خود (که با `cr_` شروع می‌شود) را در **کلید API** وارد کنید
4. **استفاده از Base URL سفارشی** را علامت بزنید و `https://api.qcode.cc/api` را وارد کنید
5. `claude-sonnet-5` (یا شناسه فعال دیگری) را در فهرست کشویی مدل انتخاب کنید
6. ذخیره کنید، سپس برای تأیید یک پیام در کادر گفت‌وگو بفرستید

> **از سرزمین اصلی چین**، میزبان را با `https://asia.qcode.cc/api` عوض کنید (نود آسیا، نزدیک‌ترین از میان کره / تایوان / هنگ‌کنگ)؛ کلید تغییری نمی‌کند.
> **بدون اسلش انتهایی در Base URL** — افزونه خودش `/v1/messages` را اضافه می‌کند، و یک اسلش اضافه منجر به 404 می‌شود.
## پیکربندی مدل‌های GPT و چینی (OpenAI Compatible)

1. **ارائه‌دهنده API** را روی **OpenAI Compatible** قرار دهید
2. **Base URL**: `https://api.qcode.cc/openai/v1`
3. **کلید API**: همان کلید `cr_`
4. **شناسه مدل**: `gpt-6-sol`، `gpt-5.6-terra`، یا یک [شناسه چینی](/docs/usage/cn-models) مانند `glm-5.2`

## بررسی اتصال

ابتدا نقطه پایانی و کلید را با curl بررسی کنید تا بدانید باید رابط کاربری افزونه را اشکال‌زدایی کنید یا نه:

```bash
KEY="cr_your_qcode_key"
curl -X POST https://api.qcode.cc/api/v1/messages \
  -H "x-api-key: $KEY" -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5","max_tokens":32,"messages":[{"role":"user","content":"ping"}]}'
```

JSON حاوی `content` یعنی سمت نقطه پایانی درست است؛ اگر افزونه همچنان خطا می‌دهد، مشکل در تنظیمات آن است.

## عیب‌یابی

| نشانه | علت | راه‌حل |
|---------|-------|-----|
| `model_not_available_on_endpoint` | دسترسی به Claude از طریق OpenAI Compatible | به ارائه‌دهنده Anthropic با `/api` تغییر دهید |
| `Invalid API key` | کلید اشتباه یا فاصله اضافی | پیشوند `cr_` را بررسی کنید و فاصله‌ها را حذف کنید |
| 404 | اسلش انتهایی در Base URL، یا مسیر اشتباه | با جدول بالا مقایسه کنید |
| شناسه مدل شما در منوی کشویی نیست | در فهرست داخلی افزونه نیست | آن را در فیلد شناسه مدل سفارشی وارد کنید |

## توضیح تنظیمات

| تنظیم (رابط کاربری Roo Code) | چه چیزی وارد کنید | یادداشت‌ها |
|---|---|---|
| ارائه‌دهنده API | `Anthropic` (Claude) یا `OpenAI Compatible` (GPT، مدل‌های چینی) | پروتکل را تعیین می‌کند؛ انتخاب اشتباه بی‌درنگ رد می‌شود |
| کلید API | کلید QCode شما که با `cr_` شروع می‌شود | همان کلید با هر دو ارائه‌دهنده کار می‌کند |
| استفاده از Base URL سفارشی | آن را تیک بزنید و `https://api.qcode.cc/api` را وارد کنید | فقط برای ارائه‌دهنده Anthropic لازم است؛ در سرزمین اصلی چین از `asia.qcode.cc` استفاده کنید |
| Base URL (OpenAI Compatible) | `https://api.qcode.cc/openai/v1` | بدون اسلش انتهایی |
| مدل / شناسه مدل | برای مثال `claude-sonnet-5`، `gpt-6-sol`، `glm-5.2` | اگر در منوی کشویی داخلی نیست، آن را در فیلد سفارشی وارد کنید |

## عیب‌یابی بیشتر

ابتدا مشخص کنید مشکل در سمت نقطه پایانی است یا در پیکربندی رابط کاربری: اگر فرمان curl از بخش «بررسی اتصال» محتوا برگرداند، QCode درست است. سپس این موارد را به ترتیب بررسی کنید:

1. **ابتدا علت‌های کوچک را رد کنید**: وجود فاصله در اطراف کلید یا اسلش انتهایی در Base URL دو مورد از شایع‌ترین علت‌ها هستند؛ آن‌ها را اصلاح کنید، ذخیره کنید و یک پیام آزمایشی بفرستید.
2. **تنظیمات Anthropic و OpenAI Compatible با هم اشتباه گرفته شده‌اند**: پس از تغییر ارائه‌دهنده، Base URL و کلید را دوباره بررسی کنید.
3. **مدل مورد نظر شما رد می‌شود**: Claude فقط از طریق ارائه‌دهنده Anthropic کار می‌کند، GPT و مدل‌های چینی فقط از طریق OpenAI Compatible؛ جدول مرجع را در [نقاط پایانی و قالب‌های API](/docs/getting-started/endpoints-and-api-paths) بررسی کنید.
4. **درخواست‌ها در سمت QCode نمایش داده نمی‌شوند**: کلید خود را در [probe.qcode.cc](https://probe.qcode.cc) وارد کنید تا ببینید درخواست‌ها می‌رسند یا نه؛ نبودن سابقه یعنی درخواست هرگز ارسال نشده است، بنابراین Base URL را در افزونه دوباره بررسی کنید.
## پرسش‌های متداول

### Roo Code بایگانی شده است. آیا هنوز می‌توان از آن استفاده کرد؟

بله، اما به‌روزرسانی یا اصلاحی دریافت نخواهد کرد. تا 2026-10-15، GitHub API مخزن RooCodeInc/Roo-Code را بایگانی‌شده (فقط‌خواندنی) نشان می‌دهد و آخرین push در 2026-05-15 بوده است. نصب‌های موجود همچنان با تنظیمات همین صفحه به QCode متصل می‌شوند؛ برای ابزاری که هنوز نگهداری می‌شود، به [Kilo Code](/docs/ide/kilo-code) یا [Cline](/docs/ide/cline) بروید که راه‌اندازی آن‌ها تقریباً یکسان است.

### آیا می‌توان از GPT در Roo Code استفاده کرد؟

بله. `OpenAI Compatible` را به‌عنوان ارائه‌دهنده API انتخاب کنید، Base URL را روی `https://api.qcode.cc/openai/v1` تنظیم کنید و `gpt-6-sol` یا `gpt-5.6-terra` را به‌عنوان شناسه مدل به کار ببرید.

### چرا نمی‌توان از Claude با OpenAI Compatible استفاده کرد؟

نقطه پایانی OpenAI در QCode مدل‌های Claude را نمی‌پذیرد و `model_not_available_on_endpoint` را برمی‌گرداند. این بررسی پیش از احراز هویت انجام می‌شود؛ بنابراین یعنی پروتکل اشتباه انتخاب شده است، نه اینکه کلید نامعتبر باشد. برای Claude از ارائه‌دهنده Anthropic استفاده کنید.

### در سرزمین اصلی چین از کدام دامنه استفاده کنم؟

`asia.qcode.cc` توصیه می‌شود (برای ارائه‌دهنده Anthropic، `https://asia.qcode.cc/api` را وارد کنید)؛ اگر ناپایدار بود به `api.qcode.cc` برگردید. هر سه دامنه از همان کلید استفاده می‌کنند.

### راه‌اندازی آن با Cline و Kilo Code چه تفاوتی دارد؟

رابط‌ها بسیار شبیه‌اند: Roo Code از Cline منشعب شده است و Kilo Code از Roo Code. پروتکل، Base URL و کلید به همان روش وارد می‌شوند؛ فقط برخی برچسب‌های منو تفاوت دارند.

## مطالب مرتبط

- [نقاط پایانی و مسیرهای API](/docs/getting-started/endpoints-and-api-paths) — جدول پروتکل × خانواده مدل
- [راه‌اندازی Kilo Code](/docs/ide/kilo-code) — انشعاب پایین‌دست، راه‌اندازی تقریباً یکسان
- [یکپارچه‌سازی Cline](/docs/ide/cline) — پروژه‌ای که Roo Code از آن به وجود آمده است
- [مدل‌های چینی](/docs/usage/cn-models)