دليل إعداد VS Code
استخدم OpenAI Compatible في VS Code + Cline للربط بخدمة Guishu Token.
الهدف: تثبيت Cline في VS Code والربط بخدمة Guishu Token عبر OpenAI Compatible. بعد إكمال الإعداد، يمكنك أن تطلب من الذكاء الاصطناعي داخل VS Code قراءة الشفرة وتعديلها وكتابة الأوامر وشرح الأخطاء مباشرة.
| عنصر الإعداد | القيمة المطلوبة | ملاحظات |
|---|---|---|
| API Provider | OpenAI Compatible | يدعم Cline رسميًا مزوّدي الخدمات المتوافقة مع OpenAI. |
| Base URL | https://api.llm-token.cn/v1 | لا تُدخل مسار /chat/completions الكامل. |
| API Key | sk-xxxxxxxx | الصق مفتاح API الكامل الخاص بك. |
| Model ID | انسخ اسم النموذج كاملًا من قائمة النماذج | إذا لم يكن النموذج موجودًا، فالسبب في الغالب خطأ في هذا الحقل. |
أولًا: المتطلبات المسبقة
- ثبّت VS Code: https://code.visualstudio.com/
- ثبّت Git: https://git-scm.com/downloads
- يُنصح مستخدمو Windows بإعادة تشغيل الكمبيوتر مرة واحدة بعد تثبيت Git لضمان تفعيل متغيرات البيئة.
ثانيًا: تثبيت إضافة Cline
- افتح VS Code، ثم انقر على متجر إضافات Extensions في الشريط الأيسر.
- ابحث عن Cline، ثم انقر على Install.
- بعد اكتمال التثبيت، سيظهر رمز Cline في الشريط الأيسر.
- إذا لم يظهر الرمز، فأعد تشغيل VS Code.
تعرض الصورة واجهة البحث عن إضافة Cline في VS Code. تظهر عدة رموز في الشر…
ثالثًا: فتح إعدادات Cline
انقر على رمز Cline في الشريط الأيسر، ثم افتح الإعدادات بعد الدخول إلى لوحة Cline.
هذه لقطة شاشة لمرحلة إعداد Cline في VS Code، وتقابل الخطوات التالية لفتح…
تعرض الصورة واجهة إعدادات إضافة Cline في VS Code. تظهر على اليسار خيارات…
رابعًا: إدخال واجهة Guishu Token
- API Provider: اختر OpenAI Compatible.
- Base URL: أدخل
https://api.llm-token.cn/v1. - API Key: الصق المفتاح الذي يبدأ بـ
sk-. - Model ID: أدخل معرّف النموذج كاملًا، مثل
claude-sonnet-4-6. - بعد حفظ الإعداد، أنشئ مهمة جديدة للاختبار.
إذا ظهر خطأ عند الحفظ: تأكد أولًا من أنك لم تكتب Base URL بالشكل https://api.llm-token.cn/v1/chat/completions. يتطلب Cline إدخال المسار الجذر لـAPI، أي /v1.
خامسًا: الاختبار واستكشاف الأخطاء
| الحالة | طريقة المعالجة |
|---|---|
| تعذّر إدخال URL | تأكد من اختيار OpenAI Compatible، وليس مزوّد OpenAI الرسمي العادي. |
| Model Not Found | يجب أن يطابق معرّف النموذج قائمة النماذج تمامًا. |
| فشل الاتصال | تحقق من المفتاح وBase URL ووكيل الشبكة؛ ويمكنك تجربة نقطة اتصال هاتف إذا كنت تستخدم شبكة شركة أو جامعة. |
| لا يظهر رمز Cline | أعد تشغيل VS Code؛ وإذا لم يظهر بعد ذلك، فأعد تثبيت الإضافة. |