📘 תיעוד 20

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

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

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

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

תוסף 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. התקינו את Claude Code CLI

עקבו אחרי ההתחלה המהירה כדי להתקין את ה-CLI אם עדיין לא התקנתם. התוסף מציג התראה "Cannot launch Claude Code" כאשר claude לא נמצא ב-PATH.

2. התקינו את תוסף JetBrains

התקינו את תוסף Claude Code מ-JetBrains Marketplace והפעילו מחדש את סביבת הפיתוח.

הערה:

JetBrains Marketplace הוא תוכנה של צד שלישי, ו-Anthropic לא נותנת לו חסות, לא מתחזקת אותו ולא מבקרת אותו. Anthropic שולחת את תוסף Claude Code לפרסום ב-JetBrains Marketplace.

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

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

#שימוש

#הרצת Claude Code מתוך סביבת הפיתוח

הריצו את claude מהטרמינל המשולב של סביבת הפיתוח, וכל יכולות השילוב יהיו פעילות.

#חיבור מטרמינל חיצוני

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

claude

/ide

כאשר החיבור מצליח, Claude Code מאשר בהודעה כמו Connected to IntelliJ IDEA.

אם אתם רוצים של-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 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.

2. צרו כלל חומת אש

פתחו את PowerShell כמנהל והריצו את הפקודה הבאה, תוך התאמת טווח ה-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

3. הפעילו מחדש את סביבת הפיתוח ואת Claude Code

סגרו ופתחו מחדש את שניהם כדי שהכלל החדש ייכנס לתוקף.

#מעבר של WSL2 לרשת mirrored

רשת mirrored דורשת 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 לעריכות, כי acceptEdits ומצב auto שניהם מאשרים עריכות בתוך תיקיית העבודה בלי לשאול, למעט בנתיבים מוגנים
• זהירות נוספת כדי לוודא ש-Claude משמש רק עם הנחיות מהימנות
• מודעות לאילו קבצים יש ל-Claude Code גישה לשנות

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

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

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

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

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

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

כדי להחריג קובץ רגיש כמו .env, הוסיפו כלל דחייה של Read עבור הנתיב שלו. כלל דחייה תואם מונע גם מהטקסט שנבחר וגם מההודעה על הקובץ הפתוח עבור הקובץ הזה להגיע ל-Claude.

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

כלים שנחשפים למודל. השרת מארח כמה כלים, אבל רק אחד גלוי למודל. השאר הם RPC פנימי שה-CLI משתמש בו לממשק שלו, כמו פתיחת הבדלים וקריאת בחירות, והם מסוננים לפני שרשימת הכלים מגיעה ל-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 כדי שממשק ה-loopback של Windows ישותף עם מכונת ה-Linux והשקע יוכל להישאר על loopback.