Claude Code від Anthropic поступово перетворюється з «чергового AI?асистента» на повноцінного співрозробника, який працює безпосередньо з локальним кодом. Канал KODARIK підготував детальний практичний гайд по цьому інструменту, а в цьому матеріалі зосередимося на тому, як саме промптити Claude Code в CLI, як посилатися на файли, керувати дозволами та використовувати вбудовані команди.
Йдеться не про черговий чат з кодом, де доводиться копіювати фрагменти вручну, а про інструмент, який читає структуру проєкту, сам знаходить потрібні файли, змінює їх і щоразу запитує дозволу перед діями. Для розробників, які працюють у терміналі, це може радикально змінити щоденний робочий процес.
Від «чату з кодом» до агента в проєкті: як працюють промпти в Claude Code
Ключова відмінність Claude Code від класичних AI?чатів на кшталт ChatGPT полягає в тому, що він працює «всередині» вашого проєкту. Інструмент встановлюється як CLI?утиліта, запускається в конкретній директорії й отримує доступ до всіх файлів та папок у ній. Далі взаємодія відбувається через звичайні текстові запити — але наслідки цих запитів уже не обмежуються відповіддю у вигляді коду на екрані.
Claude Code може читати, створювати, редагувати й видаляти файли, а також запускати команди. Після виконання змін він здатен самостійно перевірити, чи нічого не зламалося, і відзвітувати про результат. З погляду розробника це виглядає як співпраця з колегою: ви формулюєте завдання природною мовою, а інструмент не просто пояснює, що робити, а виконує роботу в репозиторії.
Це прибирає класичний «біг по колу», знайомий усім, хто користувався AI?чатами для програмування. Замість циклу «запит — відповідь з кодом — копіювання — вставка — запуск — новий запит» Claude Code працює безпосередньо з файлами. Користувачеві не потрібно вручну переносити код у потрібні місця, стежити, який саме файл змінювати, чи шукати, куди вставити фрагмент.
Інструмент приймає запити природною мовою і може самостійно визначати, які файли проєкту потрібно змінити, без ручного копіювання коду користувачем. Якщо, наприклад, попросити «зроби, щоб на сайті з’явилася кнопка входу через Google», Claude Code:
спочатку аналізує структуру проєкту,
визначає, які файли відповідають за аутентифікацію та інтерфейс,
пропонує створення або зміну відповідних файлів,
виконує зміни після явного дозволу,
і може запустити команди для перевірки працездатності.
Те саме стосується завдань на кшталт «сайт повільно вантажиться, розберися та виправ» або «перевір, чи все працює після моїх змін». Розробнику не обов’язково бути експертом у всіх деталях стеку: Claude Code може виступати як наставник, який не лише пояснює, а й виконує рутинну роботу разом із вами.
При цьому базове правило промптингу залишається знайомим: чим конкретніше сформульоване завдання, тим кращий результат. Запит «знайди помилку та виправ» змусить інструмент проглядати весь проєкт у пошуках будь-яких аномалій, тоді як уточнення «у файлі login є помилка, через яку користувачі не можуть зайти на сайт, знайди її і виправ» суттєво звужує пошук і прискорює результат.
Посилання на файли через @: як точніше спрямовувати Claude Code
Один із найважливіших інструментів керування увагою моделі в CLI?версії Claude Code — можливість явно посилатися на файли в промптах. Це вирішує одразу кілька практичних проблем: від неоднозначних назв файлів до великих проєктів із повторюваною структурою.
У CLI Claude Code можна посилатися на файли в промптах за допомогою символу @ з подальшим вибором файлу зі списку. Механіка проста: у полі вводу користувач набирає символ «собачки», після чого інструмент показує список файлів у поточному проєкті. Далі можна стрілками обрати потрібний файл і продовжити формулювати завдання.
Це дає кілька важливих переваг.
По?перше, зникає ризик, що модель переплутає файли з однаковими назвами в різних директоріях. У великих проєктах типові імена на кшталт index.tsx, config.json або login.js можуть зустрічатися десятки разів. Текстове пояснення «у файлі login» в такій ситуації не завжди достатньо однозначне. Посилання через @ прив’язує завдання до конкретного шляху в файловій системі.
По?друге, це зручніше, ніж щоразу описувати шлях до файлу текстом. Замість «відкрий файл src/components/auth/LoginForm.tsx і додай в нього…» можна ввести @, обрати файл зі списку й продовжити: «…додай в нього валідацію для поля email». Claude Code вже розуміє, про який саме файл ідеться.
По?третє, такий підхід добре масштабується на складніші сценарії. Можна в одному промпті послатися на кілька файлів, наприклад: «онови @LoginForm.tsx, щоб використовувати новий API з @authService.ts і опиши зміни в @README.md». Для моделі це чіткий сигнал, які саме файли потрібно читати й змінювати.
У прикладі з гайду спочатку в проєкті не було жодного файлу, тому список після введення @ був порожній. Після того як Claude Code створив тестовий README.md, файл одразу з’явився в списку й став доступним для вибору через @. Це демонструє ще одну деталь: інструмент працює з актуальним станом файлової системи, а не з «захардкоженим» списком файлів на момент запуску.
Фактично, @?посилання перетворюють промпт на щось середнє між природною мовою та інтерактивною командою редактора, де можна точно вказати ціль змін, не виходячи з текстового режиму.
Дозволи як запобіжник: чому Claude Code завжди питає «можна?»
Можливість інструмента читати й змінювати файли, а також запускати команди в терміналі, автоматично піднімає питання безпеки та контролю. Розробник, який запускає AI?агента в робочому репозиторії, хоче бути впевненим, що інструмент не «натворить чогось поганого» — від випадкового видалення файлів до небажаних змін у конфігурації.
Саме тому в Claude Code реалізовано явну модель дозволів. Claude Code запитує явний дозвіл користувача перед виконанням дій на кшталт створення, редагування, видалення файлів або запуску команд, якщо дозволи не були послаблені в налаштуваннях.
У практиці це виглядає так. Коли користувач просить, наприклад, «створи тестовий файл README», Claude Code не просто відповідає текстом із вмістом файлу. Замість цього він формує запит на дозвіл: у терміналі з’являється повідомлення з уточненням, що інструмент хоче створити файл README.md у поточному проєкті, і пропонує варіанти відповіді — підтвердити або відхилити дію.
Користувач може стрілками обрати «yes» або «no». Після підтвердження файл створюється, а його вміст можна одразу побачити в файловому оглядачі терміналу або в редакторі. Якщо ж дозвіл не надано, дія не виконується.
Цей механізм працює не лише для створення файлів. Будь?які операції, що змінюють стан проєкту, — редагування, видалення, запуск команд — також вимагають підтвердження, якщо користувач не змінив політику дозволів у налаштуваннях. Такий підхід дає кілька важливих гарантій.
По?перше, розробник завжди бачить, що саме збирається зробити інструмент. Це особливо важливо в складних завданнях, де Claude Code може запропонувати серію змін у різних файлах. Кожен крок супроводжується запитом, і користувач може зупинити процес, якщо щось виглядає підозріло або небажано.
По?друге, це знижує ризик помилок через неточні промпти. Якщо запит сформульовано нечітко, модель може інтерпретувати його ширше, ніж очікував користувач. Але перед тим, як щось змінити, Claude Code все одно покаже, які саме файли планує зачепити, і попросить дозволу.
По?третє, така модель дозволів робить інструмент придатним для використання навіть тими, хто не почувається впевнено в AI?автоматизації. Можна сприймати Claude Code як «асистента під наглядом»: він пропонує дії, але остаточне рішення завжди залишається за людиною.
У налаштуваннях існують режими, які дозволяють послабити цей контроль і давати інструменту більше автономії, але базова поведінка — постійне запитування дозволу — логічно відповідає очікуванням більшості розробників, особливо на етапі знайомства з Claude Code.
Меню команд зі зворотним слешем: як працює інтерфейс CLI
Хоча основна взаємодія з Claude Code відбувається через промпти природною мовою, CLI?версія інструмента має ще один важливий шар керування — систему команд. Вони дозволяють швидко змінювати модель, перемикати режими, керувати сесіями та виконувати інші службові дії без довгих текстових пояснень.
CLI Claude Code надає команди через меню з префіксом слеш, яке з’являється при введенні символу \ в полі вводу. Як тільки користувач набирає зворотний слеш, у нижній частині інтерфейсу відкривається список доступних команд. По ньому можна переміщатися стрілками й обирати потрібну дію.
Це меню нагадує командну палітру в сучасних редакторах коду: замість того, щоб запам’ятовувати синтаксис або точні назви, достатньо викликати список і візуально знайти потрібну опцію. У гайді демонструється, що команд досить багато, і значна частина з них стосується керування моделями, режимами роботи, сесіями та іншими аспектами поведінки Claude Code.
Наприклад, команда \model відкриває інтерфейс вибору моделі. У Claude Code підтримуються три основні сімейства моделей — Haiku, Sonnet та Opus, причому деякі з них доступні у варіантах зі стандартним і розширеним контекстом до 1 млн токенів. Через меню команд можна швидко перемкнутися з більш потужної, але дорогої моделі Opus на швидку й економну Haiku, якщо потрібно виконати прості тестові дії й не витрачати зайві токени.
Командне меню зі зворотним слешем виконує ще одну важливу роль: воно знижує поріг входу для тих, хто не хоче одразу занурюватися в документацію. Бачачи список доступних команд, користувач інтуїтивно розуміє, які можливості взагалі існують у CLI?інтерфейсі, і може поступово досліджувати їх у міру потреби.
У поєднанні з природномовними промптами це створює двошаровий інтерфейс:
на «людському» рівні — завдання формулюються як звичайні фрази,
на «системному» — спеціальні команди дозволяють керувати самим інструментом, не змішуючи службові дії з описом задачі.
Коли природна мова, а коли команди: практичний баланс
Робота з Claude Code в терміналі будується на поєднанні трьох механізмів: природномовних промптів, посилань на файли через @ та службових команд через \. Разом вони формують досить гнучкий, але при цьому передбачуваний інтерфейс.
Природна мова найкраще підходить для опису бізнес?логіки, бажаного результату та контексту задачі. Саме тут варто бути максимально конкретним: пояснювати, що саме не працює, які обмеження є, як виглядає очікувана поведінка. Claude Code вміє самостійно визначати, які файли потрібно змінити, але чим точніше сформульовано проблему, тим менше зайвої роботи він виконуватиме.
Посилання через @ доречні тоді, коли важливо вказати конкретні файли або коли назви можуть бути неоднозначними. Це також корисно для завдань, де потрібно синхронізувати зміни між кількома файлами: наприклад, оновити компонент, сервіс і документацію в одному промпті.
Команди зі зворотним слешем варто використовувати для керування самим інструментом: вибору моделі, перемикання режимів, роботи з сесіями. Це дозволяє розділити «що робити з кодом» і «як працює Claude Code», не змішуючи службові інструкції з описом задачі.
Окремо варто пам’ятати про модель дозволів. Навіть якщо промпт сформульовано чітко, Claude Code все одно запитає підтвердження перед тим, як створити, змінити або видалити файли чи запустити команди, якщо користувач не послабив ці обмеження в налаштуваннях. Це не лише безпека, а й корисний момент для самоперевірки: ще раз подивитися, які саме дії пропонує виконати інструмент, перш ніж дозволити їх.
У підсумку Claude Code в CLI виглядає не як «чарівна чорна скринька», а як керований агент, з яким можна будувати зрозумілий робочий процес. Природна мова задає цілі, @?посилання уточнюють об’єкти, а \?команди керують самим середовищем.
Висновок: Claude Code як керований співрозробник у терміналі
Claude Code у форматі CLI — це спроба переосмислити роль AI?інструментів у розробці. Замість того, щоб бути лише джерелом порад і фрагментів коду, він стає активним учасником роботи з проєктом: читає структуру, змінює файли, запускає команди й перевіряє результати.
Ключовими елементами цього підходу є:
прийом промптів природною мовою з можливістю самостійно визначати, які файли потрібно змінити;
явні посилання на файли через @, що усувають неоднозначність і дають точний контроль над об’єктами змін;
система дозволів, яка змушує інструмент щоразу питати «можна?» перед будь?якою дією, що змінює проєкт;
меню команд зі зворотним слешем, яке відкриває доступ до службових функцій CLI без необхідності запам’ятовувати синтаксис.
Усе це робить Claude Code придатним як для новачків, яким потрібен наставник, що «робить разом», так і для досвідчених розробників, які хочуть зняти з себе рутину й зосередитися на складних архітектурних рішеннях. За умови уважного ставлення до промптів і дозволів інструмент перетворюється на керованого співрозробника, який працює прямо в терміналі — там, де й так проходить більша частина реальної розробки.
Джерело
Claude Code — повний огляд від А до Я | Все що потрібно знати
This is great info.