آموزش GitHub Copilot با مدل سفارشی (llmapi)
GitHub Copilot دستیار هوش مصنوعی GitHub است که در VS Code، Visual Studio و JetBrains کار میکند. Copilot Chat اجازه میدهد مدلهای سفارشی از یک endpoint سازگار با OpenAI یا Anthropic اضافه کنید؛ llmapi از همین راه وصل میشود.
راهاندازی با یک دستور
macOS و Linux:
curl -fsSL https://llmapi.cheap/install.sh | sh
Windows (PowerShell):
irm https://llmapi.cheap/install.ps1 | iex
Node.js لازم نیست. فقط Copilot (macOS/Linux):
curl -fsSL https://llmapi.cheap/install.sh | sh -s -- --only copilot
این دستور چه چیزهایی را تغییر میدهد؟
اگر افزونهٔ GitHub Copilot Chat در VS Code نصب باشد، اسکریپت فایل chatLanguageModels.json را در پوشهٔ کاربر VS Code ویرایش میکند:
| سیستمعامل | پوشهٔ کاربر VS Code |
|---|---|
| macOS | ~/Library/Application Support/Code/User |
| Windows | %APPDATA%\Code\User |
| Linux | ~/.config/Code/User |
یک endpoint سفارشی به نام llmapi اضافه میشود که همهٔ مدلها را دارد: مدلهای Claude از https://llmapi.cheap/v1/messages (پروتکل Anthropic) و بقیه از https://llmapi.cheap/v1/chat/completions (پروتکل OpenAI)، با tool calling فعال. endpointهای دیگر شما حفظ میشوند.
بعد از اجرا، در Copilot Chat انتخابگر مدل را باز کنید، Manage Models را بزنید و مدلهای llmapi را فعال کنید.
راهاندازی دستی
در Copilot Chat: انتخابگر مدل → Manage Models → Add → OpenAI compatible:
URL: https://llmapi.cheap/v1/chat/completions
API key: YOUR_API_KEY
Model: gemini-3.8-flash-high
Visual Studio و Copilot در JetBrains همین صفحهٔ Manage Models را دارند.
GitHub Copilot CLI
export COPILOT_PROVIDER_BASE_URL=https://llmapi.cheap/v1 COPILOT_PROVIDER_API_KEY=YOUR_API_KEY COPILOT_MODEL=gemini-3.8-flash-high
تغییر مدل
در Copilot Chat از انتخابگر مدل یکی از مدلهای llmapi را انتخاب کنید. برای Copilot CLI مقدار COPILOT_MODEL را عوض کنید.
مشکلات رایج
- گزینهٔ Manage Models یا مدل سفارشی وجود ندارد: در حسابهای Copilot Business و Enterprise، مدیر سازمان میتواند مدلهای سفارشی را غیرفعال کند.
- خطای 404: برای Copilot آدرس کامل لازم است:
https://llmapi.cheap/v1/chat/completions، نه فقط/v1. - مدلها اضافه شدند ولی در انتخابگر نیستند: در Manage Models آنها را فعال (visible) کنید و VS Code را دوباره باز کنید.
- Copilot پیدا نشد: اسکریپت فقط VS Code معمولی را بررسی میکند؛ برای Insiders یا ویرایشگرهای دیگر راهاندازی دستی را انجام دهید.
- مدل Claude کار نمیکند: در دورهٔ آزمایشی فقط مدلهای Gemini فعالاند.
سؤالات متداول
به اشتراک پولی Copilot نیاز دارم؟
این به سیاستهای GitHub برای مدلهای سفارشی بستگی دارد. llmapi فقط مدلها را فراهم میکند؛ دسترسی به صفحهٔ Manage Models را GitHub تعیین میکند.
در Visual Studio یا JetBrains چطور؟
دستور یکخطی فقط VS Code را تنظیم میکند. در Visual Studio و Copilot در JetBrains همان مراحل Manage Models → Add → OpenAI compatible را دستی انجام دهید.
کلیدم کجا ذخیره میشود؟
در chatLanguageModels.json روی کامپیوتر خودتان.
شروع کنید
ثبتنام کنید؛ کلید API خودکار ساخته میشود و یک ساعت آزمایش رایگان روی مدلهای Gemini دارید. دستور یکخطی را اجرا کنید و از Manage Models مدلها را فعال کنید.