آموزش‌ها / آموزش Roo Code با API سازگار با OpenAI (llmapi)

آموزش Roo Code با API سازگار با OpenAI (llmapi)

به‌روزرسانی: 2026-10-06

Roo Code یک ایجنت برنامه‌نویسی متن‌باز برای VS Code است که از Cline منشعب شده و حالت‌های مختلف (مثل Code، Architect و Ask) دارد. Roo Code از طریق provider سازگار با OpenAI به llmapi وصل می‌شود.

راه‌اندازی با یک دستور

macOS و Linux:

curl -fsSL https://llmapi.cheap/install.sh | sh

Windows (PowerShell):

irm https://llmapi.cheap/install.ps1 | iex

Node.js لازم نیست. فقط Roo Code (macOS/Linux):

curl -fsSL https://llmapi.cheap/install.sh | sh -s -- --only roo

این دستور چه چیزهایی را تغییر می‌دهد؟

  • یک فایل پروفایل در ~/.llmapi/roo-settings.json ساخته می‌شود: پروفایلی به نام llmapi با Base URL https://llmapi.cheap/v1، کلید شما و مدل gemini-3.8-flash-high. روی macOS و Linux دسترسی این فایل فقط برای کاربر خودتان است.
  • در settings.json کاربر VS Code مقدار roo-cline.autoImportSettingsPath به همین فایل اشاره می‌کند.

دفعهٔ بعد که VS Code را باز کنید، Roo Code پروفایل llmapi را خودش وارد می‌کند. اسکریپت فقط وقتی Roo را تنظیم می‌کند که افزونهٔ آن در VS Code نصب باشد.

راه‌اندازی دستی

در تنظیمات Roo Code، گزینهٔ API Provider را روی OpenAI Compatible بگذارید:

Base URL:  https://llmapi.cheap/v1
API Key:   YOUR_API_KEY
Model ID:  gemini-3.8-flash-high

تغییر مدل

در تنظیمات پروفایل llmapi فیلد Model ID را عوض کنید. Roo Code اجازه می‌دهد چند پروفایل داشته باشید؛ مثلاً یک پروفایل با gemini-3.8-flash-high برای کارهای روزمره و یکی با gemini-3.1-pro-high یا claude-sonnet-4-6 برای حالت Architect. مدل‌های Claude فقط در پلن‌های پولی فعال‌اند.

مشکلات رایج

  • پروفایل llmapi ظاهر نشد: VS Code را کامل ببندید و دوباره باز کنید؛ وارد کردن پروفایل هنگام شروع VS Code انجام می‌شود.
  • Roo پیدا نشد: اسکریپت افزونه را در ~/.vscode/extensions دنبال می‌کند. اگر از VS Code Insiders یا ویرایشگر دیگری استفاده می‌کنید، راه‌اندازی دستی را انجام دهید.
  • خطای 404: Base URL باید https://llmapi.cheap/v1 باشد.
  • خطای 401: کلید را دوباره از داشبورد کپی کنید.
  • مدل مجاز نیست: در دورهٔ آزمایشی فقط مدل‌های Gemini فعال‌اند.

سؤالات متداول

تفاوت Roo Code و Cline چیست؟

هر دو ایجنت VS Code هستند. Roo Code حالت‌ها و پروفایل‌های قابل تنظیم بیشتری دارد؛ Cline ساده‌تر است و نسخهٔ CLI هم دارد. راهنمای Cline را هم ببینید.

پروفایل‌های قبلی Roo پاک می‌شوند؟

فایل وارداتی فقط پروفایل llmapi را تعریف می‌کند. اگر نگران هستید، قبل از اجرا از تنظیمات Roo خروجی بگیرید.

کدام مدل برای Roo Code بهتر است؟

برای شروع gemini-3.8-flash-high. اگر کار به استدلال طولانی یا معماری نیاز دارد، gemini-3.1-pro-high را امتحان کنید.

شروع کنید

حساب رایگان بسازید، کلید API خودکار ساخته می‌شود؛ دستور یک‌خطی را اجرا کنید و VS Code را دوباره باز کنید. پلن‌ها از ماهی ۲ دلار شروع می‌شوند: قیمت‌ها.