تكامل JetBrains IDE

استخدم Claude Code عبر QCode في IntelliJ IDEA وWebStorm وPyCharm وGoLand وغيرها من بيئات JetBrains IDE

تحتاج مفتاح API؟ أنشئ حسابًا ←·نقاط النهاية وعناوين Base URL ←

آخر تحقق: 2026-09-18 · 📄 وفق الوثائق الرسمية (إضافة JetBrains لـ Claude Code 0.1.14-beta (Marketplace؛ تتطلب IDE ≥2024.2))

نظرة سريعة¶

يوفر Claude Code إضافة JetBrains رسمية. تذكر الوثائق ست بيئات IDE (بما فيها Android Studio، التي تحتاج إلى Ladybug 2024.2.1 أو أحدث؛ وتحتاج JetBrains MPS بشكل منفصل إلى 2024.3+)، وتضيف قائمة التوافق في Marketplace بيئات RubyMine وCLion وRider وDataGrip وغيرها من بيئات IDE العاملة على منصة IntelliJ — لذلك لا نَعِد بـ«كل بيئة IDE مبنية على IntelliJ»: تحقق من صفحة الإضافة داخل IDE الخاص بك قبل التثبيت. يوضح هذا الدليل كيفية تثبيت الإضافة وتوجيهها إلى بوابة QCode لتتمكن من استدعاء النماذج الرائدة مثل Claude Opus 5 وSonnet 5 بتكلفة أقل.

تتشاطر الإضافة الإعداد نفسه مع نسخة سطر الأوامر: ما دام CLI الخاص بـ claude قادرًا على الوصول إلى QCode، ستعمل إضافة IDE أيضًا.

المتطلبات المسبقة¶

1. CLI الخاص بـ Claude Code مثبت ويعمل (أكّد ذلك باستخدام claude --version؛ لا تطابق رقمًا قديمًا من هذه الصفحة)

2. اتبع دليل التثبيت لإكمال التثبيت

3. اتبع دليل متغيرات البيئة لضبط QCode API

4. شغّل claude --version في طرفية للتأكد من أنه يعمل

5. JetBrains IDE 2024.2 أو أحدث (يسرد إدخال Marketplace رقم البناء 242.0 كحد أدنى، أي 2024.2؛ على 2024.1 تظهر الإضافة كغير متوافقة)

6. مفتاح API من QCode (يبدأ بـ cr_) — يعمل المفتاح نفسه مع جميع نقاط النهاية

خطوات التثبيت¶

الخطوة 1: تثبيت إضافة Claude Code¶

1. افتح JetBrains IDE الخاص بك

2. انتقل إلى الإعدادات / التفضيلات → الإضافات → Marketplace

3. ابحث عن Claude Code [Beta] — فهذا هو اسمه الفعلي في Marketplace (الناشر Anthropic PBC، وxmlId com.anthropic.code.plugin). ⚠️ البحث عن «Claude Code» فقط يُظهر أولًا عدة إضافات مشابهة تابعة لجهات خارجية وغير ذات صلة؛ ثبّت الإضافة المنشورة من Anthropic PBC

4. انقر على تثبيت

5. أعد تشغيل IDE

نصيحة: إذا تعذّر على شبكتك الوصول مباشرة إلى JetBrains Marketplace، فحمّل حزمة .zip من الصفحة الرئيسية للإضافة وثبّتها دون اتصال عبر الإضافات → أيقونة الترس → تثبيت إضافة من القرص.... راجع الوثائق الرسمية لـ JetBrains للحصول على التفاصيل.

الخطوة 2: ضبط الوصول إلى QCode¶

تعيد الإضافة استخدام إعداد CLI الخاص بـ Claude Code. المتغيران الأساسيان للبيئة هما:

export ANTHROPIC_BASE_URL="https://api.qcode.cc/api"
export ANTHROPIC_AUTH_TOKEN="cr_your_api_key"

المستخدمون في البر الرئيسي للصين: استبدال api.qcode.cc بـ asia.qcode.cc هو عادةً الخيار الأفضل:

bash export ANTHROPIC_BASE_URL="https://asia.qcode.cc/api"

تتشارك النطاقات الثلاثة api / asia / us مفتاح API نفسه، لذا اختر الأنسب لمنطقتك. يجب أن لا يحتوي BASE_URL على شرطة مائلة لاحقة.

نصيحة: ترث بيئات JetBrains IDE متغيرات بيئة النظام. إذا كنت قد ضبطتها بالفعل في ~/.zshrc أو ~/.bashrc، فسيلتقطها IDE عند التشغيل — بشرط أن يبدأ IDE من بيئة حُمِّل فيها ذلك الإعداد (راجع الأسئلة الشائعة أدناه).

إذا كنت تفضّل عدم الاعتماد على متغيرات البيئة العامة، فيمكنك ضبطها لكل مشروع بدلًا من ذلك (راجع الأسئلة الشائعة).

الخطوة 3: التحقق¶

1. في IDE، اضغط Cmd+Esc (macOS) أو Ctrl+Esc (Windows/Linux) لفتح لوحة Claude Code

2. اكتب رسالة بسيطة (مثل «hello») لاختبار الاتصال

3. إذا تلقيت ردًا عاديًا، فالإضافة متصلة بنجاح عبر QCode

يمكنك أيضًا التحقق من إمكانية الوصول إلى البوابة نفسها باستخدام curl (يعني 401 أن المسار صحيح وأن المصادقة فقط مفقودة، وهو أمر متوقع):

curl -i https://api.qcode.cc/api/v1/messages
# HTTP/2 401  ← path is correct, as expected

الاستخدام¶

اختصارات لوحة المفاتيح¶

تعتمد الاختصارات الفعلية على إصدار الإضافة وخريطة المفاتيح لديك؛ ابحث عن «Claude» ضمن Settings → Keymap لتخصيصها.

القدرات الأساسية¶

1. شرح الشيفرة: حدد الشيفرة → انقر بزر الفأرة الأيمن → Ask Claude ليشرح المنطق

2. توليد الشيفرة: صف متطلباتك بلغة واضحة في لوحة Claude ودعه يولّد الشيفرة أو يعدّلها

3. إصلاح الأخطاء: أرسل تتبع مكدس أو رسالة خطأ إلى Claude للتحليل والإصلاح

4. إعادة هيكلة الشيفرة: حدد الشيفرة المستهدفة واطلب من Claude تحسين بنيتها، أو استخراج الدوال، أو إضافة اختبارات

عرض الفروقات الأصلي¶

الإضافة مدمجة بعمق مع JetBrains: عندما يقترح Claude تغييرات على الملفات، تُعرض في عرض الفروقات الأصلي جنبًا إلى جنب داخل IDE، بحيث يمكنك مراجعة كل تغيير وقبوله أو رفضه ثم كتابته إلى القرص. هذا أوضح وأكثر أمانًا من فروقات الطرفية العادية.

الاستخدام مع الطرفية المدمجة¶

يمكن للطرفية المدمجة في JetBrains IDEs أيضًا تشغيل الأمر claude مباشرة، مما يوفر تجربة CLI كاملة. تمرر الإضافة تلقائيًا الملف المفتوح حاليًا والتحديد كسياق إلى CLI، لذا يعمل الاثنان معًا على أفضل وجه.

إدخال الصور (الرؤية)¶

يمكن للنماذج القادرة على الرؤية (Claude Opus 5 / Sonnet 5 وعائلة GPT-5.x) قراءة الصور كإدخال:

• لصق لقطة شاشة مباشرة (Ctrl+V) في لوحة Claude
• سحب ملف صورة وإفلاته في مربع المحادثة
• الإشارة إلى مسار ملف صورة في prompt

الاستخدامات النموذجية: إعادة بناء واجهة مستخدم من نموذج تصميم/لقطة شاشة، وتصحيح الأخطاء من لقطة شاشة لخطأ، وتفسير مخططات البنية والرسوم البيانية.

هذا إدخال صور، وليس توليد صور. لجعل النموذج يولّد الصور، استخدم نموذج gpt-image-2 — راجع توليد الصور gpt-image-2.

اختيار النموذج¶

في لوحة Claude يمكنك تبديل النماذج بالأمر /model؛ تُستدعى جميع النماذج عبر المفتاح نفسه في QCode. الخيارات الشائعة:

لا تُنسخ الأسعار إلى هذه الصفحة — استخدم الأرقام المباشرة على qcode.cc/models (يمكن للمسؤولين تغيير الأسعار).

يدعم QCode أيضًا نماذج GPT (مثل gpt-6-sol وgpt-5.6-terra؛ لا يوفر Gemini حاليًا)، لكن إضافة Claude Code لـJetBrains تستهدف بروتوكول Anthropic؛ من الأفضل استخدام GPT في أداته الخاصة مثل Codex. أسعار الوحدات هي ما يعرضه qcode.cc/models. تظل معرّفات 4.x مثل claude-sonnet-4-6 وclaude-opus-4-8 معروضة للبيع.

الاستخدام المتقدم¶

• Dynamic Workflows: ضمّن الكلمة المفتاحية ultracode في prompt (أو اطلب ببساطة «تشغيل سير عمل») لتنسيق عشرات إلى مئات من الوكلاء الفرعيين في الخلفية بالتوازي للمهام الكبيرة (مراجعة الشيفرة على مستوى المستودع، والترحيل المجمّع، والبحث عبر الملفات، وما إلى ذلك). يعمل الوكلاء الفرعيون في الخلفية بينما تواصل عملك؛ تحقق من التقدم بالأمر /workflows. يعمل على أي نموذج تمت تهيئة Claude Code به — لذا يعمل عند توجيهه إلى QCode. راجع الوكلاء الفرعيون.

• بلا واجهة / الأتمتة: في طرفية IDE يمكنك أيضًا استخدام claude -p "<prompt>" مع --output-format json|text|stream-json للاستدعاءات البرمجية. يعيد json كائنًا منظمًا يحتوي على result وtotal_cost_usd وusage وsession_id، وهو سهل التحليل باستخدام jq. راجع الأتمتة وCI/CD.

للإضافة صفحة إعدادات خاصة بها¶

رسميًا: الإعدادات → الأدوات → Claude Code [Beta]. والعناصر الموثّقة هي:

• أمر Claude — الأمر الذي تستخدمه الإضافة لبدء Claude Code، مثل claude، /usr/local/bin/claude، npx @anthropic-ai/claude-code. عندما يتعذر على IDE العثور على claude، فالإصلاح الرسمي هو وضع مسار مطلق هنا، بدلًا من إعادة صياغة طريقة تشغيل الصدفة

• كتم الإشعار عند تعذّر العثور على أمر Claude — إسكات إشعار «command not found»

• تمكين استخدام Option+Enter في prompts متعددة الأسطر — على macOS فقط
• تمكين التحديثات التلقائية — التحقق من تحديثات الإضافة وتثبيتها، وتُطبّق عند إعادة التشغيل

إرفاق طرفية خارجية: /ide¶

وفقًا للوثائق الرسمية، فإن تشغيل /ide داخل Claude Code في أي طرفية خارجية يربطه بـ JetBrains IDE قيد التشغيل ويمكّن جميع الميزات. عند النجاح، يرد Claude Code بشيء مثل Connected to IntelliJ IDEA.؛ وإذا اكتشف IDE بدون الإضافة، فسيقوم /ide بتثبيت الإضافة ويطلب منك إعادة التشغيل. مع QCode يعمل هذا بالطريقة نفسها — يستخدم claude الخارجي قيمة ANTHROPIC_BASE_URL التي ضبطتها مسبقًا.

JetBrains Remote Development: التثبيت على المضيف¶

الوثائق صريحة: مع JetBrains Remote Development يجب تثبيت الإضافة على المضيف البعيد، عبر الإعدادات → الإضافات → الإضافة (المضيف). وتثبيتها على العميل المحلي لا يفعل شيئًا.

AI Assistant منتج مختلف¶

تتناول هذه الصفحة إضافة Claude Code، التي تشغّل claude CLI الخاص بك عبر بروتوكول Anthropic مع أخذ Base URL من متغير بيئة. يستطيع JetBrains AI Assistant أيضًا استخدام نماذج طرف ثالث، لكن عبر مدخل آخر: الإعدادات | الأدوات | AI Assistant | المزوّدون ومفاتيح API، ووفقًا للوثائق الرسمية فقط نوع «OpenAI-compatible» هو الذي يوفر حقل URL — أما نوعا مفتاح API لـ Anthropic وGemini فلديهما حقل مفتاح فقط.

الإكمال بالذكاء الاصطناعي في AI Assistant (الإكمال المضمّن / التحرير التالي) لا يقبل كذلك إلا نقطة نهاية «OpenAI Compatible»، وتحذّر الوثائق من أن الإكمال المضمّن يحتاج إلى دعم Fill-in-the-Middle، وهو ما تفتقر إليه عادةً نماذج المحادثة العامة.

الأسئلة الشائعة¶

لوحة Claude Code لا تظهر؟¶

1. تأكد من أن الإضافة مثبتة ومفعّلة (Settings → Plugins → Installed)

2. تأكد من أن Claude Code CLI مثبت عالميًا: شغّل claude --version في طرفية — ينبغي أن يطبع إصدارًا (راجع الإصدارات الرسمية)

3. تأكد من أن إصدار IDE هو ≥ 2024.2

4. أعد تشغيل IDE؛ وإذا لزم الأمر، شغّل File → Invalidate Caches / Restart

Esc لا يقاطع التوليد الحالي؟¶

مدخل استكشاف الأخطاء الرسمي: في طرفيات JetBrains، يلتقط IDE مفتاح Esc لنقل التركيز إلى المحرر. أصلح ذلك ضمن Settings → Tools → Terminal — إما بإزالة تحديد "Move focus to the editor with Escape"، أو بالنقر على "Configure terminal keybindings" وحذف اختصار "Switch focus to Editor".

متغيرات البيئة لا تسري؟¶

قد لا تلتقط بيئات IDE من JetBrains متغيرات البيئة من ملفات تكوين shell لديك (غالبًا لا تحمّل العمليات التي تُطلق عبر واجهة المستخدم ~/.zshrc). الحلول:

• macOS: شغّل IDE من الطرفية (مثل open -a "IntelliJ IDEA") بدلًا من النقر على أيقونة Dock؛ أو استخدم Tools → Create Command-line Launcher وابدأه من طرفية

• كل الأنظمة الأساسية: أضف يدويًا ANTHROPIC_BASE_URL وANTHROPIC_AUTH_TOKEN في Run/Debug Configurations → Environment variables

• الاستمرارية: اضبطها عبر JetBrains Toolbox أو *.vmoptions أو متغيرات بيئة على مستوى النظام حتى تُقرأ عند كل تشغيل

فشل المصادقة / 401 / 403؟¶

1. تحقق من أن ANTHROPIC_AUTH_TOKEN مفتاح QCode صالح يبدأ بـ cr_، دون مسافات أو علامات اقتباس زائدة

2. تأكد من أن ANTHROPIC_BASE_URL لا يحتوي على شرطة مائلة لاحقة وأن المسار هو /api (بروتوكول Anthropic)

3. شغّل curl -i https://api.qcode.cc/api/v1/messages: يعني 401 أن البوابة يمكن الوصول إليها (المصادقة فقط مفقودة)؛ ويشير خطأ الاتصال إلى مشكلة في الشبكة/الوكيل

مهلات الاتصال / الحجب خلف وكيل مؤسسي؟¶

• على المستخدمين في البر الرئيسي للصين التبديل إلى asia.qcode.cc أولًا

• إذا كنت خلف وكيل مؤسسي، فتأكد من تكوين Settings → Appearance & Behavior → System Settings → HTTP Proxy في IDE بشكل صحيح، أو اضبط متغير البيئة HTTPS_PROXY للطرفية

• تأكد من أن جدار الحماية لديك يسمح لعملية IDE بالوصول الصادر إلى *.qcode.cc:443

غيّرت متغيرات البيئة لكن IDE لا يلاحظها؟¶

تُقرأ متغيرات البيئة مرة واحدة عند بدء تشغيل العملية. بعد تحرير ~/.zshrc أو متغيرات النظام، يجب عليك إنهاء IDE بالكامل وإعادة تشغيله (وليس مجرد إعادة فتح نافذة) حتى تسري التغييرات.

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

• راجع نقاط النهاية وصيغ API للنطاقات الثلاثة و Base URL لكل بروتوكول

• راجع تكامل VS Code لامتداد VS Code

• راجع تكامل Cline لامتداد آخر للذكاء الاصطناعي في VS Code

• راجع نصائح CLI للحصول على نصائح استخدام الطرفية

تتساءل عن النموذج الأكثر فعالية من حيث التكلفة لتشغيله في JetBrains؟ راجع صفحة أسعار QCode واختر Opus / Sonnet / Haiku بما يناسب ميزانيتك.

المؤسسات ←