أدوات البرمجة

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_TYPEopenai
COPILOT_PROVIDER_BASE_URLhttps://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. قم بتغيير أي مفتاح تم كشفه في سجل الطرفية أو لقطات الشاشة أو السجلات.

في هذه الصفحة