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

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

Cline یک ایجنت برنامه‌نویسی متن‌باز است که داخل VS Code (و به‌صورت CLI) کار می‌کند: برنامه‌ریزی می‌کند، فایل‌ها را ویرایش می‌کند و با اجازهٔ شما دستور اجرا می‌کند. Cline با provider «OpenAI Compatible» به llmapi وصل می‌شود.

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

macOS و Linux:

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

Windows (PowerShell):

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

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

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

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

اگر Cline CLI نصب باشد، اسکریپت خود CLI را با cline auth اجرا می‌کند تا provider را روی openai-compatible با کلید و مدل llmapi بگذارد. این تنظیم بین CLI و افزونه مشترک است.
اگر CLI نصب نباشد، اسکریپت فایل ~/.cline/data/settings/providers.json را ویرایش می‌کند: provider openai-compatible با کلید، مدل gemini-3.8-flash-high و آدرس https://llmapi.cheap/v1 ثبت و به‌عنوان آخرین provider استفاده‌شده انتخاب می‌شود.

بعد از اجرا، VS Code را دوباره باز کنید.

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

در افزونهٔ VS Code

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

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

در Cline CLI

cline auth -p openai-compatible -k YOUR_API_KEY -m gemini-3.8-flash-high -b https://llmapi.cheap/v1

تغییر مدل

در تنظیمات Cline فیلد Model ID را عوض کنید، مثلاً به gemini-3.1-pro-high یا (در پلن‌های پولی) claude-sonnet-4-6. در CLI همان دستور cline auth را با مقدار دیگری برای -m اجرا کنید.

یک ترفند خوب: برای حالت Plan مدل قوی‌تر و برای حالت Act مدل سریع‌تر بگذارید، اگر Cline شما مدل جداگانه برای هر حالت را پشتیبانی می‌کند.

مشکلات رایج

provider اشتباه: گزینهٔ «OpenAI» معمولی را انتخاب نکنید؛ باید OpenAI Compatible باشد تا Base URL قابل تنظیم باشد.
خطای 404: Base URL باید با /v1 تمام شود.
خطای 401: کلید با sk-llm- شروع می‌شود؛ فاصلهٔ اضافی قبل یا بعد آن را پاک کنید.
مدل مجاز نیست: در دورهٔ آزمایشی فقط مدل‌های Gemini فعال‌اند.
خطای usage limit: سهمیهٔ پنج‌ساعته یا هفتگی تمام شده و پیام خطا زمان شارژ دوباره را می‌گوید.

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

Roo Code هم همین‌طور تنظیم می‌شود؟

تقریباً. Roo Code از Cline منشعب شده و همان provider «OpenAI Compatible» را دارد. راهنمای Roo Code را ببینید.

Cline با مدل‌های Gemini خوب کار می‌کند؟

بله. پیش‌فرض llmapi، یعنی gemini-3.8-flash-high، از tool calling پشتیبانی می‌کند که Cline برای ویرایش فایل و اجرای دستور به آن نیاز دارد.

کلیدم کجا ذخیره می‌شود؟

در تنظیمات خود Cline روی کامپیوتر شما. llmapi فقط کلید را برای احراز هویت درخواست‌ها می‌بیند.

شروع کنید

ثبت‌نام کنید، کلید API خودکار ساخته می‌شود و یک ساعت آزمایش رایگان روی مدل‌های Gemini دارید. بعد دستور یک‌خطی را اجرا کنید و Cline را باز کنید.