IDEهای JetBrains

این یک ترجمهٔ غیررسمی از مستندات Claude Code است که توسط مسیر تهیه شده. نسخهٔ مرجع و معتبر، مستندات رسمی انگلیسی است.

Claude Code از طریق یک پلاگینِ اختصاصی با IDEهای JetBrains یکپارچه می‌شود و قابلیت‌هایی مانند نمایش تعاملی diff، اشتراکِ کانتکستِ بخشِ انتخاب‌شده و موارد دیگر را فراهم می‌کند.

IDEهای پشتیبانی‌شده

پلاگین Claude Code با بیشتر IDEهای JetBrains کار می‌کند، از جمله:

• IntelliJ IDEA
• PyCharm
• Android Studio
• WebStorm
• PhpStorm
• GoLand

قابلیت‌ها

• اجرای سریع: با Cmd+Esc (مک) یا Ctrl+Esc (ویندوز/لینوکس) مستقیماً از ویرایشگرت Claude Code را باز کن، یا روی دکمه‌ی Claude Code در رابطِ کاربری کلیک کن
• نمایش diff: تغییرات کد می‌توانند به‌جای ترمینال، مستقیماً در نمایشگرِ diff خودِ IDE نشان داده شوند
• کانتکستِ انتخاب: بخشِ انتخاب‌شده یا تبِ فعلی در IDE به‌صورت خودکار با Claude Code به اشتراک گذاشته می‌شود. قواعدِ Read deny این اشتراک را برای فایل‌های منطبق مسدود می‌کنند
• میان‌برهای ارجاع به فایل: با Cmd+Option+K (مک) یا Alt+Ctrl+K (لینوکس/ویندوز) ارجاع‌هایی به فایل مانند @src/auth.ts#L1-99 درج کن
• اشتراکِ تشخیص‌ها: خطاهای تشخیصیِ IDE، مانند خطاهای lint و نحوی، حین کار به‌صورت خودکار با Claude به اشتراک گذاشته می‌شوند

نصب

پلاگین، دستورِ claude را در ترمینالِ یکپارچه‌ی IDEات اجرا می‌کند و به آن متصل می‌شود. این پلاگین نسخه‌ی جداگانه‌ای از CLI را همراه خود ندارد، پس هر دو بخش را نصب کن:

نصب Claude Code CLI

اگر هنوز CLI را نصب نکرده‌ای، شروعِ سریع را دنبال کن. وقتی claude در PATHات نباشد، پلاگین اعلانِ «Cannot launch Claude Code» را نشان می‌دهد.

نصب پلاگین JetBrains

پلاگین Claude Code را از JetBrains Marketplace نصب کن و IDEات را ری‌استارت کن.

اگر claude جایی نصب شده که IDEات نمی‌تواند آن را پیدا کند، مسیرِ کامل را در تنظیمِ Claude command پلاگین وارد کن.

Claude Code با هر اشتراکِ پولیِ Claude (Pro, Max, Team یا Enterprise) یا یک حسابِ Claude Console کار می‌کند و به API key نیاز ندارد. اولین باری که claude را اجرا کنی، از تو خواسته می‌شود وارد شوی.

یادداشت

بعد از نصب پلاگین، ممکن است لازم باشد IDEات را کاملاً ری‌استارت کنی تا اعمال شود.

استفاده

از داخل IDE

claude را از ترمینالِ یکپارچه‌ی IDEات اجرا کن تا همه‌ی قابلیت‌های یکپارچگی فعال شوند.

از ترمینال‌های بیرونی

در هر ترمینالِ بیرونی، دستورِ /ide را برای اتصال Claude Code به IDEی JetBrains و فعال‌سازی همه‌ی قابلیت‌ها به کار ببر:

claude

/ide

اگر می‌خواهی Claude به همان فایل‌هایی دسترسی داشته باشد که IDEات دارد، Claude Code را از همان دایرکتوریِ ریشه‌ی پروژه‌ی IDEات اجرا کن.

پیکربندی

تنظیمات Claude Code

یکپارچگی با IDE را از طریق تنظیمات Claude Code پیکربندی کن:

1. claude را اجرا کن
2. دستورِ /config را وارد کن
3. ابزارِ diff را روی auto بگذار تا diffها در IDE نمایش داده شوند، یا روی terminal تا در ترمینال بمانند

تنظیمات پلاگین

برای پیکربندی پلاگین Claude Code به Settings → Tools → Claude Code [Beta] برو:

تنظیمات عمومی

• Claude command: یک دستورِ سفارشی برای اجرای Claude مشخص کن، مثلاً claude، /usr/local/bin/claude، یا npx @anthropic-ai/claude-code
• Suppress notification for Claude command not found: از اعلان‌های مربوط به پیدا‌نشدنِ دستورِ Claude صرف‌نظر کن
• Enable using Option+Enter for multi-line prompts: فقط روی macOS. وقتی فعال باشد، Option+Enter در پرامپت‌های Claude Code خطِ جدید درج می‌کند. اگر کلیدِ Option به‌طور غیرمنتظره گرفته می‌شود، آن را غیرفعال کن. به ری‌استارتِ ترمینال نیاز دارد.
• Enable automatic updates: به‌صورت خودکار به‌روزرسانی‌های پلاگین را بررسی و نصب می‌کند که هنگام ری‌استارت اعمال می‌شوند

نکته

برای کاربرانِ WSL: مقدارِ wsl -d Ubuntu -- bash -lic "claude" را به‌عنوان دستورِ Claude خود تنظیم کن (به‌جای Ubuntu نامِ توزیعِ WSLات را بگذار)

پیکربندی کلید ESC

اگر کلیدِ ESC عملیاتِ Claude Code را در ترمینال‌های JetBrains قطع نمی‌کند:

1. به Settings → Tools → Terminal برو
2. یکی از این دو کار را بکن:
   • تیکِ «Move focus to the editor with Escape» را بردار، یا
   • روی «Configure terminal keybindings» کلیک کن و میان‌برِ «Switch focus to Editor» را حذف کن
3. تغییرات را اعمال کن

این کار باعث می‌شود کلیدِ ESC به‌درستی عملیاتِ Claude Code را قطع کند.

پیکربندی‌های خاص

توسعه‌ی از راه دور (Remote development)

احتیاط

هنگام استفاده از JetBrains Remote Development، باید پلاگین را روی میزبانِ راه‌دور از طریق Settings → Plugin (Host) نصب کنی.

پلاگین باید روی میزبانِ راه‌دور نصب شود، نه روی دستگاهِ کلاینتِ محلیِ تو.

پیکربندی WSL

اگر Claude Code را روی WSL2 با یک IDEی JetBrains استفاده می‌کنی و پیامِ «No available IDEs detected» را می‌بینی، علت معمولاً شبکه‌بندیِ NAT در WSL2 یا Windows Firewall است که اتصالِ بین WSL2 و IDEی در حالِ اجرا روی میزبانِ ویندوز را مسدود می‌کند. WSL1 مستقیماً از شبکه‌ی میزبان استفاده می‌کند و دچارِ این مشکل نمی‌شود.

اجازه‌ی عبورِ ترافیکِ WSL2 از Windows Firewall

این راهِ‌حلِ توصیه‌شده است چون حالتِ شبکه‌بندیِ موجودِ WSL2 را حفظ می‌کند.

آدرس IP مربوط به WSL2 را پیدا کن

از داخلِ شِلِ WSL، این را اجرا کن:

hostname -I

به subnet توجه کن؛ مثلاً 172.21.123.45 در 172.21.0.0/16 است.

یک قانون فایروال بساز

PowerShell را به‌عنوان Administrator باز کن و دستور زیر را اجرا کن، با تنظیمِ بازه‌ی IP متناسب با subnetات:

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 به شبکه‌بندیِ mirrored

شبکه‌بندیِ mirrored به Windows 11 22H2 یا بالاتر نیاز دارد. اگر روی Windows 10 هستی، به‌جای آن از قانونِ فایروالِ بالا استفاده کن.

این را به فایلِ .wslconfig در دایرکتوریِ کاربریِ ویندوزت اضافه کن:

[wsl2]
networkingMode=mirrored

سپس WSL را با wsl --shutdown از PowerShell ری‌استارت کن.

عیب‌یابی

کار‌نکردنِ پلاگین

اگر پلاگین نصب شده اما قابلیت‌های Claude Code در IDEات ظاهر نمی‌شوند:

• مطمئن شو که Claude Code را از دایرکتوریِ ریشه‌ی پروژه اجرا می‌کنی
• بررسی کن که پلاگین JetBrains در تنظیمات IDE فعال باشد
• IDE را کاملاً ری‌استارت کن (ممکن است لازم باشد این کار را چند بار انجام دهی)
• برای Remote Development، مطمئن شو که پلاگین روی میزبانِ راه‌دور نصب شده است

تشخیص‌داده‌نشدنِ IDE

اگر اجرای claude پیامِ «No available IDEs detected» را نشان می‌دهد:

• تأیید کن که پلاگین نصب و فعال است
• IDE را کاملاً ری‌استارت کن
• بررسی کن که Claude Code را از ترمینالِ یکپارچه اجرا می‌کنی
• برای کاربرانِ WSL، پیکربندی WSL را در بالا ببین

پیدا‌نشدنِ دستور (Command not found)

اگر کلیک روی آیکونِ Claude پیامِ «command not found» را نشان می‌دهد:

1. با اجرای claude --version در یک ترمینال، نصبِ Claude Code را تأیید کن
2. مسیرِ دستورِ Claude را در تنظیمات پلاگین پیکربندی کن
3. برای کاربرانِ WSL، از قالبِ دستورِ WSL که در بخشِ پیکربندی ذکر شد استفاده کن

ملاحظاتِ امنیتی

وقتی Claude Code در یک IDEی JetBrains با دسترسی‌های auto-edit فعال اجرا می‌شود، ممکن است بتواند فایل‌های پیکربندیِ IDE را تغییر دهد که IDEات می‌تواند آن‌ها را به‌صورت خودکار اجرا کند. این موضوع می‌تواند ریسکِ اجرای Claude Code در حالتِ auto-edit را افزایش دهد و امکانِ دور‌زدنِ پرامپت‌های مجوزِ Claude Code برای اجرای bash را فراهم کند.

هنگامِ اجرا در IDEهای JetBrains، این موارد را در نظر بگیر:

• استفاده از حالتِ تأییدِ دستی برای ویرایش‌ها
• دقتِ بیشتر برای اطمینان از اینکه Claude فقط با پرامپت‌های قابل‌اعتماد استفاده می‌شود
• آگاهی از اینکه Claude Code به کدام فایل‌ها دسترسیِ تغییر دارد

برای مشکلاتِ نصب یا ورودِ Claude Code خارج از IDE، عیب‌یابیِ نصب و ورود را ببین.