أدوات البرمجة
OpenCode
تكوين OpenCode لاستخدام TokenLab API
دع الوكيل الخاص بي يقوم بهذا الإعداد
انسخ هذه المهمة إلى وكيل يعمل بالفعل على جهاز الكمبيوتر الخاص بك:
Read this guide and help me connect OpenCode to TokenLab:
https://tokenlab.sh/docs/ar/integrations/opencode
Check my installed version and active configuration first.
Preserve existing accounts, providers, permissions and other settings.
Back up local files and show proposed changes.
Have me enter any API key locally; never ask for, print or paste it in chat.
Check configuration loading first.
Explain any paid request test separately before running it.نظرة عامة
يمكن لـ OpenCode استخدام TokenLab من خلال مزود مخصص متوافق مع OpenAI. أضف مفتاح TokenLab API، وBase URL، ومعرف النموذج الحالي.
التثبيت
npm install -g opencode-ai@1.18.31تحقق من التثبيت:
opencode --versionالتكوين
الخطوة 1: تعيين متغيرات البيئة
استخدم تعليمات الجهاز الطرفي (Terminal) الخاصة بـ البدء السريع لنظام macOS أو Linux أو WSL أو Windows PowerShell لتعيين TOKENLAB_API_KEY دون وضع المفتاح في سجل الأوامر. قم بتشغيل OpenCode من ذلك الجهاز الطرفي. للاستخدام الدائم، استخدم مدير الأسرار المحلي الخاص بك؛ لا تقم بإلحاق مفتاح بنص عادي (plaintext) بملف تعريف الصدفة (shell profile) الخاص بك.
الخطوة 2: تكوين OpenCode
تم التحقق من التكوين أدناه باستخدام OpenCode 1.18.31. تحتاج الإصدارات الأخرى إلى التحقق الخاص بها مقابل الوثائق الرسمية.
قم بإنشاء ملف منفصل باسم ~/.config/opencode/tokenlab.jsonc مع التكوين أدناه. إذا تم تعيين XDG_CONFIG_HOME، فاستخدم opencode/tokenlab.jsonc ضمن ذلك الدليل. حافظ على ملفات opencode.json / opencode.jsonc العادية، والحسابات، والنموذج الافتراضي، والأذونات دون تغيير: يتم تحميل هذا الملف المنفصل فقط عند الاستدعاء الذي يحدده باستخدام OPENCODE_CONFIG. إذا كان اسم الملف أو المزود ينتمي بالفعل إلى إعداد آخر، فاختر ملفاً/اسماً مختلفاً وقم بتعديل الأوامر.
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"tokenlab": {
"npm": "@ai-sdk/openai-compatible",
"name": "TokenLab",
"options": {
"baseURL": "https://api.tokenlab.sh/v1",
"apiKey": "{env:TOKENLAB_API_KEY}"
},
"models": {
"gpt-5.6-terra": {
"name": "GPT-5.6 Terra"
},
"gpt-5.6-luna": {
"name": "GPT-5.6 Luna"
}
}
}
}
}يستخدم هذا التكوين @ai-sdk/openai-compatible لإكمال الدردشة (Chat Completions). اختر نموذجاً حالياً تدعم تفاصيله إكمال الدردشة والأدوات التي تحتاجها؛ لا تستنتج الدعم لبروتوكول أو إصدار آخر من هذا المثال.
اختياري: يوفر مساعد إعداد OpenCode القابل للعكس إمكانية المعاينة والتطبيق واستعادة الملف الأصلي باستخدام Python 3.11+. يتضمن المكون الإضافي TokenLab Skills إصدار 0.1.2 هذه النصوص البرمجية؛ يمكن أيضاً استخدام تثبيت Skill مستقل بعد التحديث إلى إصدار يحتوي عليها. بالنسبة لمكون إضافي موجود أو تثبيت Skill مستقل، اتبع تعليمات تحديث README وتأكد من وجود النص البرمجي. يظل التكوين اليدوي هنا قابلاً للاستخدام بدون المساعد.
الاستخدام الأساسي
قم بتعيين المفتاح باستخدام Quickstart، ثم قم بتحميل هذا الملف وحدد النموذج صراحةً لهذا الاستدعاء. استبدل المسار الفعلي واسم المزود الخاص بك إذا قمت بتخصيصهما. احتفظ بأي إعداد OPENCODE_CONFIG موجود أو OPENCODE_CONFIG_CONTENT مضمن في بيئة تشغيل منفصلة؛ قد تظل إعدادات المشروع والإعدادات المُدارة لها الأولوية.
OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode models tokenlab
OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode --model tokenlab/gpt-5.6-terraيتحقق اكتشاف النموذج من التحميل المحلي، وليس من صلاحية المفتاح أو نجاح طلب مباشر. يستخدم الطلب رصيد TokenLab، وقد يرسل OpenCode طلبات مساعدة يتم محاسبتها بشكل منفصل، مثل إنشاء العنوان. تحقق من الرد وسجلات الطلبات المطابقة.
لاستخدام إعدادك العادي، قم بالتشغيل بدون هذه الطبقة. لا تقم بحفظ OPENCODE_CONFIG بشكل دائم في ملف تعريف الصدفة الخاص بك لهذا الدليل. للتراجع عن الإعداد اليدوي، احذف فقط الملف المنفصل الذي أنشأته، أو استعد نسخته الاحتياطية إذا كانت موجودة من قبل.
إنشاء الصور والفيديو في نفس الوكيل
يمكن لـ OpenCode أيضاً إنشاء صور ومقاطع فيديو قصيرة باستخدام خادم TokenLab MCP. يتم دفع تكلفة كل عملية إنشاء من نفس رصيد TokenLab. ادمج إدخال mcp هذا في نفس ملف tokenlab.jsonc بجوار provider. يستبدل OpenCode {env:TOKENLAB_API_KEY} بالمتغير من جهازك الطرفي، لذا لا يتم كتابة المفتاح في الملف:
{
"mcp": {
"tokenlab": {
"type": "local",
"command": ["npx", "-y", "@tokenlabai/mcp-server@0.6.48"],
"environment": {
"TOKENLAB_MCP_TOOL_PROFILE": "core",
"TOKENLAB_API_KEY": "{env:TOKENLAB_API_KEY}"
},
"timeout": 30000
}
}
}تمنح قيمة timeout الأطول وقتاً لـ npx لتنزيل الحزمة عند البدء لأول مرة. قم بتشغيل opencode mcp list باستخدام نفس OPENCODE_CONFIG وتأكد من اتصال 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 معرف مهمة. يستدعي الوكيل get_task_status حتى يصبح الفيديو جاهزاً. راجع خوادم OpenCode MCP لمعرفة الإعدادات الأخرى.
اختيار نموذج
انسخ معرف نموذج برمجي حالي من صفحة النماذج. قارن بين النماذج في مستودعك الخاص قبل تعيين نموذج افتراضي.
الأوامر الشائعة
تحليل الكود:
OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "What does this function do?" < src/utils.tsإنشاء الكود:
OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "Create a REST API with Express"مراجعة التغييرات:
git diff | OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "Review these changes"إصلاح الأخطاء:
OPENCODE_CONFIG="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/tokenlab.jsonc" opencode run --model tokenlab/gpt-5.6-terra "Fix the TypeScript errors in this project"الأوامر التفاعلية
| الأمر | الوصف |
|---|---|
/help | عرض الأوامر المتاحة |
/models | التبديل إلى نموذج مختلف |
/clear | مسح سجل المحادثة |
/exit | الخروج من OpenCode |