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

از QCode.cc در افزونه Roo Code برای VS Code استفاده کنید: ارائه‌دهنده Anthropic را انتخاب کنید، Base URL سفارشی را علامت بزنید و Claude کار می‌کند

به کلید API نیاز دارید؟ ثبت‌نام ←·نقاط پایانی و Base URL ←

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

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

در یک نگاه¶

Roo Code یک افزونه متن‌باز کدنویسی با هوش مصنوعی برای VS Code است که از Cline فورک شده است؛ Kilo Code نیز به‌نوبه خود از آن فورک شده است — این سه، صفحه‌های تنظیمات تقریباً یکسانی دارند، بنابراین این صفحه بین آن‌ها قابل انتقال است.

کدام پروتکل¶

🔴 از OpenAI Compatible برای دسترسی به Claude استفاده نکنید — نقطه پایانی OpenAI در QCode مدل‌های Claude را با model_not_available_on_endpoint رد می‌کند. نقاط پایانی و مسیرهای API را ببینید.

نصب¶

Roo Code را در مارکت‌پلیس VS 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، یا یک شناسه چینی مانند glm-5.2

بررسی اتصال¶

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

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 یعنی سمت نقطه پایانی درست است؛ اگر افزونه همچنان خطا می‌دهد، مشکل در تنظیمات آن است.

عیب‌یابی¶

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

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

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

1. ابتدا علت‌های کوچک را رد کنید: وجود فاصله در اطراف کلید یا اسلش انتهایی در Base URL دو مورد از شایع‌ترین علت‌ها هستند؛ آن‌ها را اصلاح کنید، ذخیره کنید و یک پیام آزمایشی بفرستید.
2. تنظیمات Anthropic و OpenAI Compatible با هم اشتباه گرفته شده‌اند: پس از تغییر ارائه‌دهنده، Base URL و کلید را دوباره بررسی کنید.
3. مدل مورد نظر شما رد می‌شود: Claude فقط از طریق ارائه‌دهنده Anthropic کار می‌کند، GPT و مدل‌های چینی فقط از طریق OpenAI Compatible؛ جدول مرجع را در نقاط پایانی و قالب‌های API بررسی کنید.
4. درخواست‌ها در سمت QCode نمایش داده نمی‌شوند: کلید خود را در probe.qcode.cc وارد کنید تا ببینید درخواست‌ها می‌رسند یا نه؛ نبودن سابقه یعنی درخواست هرگز ارسال نشده است، بنابراین Base URL را در افزونه دوباره بررسی کنید.

پرسش‌های متداول¶

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

بله، اما به‌روزرسانی یا اصلاحی دریافت نخواهد کرد. تا 2026-10-15، GitHub API مخزن RooCodeInc/Roo-Code را بایگانی‌شده (فقط‌خواندنی) نشان می‌دهد و آخرین push در 2026-05-15 بوده است. نصب‌های موجود همچنان با تنظیمات همین صفحه به QCode متصل می‌شوند؛ برای ابزاری که هنوز نگهداری می‌شود، به Kilo Code یا 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 — جدول پروتکل × خانواده مدل
• راه‌اندازی Kilo Code — انشعاب پایین‌دست، راه‌اندازی تقریباً یکسان
• یکپارچه‌سازی Cline — پروژه‌ای که Roo Code از آن به وجود آمده است
• مدل‌های چینی

سازمانی ←