موارد المطورين

Claude Code في VS Code وCursor

ثبّت امتداد Claude Code في VS Code أو Cursor وصّل إعداداته المشتركة بـ RunAPI.

نظرة عامة

تعمل إضافة Claude Code الرسمية في كلٍّ من VS Code وCursor. يستخدم كلا المحررَين إعدادات مستخدم Claude Code ذاتها، لذا يُثبّت هذا الدليل الإضافة المقابلة ويُهيّئ RunAPI مرة واحدة في ~/.claude/settings.json.

قبل البدء

ثبّت إصداراً مدعوماً من VS Code أو Cursor. يُذكر الحد الأدنى الحالي لإصدار VS Code في دليل الامتداد الرسمي.
أنشئ مفتاح API قياسياً وفق دليل المصادقة. لا تضعه في إعدادات مساحة العمل أو نظام التحكم في الإصدار.
انسخ معرّف نموذج يدعم Anthropic Messages من كتالوج النماذج.

التثبيت

ثبّت الامتداد الرسمي anthropic.claude-code:

VS Code: افتح قائمة VS Code Marketplace أو ابحث في Extensions عن Claude Code.
Cursor: افتح cursor:extension/anthropic.claude-code أو ابحث في Extensions عن Claude Code.

تتضمن الإضافة وقت التشغيل اللازم للوحة الدردشة الخاصة بها. ثبّت واجهة سطر الأوامر المستقلة فقط إذا كنت تريد أيضًا تشغيل claude في الطرفية المدمجة.

إعداد RunAPI

افتح ~/.claude/settings.json وأضف إعدادات البيئة المشتركة على مستوى المستخدم:

JSON

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://runapi.ai",
    "ANTHROPIC_API_KEY": "YOUR_RUNAPI_API_KEY",
    "ANTHROPIC_MODEL": "YOUR_RUNAPI_MODEL_ID"
  }
}

في إعدادات VS Code أو Cursor، ابحث عن Claude Code login وفعّل Disable Login Prompt لهذه النقطة النهائية المخصصة. إعدادات المستخدم مشتركة مع CLI؛ إعدادات امتداد VS Code تتحكم فقط في سلوك الامتداد.

احتفظ بالمفتاح الحقيقي خارج .claude/settings.json وإعدادات مساحة عمل المحرر لأن تلك الملفات قد تُرفع إلى المستودع.

اختر نموذجاً

استبدل YOUR_RUNAPI_MODEL_ID بمعرّف دقيق من كتالوج النماذج. في لوحة Claude Code، يُغيّر /model الاختيار الحالي، ويعرض /status النموذج النشط.

تحقق

أعد تحميل نافذة المحرر بعد تغيير الإضافة أو الإعدادات.
افتح لوحة Claude Code Spark.
نفِّذ /status وتحقق من إعدادات المستخدم والنموذج.
أرسل Describe this repository in one sentence. وتحقق من صحة الاستجابة.

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

لن تتثبّت الإضافة: تأكد من أن إصدار المحرر يستوفي المتطلبات الرسمية.
أيقونة Spark مفقودة: أعد تحميل نافذة المحرر، ثم أعد تشغيله.
لا تزال تظهر نافذة تسجيل الدخول: فعّل Disable Login Prompt في إعدادات إضافة Claude Code.
اللوحة لا تَرث متغيرات الصدفة: استخدم ~/.claude/settings.json، أو شغّل المحرر من الطرفية المُهيَّأة. كثيراً ما تبدأ تطبيقات واجهة المستخدم الرسومية دون بيئة الطرفية.
تعمل CLI لكن اللوحة لا تعمل: أعد تحميل النافذة واستخدم CLI المستقلة لاستعادة الطلب مع تشخيصات أكثر تفصيلاً.
فشل المصادقة أو اختيار النموذج: تحقق من المفتاح في دليل المصادقة وانسخ المعرّف الدقيق من كتالوج النماذج.

الخطوات التالية

استخدم البدء السريع لـ LLM API للاطلاع على سلوك البروتوكول ومرجع Anthropic Messages API لحقول الطلب. لإضافة أدوات RunAPI داخل المحرر، تابع مع نظرة عامة على MCP.