Claude Code в IDE: що дає плагін і на чому можна спіткнутися

Плагін встановили, кнопку знайшли, натиснули - і перше враження зазвичай таке: це спосіб запустити claude, не перемикаючись в окреме вікно термінала. Зручно, звісно. Але заради однієї кнопки встановлювати окремий плагін було б дивно.

Враження оманливе. Термінал усередині IDE був і до плагіна, набрати в ньому claude руками ніхто не заважав. Плагін займається іншим: він з'єднує агента з редактором, щоб вони бачили одне одного. Що у вас відкрито і виділено, на що скаржиться лінтер, який вигляд має запропонована правка порядково - усе це перестає бути вашою роботою з переказу. Запуск однією кнопкою в цьому наборі - найнудніше, що там є.

Claude Code - річ термінальна, і без IDE він чудово працює: відкрили термінал, набрали claude, далі пишете звичайними словами.

Різниця не в тому, запуститься агент чи ні. Різниця в тому, чим ви перевіряєте його роботу. Файли на диску він змінює по-справжньому. Коли редактор закритий, у вас на руках лише звіт: "додав обробку помилок у три методи". Схоже на правду. Звірити немає з чим.

Плагін закриває саме цей розрив. Нижче - що він дає і на чому найчастіше спотикаються.

1. Що дає зв'язок з редактором

Офіційний плагін уміє п'ять речей. По черзі, починаючи з тієї, заради якої все це й робилося.

• Diff у вікні IDE. Diff - це список змін: які рядки видалено, які додано, що змінилося між старою і новою версією. Правки агента відкриваються у звичному diff-переглядачі редактора, а не текстом у терміналі. Ліворуч було, праворуч стало.
• Контекст виділення. Відкрита вкладка і виділений фрагмент ідуть до агента самі. Не треба копіювати код у чат і пояснювати словами, про який шматок ідеться.
• Надсилання коду агенту. Виділили фрагмент, натиснули хоткей - у промпт іде посилання саме на ці рядки, на кшталт @src/auth.ts#L1-99.
• Діагностика з IDE. Помилки лінтера і синтаксису, які редактор підкреслює червоним, Claude може запросити в IDE сам, без вашого переказу. Про цю можливість зазвичай дізнаються в останню чергу, а вона одна з найкорисніших. Автоматично після кожної правки він їх не перевіряє, тож якщо треба, просто попросіть подивитися помилки у файлі.
• Швидкий запуск. Логотип Claude на панелі IDE або гаряча клавіша - агент відкривається, а ви лишаєтеся в редакторі.

2. Встановлюємо: два шматки, а не один

Тут спотикаються найчастіше. Плагін не містить Claude Code у собі. Він запускає команду claude в інтегрованому терміналі IDE і підключається до неї. Отже, встановлювати треба обидві частини:

1. сам Claude Code - якщо його немає, плагін чесно напише Cannot launch Claude Code;
2. плагін Claude Code [Beta] від Anthropic PBC - встановлюється з Marketplace, після встановлення IDE краще перезапустити повністю, іноді не з першого разу.

Якщо claude встановлений, але лежить не там, де IDE його шукає, повний шлях прописується в Settings → Tools → Claude Code [Beta] → Claude command.

3. Хоткеї, які потрібні одразу

Останній рядок у таблиці не для краси. Хоткеї спрацьовують не завжди: комбінацію перехоплює то система, то інший плагін. Це не збій і не привід лагодити IDE - відкривайте мишкою, спосіб повільніший, зате працює скрізь.

Шукати довго не доведеться: іконка плагіна - це логотип Claude, той самий, що й скрізь в інтерфейсі. Ні з чим не сплутаєте.

Send to Claude Code

Другий хоткей - найуживаніший. Виділяєте шматок коду, натискаєте Ctrl+Alt+K - і в промпт агента потрапляє посилання саме на ці рядки. Те саме лежить у меню дій біля виділення, пункт Send to Claude Code.

У промпті з'являється ось такий рядок - шлях до файлу і діапазон рядків:

@presentations/assets/slides.css#L29-30

Далі дописуєте до нього завдання звичайними словами:

@presentations/assets/slides.css#L29-30 прибери margin-left, через нього верстка з'їжджає на вузькому екрані

Виграють обидва: агент не витрачає кроки на пошук файлу, ви не витрачаєте на цей пошук контекст.

Якщо плагіна немає

Посилання на рядок можна зібрати і засобами самої IDE: правий клік на рядок - Copy / Paste Special - Copy Reference. У буфері опиниться src/utils/slides.js:16.

Формат інший - без @ і через двокрапку. Це вже не автоматична підстановка файлу в контекст, а просто текст у запиті, але як вказівка "дивись сюди" працює: агент прочитає шлях і відкриє потрібне місце сам.

4. Два способи запуску і команда /ide

Запускаєте claude із вбудованого термінала IDE - усі можливості вмикаються самі, робити нічого не треба.

Запустили із зовнішнього термінала (окреме вікно, Windows Terminal, iTerm) - зв'язку з редактором немає, поки не скажете:

# підключити Claude Code до відкритої IDE
/ide

Я б просто взяв за правило запускати агента з термінала IDE. Тоді про /ide згадувати не доводиться взагалі: вона потрібна лише в одному випадку - коли термінал зовнішній.

І ще про теку, з якої запускаєте. Агент дивиться на файли там, де його запустили, - із сусідньої теки він працюватиме не з тими файлами. У своєму проєкті запускайте з його кореня, того самого, що відкритий в IDE.

Із задачами курсу інакше: запускайте агента з теки задачі, а не з кореня javarush-project. Кожна задача там - окрема тека зі своїми файлами і своїми правилами для агента, а в корені проєкту в поле зору агента потрапить одразу весь курс.

5. Куди показувати diff

Де саме показувати зміни - це налаштування, а не щось незмінне:

# відкрити налаштування Claude Code
/config

Там є diff tool: значення auto показує правки в IDE, terminal лишає їх у терміналі. Цей пункт з'являється, лише коли агент підключений до IDE, тож із зовнішнього термінала спершу виконайте /ide. Якщо diff уперто лишається в терміналі - дивитися треба сюди, а не шукати збій у плагіні.

У терміналі diff приходить текстом, приблизно так:

diff --git a/src/main/java/RefundQueue.java b/src/main/java/RefundQueue.java
index 3a7f2bc..9d41a80 100644
--- a/src/main/java/RefundQueue.java
+++ b/src/main/java/RefundQueue.java
@@ -42,7 +42,7 @@ void prioritize(RefundRequest refundRequest) {
-    if (refundRequest.isUrgent()) {
+    if (refundRequest.isUrgent() || refundRequest.amount() > 100) {
         moveToTop(refundRequest);
     }
 }

Читається це так: рядок з мінусом був, рядок з плюсом став. Усе інше - службові заголовки: який файл і з якого рядка показано фрагмент.

А тепер те, заради чого варто ввімкнути показ в IDE. У режимах, де Claude просить дозволу перед кожною правкою, запитання приходить не лише текстом у термінал: IDEA відкриває зміну у своєму diff-вікні з кнопками Reject і Apply. Ви дивитеся на підсвічені рядки в контексті всього файлу і вирішуєте тут-таки.

З текстовим diff у консолі це навіть порівнювати незручно: тут підсвітка синтаксису, сусідні рядки, звична навігація. Рішення "прийняти чи ні" ухвалюється за кодом, а не за описом коду.

6. Три типові граблі

Esc не перериває агента

У терміналі JetBrains клавіша Esc за замовчуванням перекидає фокус у редактор - і до Claude Code просто не доходить. Ситуація неприємна: агент робить не те, ви натискаєте Esc, нічого не відбувається.

Лагодиться один раз: Settings → Tools → Terminal, зняти позначку Move focus to the editor with Escape. Я б зробив це одразу після встановлення плагіна, не чекаючи першого такого випадку.

"No available IDEs detected"

Агент не бачить редактор. Перевірте по черзі: плагін встановлено й увімкнено; IDE перезапущено повністю; claude запущено з вбудованого термінала, а не із зовнішнього вікна.

WSL: агент у Linux, IDE у Windows

Окремий випадок тієї самої помилки. Якщо Claude Code живе у WSL2, а IDE - у Windows, з'єднанню зазвичай заважає мережева ізоляція WSL2 або брандмауер. Лікується правилом брандмауера або перемиканням WSL2 у mirrored networking - обидва способи розписані в документації плагіна. Mirrored networking є лише у Windows 11 22H2 і новіших, на Windows 10 лишається правило брандмауера.

7. Заради чого це все

Зв'язок з IDE дає головне: ви бачите, що робить агент, поки він це робить. Далі ритм такий:

1. Claude пропонує зміну;
2. ви дивитеся diff і вирішуєте, прийняти чи ні;
3. Git фіксує те, що ви прийняли.

Третій крок тут лише позначений. Git-ритм, коміти і відкати - окрема велика тема, до неї курс іще повернеться. Поки досить пам'ятати одне: точка збереження з'являється після вашої перевірки, а не до неї.

Рівним цей цикл буває тільки на схемі. У живій роботі половину правок ви приймете, навіть не глянувши, бо це перейменування змінної, а на одній зависнете на десять хвилин і попросите переробити. Це нормально. Сенс не в тому, щоб вичитувати кожен рядок, а в тому, щоб така можливість була в той момент, коли правка має дивний вигляд.

Без редактора цієї можливості просто немає: звіряти доводиться з описом, а не з кодом.