מדריך קלוד קוד בעברית
לאתר הראשי כל המדריכים קלאודפלייר קלוד דסקטופ גרוק CLI גרוק בוט MCP קרסור וואטסאפ OpenClaw n8n בענן n8n בהתקנה עצמית

תיעוד 20

סביבות פיתוח של JetBrains

השתמש ב-Claude Code עם סביבות פיתוח של JetBrains כולל IntelliJ, PyCharm, WebStorm ועוד

Claude Code משתלב עם סביבות פיתוח של JetBrains באמצעות תוסף ייעודי, ומספק תכונות כמו צפייה אינטראקטיבית בהבדלי קוד (diff), שיתוף הקשר של בחירה ועוד.

#סביבות פיתוח נתמכות

התוסף של Claude Code עובד עם רוב סביבות הפיתוח של JetBrains, כולל:

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

#תכונות

  • הפעלה מהירה: השתמש ב-Cmd+Esc (ב-Mac) או ב-Ctrl+Esc (ב-Windows/Linux) כדי לפתוח את Claude Code ישירות מהעורך שלך, או לחץ על כפתור Claude Code בממשק המשתמש
  • צפייה בהבדלים: Claude Code פותח שינויי קוד במציג ההבדלים של סביבת הפיתוח במקום במסוף. ניתן לשנות זאת באמצעות הגדרת Diff tool ב-/config
  • הקשר של בחירה: הבחירה הנוכחית או הלשונית הפעילה בסביבת הפיתוח משותפות באופן אוטומטי עם Claude Code. כללי חסימת Read חוסמים שיתוף זה עבור קבצים תואמים
  • קיצורי דרך להפניה לקבצים: השתמש ב-Cmd+Option+K (ב-Mac) או ב-Alt+Ctrl+K (ב-Linux/Windows) כדי להוסיף הפניות לקבצים כגון @src/auth.ts#L1-99
  • שיתוף אבחונים: Claude קורא את אבחוני הבדיקה של סביבת הפיתוח, כגון שגיאות lint ותחביר, על ידי קריאה לכלי getDiagnostics. Claude Code אינו מבקש מהתוסף אבחונים בעצמו לאחר עריכות

#התקנה

התוסף מריץ את הפקודה claude במסוף המשולב של סביבת הפיתוח ומתחבר אליו. הוא אינו כולל עותק משלו של ה-CLI, לכן יש להתקין את שני החלקים:

  1. התקן את ה-CLI של Claude Code: עקוב אחר ה-quickstart כדי להתקין את ה-CLI אם עדיין לא עשית זאת. התוסף מציג התראה "Cannot launch Claude Code" כאשר claude אינו נמצא ב-PATH שלך.
  2. התקן את התוסף של JetBrains: התקן את התוסף של Claude Code מ-JetBrains Marketplace והפעל מחדש את סביבת הפיתוח שלך.

אם claude מותקן במיקום שסביבת הפיתוח שלך אינה יכולה למצוא, הגדר את הנתיב המלא בהגדרת Claude command של התוסף.

Claude Code עובד עם כל מנוי בתשלום של Claude (Pro, Max, Team או Enterprise) או עם חשבון Claude Console, ואין צורך במפתח API. תתבקש להתחבר בפעם הראשונה שתריץ את claude.

#שימוש

#מסביבת הפיתוח שלך

הרץ את claude מהמסוף המשולב של סביבת הפיתוח שלך, וכל תכונות השילוב יהיו פעילות.

#ממסופים חיצוניים

השתמש בפקודה /ide בכל מסוף חיצוני כדי לחבר את Claude Code לסביבת הפיתוח של JetBrains ולהפעיל את כל התכונות:

claude
/ide

כאשר החיבור מצליח, Claude Code מאשר זאת בהודעה כמו Connected to IntelliJ IDEA. אם Claude Code מזהה סביבת פיתוח פועלת שאין בה את התוסף, /ide מתקין את התוסף עבורך ומבקש ממך להפעיל מחדש את סביבת הפיתוח.

אם ברצונך של-Claude תהיה גישה לאותם קבצים כמו לסביבת הפיתוח שלך, הפעל את Claude Code מאותה ספרייה של שורש הפרויקט בסביבת הפיתוח.

#הגדרה

#הגדרות Claude Code

הגדר את השילוב עם סביבת הפיתוח דרך ההגדרות של Claude Code:

  1. הרץ את claude
  2. הזן את הפקודה /config
  3. הגדר את Diff tool ל-auto כדי להציג הבדלים בסביבת הפיתוח, או ל-terminal כדי להשאיר אותם במסוף

האפשרות Diff tool מופיעה ב-/config רק כאשר Claude Code מחובר לסביבת הפיתוח, לכן הרץ את claude ממסוף JetBrains או הרץ תחילה את /ide ממסוף חיצוני. ראה את diffTool עבור ההגדרה הבסיסית.

#הגדרות התוסף

הגדר את התוסף של Claude Code על ידי מעבר אל Settings → Tools → Claude Code [Beta]:

#הגדרות כלליות

  • Claude command: ציין פקודה מותאמת אישית להרצת Claude, לדוגמה claude, /usr/local/bin/claude, או npx @anthropic-ai/claude-code
  • Suppress notification for when Claude Command is 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.

#תצורות מיוחדות

#פיתוח מרוחק

אזהרה: בעת שימוש ב-JetBrains Remote Development, חובה להתקין את התוסף במחשב המארח המרוחק דרך Settings → Plugin (Host), ולא במחשב הלקוח המקומי שלך.

#תצורת WSL

אם אתה משתמש ב-Claude Code ב-WSL2 עם סביבת פיתוח של JetBrains ורואה את ההודעה "No available IDEs detected", הסיבה היא בדרך כלל רשת ה-NAT של WSL2 או חומת האש של Windows (Windows Firewall) שחוסמת את החיבור בין WSL2 לבין סביבת הפיתוח הפועלת במחשב המארח של Windows. הגרסה WSL1 משתמשת ישירות ברשת של המארח ואינה מושפעת.

#אפשר תעבורת WSL2 דרך Windows Firewall

זהו התיקון המומלץ מכיוון שהוא שומר על מצב הרשת הקיים של WSL2.

  1. מצא את כתובת ה-IP של WSL2 שלך: מתוך מעטפת ה-WSL שלך, הרץ:
hostname -I

שים לב לרשת המשנה שלך: קח את שני המקטעים הראשונים של הכתובת והוסף אחריהם .0.0/16. לדוגמה, אם הכתובת היא 172.21.123.45, רשת המשנה שלך היא 172.21.0.0/16.

  1. צור כלל חומת אש: פתח את PowerShell כמנהל מערכת (Administrator) והרץ את הפקודה הבאה, תוך התאמת טווח ה-IP לרשת המשנה שלך:
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
  1. הפעל מחדש את סביבת הפיתוח ואת Claude Code: סגור ופתח מחדש את שניהם כדי שהכלל החדש ייכנס לתוקף.

#העבר את WSL2 למצב רשת במראה (mirrored networking)

רשת במראה דורשת את Windows 11 22H2 או גרסה מאוחרת יותר. אם אתה ב-Windows 10, השתמש בכלל חומת האש שלמעלה במקום זאת.

הוסף זאת לקובץ .wslconfig בספריית המשתמש שלך ב-Windows:

[wsl2]
networkingMode=mirrored

לאחר מכן הפעל מחדש את WSL עם wsl --shutdown מתוך PowerShell.

#פתרון בעיות

#התוסף אינו עובד

אם התוסף מותקן אך תכונות Claude Code אינן מופיעות בסביבת הפיתוח שלך:

  • ודא שאתה מריץ את Claude Code מספריית השורש של הפרויקט
  • בדוק שהתוסף של JetBrains מופעל בהגדרות סביבת הפיתוח
  • הפעל מחדש לחלוטין את סביבת הפיתוח (ייתכן שתצטרך לעשות זאת מספר פעמים)
  • עבור פיתוח מרוחק (Remote Development), ודא שהתוסף מותקן במארח המרוחק

#סביבת הפיתוח אינה מזוהה

אם הפקודה /ide מציגה "No available IDEs detected":

  • ודא שהתוסף מותקן ומופעל
  • הפעל מחדש לחלוטין את סביבת הפיתוח
  • אם ציפית לחיבור אוטומטי בלי להריץ את /ide, בדוק שהפעלת את claude מהמסוף המשולב של סביבת הפיתוח
  • עבור משתמשי WSL, ראה תצורת WSL למעלה

#פקודה לא נמצאה

אם לחיצה על סמל Claude מציגה "command not found":

  1. ודא ש-Claude Code מותקן על ידי הרצת claude --version במסוף
  2. הגדר את נתיב פקודת Claude בהגדרות התוסף
  3. עבור משתמשי WSL, השתמש במבנה פקודת ה-WSL שצוין בסעיף ההגדרות

#שיקולי אבטחה

כאשר Claude Code פועל בסביבת פיתוח של JetBrains במצב הרשאות acceptEdits, ייתכן שיוכל לשנות קובצי תצורה של סביבת הפיתוח אשר עשויים להיות מופעלים אוטומטית על ידי סביבת הפיתוח שלך. דבר זה עלול להגביר את הסיכון בהרצת Claude Code במצב acceptEdits ולאפשר עקיפה של בקשות האישור של Claude Code להרצת bash.

בעת הרצה בסביבות פיתוח של JetBrains, שקול:

  • שימוש במצב ידני (Manual mode) עבור עריכות, מכיוון שמצב acceptEdits ומצב auto מאשרים שניהם עריכות בתוך ספריית העבודה שלך ללא שאלה, למעט ב-נתיבים מוגנים
  • נקיטת זהירות יתרה כדי לוודא שמשתמשים ב-Claude רק עם הנחיות מהימנות
  • מודעות לקבצים של-Claude Code יש גישה לשנות

לבעיות בהתקנת Claude Code או בהתחברות מחוץ לסביבת הפיתוח, ראה פתרון בעיות התקנה והתחברות.

#שרת ה-MCP המובנה של סביבת הפיתוח

כאשר התוסף פעיל, הוא מריץ שרת MCP מקומי שה-CLI מתחבר אליו אוטומטית. כך ה-CLI פותח שינויים (diffs) במציג ההבדלים המקורי של סביבת הפיתוח, קורא את הבחירה הנוכחית שלך עבור אזכורי @, ומאפשר ל-Claude לקרוא אבחוני בדיקה.

השרת נקרא ide והוא מוסתר מ-/mcp מכיוון שאין בו דבר להגדרה. עם זאת, אם הארגון שלך משתמש ב-hook מסוג PreToolUse כדי לאשר כלי MCP ברשימת היתרים, תצטרך לדעת שהוא קיים.

הקשר של בחירה ושל קובץ פתוח. בזמן החיבור, ה-CLI כולל את בחירת העורך הנוכחית שלך ואת הנתיב של הקובץ הפעיל כהקשר בכל הנחיה שאתה שולח. תמליל השיחה מציג את השורה ⧉ Selected N lines from <file> כאשר זה קורה. כדי להחריג קובץ רגיש כגון .env, הוסף כלל חסימת Read עבור הנתיב שלו. כלל חסימה תואם מונע הן מהטקסט הנבחר והן מההודעה על קובץ פתוח עבור אותו קובץ מלהגיע אל Claude.

תעבורה ואימות. השרת מאזין ביציאה ארעית (ephemeral port) שהוקצתה על ידי מערכת ההפעלה, והיציאה אינה ניתנת להגדרה. התעבורה היא ws:// לא מוצפן. ב-loopback, כל תהליך שיכול ללכוד את התעבורה יכול גם לקרוא את האסימון מקובץ הנעילה, כך ש-TLS לא יוסיף הגנה מפני תוקף מקומי. כל הפעלה של סביבת הפיתוח מייצרת אסימון אימות אקראי חדש, כותבת אותו לקובץ נעילה בנתיב ~/.claude/ide/<port>.lock, וה-CLI חייב להציג אותו ככותרת X-Claude-Code-Ide-Authorization כדי להתחבר. אם המשתנה CLAUDE_CONFIG_DIR מוגדר, קובץ הנעילה נכתב במקום זאת אל $CLAUDE_CONFIG_DIR/ide/.

כלים שנחשפים למודל. השרת מארח מספר כלים, אך רק אחד מהם גלוי למודל. השאר הם קריאות RPC פנימיות שה-CLI משתמש בהן עבור ממשק המשתמש שלו, כגון פתיחת הבדלים וקריאת בחירות, והם מסוננים החוצה לפני שרשימת הכלים מגיעה אל Claude.

שם הכלי (כפי שנראה על ידי hooks)מה הוא עושהלקריאה בלבד
mcp__ide__getDiagnosticsמחזיר את אבחוני הבדיקה של סביבת הפיתוח, השגיאות והאזהרות שמוצגות בעורך. כל קריאה מכסה קובץ אחד: הקובץ ש-Claude מציין, או הקובץ בעורך הפעיל שלך אם Claude אינו מציין קובץ.כן

התוסף של JetBrains אינו חושף למודל כלי להרצת קוד.

ממשק האזנה. ממשק הרשת שאליו השרת מאזין נשלט על ידי Accept connections from all network interfaces תחת Settings → Tools → Claude Code [Beta] → Networking (Advanced). כאשר ההגדרה מושבתת, השרת מאזין ב-127.0.0.1 בלבד ואינו נגיש ממארחים אחרים. כאשר היא מופעלת, היציאה נגישה מהרשת המקומית שלך. ההגדרה קיימת עבור מקרים שבהם ה-CLI אינו יכול להגיע לסביבת הפיתוח דרך loopback, כגון WSL2 עם רשת NAT המוגדרת כברירת מחדל או מערך סביבת פיתוח מרוחקת. ראה תצורת WSL עבור תרחיש זה.

אזהרה: הפעלת Accept connections from all network interfaces הופכת את יציאת ה-MCP של סביבת הפיתוח לנגישה מהרשת המקומית שלך. חיבורים עדיין דורשים את אסימון האימות מקובץ הנעילה, אך מכיוון שהתעבורה היא ws:// לא מוצפן, גם תעבורת ההפעלה וגם האסימון הזה עוברים ברשת כטקסט גלוי כאשר ההגדרה מופעלת. הפעל אותה רק כאשר loopback אינו יכול לעבוד. עבור WSL2, העדף רשת במראה (mirrored networking) כדי שממשק ה-loopback של Windows ישותף עם מכונת ה-Linux הווירטואלית והשקע יוכל להישאר ב-loopback.