# تكامل JetBrains IDE

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

## نظرة سريعة

| العنصر | التفاصيل |
|---|---|
| النماذج التي يمكنك استخدامها | Claude ✅ (إضافة Claude Code، تشترك في إعداد CLI) · GPT / النماذج الصينية ⚠️ راجع النماذج المخصصة في JetBrains AI Assistant (قسم منفصل) · Gemini ❌ |
| البروتوكول وBase URL | Anthropic: `https://api.qcode.cc/api` (يُضبط في بيئة CLI الخاصة بـ `claude` / settings.json) |
| مكان الضبط | الإعدادات → الأدوات → Claude Code [Beta] داخل IDE؛ وفي الخلفية يستخدم `~/.claude/` المشترك |
| الوثائق الرسمية | [code.claude.com/docs/en/jetbrains](https://code.claude.com/docs/en/jetbrains) |

يوفر 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`؛ لا تطابق رقمًا قديمًا من هذه الصفحة)
   - اتبع [دليل التثبيت](/docs/getting-started/installation) لإكمال التثبيت
   - اتبع دليل [متغيرات البيئة](/docs/getting-started/environment) لضبط QCode API
   - شغّل `claude --version` في طرفية للتأكد من أنه يعمل

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

3. **مفتاح 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. المتغيران الأساسيان للبيئة هما:

```bash
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 من بيئة حُمِّل فيها ذلك الإعداد (راجع الأسئلة الشائعة أدناه).

إذا كنت تفضّل عدم الاعتماد على متغيرات البيئة العامة، فيمكنك ضبطها لكل مشروع بدلًا من ذلك (راجع [الأسئلة الشائعة](#environment-variables-not-taking-effect)).

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

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

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

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

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

```bash
curl -i https://api.qcode.cc/api/v1/messages
# HTTP/2 401  ← path is correct, as expected
```
## الاستخدام

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

| الاختصار | الوظيفة |
|----------|----------|
| `Cmd+Esc` / `Ctrl+Esc` | فتح / إغلاق لوحة Claude Code |
| `Cmd+Option+K` / `Ctrl+Alt+K` | إدراج مرجع إلى الملف الحالي (@file) في prompt |
| `Esc` | مقاطعة التوليد الحالي |

> تعتمد الاختصارات الفعلية على إصدار الإضافة وخريطة المفاتيح لديك؛ ابحث عن «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](/docs/usage/image-2).

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

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

| النموذج | السياق | الأنسب لـ |
|------|--------|----------|
| `claude-opus-5` | 1M | الرائد، إعادة الهيكلة المعقدة والاستدلال المعماري |
| `claude-opus-4-7` | 1M | بديل رائد |
| `claude-sonnet-5` | 1M | البرمجة اليومية، قيمة متوازنة |
| `claude-haiku-5-5` | 1M | مهام خفيفة، أسئلة وأجوبة سريعة |

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

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

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

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

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

رسميًا: **الإعدادات → الأدوات → 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 فلديهما حقل مفتاح فقط.

| المسار | البروتوكول | عنوان مخصص؟ | ما الذي يمكن لـ QCode تقديمه هناك |
|---|---|---|---|
| إضافة Claude Code (هذه الصفحة) | Anthropic Messages | نعم، `ANTHROPIC_BASE_URL` = `https://api.qcode.cc/api` | نماذج Claude والعائلات الصينية (نقطة نهاية Anthropic) |
| AI Assistant → متوافق مع OpenAI | OpenAI Chat Completions | نعم، يوجد حقل URL | نماذج GPT والعائلات الصينية (`https://api.qcode.cc/openai/v1`) |
| AI Assistant → Anthropic / Gemini | أصلي | **لا يوجد حقل عنوان في الوثائق**، مفتاح المزوّد فقط | لا يمكن توجيهه إلى QCode |

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

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

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

2. تأكد من أن Claude Code CLI مثبت عالميًا: شغّل `claude --version` في طرفية — ينبغي أن يطبع إصدارًا (راجع [الإصدارات الرسمية](https://github.com/anthropics/claude-code/releases))

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](/docs/getting-started/endpoints-and-api-paths) للنطاقات الثلاثة و Base URL لكل بروتوكول

- راجع [تكامل VS Code](/docs/ide/vscode) لامتداد VS Code

- راجع [تكامل Cline](/docs/ide/cline) لامتداد آخر للذكاء الاصطناعي في VS Code

- راجع [نصائح CLI](/docs/usage/cli-tips) للحصول على نصائح استخدام الطرفية

> تتساءل عن النموذج الأكثر فعالية من حيث التكلفة لتشغيله في JetBrains؟ راجع [صفحة أسعار QCode](https://qcode.cc/pricing) واختر Opus / Sonnet / Haiku بما يناسب ميزانيتك.