Claude Code ב-JetBrains: התקנה ועבודה מתוך ה-IDE

מאת צוות מדיה דיל · 08.08.2026 · AI · 8 דק׳

מדריך מעשי לפלאגין הרשמי של Claude Code ל-IntelliJ, PyCharm, WebStorm ועוד: התקנה נכונה, עבודה עם diff viewer מובנה, שיתוף הקשר מהבחירה בעורך, וכל מה שצריך כדי לעבוד נכון מתוך ה-IDE.

מי שעובד יום-יום ב-IntelliJ IDEA, PyCharm, WebStorm או כל IDE אחר מבית JetBrains, מכיר את התחושה: לעבור לטרמינל חיצוני כדי לדבר עם עוזר AI, ואז לחזור לעורך כדי לראות מה בעצם השתנה בקוד, זה שובר את הזרימה. בדיוק בשביל זה קיים הפלאגין הרשמי של Claude Code ל-JetBrains - אינטגרציה שמביאה את Claude Code ישירות לתוך ה-IDE, עם diff viewer מובנה, שיתוף אוטומטי של ההקשר שאתם עובדים עליו, וקיצורי מקלדת שחוסכים המון קליקים מיותרים. במדריך הזה נעבור על מה שהפלאגין באמת עושה, איך מתקינים אותו נכון (כולל השלב שהרבה מפתחים מפספסים), ואיך זה נראה בעבודה יומיומית אמיתית.

אילו IDE-ים נתמכים

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

• IntelliJ IDEA - לפיתוח Java ו-Kotlin
• PyCharm - לפיתוח Python
• Android Studio - לפיתוח אפליקציות Android
• WebStorm - לפיתוח JavaScript ו-TypeScript
• PhpStorm - לפיתוח PHP
• GoLand - לפיתוח Go

בפועל, מדובר באותו פלאגין בדיוק שמותקן דרך JetBrains Marketplace, ומכיוון שכל ה-IDE-ים האלה חולקים את אותה תשתית פלטפורמה (IntelliJ Platform), חוויית העבודה כמעט זהה בין הכלים - כלומר צוות שעובד עם PyCharm בצד Python ו-WebStorm בצד Frontend מקבל את אותה שכבת אינטגרציה, בלי צורך ללמוד שני ממשקים שונים.

איך מתקינים - שני שלבים, לא אחד

הנקודה הכי חשובה להבין לפני ההתקנה: הפלאגין עצמו לא מכיל עותק של ה-CLI. הוא רק מריץ את הפקודה claude בטרמינל המשולב של ה-IDE ומתחבר אליה. זאת אומרת שצריך להתקין שני רכיבים נפרדים, ובסדר הנכון:

• שלב ראשון - התקנת ה-CLI: אם עוד לא התקנתם את Claude Code, צריך לעשות זאת קודם דרך תהליך ההתקנה הרגיל. אם ה-CLI לא נמצא ב-PATH של המערכת, הפלאגין יציג התראה ‘Cannot launch Claude Code’ ברגע שתנסו להפעיל אותו.
• שלב שני - התקנת הפלאגין: מתקינים את פלאגין Claude Code מ-JetBrains Marketplace, ואז מפעילים מחדש את ה-IDE. חשוב לא לדלג על שלב הריסטרט - לפעמים צריך אפילו יותר מפעם אחת כדי שהפלאגין ייטען כמו שצריך.

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

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

איך מפעילים את האינטגרציה בפועל

אחרי שההתקנה הושלמה, יש שתי דרכים להתחיל לעבוד:

• מתוך ה-IDE: פשוט מריצים claude מהטרמינל המשולב של JetBrains, וכל תכונות האינטגרציה מופעלות אוטומטית.
• מטרמינל חיצוני: אם כבר פתחתם את Claude Code מטרמינל רגיל מחוץ ל-IDE, מריצים את הפקודה /ide כדי לחבר אותו ל-IDE הפתוח ולהפעיל את כל התכונות. אם Claude Code מזהה IDE פתוח שאין לו פלאגין מותקן, הפקודה /ide תתקין אותו עבורכם ותבקש ריסטרט.

כשהחיבור מצליח, Claude Code מאשר זאת עם הודעה כמו ‘Connected to IntelliJ IDEA’. חשוב לזכור: כדי ש-Claude יראה בדיוק את אותם קבצים כמו ה-IDE, כדאי להריץ את Claude Code מאותה תיקיית שורש של הפרויקט שפתוח ב-IDE.

התכונות המרכזיות של הפלאגין

זה החלק שבאמת משנה את חוויית העבודה היומיומית. הפלאגין מוסיף חמש תכונות עיקריות:

• הפעלה מהירה (Quick launch) - קיצור Cmd+Esc ב-Mac או Ctrl+Esc ב-Windows/Linux פותח את Claude Code ישירות מהעורך, או שאפשר פשוט ללחוץ על כפתור Claude Code בממשק.
• Diff viewing - צפייה בשינויים ב-diff viewer של ה-IDE - במקום לראות את השינויים בקוד כטקסט גולמי בטרמינל, Claude Code פותח אותם ב-diff viewer הרגיל של JetBrains, אותו כלי שאתם כבר מכירים מ-code review וממיזוגים ב-git. אפשר לשלוט בהתנהגות הזו דרך הגדרת Diff tool ב-/config.
• שיתוף הקשר מהבחירה (Selection context) - הבחירה הנוכחית בעורך, או הטאב הפתוח כרגע, משותפים אוטומטית עם Claude Code בכל פרומפט שאתם שולחים. חוק deny על Read עבור קובץ מסוים חוסם את השיתוף הזה עבור אותו קובץ.
• קיצורי הפניה לקבצים (File reference shortcuts) - Cmd+Option+K ב-Mac או Alt+Ctrl+K ב-Linux/Windows מכניסים הפניה לקובץ בפורמט כמו @src/auth.ts#L1-99, בלי לכתוב את זה ידנית.
• שיתוף אבחונים (Diagnostic sharing) - שגיאות אבחון מה-IDE, כמו שגיאות lint ותחביר, משותפות אוטומטית עם Claude תוך כדי העבודה, כך שהוא “רואה” את מה שה-IDE כבר מסמן באדום.

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

מה קורה מאחורי הקלעים: שרת ה-MCP המובנה

שווה להבין קצת יותר לעומק איך זה עובד טכנית, בעיקר אם אתם עובדים בארגון עם מדיניות אבטחה. כשהפלאגין פעיל, הוא מריץ שרת MCP מקומי בשם ide, וזה מה שמאפשר ל-CLI לפתוח diff-ים ב-viewer הטבעי, לקרוא את הבחירה הנוכחית שלכם לצורך אזכורי @, ולמשוך אבחוני inspection לתוך השיחה. השרת הזה מוסתר מ-/mcp כי אין בו מה להגדיר, אבל אם הארגון שלכם משתמש ב-hook מסוג PreToolUse כדי לנהל allowlist של כלי MCP, כדאי לדעת שהוא קיים.

מבחינת חשיפה טכנית: השרת מאזין על פורט אקראי שנקבע על ידי מערכת ההפעלה ולא ניתן להגדיר אותו ידנית. התעבורה היא ws:// לא מוצפנת, וכל הפעלה של ה-IDE מייצרת טוקן אימות אקראי חדש שנשמר בקובץ lock תחת ~/.claude/ide/. ה-CLI חייב להציג את הטוקן הזה כדי להתחבר. כברירת מחדל השרת מאזין רק על 127.0.0.1, כלומר לא נגיש ממחשבים אחרים ברשת - אלא אם מפעילים במפורש את ההגדרה Accept connections from all network interfaces, שרלוונטית בעיקר למקרים כמו WSL2 עם רשת NAT או עבודה מרוחקת (Remote Development), כאשר הלולאה המקומית (loopback) לא מספיקה. הכלי היחיד שנחשף בפועל למודל הוא mcp__ide__getDiagnostics שקורא בלבד את אבחוני ה-IDE - הפלאגין לא חושף למודל שום יכולת הרצת קוד.

דוגמה מהעבודה היומיומית

נניח שאתם עובדים ב-WebStorm על קומפוננטת React שמציגה שגיאת TypeScript, ואתם רוצים ש-Claude Code יתקן אותה. ככה זה נראה בפועל:

• מסמנים את הפונקציה הבעייתית בעורך ולוחצים Cmd+Esc כדי לפתוח את Claude Code - הבחירה שסימנתם כבר “בדרך” אליו כהקשר.
• Claude Code רואה גם את שגיאת ה-TypeScript שה-IDE כבר מסמן, בזכות שיתוף האבחונים האוטומטי, ולא צריך להעתיק את הודעת השגיאה ידנית.
• מבקשים ממנו לתקן, והוא מציע שינוי. במקום פלט טקסט ארוך בטרמינל, השינוי נפתח ב-diff viewer המוכר של JetBrains - אותו ממשק ירוק-אדום שאתם משתמשים בו כל יום ב-code review.
• בודקים את ה-diff, מאשרים או מבקשים תיקון נוסף, וממשיכים לקובץ הבא באמצעות @ וקיצור ה-Cmd+Option+K כדי להפנות במדויק לשורות הרלוונטיות.

כל התהליך הזה קורה בלי לצאת מה-IDE, בלי חלונות טרמינל נפרדים שצריך לסדר על המסך, ובלי לתאר ל-Claude בעצמכם איפה הבעיה - הוא כבר “רואה” את מה שאתם רואים.

הגדרות שכדאי להכיר

כמה הגדרות שווה להכיר כדי להתאים את הפלאגין לזרימת העבודה שלכם:

• Diff tool ב-/config - כדי לקבוע אם diff-ים נפתחים בתוך ה-IDE (auto) או נשארים בטרמינל (terminal). שימו לב שהערך Diff tool מופיע ב-/config רק כש-Claude Code מחובר בפועל ל-IDE, אז צריך להריץ אותו מהטרמינל של JetBrains או להריץ קודם /ide מטרמינל חיצוני.
• Claude command - בהגדרות הפלאגין תחת Settings → Tools → Claude Code [Beta], שם קובעים איזו פקודה בדיוק מפעילה את Claude, כולל נתיבים מותאמים כמו npx @anthropic-ai/claude-code.
• Enable using Option+Enter for multi-line prompts - הגדרה ל-Mac בלבד, שמאפשרת ל-Option+Enter להוסיף שורה חדשה בפרומפט, שימושית למי שכותב הודעות ארוכות עם כמה נקודות.
• Enable automatic updates - עדכון אוטומטי של הפלאגין עצמו, שמופעל בריסטרט הבא של ה-IDE.
• הגדרות ESC - אם מקש ה-ESC לא עוצר פעולה שמתבצעת ב-Claude Code בתוך הטרמינל של JetBrains, צריך לגשת ל-Settings → Tools → Terminal ולבטל את ההגדרה ‘Move focus to the editor with Escape’ או למחוק את קיצור המקלדת המקביל.

למי שעובד עם WSL, יש הערה שימושית: את הפקודה שמגדירים ב-Claude command אפשר להגדיר בפורמט כמו wsl -d Ubuntu -- bash -lic ‘claude’, כדי שהפלאגין יידע להפעיל את ה-CLI בתוך סביבת ה-WSL הנכונה.

שימוש ב-Remote Development ו-WSL

שתי נקודות חשובות למי שלא עובד בהתקנה סטנדרטית:

• JetBrains Remote Development - כשעובדים עם פיתוח מרוחק, הפלאגין חייב להיות מותקן על ה-host המרוחק דרך Settings → Plugin (Host), לא על המחשב המקומי שממנו מתחברים. זו טעות נפוצה שגורמת לתחושה שהאינטגרציה “לא עובדת” כשבעצם היא פשוט לא מותקנת במקום הנכון.
• WSL2 - אם רואים הודעת ‘No available IDEs detected’, הסיבה השכיחה היא רשת ה-NAT של WSL2 או חומת האש של Windows שחוסמת את החיבור בין WSL2 ל-IDE שרץ על ה-host. הפתרון המומלץ הוא להוסיף כלל בחומת האש שמאפשר תעבורת WSL2 פנימית (לפי כתובת ה-IP וה-subnet של ה-WSL), ואם עובדים על Windows 11 22H2 ומעלה, אפשרות חלופית היא לעבור למצב mirrored networking בקובץ .wslconfig, שמשתף את ממשק ה-loopback של Windows עם ה-VM של לינוקס.

למה זה משתלם במיוחד לצוותים שעובדים עם JetBrains

ארגונים שכל הפיתוח שלהם כבר בנוי סביב IntelliJ Platform - למשל צוות backend ב-Java עם IntelliJ IDEA, צוות Python עם PyCharm, וצוות mobile עם Android Studio - מקבלים מהפלאגין משהו שקשה להשיג אחרת: שכבת אינטגרציה אחידה על פני כלים שונים, בלי שכל צוות צריך ללמוד ממשק אחר. מפתח שרגיל ל-diff viewer של PyCharm לא צריך להסתגל לכלי diff חדש כדי לעבוד עם Claude Code - הוא רואה בדיוק את אותו ממשק שהוא כבר מכיר מ-code review יומיומי.

זה גם מקטין את חיכוך האימוץ בתוך ארגון: כשמנהל פיתוח רוצה להטמיע Claude Code בצוות שלם, ההבדל בין “עוד כלי CLI שצריך לפתוח בטרמינל נפרד” לבין “כפתור בתוך ה-IDE שכבר פתוח כל היום” הוא ההבדל בין אימוץ חלקי לאימוץ מלא. צוותים שמשלבים את זה עם skills ופקודות מותאמות אישית מקבלים סביבת עבודה שבה גם ההקשר וגם התהליכים המותאמים לצוות זמינים ישירות מה-IDE, בלי צעדים נוספים.

שווה גם לציין: מי שעובד בעיקר ב-VS Code או ב-Cursor יכול להכיר תכונות מקבילות דרך התוסף של Claude Code ל-VS Code - העקרונות דומים, גם אם הממשק והקיצורים שונים בהתאם לפלטפורמה.

שיקולי אבטחה שכדאי לדעת

כשמריצים Claude Code ב-JetBrains במצב הרשאה acceptEdits (אישור אוטומטי של עריכות קבצים), יש נקודה שכדאי להיות מודעים אליה: המצב הזה עלול לאפשר ל-Claude לשנות גם קובצי קונפיגורציה של ה-IDE עצמו, שחלקם עלולים לרוץ אוטומטית. זה עשוי להגדיל את הסיכון בעבודה במצב הזה ולעקוף בפועל את בקשות ההרשאה הרגילות עבור הרצת פקודות. לכן, כשעובדים בפרויקטים רגישים, מומלץ לשקול מצב אישור ידני לעריכות, להקפיד שהפרומפטים שנשלחים ל-Claude מגיעים ממקור מהימן, ולהיות מודעים בכל רגע לאילו קבצים יש ל-Claude Code גישה בפרויקט הנוכחי.

פתרון בעיות נפוצות

כמה תקלות שחוזרות על עצמן ואיך לפתור אותן:

• הפלאגין מותקן אבל התכונות לא מופיעות - ודאו שאתם מריצים את Claude Code מתיקיית השורש של הפרויקט, בדקו שהפלאגין מופעל בהגדרות ה-IDE, ונסו לסגור ולפתוח מחדש את ה-IDE לחלוטין - לפעמים יותר מפעם אחת. בעבודה עם Remote Development, ודאו שהפלאגין מותקן ב-host המרוחק ולא בצד הלקוח.
• “No available IDEs detected” בהרצת /ide - ודאו שהפלאגין מותקן ומופעל, הפעילו מחדש את ה-IDE, ואם ציפיתם לחיבור אוטומטי בלי להריץ /ide, בדקו שהפעלתם את claude מתוך הטרמינל המשולב של ה-IDE עצמו ולא מטרמינל חיצוני.
• “command not found” בלחיצה על אייקון Claude - ודאו קודם ש-claude --version עובד בטרמינל רגיל, ואם כן - הגדירו את הנתיב המדויק בהגדרת Claude command של הפלאגין.

שאלות נפוצות

האם צריך להתקין את Claude Code CLI בנפרד, או שהפלאגין כולל הכל?

צריך להתקין את שניהם בנפרד. הפלאגין לא מגיע עם עותק משלו של ה-CLI - הוא רק מריץ את הפקודה claude בטרמינל המשולב של ה-IDE ומתחבר אליה. אם ה-CLI לא מותקן או לא נמצא ב-PATH, תופיע הודעת ‘Cannot launch Claude Code’.

איך רואים את השינויים שClaude מציע - בטרמינל או בתוך ה-IDE?

ברירת המחדל היא לפתוח את השינויים ב-diff viewer המובנה של JetBrains, אותו ממשק שמשמש לבדיקת קוד רגילה. אפשר לשנות את זה חזרה לתצוגת טרמינל דרך הגדרת Diff tool בפקודת /config, שמופיעה שם רק כש-Claude Code מחובר בפועל ל-IDE.

מה זה בדיוק “שיתוף הקשר מהבחירה”, ואיך שולטים בו?

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

האם צריך מפתח API כדי להשתמש בפלאגין?

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

אני עובד עם WSL2 ו-JetBrains בווינדוס - למה ה-IDE לא מתגלה?

הבעיה השכיחה היא רשת ה-NAT של WSL2 יחד עם חומת האש של Windows, שחוסמות את החיבור בין ה-WSL ל-IDE שרץ בצד ה-Windows. WSL1 לא סובל מהבעיה כי הוא משתמש ברשת של ה-host ישירות. הפתרון המומלץ הוא כלל חומת אש שמאפשר תעבורת WSL2 פנימית, או מעבר למצב mirrored networking אם עובדים על Windows 11 22H2 ומעלה.

למה חשוב להיזהר במיוחד עם מצב acceptEdits בתוך JetBrains?

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

הפלאגין של Claude Code ל-JetBrains הופך אינטגרציית AI מתוסף חיצוני שצריך “לזכור להשתמש בו” לחלק טבעי מזרימת העבודה בתוך ה-IDE שאתם כבר חיים בו כל יום. בצוות מדיה דיל אנחנו מלווים חברות וצוותי פיתוח בהטמעת Claude Code בסביבות JetBrains, IntelliJ Platform וכלים נוספים, כולל הגדרה נכונה של הרשאות, Hooks ותהליכי עבודה מותאמים. מוזמנים לדבר איתנו ב-וואטסאפ

תגיות: Claude Code · JetBrains · IntelliJ IDEA · PyCharm · WebStorm · פלאגין AI · diff viewer

← חזרה לבלוג · צור קשר