Команди запуску та команди в сесії

1. Два шари, які легко сплутати

Команди Claude Code здаються однією купою — і через це легко змішати два моменти: вхід у CLI і керування вже відкритою роботою. Далі починається класика: людина пише /compact у терміналі або намагається «додати» прапорець запуску всередині відкритої сесії. Не туди.

Під час першого запуску ви це бачили: claude відкривав сесію з shell, а /doctor і /status працювали всередині неї.

Термінал shell
  └─ рівень запуску: claude ...
       └─ відкрита сесія Claude Code
            └─ команди всередині сесії: /help, /status, /clear, /compact ...

Правило просте. Команда визначає, як сесія стартує, — це рівень запуску. Команда керує сесією, що вже триває — це команда всередині сесії. І це важливіше за назви: імена та прапорці змінюються від версії до версії, логіка двох шарів — ні.

2. Рівень запуску: вхід у роботу

Поки Claude Code не запущено, ви перебуваєте у звичайній оболонці ОС — Terminal, iTerm, PowerShell, Git Bash, WSL. Тут вирішується не «що Claude зробить у розмові», а як розмова почнеться.

Базовий випадок — зайти до папки Commerce OS і відкрити інтерактивну сесію:

cd ~/projects/commerce-os
claude                    # відкриває інтерактивну сесію в поточному каталозі

Для першого робочого дня цього вистачає. Решта нижче — карта варіантів старту, запамʼятовувати не потрібно.

Одноразова дія без діалогу:

claude -p "Коротко опиши структуру проєкту"   # одноразовий запуск; назва прапорця може відрізнятися залежно від версії

Продовжити попередню сесію:

claude -c   # продовжити / resume попередню сесію; точна назва прапорця залежить від версії

Задати на старті рамку роботи — режим permissions, окремий worktree:

claude --permission-mode plan         # приклад задання режиму на старті; назва режиму може відрізнятися
claude --worktree ../commerce-os-exp  # приклад запуску в окремому worktree; синтаксис залежить від версії

У всіх випадках одне: ви ще не всередині живої бесіди, ви налаштовуєте точку входу. Такі команди шукайте в claude --help або документації, а не в /help сесії.

Контрольне запитання: «Я змінюю спосіб запуску чи керую вже розпочатою розмовою?» Відповідь про запуск — ви у зовнішньому шарі. Звідси типова помилка: ви всередині сесії й хочете «додати» --permission-mode, але прапорець працює до появи сесії.

3. Команди всередині сесії: керування розмовою

Сесія активна — ви не запускаєте процес, а живете всередині нього: діалог, накопичений контекст, прочитані файли, історія. Команди зі слешем не «створюють нового Claude», а наводять лад в відкритій розмові.

Базова — /help: локальне джерело істини про те, що вміє саме ваша версія. Сумніваєтеся в назві команди — сюди, а не в пост «10 суперкоманд Claude Code».

Типовий фрагмент живої сесії:

$ claude
> /help
> /status
> /doctor
> /context
> /compact
> /diff

Що робить кожна. /status — поточний стан. /doctor — перевірка середовища та діагностика. /context — чим заповнений робочий контекст. /compact — стиснути довгу історію. /clear — очистити діалог. /diff — зміни в коді очима Claude. /permissions — дозволи саме в поточній сесії. /rewind — відновлення стану цієї сесії, а не перезапуск Claude як програми.

Різниця помітна на парі дій. Історія розрослася — берете /compact, це зміна стану поточної сесії. Потрібна інша сесія або інший запуск — слеш не допоможе, повертаєтеся до рівня запуску.

Ці команди працюють із тим, що вже накопичилося. Напишете /clear у звичайній оболонці — shell сприйме це як незрозумілий набір символів. І буде правий.

Команди запуску створюють кімнату. Команди всередині сесії переставляють у ній меблі.

4. Швидкий вибір рівня

Тримати весь каталог команд у голові не потрібно. Перед дією поставте собі одне запитання. Вистачає таблиці.

claude

claude -p "..."

claude -c

--permission-mode

--worktree

/status

/doctor

/clear

/compact

/context

/diff

/permissions

/review

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

Подивіться на пару типових промахів. Людина пише в shell:

$ /compact

Це неправильно не тому, що /compact — «погана команда», а тому, що її надіслано не в той шар. Так само неправильно очікувати, що всередині вже відкритої сесії можна раптово «додати» собі прапорець запуску заднім числом. Помилка тут не в незнанні синтаксису, а в плутанині між моментами керування.

І ось це дуже добра новина для навчання: вам не потрібно запамʼятовувати сотню команд. Вам потрібно навчитися розрізняти момент входу та момент керування.

5. Шари в дії: сценарій у Commerce OS

Тепер давайте подивимося на реальний маленький сценарій у нашому наскрізному проєкті Commerce OS. Припустімо, ви відкрили репозиторій і хочете спочатку просто зайти в Claude Code, потім перевірити стан, потім стиснути контекст, а пізніше зробити короткий одноразовий запит щодо diff. На словах усе просто, але саме на такому повсякденному маршруті й закріплюється розуміння двох шарів.

Спочатку ви заходите в проєкт і запускаєте Claude Code. Це рівень запуску:

cd ~/projects/commerce-os
claude   # відкрили інтерактивну сесію в репозиторії

Після запуску ви вже всередині живої сесії. Тепер можна подивитися її стан і діагностичну інформацію:

> /status
> /doctor

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

> /context
> /compact

Якщо після цього Claude запропонував зміни, ви можете перевірити їх через команду всередині сесії:

> /diff

А тепер уявімо, що ви вже завершили основну бесіду і окремо хочете швидко отримати коротке резюме поточного diff без нової довгої інтерактивної сесії. Ось тут ви знову виходите до рівня запуску і робите щось на кшталт одноразового виклику:

claude -p "Коротко опиши поточні зміни в проєкті"   # приклад one-shot запуску

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

Ще один характерний приклад. Припустімо, ви розумієте, що хочете не просто очистити розмову, а відкрити інший спосіб роботи, наприклад окремий worktree для експерименту. /clear тут не допоможе, тому що він стосується поточної сесії. Вам потрібен новий запуск із потрібними параметрами. А якщо ви вже в потрібній сесії і просто хочете не загубитися в накопиченому діалозі, тоді якраз безглуздо «перезапускати все» — достатньо /compact або /clear, залежно від ситуації.

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

6. Момент важливіший за назву

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

Нам потрібна інша навичка — звичка запамʼятовувати не «чарівні команди», а логіку місця і моменту. Є допомога CLI до старту, є /help всередині сесії, є claude --version для розуміння поточної версії і є офіційна документація як зовнішнє джерело істини. Усе інше — вже деталі конкретного збирання інструмента.

Корисно навіть промовляти це про себе. Якщо ви стоїте в shell і думаєте: «Мені потрібно відкрити Claude певним способом», йдіть у claude --help. Якщо ви вже всередині Claude і думаєте: «Мені потрібно зрозуміти, чим можна керувати в поточній сесії», йдіть у /help. Ця звичка здається дрібницею, але саме вона рятує від застарілих гайдів, старих скриншотів і порад формату «у мене працювало пів року тому».

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