> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# دليل استخدام Claude Code لـ JetBrains IDE

> Claude Code 集成指南 - Ace Data Cloud

Claude Code هو أداة **Agentic Coding** أطلقتها شركة Anthropic، ويعتبر واحدًا من أقوى وكلاء البرمجة في العالم. يوفر Claude Code ملحقًا خاصًا بـ JetBrains IDE، ويدعم IntelliJ IDEA وPyCharm وWebStorm وGoLand وPhpStorm وAndroid Studio وغيرها من سلسلة JetBrains IDE.

تتناول هذه الوثيقة كيفية تكوين واستخدام Claude Code في JetBrains IDE من خلال خدمة الوكيل AceData Cloud.

## عملية التقديم

لاستخدام Claude Code، يمكنك أولاً زيارة [صفحة خدمة Claude Messages](https://platform.acedata.cloud/documents/claude-messages) والنقر على زر "Acquire" للحصول على الشهادات المطلوبة:

![](https://cdn.acedata.cloud/nyq0xz.png)

إذا لم تكن قد قمت بتسجيل الدخول أو التسجيل، فسيتم تحويلك تلقائيًا إلى صفحة تسجيل الدخول لدعوتك للتسجيل وتسجيل الدخول، وبعد تسجيل الدخول، سيتم العودة تلقائيًا إلى الصفحة الحالية.

عند التقديم لأول مرة، ستحصل على رصيد مجاني لتجربة خدمة Claude Code مجانًا.

## IDE المدعومة

يدعم ملحق Claude Code IDEs التالية من JetBrains:

| IDE                | اللغات/السيناريوهات المناسبة  |
| ------------------ | ----------------------------- |
| **IntelliJ IDEA**  | Java، Kotlin، Scala وغيرها    |
| **PyCharm**        | Python                        |
| **WebStorm**       | JavaScript، TypeScript        |
| **GoLand**         | Go                            |
| **PhpStorm**       | PHP                           |
| **Android Studio** | تطوير Android                 |
| **أخرى**           | معظم IDEs من JetBrains مدعومة |

## التثبيت

### المتطلبات الأساسية

يعتمد ملحق Claude Code لـ JetBrains على Claude Code CLI، لذا تأكد من تثبيت CLI أولاً:

```bash theme={null}
# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# أو باستخدام Homebrew
brew install claude-code
```

بعد الانتهاء من التثبيت، يمكنك التحقق:

```bash theme={null}
claude --version
```

### تثبيت الملحق

![ملحق Claude Code في JetBrains Marketplace](https://cdn.acedata.cloud/de78fd305b.png)

1. افتح JetBrains IDE
2. انتقل إلى **Settings** → **Plugins** → **Marketplace**
3. ابحث عن **Claude Code**
4. انقر على **Install** لتثبيت الملحق
5. أعد تشغيل IDE

أو يمكنك زيارة [JetBrains Marketplace](https://plugins.jetbrains.com/plugin/27310-claude-code-beta-) للتثبيت عبر الإنترنت.

> **مهم**: بعد تثبيت الملحق، تحتاج إلى **إعادة تشغيل IDE بالكامل** (قد تحتاج إلى إعادة التشغيل عدة مرات) لتفعيل التغييرات.

## تكوين AceData Cloud API

يعمل ملحق Claude Code لـ JetBrains من خلال تشغيل أمر `claude` في الطرفية المدمجة، لذا فإن طريقة تكوين متغيرات البيئة هي نفسها كما في CLI.

### الخطوة الأولى: إنشاء config.json

قم بإنشاء ملف تكوين Claude Code:

| النظام            | المسار                                        |
| ----------------- | --------------------------------------------- |
| **macOS / Linux** | `~/.claude/config.json`                       |
| **Windows**       | `C:\Users\{اسم المستخدم}\.claude\config.json` |

اكتب المحتوى التالي في هذا الملف واحفظه:

```json theme={null}
{
  "primaryApiKey": "self"
}
```

أمر سريع لإنشاء الملف على macOS / Linux:

```bash theme={null}
mkdir -p ~/.claude && echo '{"primaryApiKey": "self"}' > ~/.claude/config.json
```

### الخطوة الثانية: تكوين متغيرات البيئة

**الطريقة الأولى: إعداد في ملف تكوين Shell (موصى بها)**

أضف المحتوى التالي إلى `~/.zshrc` أو `~/.bashrc`، واستبدل `{token}` برمز API الخاص بك:

```bash theme={null}
# تكوين وكيل Claude Code - AceData Cloud
export ANTHROPIC_AUTH_TOKEN="{token}"
export ANTHROPIC_BASE_URL="https://api.acedata.cloud"
```

بعد التعديل، نفذ `source ~/.zshrc` لتفعيل التكوين، ثم **أعد تشغيل JetBrains IDE**.

**الطريقة الثانية: إعداد في settings.json لـ Claude Code**

قم بتحرير `~/.claude/settings.json` (إذا لم يكن موجودًا، قم بإنشائه):

```json theme={null}
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "{token}",
    "ANTHROPIC_BASE_URL": "https://api.acedata.cloud"
  }
}
```

> **تلميح**: يمكنك العثور على رمز API في [لوحة تحكم AceData Cloud](https://platform.acedata.cloud/console).

## الاستخدام الأساسي

### بدء التشغيل من الطرفية المدمجة في IDE

افتح الطرفية المدمجة في JetBrains IDE، ثم نفذ:

```bash theme={null}
claude
```

عند التشغيل في الطرفية المدمجة في IDE، سيتم تفعيل جميع الميزات المتكاملة (عرض Diff، اختيار السياق، إلخ) تلقائيًا.

### الاتصال من طرفية خارجية

إذا كنت تقوم بتشغيل Claude Code من طرفية خارجية، يمكنك استخدام الأمر `/ide` للاتصال بـ JetBrains IDE:

```bash theme={null}
claude
> /ide
```

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

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

| اختصار                                             | الوظيفة                            |
| -------------------------------------------------- | ---------------------------------- |
| `Cmd+Esc` (ماك) / `Ctrl+Esc` (ويندوز/لينكس)        | فتح Claude Code بسرعة              |
| `Cmd+Option+K` (ماك) / `Alt+Ctrl+K` (ويندوز/لينكس) | إدراج مرجع ملف (مثل `@File#L1-99`) |

### الميزات المتكاملة

يوفر ملحق Claude Code لـ JetBrains الميزات المتكاملة التالية:

* **عرض Diff**: يتم عرض تغييرات الكود مباشرة في عارض Diff في IDE
* **اختيار السياق**: يتم مشاركة الكود المحدد حاليًا وعلامات التبويب تلقائيًا مع Claude
* **مرجع الملف**: استخدم اختصارات لوحة المفاتيح للإشارة بسرعة إلى الملفات وأرقام الأسطر
* **مشاركة التشخيص**: يتم مشاركة معلومات التشخيص مثل Lint والأخطاء النحوية تلقائيًا مع Claude

## إعدادات الملحق

يمكنك تكوين الإعدادات في **Settings** → **Tools** → **Claude Code \[Beta]**:

| الإعداد                       | الوصف                                                        |
| ----------------------------- | ------------------------------------------------------------ |
| **Claude command**            | تخصيص مسار أمر Claude (مثل `/usr/local/bin/claude`)          |
| **Enable automatic updates**  | التحقق تلقائيًا من تحديثات الملحق وتثبيتها                   |
| **Enable using Option+Enter** | استخدام Option+Enter في macOS لإضافة سطر جديد في مربع الحوار |

### إعدادات مستخدمي WSL

إذا كنت تستخدم في بيئة WSL، يجب تعيين أمر Claude إلى:

```
wsl -d Ubuntu -- bash -lic "claude"
```

(استبدل `Ubuntu` باسم توزيعة WSL الخاصة بك)

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

### ماذا أفعل إذا فشل الاتصال؟

1. تحقق مما إذا كان ملف `~/.claude/config.json` قد تم إنشاؤه بشكل صحيح
2. تأكد من أن متغيرات البيئة تم إعدادها بشكل صحيح
3. تأكد من أن رمز API صالح (يمكنك التحقق في [اللوحة](https://platform.acedata.cloud/console))
4. أعد تشغيل JetBrains IDE وحاول مرة أخرى

### ماذا أفعل إذا لم يعمل الملحق؟

1. تأكد من أنك تقوم بتشغيل Claude Code من جذر المشروع
2. تحقق مما إذا كان الملحق مفعلًا في إعدادات IDE
3. أعد تشغيل IDE بالكامل (قد تحتاج إلى إعادة التشغيل عدة مرات)
4. إذا كنت تستخدم وضع التطوير عن بُعد، تأكد من تثبيت الملحق على المضيف البعيد (Settings → Plugin (Host))

### ماذا أفعل إذا لم يتم اكتشاف IDE؟

1. تأكد من تثبيت الملحق وتفعيله
2. أعد تشغيل IDE
3. تأكد من أنك تقوم بتشغيل Claude Code في الطرفية المدمجة
4. لمستخدمي WSL، يرجى مراجعة [دليل استكشاف الأخطاء وإصلاحها لـ WSL](https://code.claude.com/docs/en/troubleshooting#jetbrains-ide-not-detected-on-wsl2)

### command not found

إذا ظهرت لك رسالة "command not found" عند النقر على أيقونة Claude:

1. تحقق مما إذا كان CLI مثبتًا: `which claude`
2. قم بتكوين المسار الكامل لأمر Claude في إعدادات الملحق
3. لمستخدمي WSL، استخدم تنسيق الأمر المذكور أعلاه لـ WSL

### كيفية查看 الرصيد المتبقي؟

قم بتسجيل الدخول إلى [وحدة تحكم AceData Cloud](https://platform.acedata.cloud/console) ، يمكنك من خلالها الاطلاع على الرصيد المتبقي الحالي وحالة الاستخدام.

## لمعرفة المزيد

* 📖 [وثائق Claude Code JetBrains الرسمية](https://code.claude.com/docs/en/jetbrains)
* 🔧 [خدمة AceData Cloud Claude Code](https://platform.acedata.cloud/documents/claude-messages)
* 💬 إذا كان لديك أي استفسارات، لا تتردد في الاتصال بنا عبر خدمة العملاء على المنصة