OpenCode

دع وكيلي يتولى الإعدادCopy Anchor Link

انسخ هذه المهمة إلى وكيل يعمل بالفعل على جهازك:

اقرأ هذا الدليل وساعدني في ربط OpenCode بـ TokenLab:
https://tokenlab.sh/docs/ar/integrations/opencode
تحقق أولًا من الإصدار المثبت لديّ والإعدادات الفعّالة.
احتفظ بالحسابات ومزوّدي الخدمة والأذونات والإعدادات الأخرى الموجودة.
انسخ الملفات المحلية احتياطيًا واعرض التغييرات المقترحة.
دعني أُدخل أي مفتاح API مطلوب محليًا؛ لا تطلبه أو تعرضه أو تلصقه في المحادثة.
تحقق أولًا من إمكانية تحميل الإعدادات.
اشرح تكلفة أي اختبار يتضمن طلبًا مدفوعًا بشكل منفصل قبل تشغيله.

نظرة عامةCopy Anchor Link

OpenCode هو مساعد برمجة AI مفتوح المصدر يعمل داخل الطرفية الخاصة بك. وهو يدعم عدة مزوّدي LLM ويمكن تهيئته لاستخدام API الخاصة بـ TokenLab للوصول إلى مئات النماذج.

التثبيتCopy Anchor Link

OpenCode

npm install -g opencode-ai@1.18.31

تحقق من التثبيت:

opencode --version

التهيئةCopy Anchor Link

الخطوة 1: تعيين متغيرات البيئةCopy Anchor Link

اتبع خطوات الطرفية في البدء السريع لنظام macOS أو Linux أو WSL أو Windows PowerShell لتعيين TOKENLAB_API_KEY دون كتابة المفتاح في سجل الأوامر. شغّل OpenCode من الطرفية نفسها. للاستخدام الدائم، استخدم مدير أسرار محليًا ولا تُضف المفتاح كنص صريح إلى ملف إعدادات الصدفة.

الخطوة 2: تهيئة OpenCodeCopy Anchor Link

تم التحقق من الإعداد أدناه باستخدام 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"
        }
      }
    }
  }
}

اختياريًا، يتيح مساعد إعداد OpenCode القابل للاستعادة المعاينة والتطبيق واستعادة الملف الأصلي باستخدام Python 3.11+. تتضمن إضافة TokenLab Skills 0.1.2 هذه السكربتات؛ ويمكن أيضًا استخدام Skill مستقل بعد تحديثه إلى إصدار يحتوي عليها. للإضافة أو Skill المستقل المثبّت مسبقًا، اتبع تعليمات تحديث README وتأكد من وجود السكربت. تظل خطوات الإعداد اليدوي هنا كافية دون المساعد.

الاستخدام الأساسيCopy Anchor Link

عيّن المفتاح وفق البدء السريع، ثم حمّل الملف واختر النموذج صراحةً لهذا التشغيل فقط. استبدل المسار واسم المزوّد إذا خصصتهما. احتفظ بإعدادات 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 في ملف إعداد الصدفة من أجل هذا الدليل. للتراجع عن الإعداد اليدوي، احذف الملف المستقل الذي أنشأته فقط، أو استعد نسخته الاحتياطية إذا كان موجودًا سابقًا.

النماذج المتاحةCopy Anchor Link

الأوامر الشائعةCopy Anchor Link

تحليل الكود:

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"

الأوامر التفاعليةCopy Anchor Link

استكشاف الأخطاء وإصلاحهاCopy Anchor Link

أفضل الممارساتCopy Anchor Link