الانتقال إلى المحتوى الرئيسي
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 والنقر على زر “Acquire” للحصول على الشهادات المطلوبة: إذا لم تكن قد قمت بتسجيل الدخول أو التسجيل، فسيتم تحويلك تلقائيًا إلى صفحة تسجيل الدخول لدعوتك للتسجيل وتسجيل الدخول، وبعد تسجيل الدخول، سيتم العودة تلقائيًا إلى الصفحة الحالية. عند التقديم لأول مرة، ستحصل على رصيد مجاني لتجربة خدمة Claude Code مجانًا.

​
IDE المدعومة

يدعم ملحق Claude Code IDEs التالية من JetBrains:
IDEاللغات/السيناريوهات المناسبة
IntelliJ IDEAJava، Kotlin، Scala وغيرها
PyCharmPython
WebStormJavaScript، TypeScript
GoLandGo
PhpStormPHP
Android Studioتطوير Android
أخرىمعظم IDEs من JetBrains مدعومة

​
التثبيت

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

يعتمد ملحق Claude Code لـ JetBrains على Claude Code CLI، لذا تأكد من تثبيت CLI أولاً: 
# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash

# أو باستخدام Homebrew
brew install claude-code
بعد الانتهاء من التثبيت، يمكنك التحقق: 
claude --version

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

ملحق Claude Code في JetBrains Marketplace
  1. افتح JetBrains IDE
  2. انتقل إلى Settings → Plugins → Marketplace
  3. ابحث عن Claude Code
  4. انقر على Install لتثبيت الملحق
  5. أعد تشغيل IDE
أو يمكنك زيارة JetBrains Marketplace للتثبيت عبر الإنترنت.
مهم: بعد تثبيت الملحق، تحتاج إلى إعادة تشغيل IDE بالكامل (قد تحتاج إلى إعادة التشغيل عدة مرات) لتفعيل التغييرات.

​
تكوين AceData Cloud API

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

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

قم بإنشاء ملف تكوين Claude Code:
النظامالمسار
macOS / Linux~/.claude/config.json
WindowsC:\Users\{اسم المستخدم}\.claude\config.json
اكتب المحتوى التالي في هذا الملف واحفظه: 
{
  "primaryApiKey": "self"
}
أمر سريع لإنشاء الملف على macOS / Linux: 
mkdir -p ~/.claude && echo '{"primaryApiKey": "self"}' > ~/.claude/config.json

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

الطريقة الأولى: إعداد في ملف تكوين Shell (موصى بها) أضف المحتوى التالي إلى ~/.zshrc أو ~/.bashrc، واستبدل {token} برمز API الخاص بك: 
# تكوين وكيل 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 (إذا لم يكن موجودًا، قم بإنشائه): 
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "{token}",
    "ANTHROPIC_BASE_URL": "https://api.acedata.cloud"
  }
}
تلميح: يمكنك العثور على رمز API في لوحة تحكم AceData Cloud.

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

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

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

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

إذا كنت تقوم بتشغيل Claude Code من طرفية خارجية، يمكنك استخدام الأمر /ide للاتصال بـ JetBrains IDE: 
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 صالح (يمكنك التحقق في اللوحة)
  4. أعد تشغيل JetBrains IDE وحاول مرة أخرى

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

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

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

  1. تأكد من تثبيت الملحق وتفعيله
  2. أعد تشغيل IDE
  3. تأكد من أنك تقوم بتشغيل Claude Code في الطرفية المدمجة
  4. لمستخدمي WSL، يرجى مراجعة دليل استكشاف الأخطاء وإصلاحها لـ WSL

​
command not found

إذا ظهرت لك رسالة “command not found” عند النقر على أيقونة Claude:
  1. تحقق مما إذا كان CLI مثبتًا: which claude
  2. قم بتكوين المسار الكامل لأمر Claude في إعدادات الملحق
  3. لمستخدمي WSL، استخدم تنسيق الأمر المذكور أعلاه لـ WSL

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

قم بتسجيل الدخول إلى وحدة تحكم AceData Cloud ، يمكنك من خلالها الاطلاع على الرصيد المتبقي الحالي وحالة الاستخدام.

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