Your privacy choices

Allow optional cookies for referral attribution, visit analytics, and Google Ads purchase measurement.

دليل إعداد OpenCode

دليل لتثبيت OpenCode والتبديل بين النماذج، مناسب للطرفية وإصدار سطح المكتب.

سيناريو الاستخدام: OpenCode أداة برمجة مفتوحة المصدر مدعومة بالذكاء الاصطناعي، وتدعم الاستخدام عبر الطرفية وإصدار سطح المكتب. يرتب هذا الدليل الخطوات بالترتيب التالي: «تثبيت OpenCode ← إعداد نموذج Guishu Token ← التبديل بين النماذج في الطرفية/سطح المكتب ← التحقق».

عنصر الإعدادالقيمة الموصى بهاالشرح
Base URLhttps://api.llm-token.cn/v1استخدم أولًا المسار الجذر الذي يتضمن /v1، واحذفه إذا ظهر خطأ
API Keysk-xxxxxxxxأدخل مفتاح Guishu Token الكامل الخاص بك.
Model IDاسم النموذج الكامل الوارد في قائمة النماذجيجب أن يتطابق حرفيًا.

أولًا: تثبيت OpenCode

اختر أيًا من طرق التثبيت. بعد اكتمال التثبيت، يكفي أن يؤدي إدخال opencode في الطرفية إلى تشغيل البرنامج.

النظام / الطريقةالأمر
npm
npm install -g opencode-ai
macOS / Linux Homebrew
brew install anomalyco/tap/opencode
برنامج التثبيت
curl -fsSL https://opencode.ai/install | bash

يُنصح بتنزيل إصدار سطح المكتب وتثبيته من الموقع الرسمي: https://opencode.ai/. ويمكن لسطر الأوامر وإصدار سطح المكتب استخدام مجموعة إعدادات النماذج نفسها معًا.

ثانيًا: إضافة مزوّد Guishu Token باستخدام CC Switch

إذا كنت معتادًا على استخدام CC Switch، فيمكنك إضافة مزوّد مخصص وفق لقطات الشاشة التالية.

  1. افتح CC Switch، وانتبه إلى المدخل، ثم اختر إضافة مزوّد مخصص.
  2. أدخل اسم مزوّد الخدمة، مثل «Guishu Token».
  3. أدخل https://api.llm-token.cn/v1 في Base URL.
  4. أدخل المفتاح الكامل الخاص بك في API Key.
  5. أدخل اسم النموذج الكامل الوارد في قائمة النماذج في Model ID.

تعرض الصورة واجهة CC Switch في طرفية OpenCode. يظهر شعار «CC Switch» وعدة رموز في أعلى الواجهة. وفي الوسط رسالة تقول «لم تتم إضافة أي مزوّد بعد»، مع زري «استيراد الإعداد الحالي» و«إضافة مزوّد». يشير سهم أحمر إلى رمز «+» في أعلى يمين الواجهة. ترتبط الصورة بخطوات «التبديل بين النماذج في الطرفية»، وتقابل الخطوة 4، أي اختيار النموذج الذي أعددته للتو بعد التمرير إلى قائمة النماذج المخصصة. وتوضح الصورة مباشرة موضع مدخل إضافة مزوّد في واجهة الطرفية.تعرض الصورة واجهة CC Switch في طرفية OpenCode. يظهر شعار «CC Switch» وعد…

تعرض الصورة واجهة إضافة مزوّد جديد عند التبديل بين النماذج في طرفية OpenCode. تحتوي الواجهة على عدة حقول إدخال، منها اسم المزوّد وAPI Key وBase URL، وتشير أسهم حمراء إلى القيم المطلوب إدخالها، وهي تقابل «my - provider» وAPI Key وBase URL المذكورة في خطوة «إضافة مزوّد جديد» في المستند. ويوجد كذلك زر «إضافة نموذج» في أسفل الواجهة، ما يتيح إضافة النموذج الذي تريد استخدامه. تعرض الصورة مباشرة واجهة إضافة مزوّد جديد في الطرفية وأهم الحقول المطلوبة.تعرض الصورة واجهة إضافة مزوّد جديد عند التبديل بين النماذج في طرفية Open…

ثالثًا: التبديل بين النماذج في الطرفية

  1. افتح الطرفية وشغّل opencode.
  2. بعد الدخول إلى OpenCode، اضغط Ctrl + P.
  3. ابحث عن Switch Model واضغط Enter.
  4. مرّر إلى قائمة النماذج المخصصة، ثم اختر النموذج الذي أعددته للتو.
opencode

هذه لقطة شاشة لواجهة طرفية OpenCode. يظهر في الأعلى شعار متعلق بـ«OpenCode»، ويعرض مربع الإدخال العبارة «Ask anything... 'Fix a TODO in the codebase'». وتوضح الواجهة أن النموذج المحدد حاليًا هو «GPT-5.5 OpenAI»، كما تعرض تلميح التشغيل «Tip:/themes or Ctrl+X T to switch between 33 built-in themes»، ويظهر رقم الإصدار «1.14.30» في أسفل اليمين. تقابل هذه الواجهة سيناريو التبديل بين النماذج في الطرفية، وهي الشاشة التي يمكن للمستخدم بدء عملية التبديل منها بعد الدخول إلى OpenCode.هذه لقطة شاشة لواجهة طرفية OpenCode. يظهر في الأعلى شعار متعلق بـ«OpenCo…

Ctrl + P

تعرض الصورة واجهة طرفية OpenCode مع موجّه الأوامر وجزء من محتوى الشفرة. تظهر قائمة أوامر منبثقة، وقد أُبرز أمر «Switch model» باللون البرتقالي، ويظهر الاختصار «ctrl+x m» إلى يمينه. ترتبط الصورة بقسم «ثالثًا: التبديل بين النماذج في الطرفية»، وتوضح مباشرة شاشة العثور على «Switch Model» والضغط على Enter، بما يساعد المستخدم على فهم خطوة التبديل بين النماذج في الطرفية.تعرض الصورة واجهة طرفية OpenCode مع موجّه الأوامر وجزء من محتوى الشفرة.…

تعرض هذه الصورة واجهة طرفية OpenCode في صفحة اختيار النماذج «Select model». تحتوي الصفحة على عدة نماذج مدمجة، ويتبعها خيار «custom» المخصص ونموذج «gpt-5.5» المخصص، وقد تم تحديده وإبرازه باللون البرتقالي. كما تعرض الواجهة في الأسفل اختصارات التشغيل، مثل ctrl+a بجوار Connect provider وctrl+f بجوار Favorite. تقابل الصورة خطوة التمرير إلى قائمة النماذج المخصصة واختيار النموذج الذي سبق إعداده ضمن خطوات التبديل بين النماذج في الطرفية.تعرض هذه الصورة واجهة طرفية OpenCode في صفحة اختيار النماذج «Select mode…

رابعًا: الاستخدام على سطح المكتب

افتح إصدار سطح المكتب من OpenCode، وابحث في موضع اختيار النموذج عن النموذج الذي أعددته في CC Switch، ثم حدده لبدء الاستخدام.

تعرض هذه الصورة واجهة إصدار سطح المكتب من OpenCode بتصميم داكن. يعرض الجانب الأيسر محتوى متعلقًا بعبارة «أنشئ أي شيء»، وقد أُبرز خيار «Big Pickle» في الأسفل بسهم أحمر يشير إليه مباشرة. ويعرض الجانب الأيمن خيارات مرتبطة بوظيفة «إنشاء مستودع Git». تقابل الصورة قسم الاستخدام على سطح المكتب، وتوضح موضع مدخل التشغيل الأساسي في واجهة OpenCode لمساعدة المستخدم على إكمال الإعداد.تعرض هذه الصورة واجهة إصدار سطح المكتب من OpenCode بتصميم داكن. يعرض الج…

تعرض هذه الصورة واجهة إصدار سطح المكتب من OpenCode لإرشاد المستخدم إلى إضافة نموذج مخصص. فُتحت القائمة المنسدلة في منطقة اختيار النموذج على اليسار، وتعرض خيارات مثل GPT-4 nano وGPT-4.5، ويشير سهم أحمر إلى خيار «gpt-5.5». كما يظهر في وسط الواجهة نص أزرق بارز يوضح إمكانية النقر على المنطقة المناسبة لاحقًا لإضافة نموذج لغة كبير، مع ضرورة اختيار نموذج مخصص عند الإضافة. ترتبط الصورة بمرحلة الاستخدام على سطح المكتب، وهي دليل تشغيلي يساعد المستخدم على إكمال الخطوة الأساسية لإضافة نموذج.تعرض هذه الصورة واجهة إصدار سطح المكتب من OpenCode لإرشاد المستخدم إلى إ…

خامسًا: التحقق والمشكلات الشائعة

الحالةطريقة المعالجة
تعذّر تشغيل opencodeأعد فتح الطرفية وتأكد من إضافة مسار تثبيت npm / brew إلى PATH.
لا يظهر النموذج المخصص في قائمة النماذجتأكد من أن CC Switch حفظ الإعداد، ثم أعد تشغيل OpenCode.
فشل الطلبتحقق من Base URL وAPI Key ومعرّف النموذج؛ وابدأ باستخدام https://api.llm-token.cn/v1.
استجابة النموذج بطيئةاختبر نموذجًا سريع الاستجابة، مثل claude-sonnet-4-6 أو MiniMax-M3-highspeed.

دليل إعداد WorkBuddy

العناصر الثلاثة للربط بنموذج مخصص: Base URL وAPI Key ومعرّف النموذج.

دليل إعداد VS Code

استخدم OpenAI Compatible في VS Code + Cline للربط بخدمة Guishu Token.

أقسام هذه الصفحة

أولًا: تثبيت OpenCodeثانيًا: إضافة مزوّد Guishu Token باستخدام CC Switchثالثًا: التبديل بين النماذج في الطرفيةرابعًا: الاستخدام على سطح المكتبخامسًا: التحقق والمشكلات الشائعة