أدوات البرمجة
GitHub Copilot CLI
ربط GitHub Copilot CLI بـ TokenLab باستخدام BYOK
نظرة عامة
يمكن لـ GitHub Copilot CLI الاتصال بأي نقطة نهاية متوافقة مع OpenAI Chat Completions. يعمل TokenLab من خلال متغيرات بيئة BYOK الخاصة بـ Copilot CLI.
التثبيت
باستخدام Node.js 22 أو إصدار أحدث، قم بالتثبيت عبر npm:
npm install -g @github/copilot@1.0.85على نظام macOS أو Linux، يمكنك بدلاً من ذلك استخدام Homebrew:
brew install --cask copilot-cliتحقق من التثبيت:
copilot --versionتهيئة TokenLab
قم بتعيين متغيرات المزود قبل بدء Copilot CLI:
استخدم تعليمات الطرفية في البدء السريع لنظام macOS أو Linux أو WSL أو Windows PowerShell لتعيين TOKENLAB_API_KEY دون وضع المفتاح في سجل الأوامر. قم بتشغيل Copilot CLI من تلك الطرفية. للاستخدام الدائم، استخدم مدير الأسرار المحلي الخاص بك؛ لا تقم بإلحاق مفتاح بنص عادي بملف تعريف الصدفة (shell profile) الخاص بك.
تنطبق هذه المتغيرات فقط على هذا التشغيل؛ ستبقى إعدادات حسابك المحفوظة، والنموذج الافتراضي، وإعدادات الأذونات كما هي. قم بالتشغيل بشكل طبيعي بدون المتغيرات لاستخدام إعداداتك السابقة. لا تقم بحفظها بشكل دائم في ملف تعريف الصدفة الخاص بك.
COPILOT_PROVIDER_TYPE=openai COPILOT_PROVIDER_BASE_URL=https://api.tokenlab.sh/v1 COPILOT_PROVIDER_API_KEY="${TOKENLAB_API_KEY:?Set TOKENLAB_API_KEY first}" copilot --model claude-sonnet-5-5| المتغير | قيمة TokenLab |
|---|---|
COPILOT_PROVIDER_TYPE | openai |
COPILOT_PROVIDER_BASE_URL | https://api.tokenlab.sh/v1 |
COPILOT_PROVIDER_API_KEY | مفتاح TokenLab API الخاص بك |
COPILOT_MODEL | معرف نموذج مباشر، على سبيل المثال claude-sonnet-5-5 |
يتطلب GitHub أن يدعم النموذج المختار كلاً من البث (streaming) واستدعاء الأدوات (tool calling). يدعم claude-sonnet-5-5 استدعاء الأدوات ويحتوي على نافذة سياق أكبر من الحد الأدنى الموصى به من GitHub وهو 128 ألف.
التحقق
داخل Copilot CLI، اطلب إجراءً للقراءة فقط أولاً، مثل:
Inspect this repository and summarize its top-level structure. Do not modify files.حفظ الإعدادات أو سرد النماذج لا يتحقق من المفتاح أو اكتمال الطلب. تستخدم المطالبة رصيد TokenLab. تحقق من الرد وسجل الطلب المطابق له قبل تجربة الأدوات؛ قد يتم محاسبتك أيضاً على الطلبات الإضافية.
لرؤية إعدادات المزود التي يوثقها Copilot CLI، قم بتشغيل:
copilot help providersإنشاء الصور والفيديو في نفس الوكيل (Agent)
يمكن لـ Copilot CLI أيضاً إنشاء صور ومقاطع فيديو قصيرة باستخدام خادم TokenLab MCP. يتم دفع تكلفة كل عملية إنشاء من نفس رصيد TokenLab. ادمج هذا الإدخال في ~/.copilot/mcp-config.json. يمرر Copilot CLI متغير PATH فقط إلى الخادم، لذا يتم وضع كلا المتغيرين في env:
{
"mcpServers": {
"tokenlab": {
"type": "local",
"command": "npx",
"args": ["-y", "@tokenlabai/mcp-server@0.6.48"],
"env": {
"TOKENLAB_MCP_TOOL_PROFILE": "core",
"TOKENLAB_API_KEY": "<TOKENLAB_API_KEY>"
},
"tools": ["*"]
}
}
}استبدل <TOKENLAB_API_KEY> بمفتاحك في هذا الملف المحلي فقط. ابدأ تشغيل Copilot CLI وقم بتشغيل /mcp show tokenlab للتحقق من الاتصال. ثم جرب:
Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.يعيد create_video معرف مهمة (task ID). يستدعي الوكيل get_task_status حتى يصبح الفيديو جاهزاً. راجع إضافة خوادم MCP إلى Copilot CLI للحصول على إعدادات أخرى.
استكشاف الأخطاء وإصلاحها
لا تقم برفع مفاتيح API إلى نصوص برمجية (shell scripts) أو ملفات نقطية (dotfiles) يتم تتبعها بواسطة Git. قم بتغيير أي مفتاح تم كشفه في سجل الطرفية أو لقطات الشاشة أو السجلات.