إضافة Claude Code لـ VS Code تُثبَّت مباشرة من السوق وتعمل أصلاً داخل محررك، مما يغنيك عن التنقل بين علامة تبويب المتصفح ومساحة عملك. إنها تضم نفس محرك Claude Code الذي يشغل CLI، لذا كل شيء من أوامر الشرطة المائلة إلى تحرير الملفات إلى استدعاءات أدوات MCP يعمل بنفس الطريقة، فقط داخل الشريط الجانبي للمحرر. PyCharm وبقية عائلة JetBrains تحصل على نفس المعاملة عبر إضافة JetBrains مخصصة. ولأن كلا السطحين يقرآن ANTHROPIC_BASE_URL من البيئة، فإن تبديل الواجهة الخلفية لـ LLM إلى واجهة API الخاصة بـ Novita AI — ومجموعة نماذجها الأوسع — يتطلب تغيير متغير بيئة واحد فقط.
ما الذي تفعله إضافة VS Code بالفعل
إضافة Claude Code لـ VS Code ليست مجرد علامة تبويب دردشة ملحقة بمحررك. إنها تظهر وكيل Claude Code الكامل داخل لوحة جانبية: نفس واجهة REPL، نفس مجموعة الأدوات، نفس استمرارية الجلسة. عندما تطلب منها إعادة هيكلة دالة أو كتابة اختبارات لملف مفتوح لديك، فإنها تقرأ وتحرر تلك الملفات مباشرة في مساحة عملك — دون استخدام الحافظة.
أشياء ملموسة تعالجها الإضافة:
- تعديلات متعددة الملفات مع فروقات مضمنة. يقترح Claude Code تغييرات ويعرض فرقًا يمكنك قبوله أو رفضه دون مغادرة المحرر.
- أوامر الشرطة المائلة.
/compact،/init،/memory،/clear، والباقي تعمل تمامًا كما في CLI. - تثبيت السياق. البادئة
#تتيح لك إرفاق ملفات أو مجلدات أو رموز محددة كسياق للطلب. - الوعي بـ CLAUDE.md. تعليمات المشروع ومعايير الترميز التي كتبتها في
CLAUDE.mdتُحمَّل تلقائيًا عند بدء الجلسة. - استدعاءات أدوات MCP. أي خوادم MCP مسجلة في إعدادات Claude Code الخاصة بك متاحة داخل الإضافة.
ما لا تفعله: لا تضيف إكمالًا تلقائيًا بالذكاء الاصطناعي في مخزن المحرر. لهذا، أدوات مثل Copilot أو Cline تؤدي دورًا مختلفًا. Claude Code في VS Code هو وكيل — تعطيه مهمة ويقوم بتنفيذ خطوات متعددة، وليس إكمالًا واحدًا مضمنًا.
تثبيت Claude Code في VS Code
افتح لوحة الإضافات في VS Code (Ctrl+Shift+X على ويندوز/لينكس، Cmd+Shift+X على ماك). ابحث عن Claude Code وابحث عن الإضافة المنشورة بواسطة Anthropic. انقر تثبيت.
بدلاً من ذلك، قم بتشغيل هذا الأمر من الطرفية:
code --install-extension Anthropic.claude-code
بعد التثبيت، يظهر رمز Claude في شريط النشاط في VS Code على اليسار. انقر عليه لفتح لوحة Claude Code.
مصادقة التشغيل الأولى. تطالبك الإضافة بتسجيل الدخول. لديك مساران:
- حساب Anthropic (اشتراك أو فواتير وحدة التحكم): انقر من خلال تدفق OAuth في المتصفح.
- توجيه مفتاح API إلى Novita AI: تجاوز مصادقة Anthropic تمامًا. قم بتعيين
ANTHROPIC_BASE_URLوANTHROPIC_AUTH_TOKENفي بيئتك قبل تشغيل VS Code، وستستخدم الإضافة تلك بدلاً من ذلك. الإرشادات الكاملة في القسم التالي.
التحديثات التلقائية. يقوم VS Code بتحديث الإضافة في الخلفية عند إعادة تشغيل المحرر. لا تحتاج إلى إدارة الإصدارات يدويًا.
استخدام Claude Code في VS Code يوميًا
بمجرد فتح اللوحة، تكون سير العمل مباشرة. اكتب طلبًا، يقرأ Claude Code مساحة عملك ويرد بإجراءات مقترحة. قبل أن يحرر ملفًا، يعرض لك فرقًا وينتظر الموافقة افتراضيًا.
بعض الأنماط التي تجعل الاستخدام اليومي فعالاً:
أشر إلى الملف الذي تنظر إليه. اكتب # متبوعًا باسم الملف لإرفاقه صراحةً كسياق. بالنسبة لملف مفتوح بالفعل في المحرر النشط، عادةً ما يلتقطه Claude Code تلقائيًا، لكن # مفيد عندما تريد تثبيت ملف معين عبر مهمة متعددة الملفات.
قم بتشغيل /init مرة واحدة في مشروع جديد. يؤدي هذا إلى إنشاء CLAUDE.md في جذر المستودع حيث يمكنك تخزين تعليمات خاصة بالمشروع — المكتبات المفضلة، ملاحظات الهندسة المعمارية، اتفاقيات الاختبار. يقرأ Claude Code هذا الملف في كل بداية جلسة، لذا لا تكرر نفسك.
استخدم /compact عندما تطول الجلسة. مثل CLI، تقوم الإضافة بضغط تاريخ المحادثة عند الطلب لتحرير السياق للمهمة الحالية.
تحقق من قائمة الأدوات قيد التشغيل. في أسفل اللوحة، يعرض VS Code الأداة التي يستدعيها Claude Code حاليًا (قراءات الملفات، أوامر bash، عمليات البحث على الويب). هذا مفيد لفهم ما يحدث في المهام الآلية الأطول.
التراجع هو صديقك. جميع تعديلات الملفات تمر عبر نظام ملفات VS Code القياسي، لذا فإن Ctrl+Z يعيدها مثل أي تعديل يدوي. لا توجد كومة تراجع منفصلة لتغييرات Claude Code.
توجيه الإضافة إلى Novita AI
تقرأ إضافة VS Code ANTHROPIC_BASE_URL من البيئة عند بدء التشغيل — نفس المتغير الذي يستخدمه CLI. تعيينه إلى نقطة نهاية Novita AI المتوافقة مع Anthropic يعيد توجيه كل استدعاء API بعيدًا عن خوادم Anthropic. تحصل على إمكانية الوصول إلى نماذج الترميز واستخدام الأدوات المستضافة حاليًا على Novita مثل Kimi K2.7 Code و GLM 5.2 و DeepSeek V4 Pro و MiniMax M3، ويتم الفوترة من خلال حسابك في Novita AI بأسعار رمزية لـ Novita.
الحصول على مفتاح API لـ Novita AI
سجل للحصول على حساب في Novita AI لتلقي أرصدة تجريبية مجانية. انتقل إلى إدارة المفاتيح، وأنشئ مفتاحًا جديدًا، وانسخه. هذا المفتاح يحل محل مفتاح API الخاص بـ Anthropic عند التوجيه عبر Novita.
تعيين متغيرات البيئة قبل تشغيل VS Code
macOS و Linux — أضف هذه إلى ملف تعريف shell الخاص بك (.zshrc، .bashrc، أو ما يعادله)، ثم أعد تحميله:
export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="<مفتاح API الخاص بـ Novita>"
export ANTHROPIC_MODEL="moonshotai/kimi-k2.7-code"
export ANTHROPIC_SMALL_FAST_MODEL="minimax/minimax-m3"
source ~/.zshrc # أو ~/.bashrc
ويندوز (دائم — يبقى بعد إعادة التشغيل) — استخدم PowerShell لتعيين متغيرات بيئة على مستوى المستخدم:
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL","https://api.novita.ai/anthropic","User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN","<مفتاح API الخاص بـ Novita>","User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL","moonshotai/kimi-k2.7-code","User")
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_SMALL_FAST_MODEL","minimax/minimax-m3","User")
أعد تشغيل VS Code بعد تعيين هذه حتى تقرأ الإضافة البيئة المحدثة.
ويندوز (جلسة فقط):
set ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=<مفتاح API الخاص بـ Novita>
set ANTHROPIC_MODEL=moonshotai/kimi-k2.7-code
set ANTHROPIC_SMALL_FAST_MODEL=minimax/minimax-m3
بعد تعيين هذه، قم بتشغيل VS Code من نفس shell. تلتقط الإضافة المتغيرات عند بدء التشغيل. لا تحتاج إلى تسجيل الدخول إلى Anthropic — تدير Novita المصادقة من خلال مفتاح API.
اختيار نموذج
ANTHROPIC_MODEL يخبر Claude Code عن النموذج الذي سيستخدمه للمهام الأساسية؛ ANTHROPIC_SMALL_FAST_MODEL يتحكم في العمليات الخلفية مثل ملخصات الملفات. يمكن تعيين أي نموذج متاح على واجهة LLM API لـ Novita AI هنا. النماذج المستخدمة بشكل متكرر مع Claude Code على Novita:
- Kimi K2.7 Code — توصية Novita الحالية الأولى للترميز للعمل الوكيل في IDE، مع استدلال قوي على مستوى المستودع، وتحرير الكود، وتنفيذ طويل متعدد الخطوات.
- GLM 5.2 — مناسب جيدًا عندما تريد استدلالًا عامًا أقوى ونافذة سياق كبيرة لتحليل قاعدة الكود، والوثائق، وسير العمل المختلط للترميز والكتابة.
- DeepSeek V4 Pro — خيار متوازن لمهام التنفيذ المعقدة حيث تريد العمق دون القفز إلى أغلى مستوى.
- MiniMax M3 — رفيق فعال من حيث التكلفة لـ
ANTHROPIC_SMALL_FAST_MODEL، خاصة للملخصات السريعة، والحلقات كثيفة البحث، وسير عمل استدعاء الأدوات.
معظم استخدام VS Code التفاعلي، تعيين ANTHROPIC_MODEL إلى Kimi K2.7 Code و ANTHROPIC_SMALL_FAST_MODEL إلى MiniMax M3 يعطي توازنًا عمليًا بين جودة الترميز، وموثوقية استخدام الأدوات، والتحكم في التكلفة.
للعودة إلى التوجيه الافتراضي لـ Anthropic، قم بإلغاء تعيين متغيرات البيئة:
unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN ANTHROPIC_MODEL ANTHROPIC_SMALL_FAST_MODEL
أو افتح VS Code من shell حيث لم يتم تعيين هذه المتغيرات مطلقًا.
تكامل PyCharm و JetBrains
يشحن Claude Code إضافة رسمية لمنصة JetBrains، والتي تغطي PyCharm و IntelliJ IDEA و WebStorm و GoLand و Rider وبقية عائلة JetBrains.
تثبيت الإضافة
افتح الإعدادات → الإضافات في IDE الخاص بـ JetBrains، وانتقل إلى علامة التبويب السوق، وابحث عن Claude Code. انقر تثبيت، ثم أعد تشغيل IDE عند الطلب.
بدلاً من ذلك، قم بتنزيل ملف الإضافة من موقع سوق JetBrains وقم بتثبيته عبر الإعدادات → الإضافات → تثبيت إضافة من القرص.
التشغيل الأول
بعد التثبيت، تظهر لوحة Claude Code في الشريط الجانبي لـ IDE أو منطقة نافذة الأداة اعتمادًا على تخطيطك. يطالب التشغيل الأول بالمصادقة، مطابقًا لـ VS Code.
توجيه PyCharm إلى Novita AI
تقرأ إضافة JetBrains نفس متغيرات البيئة مثل إضافة VS Code و CLI. قم بتعيين ANTHROPIC_BASE_URL و ANTHROPIC_AUTH_TOKEN و ANTHROPIC_MODEL و ANTHROPIC_SMALL_FAST_MODEL في ملف تعريف shell الخاص بك قبل تشغيل IDE، وستوجه الإضافة عبر Novita.
إذا قمت بتشغيل PyCharm من مشغل سطح المكتب بدلاً من الطرفية (شائع على macOS و Linux)، فقد لا يرث IDE بيئة shell الخاصة بك. الإصلاح الموثوق هو ملف .env لكل مشروع أو تعيين المتغيرات في بيئة مستوى النظام بدلاً من ملف تعريف shell. على macOS بشكل خاص، المتغيرات التي تم تعيينها عبر launchctl setenv تكون مرئية لتطبيقات واجهة المستخدم الرسومية.
إضافة IDE مقابل CLI: متى تستخدم أيهما
تشترك الإضافة و CLI في نفس المحرك. الفرق العملي هو السياق والتكامل.
| إضافة VS Code / JetBrains | CLI | |
|---|---|---|
| التنقل بين الملفات | انقر لفتح، # للإشارة |
يقرأ من دليل العمل الحالي؛ حدد المسارات صراحة |
| مراجعة الفروقات | مضمنة في المحرر | مخرجات الطرفية |
| مشاريع متعددة | لوحة واحدة لكل نافذة | جلسات منفصلة لكل دليل |
| CI/CD والأتمتة | غير مناسبة | علامة -p لتشغيلات الدفعات غير التفاعلية |
| التوجيه والبرمجة النصية | غير مدعومة | دعم كامل لأنابيب Unix |
| توجيه Novita AI | متغير بيئة ANTHROPIC_BASE_URL |
نفس الشيء |
الإضافة هي الخيار الأفضل عندما تكون سير العمل الأساسي لديك هو تحرير الكود بشكل تفاعلي. CLI هو الخيار الصحيح عندما تقوم بأتمتة المهام، أو تشغيل Claude Code في البرامج النصية، أو التكامل مع CI، أو البناء على Claude Code SDK. إذا كانت قائمتك المختصرة هي وكلاء الترميز الطرفية تحديدًا، فشاهد OpenAI Codex مقابل Claude Code لمقارنة أعمق بين CLI و CLI.
صندوق الحماية للوكيل من Novita AI
عندما تنتقل من التطوير التفاعلي إلى خطوط الأنابيب الآلية، لم تعد إضافة VS Code هي السطح المناسب. تشغيل Claude Code بدون رأس — مراجعات PR الدفعية، إنشاء الاختبارات الآلي، إعادة هيكلة المستودعات المتعددة، وكلاء الترميز المتكاملين مع CI — يحتاج إلى بيئة تنفيذ معزولة بدلاً من جلسة IDE محلية.
يوفر صندوق الحماية للوكيل من Novita AI أجهزة افتراضية صغيرة مدعومة بـ Firecracker لتشغيل الوكلاء برمجيًا. يبدأ كل صندوق حماية نظيفًا، ويعمل في عزلة تامة عن جهاز التطوير الخاص بك، ويتم الفوترة بالثانية من الاستخدام. حالات الاستخدام العملية:
- مراجعة PR الدفعية. أنشئ صندوق حماية لكل PR، وقم بتشغيل Claude Code مع موجه مراجعة، واجمع المخرجات، ثم قم بتدمير صندوق الحماية. لا تتراكم حالة محلية بين عمليات التشغيل.
- إنشاء الاختبارات الآلي. قم بتشغيل صندوق حماية من CI على الفروع الجديدة، واجعل Claude Code يقرأ الفرق ويولد الاختبارات، ثم قم بإعادة النتائج عبر API المستودع.
- أدوات التقييم. قم بتشغيل نفس مهمة الترميز عبر تكوينات نموذج متعددة في صناديق حماية متوازية. يستخدم كل صندوق حماية نفس توجيه
ANTHROPIC_BASE_URLالذي قمت بتعيينه محليًا — قم بتبديلANTHROPIC_MODELلكل صندوق حماية لمقارنة Kimi K2.7 Code و GLM 5.2 و DeepSeek V4 Pro و MiniMax M3 ضد بعضها البعض في مهام حقيقية. - سير عمل متعدد الوكلاء. صناديق الحماية قابلة للتكوين. يحصل كل وكيل فرعي على بيئته المعزولة الخاصة؛ تتجمع النتائج في المنبع دون أن يلمس أي وكيل نظام ملفات وكيل آخر.
الواجهة بين استخدام VS Code وصندوق الحماية هي نفس طبقة متغير البيئة. سير العمل الذي يوجه عبر نقطة نهاية Novita AI المتوافقة مع Anthropic في الإضافة يعمل بدون رأس في صندوق حماية دون أي تغييرات في الكود.
الأسئلة الشائعة
هل أحتاج إلى اشتراك مدفوع في Anthropic لاستخدام إضافة VS Code؟
لا — إذا قمت بتوجيه الإضافة إلى Novita AI عبر ANTHROPIC_BASE_URL، فإن جميع الفواتير تمر عبر حسابك في Novita AI. حساب Anthropic غير مطلوب ولا يتم فوترته.
كيف أقوم بتثبيت إضافة Claude Code لـ VS Code؟
افتح لوحة الإضافات في VS Code (Ctrl+Shift+X)، وابحث عن Claude Code (الناشر: Anthropic)، وانقر تثبيت. أو قم بتشغيل code --install-extension Anthropic.claude-code من طرفية.
هل تعمل إضافة Claude Code في Cursor؟
Cursor هو نسخة مشتقة من VS Code ويدعم معظم إضافات VS Code. قد يتم تثبيت إضافة Claude Code، لكن Cursor يشحن بالفعل تكامل Claude المدمج الخاص به. تشغيل كلاهما في وقت واحد يمكن أن ينتج اقتراحات مكررة وتدفقات مصادقة متعارضة. معظم المطورين يستخدمون واحدًا أو الآخر، وليس كليهما.
هل هناك إضافة متصفح لـ Claude؟
لا توجد إضافة متصفح رسمية لـ Claude من Anthropic. يعمل Claude Code كإضافة VS Code، وإضافة JetBrains، و CLI، وتطبيق سطح مكتب، ومن خلال واجهة الويب على claude.ai/code — ولكن ليس كإضافة متصفح تتصل بصفحات ويب عشوائية.
كيف يمكنني تبديل النماذج دون إعادة تشغيل VS Code؟
قم بتغيير ANTHROPIC_MODEL في ملف تعريف shell الخاص بك، ثم أعد فتح VS Code من جلسة طرفية جديدة. داخل جلسة VS Code قيد التشغيل، لا يوجد مبدل نماذج داخل اللوحة — تتم قراءة متغير البيئة عند بدء التشغيل.
هل يمكنني استخدام نماذج مختلفة لمشاريع مختلفة؟
نعم. قم بتعيين ANTHROPIC_MODEL في ملف .env على مستوى المشروع أو تعليمات CLAUDE.md، أو استخدم direnv لتحديد نطاق متغيرات البيئة لأدلة محددة. يحترم Claude Code قيم البيئة على مستوى الجلسة، لذا يمكن تحقيق التوجيه لكل مشروع باستخدام أدوات ملفات النقاط القياسية.
كيف يختلف دمج Claude مع VSCode عن استخدام Cline؟
Cline هي إضافة تحول VS Code إلى بيئة ترميز وكيلية باستخدام أي واجهة خلفية متوافقة مع OpenAI. Claude Code هو وكيل Anthropic الخاص، متاح كإضافة VS Code، مع مجموعة أدواته الخاصة وحلقة الاستدلال الخاصة به. الفرق العملي الرئيسي: يمنحك Cline تحكمًا أكبر في أي مزود ونموذج يدير الحلقة، بينما Claude Code متكامل بإحكام مع عائلة نموذج Claude افتراضيًا — على الرغم من أن ANTHROPIC_BASE_URL يسمح لك بإعادة توجيهه إلى نقطة نهاية Novita AI المتوافقة.
مقالات مقترحة
