Плагін JavaRush всередині IntelliJ IDEA для курсу Claude Code

1. Один курс, два майданчики

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

IDEA - професійний інструмент, у якому все під рукою одразу: код, умова, термінал і агент в одному вікні, а проєкт живе у вас на диску. Спочатку може здаватися, що забиваєте цвяхи мікроскопом. Через кілька задач виявиться, що без IDE уже незручно. Я б переїжджав одразу: звикати до робочого інструмента дешевше, поки задачі прості.

Якщо не користувалися інсталятором: встановіть плагіни вручну

Інсталятор з рівня 1 уже додав плагіни JavaRush і Claude Code та налаштував вхід в акаунт. Якщо ви його запускали, цей блок можна пропустити. Не пам'ятаєте, запускали чи ні? Відкрийте список плагінів: якщо JavaRush і Claude Code уже там - усе гаразд, гортайте далі.

1. Встановіть плагін JavaRush. У Windows і Linux відкрийте File → Settings → Plugins, у macOS - IntelliJ IDEA → Preferences → Plugins. На вкладці Marketplace введіть у пошуку JavaRush і натисніть Install. Поки не перезапускайте IDEA: спочатку встановіть другий плагін.
2. Встановіть офіційний плагін Claude Code. Не закриваючи Marketplace, введіть у пошуку Claude Code, виберіть Claude Code [Beta] і натисніть Install. Коли обидва плагіни встановлені, перезапустіть IDEA.
3. Після встановлення натисніть Увійти в акаунт на верхній панелі плагіна. Відкрийте на сайті JavaRush розділ Налаштування → Безпека і вхід, скопіюйте секретний ключ і вставте його у вікно входу в IDEA.

Після входу плагін JavaRush завантажить навчальний проєкт, і можна буде відкривати задачі прямо в IDEA.

2. Де знаходиться список задач

На лівій вертикальній панелі IDEA натисніть Tasks. Відкриється список доступних завдань.

Знайдіть потрібну картку задачі і натисніть на неї. У вікні, що з'явиться, виберіть Відкрити.

У плагіні доступні всі задачі з сайту. Якщо ви вже розв'язали задачу на сайті і вона успішно пройшла перевірку, ваш код завантажиться в проєкт в IDEA.

Вікно задачі спершу виглядає перевантаженим. На старті вам потрібні рівно дві речі:

• Condition - умова задачі: що треба зробити і які вимоги виконати;
• дерево проєкту зліва - файли задачі, з якими ви працюєте. Вони можуть бути різних типів і називатися по-різному: наприклад, index.html, Main.java або якось інакше - шукайте той, який просить умова, а не звичне ім'я.

Логіка проста: спочатку прочитайте Condition, потім знайдіть потрібний файл у дереві проєкту і беріться за розв'язання задачі.

3. Агент бачить файли, але не бачить умову

Коли ви відкриваєте задачу, плагін завантажує її файли на диск. Claude Code працює з файлами, тому дерево папок, код та інші файли задачі він бачить - за умови, що запущений у потрібній папці (про це наступний розділ).

Але умова і вимоги розташовані в панелі Condition. Агент не бачить цю панель автоматично. Розібратися в суті завдання і виділити вимоги - це частина вашого навчання, яку важливо пройти самостійно.

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

Спочатку прочитайте умову цілком і розберіться в ній. Після цього можна скопіювати в чат з агентом лише важливі фрагменти. Ще краще - опишіть мету і вимоги своїми словами. Так ви справді розберетеся в задачі, а Claude Code залишиться помічником, а не заміною навчанню.

4. Кожна задача - окремий проєкт

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

Далі ручний варіант: як зробити те саме засобами IDEA. Він потрібен, щоб розуміти, що взагалі відбувається, і не залежати від підказки.

Тепер головний факт про будову курсу. Кожна задача тут - окремий проєкт. Не файл усередині спільного проєкту, а самостійний проєкт: своя папка, свої файли, свої правила для агента в .claude. Скільки задач у курсі - стільки й проєктів.

Плагін складає їх усі в одне дерево javarush-project, щоб вам не відкривати по окремому вікну на кожну задачу. Виглядає це приблизно так:

javarush-project/
└── src/ru/javarush/claude/course/level01/     # рівень курсу
    ├── task05/                # задача = окремий проєкт
    │   ├── .claude/           # правила агента для цієї задачі
    │   └── arkanoid.html      # файл задачі
    └── task09/                # інша задача = інший проєкт
        ├── .claude/           # у неї свої правила
        ├── arkanoid.html      # файли задачі, їх буває кілька
        ├── clicker.html
        └── tictactoe.html

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

Тут звичка підводить. Дерево одне, а проєктів у ньому стільки ж, скільки задач, і між собою вони не пов'язані ніяк: task09 нічого не знає про task05, і правила .claude у кожної задачі свої. Для агента корінь проєкту - це не "ваш проєкт", а склад чужих один одному проєктів. Корисного контексту в сусідніх задачах немає, а правила потрібної задачі він звідти не підхопить.

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

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

Як запустити агента в папці задачі

1. Знайдіть папку задачі в дереві проєкту зліва.
2. Натисніть на неї правою кнопкою миші і виберіть Open In - Terminal. Відкриється вкладка термінала, яка вже стоїть у цій папці.
3. Наберіть claude.

Звучить як зайвий крок. Насправді це один правий клік, і робиться він один раз на задачу.

Ніякої магії за цим кліком немає: IDEA просто набирає за вас команду cd до вибраної папки. Те саме можна зробити руками в уже відкритому терміналі:

cd src/ru/javarush/claude/course/level01/task09
claude

Одна пастка: у дереві проєкту IDEA показує пакет одним рядком через точки - ru.javarush.claude.course.level01, - а на диску це вкладені папки. Набирати такий шлях з екрана безглуздо, він там не такий. Простіше скопіювати: правий клік по папці задачі - Copy Path/Reference.

Перейшли на наступну задачу

Робоча папка задається під час запуску і сама за вами не переїжджає. Але й робити нічого складного не потрібно: агент помітить, що задача змінилася, і запропонує перейти в її папку.

Хочете самі - переходьте в папку нової задачі і запускайте claude там: тим самим правим кліком або командою cd. Можна й відкрити для нової задачі окрему вкладку термінала, тоді обидві будуть під рукою.

Агент сам каже, де він знаходиться

Слідкувати за цим руками не потрібно. У рядку стану під чатом навчальний профіль Claude Code пише, з якою задачею він працює: JR · claude.course · task02.

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

Журнал навчальних сесій

Є ще одна причина запускати агента саме в папці задачі, і про неї треба сказати прямо.

У навчальному профілі Claude Code налаштоване ведення журналу роботи. Поки ви розв'язуєте задачу, в її папці з'являється .javarush, куди записується хід роботи: ваші запити до агента, початок його відповідей, які файли він змінював, які команди запускав.

Так виглядає папка однієї задачі, коли ви в ній уже попрацювали:

task09/
├── .claude/                  # правила агента для цієї задачі
├── .javarush/
│   ├── cc-transcript.txt     # журнал роботи, звичайний текст
│   └── cc-transcript.json
├── arkanoid.html             # файли самої задачі
├── clicker.html
└── tictactoe.html

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

Журнал залишається у вас на диску, поруч із задачею: файл можна відкрити і прочитати. І з'являється він там, звідки запущений агент. Запустили з кореня проєкту - у корені й опиниться, а в папці задачі його не буде. Ще один довід не пропускати cd.

5. Як відправити розв'язок на перевірку

Коли розв'язок готовий, натисніть кнопку Перевірити у вікні задачі. Плагін відправить поточну версію розв'язку на сервер JavaRush.

Після перевірки результат з'явиться там само, в інтерфейсі задачі. Далі один із двох варіантів:

• розв'язок прийнято - вимоги виконані, задача зарахована;
• розв'язок не прийнято - плагін покаже повідомлення перевірки, після якого можна повернутися до умови і виправити розв'язок.

Неприйнята спроба - це не поломка проєкту. Це звичайний зворотний зв'язок. Прочитайте повідомлення, знову відкрийте Condition, порівняйте його з розв'язком і виправте один зрозумілий пункт. Один, а не всі одразу: так видно, що саме допомогло.

Відправляти розв'язок можна скільки завгодно разів. Перевірка для того й потрібна: зробили спробу, отримали результат, виправили, відправили знову.

6. Налаштування плагіна, які варто знати

Синхронізація задач: сайт і плагін

Плагін показує задачі активного курсу - того, який вибраний у вас на сайті. Курсів там може бути кілька, але активний завжди один.

Список задач та їхні статуси оновлюються самі: приблизно раз на п'ять хвилин і після кожної успішної відправки на перевірку. Задача, розв'язана на сайті, з'явиться в плагіні вже розв'язаною.

Оновити прямо зараз - натисніть на аватар справа зверху і виберіть Синхронізувати задачі. Після зміни активного курсу це обов'язковий крок: доки не синхронізуєте або не перезапустите IDEA, плагін показуватиме задачі попереднього курсу.

Як прибрати навігаційну панель плагіна

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

1. Натисніть на аватар справа зверху і виберіть Налаштування - Режим Новачка, щоб вимкнути його.
2. Зверху в плагіна з'явиться навігаційна панель. Натисніть на ній Налаштування (⚙️) і зніміть галочку "Відображати навігаційну панель плагіна".

Сам я її прибираю одразу: місце на екрані дорожче за пару кнопок.

Ручне встановлення плагіна

1. Завантажте плагін.
2. Відкрийте налаштування: у Windows і Linux - File → Settings, у macOS - IntelliJ IDEA → Preferences.
3. У бічному меню виберіть розділ Plugins, натисніть на шестерню (⚙️) і виберіть Install Plugin from Disk.
4. Відкрийте папку, в якій лежить плагін. Виберіть архів і натисніть OK, потім перезапустіть IDEA.