تكامل JetBrains

📚 التنقل في السلسلة: المقال السابق 08 تكامل VS Code جلب Claude Code إلى VS Code. هذا المقال يغير المعسكر - إذا كان عملك الأساسي يعتمد على عائلة JetBrains مثل IntelliJ IDEA و PyCharm و WebStorm، فهناك أيضا إضافة أصلية، وطريقة اللعب متشابهة ومختلفة في نفس الوقت. المقال التالي 10 تطبيق سطح المكتب.

أ: «أنا أعمل على PyCharm كل يوم، لذا فإن إضافة VS Code لا تعنيني، أليس كذلك؟»

ب: «هناك إضافة أصلية، قم بتثبيتها، ويمكنك استدعاء Claude من داخل المحرر بالضغط على Cmd+Esc.»

أ: «هل هي نفس إضافة VS Code؟ هل هناك ميزات مثل diff وإشارات @؟»

ب: «النواة هي نفس CLI، لكن الواجهة لم يقم بها نفس الأشخاص - بعض الأشياء متشابهة، وبعضها يتطلب منك تغيير طريقتك. على سبيل المثال، يتم تشغيله افتراضيا في الوحدة الطرفية المدمجة في IDE، وليس كلوحة مستقلة.»

هذا هو سؤال شائع لدى أولئك الذين يكتبون الواجهة الخلفية (backend) باستخدام GoLand: مستخدمو JetBrains يقلقون دائما من أنهم "مواطنون من الدرجة الثانية"، وأن الأشياء الجيدة تذهب أولا إلى VS Code.

بصراحة، هذا القلق نصفه صحيح ونصفه خاطئ. الجزء الصحيح: إضافة JetBrains بالفعل أخف من إضافة VS Code، فهي تربط بين CLI و IDE لتسمح للمعلومات بالتدفق بين الجانبين، بدلا من إنشاء لوحة رسومية شاملة وكبيرة. الجزء الخاطئ: التجربة الأساسية التي يجب أن تكون موجودة لم تنقص أبدا.

هذا المقال سيوضح: كيفية التثبيت، كيفية الاتصال، ما هو الفرق مقارنة بـ VS Code، وكيفية حل المشاكل الخاصة بـ JetBrains (مثل تعطل مفتاح ESC، و WSL، والتطوير عن بعد).

بعد قراءة هذا المقال، ستحصل على:

• الخطوات الكاملة لتثبيت إضافة Claude Code في JetBrains IDE مثل IntelliJ / PyCharm / WebStorm
• متى تستخدم طريقتي الاتصال "الوحدة الطرفية المدمجة في IDE" و "الوحدة الطرفية الخارجية /ide"
• جدول مقارنة بين "إضافة JetBrains مقابل إضافة VS Code"، بالإضافة إلى اختصارات لوحة المفاتيح الخاصة بـ JetBrains
• الحلول الرسمية لثلاث مشاكل شائعة: تعطل مقاطعة مفتاح ESC، وخطأ "لا يمكن اكتشاف IDE" في WSL2، والتطوير عن بعد

---

01 دعنا نوضح أولا: ماذا تفعل الإضافة بالضبط

العديد من الأشخاص يكونون في حيرة بعد تثبيت الإضافة: «لقد قمت بتثبيت الإضافة، لماذا لا أرى لوحة دردشة مثل تلك الموجودة في VS Code؟»

الاستنتاج أولا: إضافة JetBrains ليست نافذة دردشة مستقلة، بل هي «جسر». إن Claude Code نفسه لا يزال عبارة عن CLI يعمل في الوحدة الطرفية، وما تفعله الإضافة هو توصيل IDE بـ CLI - فالكود الذي تحدده في المحرر، وأخطاء lint التي يبلغ عنها IDE، والتعديلات التي يريد Claude إجراءها، يمكن تمريرها ذهابا وإيابا بين "IDE" و "Claude في الوحدة الطرفية" تلقائيا.

تشبيه: AirDrop بين الهاتف والكمبيوتر. الملفات والحافظة موجودة بشكل منفصل على كل جهاز، ولكن عند تشغيل AirDrop "يتعرف" الجهازان على بعضهما البعض - تقوم بالنسخ على الكمبيوتر وتلصقه مباشرة على الهاتف. الإضافة هي هذه القناة بين IDE و Claude: عندما تحدد قطعة من الكود في PyCharm، يراها Claude في الوحدة الطرفية "على الفور"، دون الحاجة للنسخ واللصق.

لذلك هناك إدراك رئيسي:

في JetBrains، المكان الذي تتحدث فيه مع Claude هو الوحدة الطرفية المدمجة مع IDE - وليس لوحة جانبية مفتوحة حديثا.

هذا هو الاختلاف الأكبر في التجربة مقارنة بـ VS Code: تمنحك إضافة VS Code لوحة دردشة رسومية؛ بينما تتيح لك JetBrains تشغيل claude في الوحدة الطرفية المدمجة، وتوفر الإضافة السياق في الخلفية. تتم المحادثة في الوحدة الطرفية، وتظهر التغييرات (diff) في عارض IDE الأصلي، مما يجمع بين مزايا الجانبين مع تكلفة تعلم تقارب الصفر - الأوامر والاختصارات وأوامر الشرطة المائلة / كلها نفس تلك الموجودة في الوحدة الطرفية. عندما قمت بتثبيت الإضافة لأول مرة في IntelliJ، كنت قلقا من الاضطرار إلى التكيف مع واجهة جديدة، لكنني اكتشفت أنه نفس Claude المألوف في الوحدة الطرفية، لكنه فجأة "طوّر عينين" ويمكنه رؤية ما حددته وأين حدد IDE الأخطاء باللون الأحمر.

💡 ملخص في جملة واحدة: إضافة JetBrains هي بمثابة "AirDrop" بين IDE و CLI، حيث تتم المحادثة في الوحدة الطرفية المدمجة، وتنبثق تغييرات diff في IDE، وليست لوحة دردشة مستقلة.

---

02 ما هي بيئات IDE المدعومة، لنتحقق منها أولا

JetBrains هي عائلة كاملة، وليست برنامجا واحدا. الأخبار السارة هي: تغطي إضافة Claude Code تقريبا جميع بيئات التطوير الرئيسية.

قائمة الدعم الرسمية المحددة:

IDE	اللغة / السيناريو الرئيسي
IntelliJ IDEA	Java / Kotlin، الواجهة الخلفية، تطوير Android الأصلي
PyCharm	Python، البيانات، الذكاء الاصطناعي، السكربتات
WebStorm	الواجهة الأمامية JS / TS
PhpStorm	PHP
GoLand	Go
Android Studio	تطوير Android (مبني على IntelliJ)

البيان الرسمي هو "مناسب لمعظم بيئات JetBrains IDE" - بيئات JetBrains IDE غير الموجودة في القائمة (مثل RubyMine و CLion و Rider إلخ) من المحتمل جدا أن تعمل أيضا، لكن لا يوجد ضمان رسمي، استخدمها إذا تمكنت من تثبيتها، وعاملها كـ "غير مدعومة رسميا" في حال حدوث مشاكل.

تشبيه: موديلات مختلفة لنفس العلامة التجارية، تشترك في نفس نظام السيارة. يشبه IntelliJ و PyCharm و WebStorm سيارة السيدان وسيارات الدفع الرباعي والسيارات الرياضية من نفس الشركة المصنعة، بمواقع مختلفة ولكن الأساس هو نفس المنصة (جميعها مبنية على منصة IntelliJ Platform). لذلك تثبت الإضافة مرة واحدة وتستخدمها في كل مكان، جميع خطوات التشغيل في هذا المقال متطابقة بغض النظر عما إذا كنت تستخدم IntelliJ أو GoLand. سنستخدم PyCharm في التوضيح أدناه.

توضح الصورة أعلاه هذه العلاقة بوضوح: الإضافة العلوية لـ Claude Code هي إضافة واحدة، وتتفرع للأسفل لتناسب كل IDE؛ وعلى الرغم من أن IntelliJ IDEA و PyCharm و WebStorm وغيرها يدير كل منها لغة مختلفة، إلا أنها تعتمد جميعها على نفس قاعدة IntelliJ Platform - لذلك يتم تثبيت إضافة واحدة مرة واحدة، وتعمل في كل مكان، وخطوات التثبيت والتكوين هي نفسها في كل مكان.

💡 ملخص في جملة واحدة: بيئات JetBrains IDE الرئيسية مدعومة، وتتشارك جميعها في نفس قاعدة منصة IntelliJ - وخطوات التثبيت والتكوين متطابقة تماما في أي IDE.

---

03 التثبيت: الإضافة + CLI، لا غنى عن أحدهما

هذه الخطوة هي الأكثر عرضة للخطأ، لأن تكامل JetBrains يتطلب كلا الأمرين: الإضافة، و CLI لـ Claude Code نفسه، ولا يمكن الاستغناء عن أي منهما.

تشبيه: تطبيق الهاتف + الحساب في الخلفية. إذا قمت بتثبيت التطبيق (الإضافة) ولكنك لم تقم بتسجيل حساب (CLI)، فإن فتحه سيكون مجرد قشرة فارغة - الإضافة مسؤولة عن تكامل الواجهة، بينما "الخلفية" التي تقوم بالعمل الفعلي هي CLI. لذلك تأكد من وجود CLI قبل تثبيت الإضافة.

الخطوة الأولى: تأكد أولا من تثبيت CLI

إذا اتبعت هذه السلسلة وقرأتها من البداية، فستكون قد قمت بتثبيت CLI في المقال الثاني (02). إذا لم تكن متأكدا، قم بتشغيل هذا الأمر في أي وحدة طرفية:

claude --version

الناتج المتوقع: يطبع سلسلة من أرقام الإصدارات، مثل 2.x.x (Claude Code).

إذا ظهرت رسالة command not found، فهذا يعني أن CLI لم يتم تثبيته بعد. ارجع إلى مقال 02 التثبيت لتثبيته، أو استخدم أمر التثبيت الرسمي (حسب المنصة):

# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# Windows PowerShell
irm https://claude.ai/install.ps1 | iex

ملاحظة للداخل: تثبيت CLI، والترخيص اللاحق وتسجيل الدخول، وجعل Claude يقوم بالعمل، جميعها تتطلب الاتصال بخدمات Anthropic طوال العملية، مما يتطلب استخدام أدوات تجاوز الحجب. هذه النقطة متوافقة مع إصدار الوحدة الطرفية وإصدار VS Code.

الخطوة الثانية: تثبيت إضافة JetBrains

هناك طريقتان، ونوصي بالطريقة الأولى.

الطريقة الأولى: البحث في IDE (موصى بها)

1. افتح JetBrains IDE الخاص بك
2. انتقل إلى Settings (الإعدادات) → Plugins (الإضافات) (اختصار Mac هو Cmd+,، وفي Windows/Linux هو Ctrl+Alt+S)
3. انتقل إلى علامة التبويب Marketplace (السوق)
4. ابحث عن Claude Code
5. انقر فوق Install (تثبيت)
6. بعد التثبيت، يجب إعادة تشغيل IDE

الطريقة الثانية: التثبيت من الموقع الرسمي لسوق الإضافات

قم بزيارة صفحة Claude Code في سوق إضافات JetBrains مباشرة، واتبع التعليمات الموجودة في الصفحة لتثبيته.

لاحظ أن اسم الإضافة يحتوي على اللاحقة [Beta] - وهذا يشير إلى أنها لا تزال في المرحلة التجريبية (Beta)، وقد يتغير سلوكها مع توالي الإصدارات (الرجوع إلى الوثائق الرسمية). الوظائف تعمل، لكن لا تعتبرها إصدارا نهائيا ومستقرا.

الخطوة الثالثة: إعادة تشغيل IDE (لا تتخط هذه الخطوة)

أكدت الوثائق الرسمية بشكل خاص على جملة واحدة:

بعد تثبيت الإضافة، قد تحتاج إلى إعادة تشغيل IDE بالكامل لكي تدخل الإضافة حيز التنفيذ.

"إعادة التشغيل بالكامل" تعني الخروج تماما ثم فتحه مرة أخرى، وليس إغلاق نافذة واحدة. من السهل جدا الوقوع في هذا الفخ - فبعد التثبيت، تقوم بتشغيل claude في IDE ولا يتم تنشيط وظائف التكامل، وتعتقد أن الإضافة معطلة؛ بينما إذا قمت بالخروج تماما من IntelliJ وأعدت تشغيله، سيعمل كل شيء بشكل طبيعي. أدرجت الوثائق الرسمية هذه المشكلة أيضا كأول بند في استكشاف أخطاء "الإضافة لا تعمل"، مما يدل على مدى شيوعها.

❌ أخطاء شائعة	✅ الطريقة الصحيحة
تثبيت الإضافة فقط، دون تثبيت CLI	قم بتأكيد وجود CLI أولا باستخدام claude --version
استخدامه دون إعادة التشغيل بعد التثبيت	اخرج من IDE تماما وأعد تشغيله بعد التثبيت
تثبيت إضافات مشابهة عشوائيا	تأكد من تثبيت الإضافة الرسمية Claude Code [Beta]
إغلاق النافذة لاعتبارها إعادة تشغيل	"إعادة التشغيل بالكامل" = إنهاء العملية تماما ثم بدء التشغيل من جديد

💡 ملخص في جملة واحدة: تكامل JetBrains = CLI الأساسي + الإضافة، يجب تثبيت كليهما؛ وبعد التثبيت، يجب إعادة تشغيل IDE بالكامل، وهذا هو السبب الأكثر شيوعا لعدم عمل الإضافة بعد تثبيتها.

---

04 الاتصال: وضعيتان، حسب المكان الذي تبدأ منه

بعد تثبيت الإضافة وإعادة تشغيل IDE، فإن الخطوة التالية هي "توصيل" Claude Code بـ IDE. بعد التوصيل، سيتم تنشيط مشاركة التحديد، وانبثاق التغييرات (diff) في IDE، ومشاركة التشخيص. تعتمد طريقة الاتصال على المكان الذي تبدأ منه تشغيل Claude.

الوضعية الأولى: التشغيل من الوحدة الطرفية المدمجة في IDE (موصى بها، اتصال تلقائي)

هي الأكثر راحة. افتح الوحدة الطرفية المدمجة مع IDE (عادة في الأسفل، مع علامة التبويب Terminal)، وقم بتشغيل الأمر مباشرة:

claude

النتيجة المتوقعة: يتم تشغيل Claude Code، وتنشط جميع وظائف التكامل تلقائيا، دون أي إجراء اتصال يدوي. لأنك بدأت من "داخل" IDE، تعرف الإضافة بشكل طبيعي بأي IDE يجب أن تتصل.

تشبيه: الاتصال بشبكة Wi-Fi في غرفة المعيشة الخاصة بك. عند فتح هاتفك في المنزل، يتصل تلقائيا دون إدخال كلمة مرور. تشغيل Claude من الوحدة الطرفية المدمجة يشبه هذه التجربة - عندما تكون البيئة صحيحة، يكتمل الاتصال تلقائيا.

الوضعية الثانية: التشغيل من وحدة طرفية خارجية، الاتصال اليدوي باستخدام /ide

إذا كنت معتادا على استخدام وحدات طرفية مستقلة مثل iTerm أو Windows Terminal، فابدأ تشغيل Claude أولا، ثم قم بتوصيله يدويا:

claude

ثم اكتب في محادثة Claude:

/ide

النتيجة المتوقعة: يدرج Claude بيئات JetBrains IDE المكتشفة، حدد البيئة المقابلة، وسيتم إنشاء الاتصال وتنشيط الوظائف. تشبيه: الاتصال بشبكة Wi-Fi في منزل شخص آخر، عليك اختيار الشبكة يدويا - /ide هو هذا الإجراء.

شرط مسبق يسهل تجاهله: التشغيل من المجلد الجذر للمشروع

بغض النظر عن الوضعية، تؤكد الوثائق الرسمية:

إذا كنت تريد أن يتمكن Claude من الوصول إلى نفس الملفات التي يصل إليها IDE، يرجى بدء تشغيل Claude Code من نفس المجلد الجذر للمشروع المفتوح في IDE.

بصراحة: مهما كان المشروع المفتوح في IDE، قم بتشغيل claude في المجلد الجذر لذلك المشروع. إذا قمت بتشغيله من مجلد مثل ~/Downloads، فإن الملفات التي يراها Claude لن تتطابق مع المشروع الموجود في IDE. البدء من الوحدة الطرفية المدمجة يلبي هذا الشرط بشكل طبيعي - وهذا سبب آخر لكونه الوضعية الأولى الموصى بها.

مصدر التشغيل	طريقة الاتصال	مجلد المشروع
الوحدة الطرفية المدمجة في IDE	تنشيط تلقائي، دون الحاجة للتدخل	الافتراضي هو المجلد الجذر للمشروع ✅
الوحدة الطرفية الخارجية (iTerm وغيرها)	تشغيل يدوي لـ /ide واختيار IDE	يتطلب منك استخدام cd للانتقال إلى المجلد الجذر للمشروع

بشكل عام، الاعتماد على الوحدة الطرفية المدمجة في IDE طوال الوقت يعتبر كافيا - حيث يكتمل الاتصال تلقائيا، وتتطابق المجلدات بشكل طبيعي، وتكون الوحدة الطرفية والكود في نفس النافذة، وبالضغط على Cmd+Esc يمكنك التنقل بينهما. ما لم تكن بالفعل تشغل شيئا آخر في وحدة طرفية خارجية، فلا تستخدم /ide للاتصال المؤقت.

💡 ملخص في جملة واحدة: التشغيل من الوحدة الطرفية المدمجة في IDE = اتصال تلقائي، وتطابق المجلدات بشكل طبيعي (موصى به)؛ التشغيل من الوحدة الطرفية الخارجية = الاتصال اليدوي عن طريق تشغيل /ide. في كلتا الحالتين، ابدأ دائما من المجلد الجذر للمشروع.

---

05 ماذا يمكنه أن يفعل: خمس وظائف للتكامل

بعد الاتصال، أدرجت الوثائق الرسمية خمس "مزايا" تقدمها الإضافة، وسنشرحها واحدة تلو الأخرى مع التركيز على الاختلافات عن VS Code، ونلقي نظرة عامة على جدول المقارنة في نهاية هذا القسم.

• ① التشغيل السريع: اضغط على Cmd+Esc (في Mac) أو Ctrl+Esc (في Windows/Linux) في المحرر لفتح Claude مباشرة، أو يمكنك النقر على الزر في واجهة المستخدم. وهذا هو الأكثر استخداما - عندما تكتب الكود وترغب في طرح سؤال، لا تحتاج إلى استخدام الماوس للنقر على علامة تبويب الوحدة الطرفية، بل ينقل الاختصار التركيز مباشرة.
• ② مشاركة سياق التحديد: تتم مشاركة الكود المحدد حاليا في المحرر، أو علامات التبويب المفتوحة، تلقائيا مع Claude. حدد فقرة واسأل "لماذا تُظهر هذه الفقرة خطأ"، وسيعرف أي فقرة تقصد.
• ③ اختصار الإشارة للملف: اضغط على Cmd+Option+K (في Mac) أو Alt+Ctrl+K (في Linux/Windows) لإدراج إشارة للملف، مثل @src/auth.ts#L1-99، مع مسار ورقم سطر، مما يسمح لـ Claude بتحديد الموقع بدقة.
• ④ عرض التغييرات (Diff): يتم عرض تعديلات الكود مباشرة في عارض diff الخاص بـ IDE، بدلا من استخدام رموز نصية لرسمها في الوحدة الطرفية (قد لا يتم تمكينه افتراضيا، يجب تعيينه على auto، وسنشرح ذلك في القسم التالي).
• ⑤ مشاركة التشخيص: الخطوط الحمراء والصفراء لتحذيرات lint الخاصة بـ IDE والأخطاء النحوية، تتم مشاركتها تلقائيا مع Claude، يمكنه "رؤية" الأماكن المحددة باللون الأحمر مباشرة، دون الحاجة منك لنسخ رسالة الخطأ.

نقطتان حول الأمان ونقاط الخطأ المحتملة يجب ذكرهما بشكل منفصل:

⚠️ الأمان (متوافق مع VS Code): إذا طابق ملف ما قاعدة المنع Read التي عينتها، فسيتم حظر مشاركة التحديد الخاص به ولن يتم إرساله إلى Claude (يخضع للوثائق الرسمية). يُنصح بإضافة ملفات حساسة مثل .env.

⚠️ سهولة الخطأ: اختصار الإشارة للملف يختلف عن VS Code - ففي VS Code هو Option+K / Alt+K، أما في JetBrains فيوجد مفتاح إضافي، وهو Cmd+Option+K / Alt+Ctrl+K، وهذا هو الخطأ الأكثر شيوعا لمن ينتقل من VS Code.

تجربة مشاركة التشخيص هذه عميقة جدا. كان فحص الكود في JetBrains دائما واحدا من أقوى الأدوات في الصناعة - في الماضي، كان عليك نسخ الأخطاء المحددة باللون الأحمر إلى Claude في الوحدة الطرفية، ولكن الآن يمكنه قراءتها مباشرة. على سبيل المثال، إذا حدد PyCharm "عملية استيراد غير مستخدمة" مع بضعة خطوط صفراء لعدم تطابق الأنواع، فبمجرد قول "أصلح المشاكل المحددة بواسطة IDE"، سيقوم بإصلاحها بناء على التشخيصات واحدة تلو الأخرى، دون الحاجة منك لنسخ ولصق رسالة الخطأ.

وظيفة التكامل	JetBrains	VS Code	ملاحظات
التشغيل السريع	Cmd/Ctrl+Esc	Cmd/Ctrl+Esc	متطابق
مشاركة التحديد / علامات التبويب	✅ تلقائي	✅ تلقائي	متطابق
اختصار الإشارة للملف	Cmd+Option+K / Alt+Ctrl+K	Option+K / Alt+K	مختلف!
انبثاق Diff في IDE	✅ (يتطلب تعيين auto)	✅	متطابق
مشاركة التشخيص	✅ تلقائي	✅ تلقائي	متطابق
شكل واجهة المحادثة	الوحدة الطرفية المدمجة في IDE	لوحة رسومية مستقلة	الفرق الجوهري

💡 ملخص في جملة واحدة: من بين المزايا الخمس، تتطابق مشاركة التحديد، مشاركة التشخيص، وانبثاق diff في IDE بشكل أساسي مع VS Code؛ والاختلاف الأكبر هو أن المحادثة تعمل في الوحدة الطرفية المدمجة، بالإضافة إلى أن اختصار الإشارة للملف يتطلب الضغط على مفتاح إضافي.

---

06 التكوين: استدعاء التغييرات (diff)، ثم ضبط الإضافة

التثبيت والاتصال ليسا كافيين، هناك إعدادان يستحقان استغراق دقيقتين لضبطهما، حيث أنهما يحدثان فرقا كبيرا في التجربة.

الإعداد الأول: تعيين أداة التغييرات (diff) إلى auto (مهم)

ذكرنا سابقا أن diff يمكن أن ينبثق في IDE، ولكن هذا يعتمد على إعداد معين. في Claude Code، قم بتشغيل /config، وابحث عن أداة التغييرات (diff tool)، واضبطها على auto:

/config

القيمة	التأثير
auto	يتم عرض التعديلات جنبا إلى جنب في عارض diff الخاص بـ IDE (موصى به)
terminal	تبقى التعديلات في الوحدة الطرفية وتُرسم باستخدام رموز نصية

يُنصح بشدة بضبطه على auto هنا - فبما أنك تستخدم IDE، يجب عليك الاستفادة من طريقة عرض diff جنبا إلى جنب سهلة الاستخدام في JetBrains، حيث أن عرض diff النصي في الوحدة الطرفية يكون متعبا للعين حقا عند كثرة التعديلات.

الإعداد الثاني: إعدادات الإضافة (Settings → Tools → Claude Code [Beta])

تختفي إعدادات الإضافة نفسها في Settings → Tools → Claude Code [Beta]. هناك بعض الإعدادات التي تستحق المعرفة:

• مسار أمر Claude (Claude command): الافتراضي هو claude؛ إذا كان claude الخاص بك ليس في مسار PATH القياسي، فيمكنك ملء المسار المطلق (مثل /usr/local/bin/claude) أو npx @anthropic-ai/claude-code. عند النقر فوق رمز Claude وتظهر لك رسالة «command not found»، فإن هذا هو المكان الذي يجب إعداده في الغالب.
• إخفاء إشعار "لم يتم العثور على أمر Claude": يمكنك إيقاف تشغيله إذا كنت تنزعج من التنبيهات.
• تمكين إدخال أسطر متعددة باستخدام Option+Enter (لنظام macOS فقط): بعد التمكين، يُدرج Option+Enter فاصلا سطرية في مربع الإدخال. أوقفه إذا تم التقاط مفتاح Option بالخطأ وتأثرت الكتابة، ويتطلب ذلك إعادة تشغيل الوحدة الطرفية لتفعيل التغيير.
• تمكين التحديثات التلقائية: يتحقق تلقائيا من تحديثات الإضافة ويثبتها، ويتم تطبيقها عند إعادة التشغيل.

من بين هذه الخيارات، أهم خيار يجب تذكره هو مسار Claude command في السطر الأول - عند النقر على أيقونة Claude وتلقي رسالة "command not found"، يكون هذا في الغالب بسبب حاجتك لتهيئة المسار.

💡 ملاحظة خاصة لمستخدمي WSL: قم بتعيين أمر Claude إلى wsl -d Ubuntu -- bash -lic "claude" (استبدل Ubuntu باسم توزيعة WSL الخاصة بك).

💡 ملخص في جملة واحدة: ادخل إلى Claude Code وشغّل /config لتعيين diff على auto، ثم انتقل إلى Settings → Tools → Claude Code [Beta] لضبط الإضافة - حيث يعد مسار Claude command المفتاح لاكتشاف أخطاء "لم يتم العثور على الأمر".

---

07 ثلاثة فخاخ حصرية لمستخدمي JetBrains

هذه الفخاخ الثلاثة أدناه هي ما يتعرض له مستخدمو JetBrains أكثر من مستخدمي VS Code، وقد ذكرت الوثائق الرسمية حلولا خاصة لها.

الفخ الأول: تعطل مقاطعة مفتاح ESC

الوحدة الطرفية في JetBrains لديها مشكلة قديمة: تريد الضغط على ESC لمقاطعة عملية يُجريها Claude حاليا، فتجد أن التركيز يقفز "فجأة" إلى المحرر، ولا تتم المقاطعة. والسبب هو أنه يربط ESC افتراضيا بـ "نقل التركيز إلى المحرر". الحل:

1. انتقل إلى Settings → Tools → Terminal
2. اختر أحد الخيارين: ألغ تحديد "استخدام Escape لنقل التركيز إلى المحرر" (Move focus to the editor with Escape)، أو انقر فوق "تكوين اختصارات الوحدة الطرفية" واحذف الربط الخاص بـ "تبديل التركيز إلى المحرر" (Switch focus to Editor)
3. تطبيق التغييرات

بعد هذا التغيير، سيقوم مفتاح ESC بالمقاطعة بشكل طبيعي. نوصي بشدة بتغييره بمجرد التثبيت - وإلا إذا خرج Claude عن السيطرة في يوم من الأيام وأردت إيقافه، ستضغط على ESC دون أي استجابة، وهذا قد يكون أمرا مقلقا حقا.

الفخ الثاني: يعرض WSL2 "لم يتم اكتشاف IDE متاح"

عند استخدام Claude Code + JetBrains IDE على WSL2، وغالبا ما يعرض الأمر /ide رسالة "No available IDEs detected". السبب الأساسي ليس عطلا في الإضافة، ولكن شبكة NAT في WSL2 أو جدار حماية Windows يحجب الاتصال بين "Claude في WSL2" و "IDE في Windows" (في حين لا يتأثر WSL1). يقدم الموقع الرسمي حلين، يُوصى بالحل الأول (السماح في جدار الحماية)، لأنه لا يغير وضع الشبكة الحالي:

# الخطوة الأولى: التحقق من عنوان IP في WSL shell
hostname -I
# بفرض أن الإخراج هو 172.21.123.45، قم بتسجيل الشبكة الفرعية 172.21.0.0/16

# الخطوة الثانية: افتح PowerShell كمسؤول، وقم بإنشاء قاعدة جدار حماية (قم بتغيير نطاق IP وفقا لشبكتك الفرعية)
New-NetFirewallRule -DisplayName "Allow WSL2 Internal Traffic" -Direction Inbound -Protocol TCP -Action Allow -RemoteAddress 172.21.0.0/16 -LocalAddress 172.21.0.0/16

ثم أعد تشغيل IDE و Claude Code لتطبيق القاعدة.

الحل الثاني هو تحويل WSL2 إلى "الشبكة المعكوسة" (يتطلب Windows 11 إصدار 22H2 أو أحدث)، وذلك بإضافة قسم [wsl2] في ملف .wslconfig ضمن مجلد مستخدم Windows، وتعيين networkingMode=mirrored، ثم إعادة التشغيل بـ wsl --shutdown. أما مستخدمو Windows 10 فلا ينبغي لهم العبث بالشبكة المعكوسة، بل استخدموا الحل الأول مباشرة.

الفخ الثالث: التطوير عن بعد، يجب تثبيت الإضافة في "المضيف البعيد"

إذا كنت تستخدم ميزة التطوير عن بعد (Remote Development) من JetBrains - حيث يتصل العميل المحلي بالخادم البعيد لكتابة الكود - فهناك نقطة غير بديهية:

يجب تثبيت الإضافة على "المضيف البعيد"، وليس على الجهاز العميل المحلي لديك.

مسار التثبيت هو Settings → Plugin (Host). الخطأ الشائع هو تثبيت الإضافة على العميل المحلي وعدم التمكن من الاتصال بأي شكل من الأشكال، فتظل تحاول لفترة طويلة قبل أن تكتشف أنك ثبتها في المكان الخطأ. تذكر: المكان الذي يعمل فيه Claude فعليا، هو المكان الذي تُثبّت فيه الإضافة. في التطوير عن بعد، المضيف البعيد هو من يقوم بالعمل، وبالتالي تُثبّت الإضافة عليه.

الفخ	حل في جملة واحدة
مفتاح ESC لا يقاطع	Settings → Tools → Terminal، ألغ خيار "Escape لنقل التركيز للمحرر"
WSL2 لا يكتشف IDE	اسمح بالاتصال في جدار حماية Windows (موصى به) أو بدّل لشبكة معكوسة، ثم أعد التشغيل
لا يمكن الاتصال في التطوير عن بعد	تُثبت الإضافة في المضيف البعيد (Settings → Plugin (Host))، وليس في العميل المحلي

💡 ملخص في جملة واحدة: في حال تعطل ESC غيّر اختصار الوحدة الطرفية، ولحل مشكلة WSL2 في عدم اكتشاف IDE اسمح بالاتصال في جدار الحماية، وفي التطوير عن بعد ثبّت الإضافة في المضيف البعيد - هذه الأخطاء الثلاثة حصرية وعالية التكرار في JetBrains، قم بتغيير مشكلة ESC فورا بعد التثبيت.

---

08 جزء العملي: استكمال العملية بأكملها في JetBrains في 10 دقائق

ستوجهك الخطوات التالية من الصفر، وتشرح كل خطوة "ما يجب أن تراه"، بمجرد اتباعها يمكنك التحقق بنفسك. سيتم العرض باستخدام PyCharm، والخطوات في بيئات JetBrains IDE الأخرى متطابقة تماما.

الخطوة 0: تأكد من وجود CLI - شغّل claude --version، المتوقع هو طباعة رقم الإصدار (مثل 2.x.x (Claude Code))؛ وإذا أبلغت عن command not found فارجع أولا إلى 02 التثبيت.

الخطوة 1: قم بتثبيت الإضافة وإعادة التشغيل - PyCharm → Settings → Plugins → Marketplace، ابحث عن Claude Code → اضغط Install، ثم اخرج بالكامل من PyCharm وأعد فتحه. المتوقع بعد إعادة التشغيل أن ترى Claude Code [Beta] ضمن Settings → Tools.

الخطوة 2: أنشئ مشروع تدريب صغير - أنشئ ملفا جديدا demo.py:

def greet(name):
    return "Hello " + name

print(greet("world"))

الخطوة 3: ابدأ Claude من الوحدة الطرفية المدمجة في IDE - افتح علامة التبويب Terminal في أسفل PyCharm وشغّل claude. المتوقع تنشيط وظائف التكامل تلقائيا (لأن التشغيل من الوحدة الطرفية المدمجة لا يتطلب /ide)؛ وفي المرة الأولى سيوجهك لتسجيل الدخول إلى حساب Anthropic واستكمال الترخيص في المتصفح.

الخطوة 4: تعيين التغييرات (diff) إلى auto - في Claude، شغّل /config، وعيّن أداة التغييرات إلى auto، بحيث تنبثق التعديلات في الخطوة التالية في عارض diff الخاص بـ PyCharm.

الخطوة 5: حدد الكود + اطرح سؤالا، وتحقق من مشاركة التحديد

في المحرر، حدد السطرين الخاصين بالدالة greet، وارجع إلى وحدة Claude الطرفية، واكتب:

ما الذي يمكن تحسينه في هذه الدالة المحددة؟

النتيجة المتوقعة: سيرد Claude بناء على السطرين اللذين حددتهما (قد يقترح استخدام f-string، وإضافة تعليقات توضيحية للأنواع) - إذا لم يسألك بالمقابل "أي دالة تقصد؟"، فهذا يعني أن مشاركة التحديد تعمل. وهذه خطوة حاسمة للتحقق مما إذا كان "AirDrop" قد نجح في الاتصال.

الخطوة 6: دعه يقوم بالتعديل، وانظر كيف ينبثق diff في IDE

ثم اكتب:

ساعدني في تغييره لاستخدام f-string، وأضف تعليقات توضيحية للأنواع

النتيجة المتوقعة: لأننا قمنا بتعيين auto في الخطوة السابقة، سيتم عرض التعديلات جنبا إلى جنب في عارض diff الخاص بـ PyCharm - يظهر على اليسار الأصل return "Hello " + name، وعلى اليمين يظهر التعديل return f"Hello {name}"، كما تم إضافة تعليق توضيحي للنوع على توقيع الدالة. افحص التغييرات بوضوح قبل قبولها.

بمجرد الوصول إلى هذه الخطوة، ستكون قد تحققت من تثبيت الإضافة، واتصال CLI، ومشاركة التحديد، وانبثاق diff في IDE، وهي الأساسيات الأربعة. إذا سألك في الخطوة 5 عن الدالة التي تقصدها، أو لم ينبثق diff في الخطوة 6 داخل IDE، فارجع إلى الأقسام 03 و 04 و 06 للتحقق.

---

09 ملخص

لقد أدرج هذا المقال Claude Code في عائلة JetBrains، وجوهر ذلك يتلخص في بضعة أشياء:

• الإضافة هي "جسر" وليست "لوحة": إنها تقوم بتوصيل IDE بـ CLI، حيث تتم المحادثة في الوحدة الطرفية المدمجة لـ IDE، وتنبثق التغييرات (diff) في العارض الأصلي لـ IDE، على عكس VS Code الذي يمنحك لوحة دردشة مستقلة.
• التثبيت يتطلب شيئين: CLI الأساسي + الإضافة، وكلاهما ضروري؛ بعد التثبيت، يجب إعادة تشغيل IDE بالكامل، وهو السبب الأبرز وراء "التثبيت لم يسفر عن نتيجة".
• هناك وضعيتان للاتصال: تشغيل الوحدة الطرفية المدمجة في IDE للاتصال التلقائي (موصى به)، والتشغيل في الوحدة الطرفية الخارجية باستخدام /ide للاتصال اليدوي؛ وكلاهما يجب تشغيله من المجلد الجذر للمشروع.
• ثلاثة فخاخ حصرية: تعطل مقاطعة ESC (تتطلب تغيير اختصار الوحدة الطرفية)، فشل WSL2 في اكتشاف IDE (تتطلب السماح بالاتصال في جدار الحماية)، وضرورة تثبيت الإضافة على المضيف البعيد في حالة التطوير عن بعد.

الآن يجب أن تكون قادرا على: تثبيت الإضافة بنفسك في JetBrains IDE الخاص بك، توصيل Claude بـ IDE، استخدام مشاركة التحديد لتقديم السياق بشكل دقيق، وجعل التعديلات تنبثق في عارض diff الخاص بـ IDE للمراجعة. مستخدمو JetBrains ليسوا مواطنين من الدرجة الثانية - كل التجارب الأساسية التي يجب أن تكون متوفرة، متوفرة بالكامل.

إلى هنا، نكون قد غطينا كلا المعسكرين الرئيسيين لبيئات التطوير: VS Code و JetBrains. الشيء المشترك بينهما هو: يجب أن تمتلك IDE أولا، ثم تقوم بتوصيل Claude به. ولكن ماذا لو لم تكن ترغب في فتح IDE على الإطلاق، وكل ما تريده هو عميل Claude مستقل وجاهز للاستخدام؟

---

المقال التالي 10 تطبيق سطح المكتب (Desktop) - يمتلك Claude Code أيضا تطبيقا مستقلا لسطح المكتب، لا يعتمد على أي محرر نصوص، ويمكنك استخدامه بالنقر المزدوج. سنرى لمن يناسب هذا التطبيق، وكيفية الاختيار بينه وبين الإصدار المدمج في IDE، وما هي المزايا التي يقدمها ولا يمكن لإصدار IDE توفيرها.

---

قراءات مقترحة

• إصدار الويب والسحابة: وضع Claude Code في المتصفح والهاتف
• أربع مهام أكثر استخداما: استكشاف قاعدة الكود، إصلاح الأخطاء (bug)، إعادة الهيكلة، وكتابة الاختبارات
• الخطافات (Hooks): الضغط على الزناد تلقائيا في أوقات محددة