Name	Name	Last commit message	Last commit date
parent directory ..
README.md	README.md
config-examples.json	config-examples.json
planning-mode-examples.md	planning-mode-examples.md
setup-auto-mode-permissions.py	setup-auto-mode-permissions.py

Розширені функції

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

Зміст

Огляд
Режим планування
Розширене мислення
Auto Mode
Фонові завдання
Заплановані завдання
Режими дозволів
Headless Mode
Управління сесіями
Інтерактивні функції
Голосовий ввід
Канали
Інтеграція Chrome
Remote Control
Веб-сесії
Десктопний додаток
Список завдань
Підказки промптів
Git Worktrees
Пісочниця
Керовані налаштування (Enterprise)
Конфігурація та налаштування
Agent Teams
Найкращі практики
Додаткові ресурси

Огляд

Розширені функції Claude Code доповнюють базові можливості плануванням, міркуванням, автоматизацією та механізмами контролю. Ці функції забезпечують складні робочі процеси для комплексних завдань розробки, ревʼю коду, автоматизації та управління кількома сесіями.

Ключові розширені функції:

Режим планування: Створення детальних планів реалізації перед кодуванням
Розширене мислення: Глибоке міркування для складних проблем
Auto Mode: Фоновий класифікатор безпеки перевіряє кожну дію перед виконанням
Фонові завдання: Виконання тривалих операцій без блокування розмови
Режими дозволів: Контроль дій Claude (default, acceptEdits, plan, auto, dontAsk, bypassPermissions)
Режим друку: Неінтерактивний запуск Claude Code для автоматизації та CI/CD (claude -p)
Управління сесіями: Управління кількома робочими сесіями
Інтерактивні функції: Клавіатурні скорочення, багаторядковий ввід та історія команд
Голосовий ввід: Push-to-talk голосовий ввід з підтримкою STT для 20 мов
Канали: MCP-сервери надсилають повідомлення в активні сесії (Research Preview)
Remote Control: Управління Claude Code з Claude.ai або додатку Claude
Веб-сесії: Запуск Claude Code у браузері на claude.ai/code
Десктопний додаток: Автономний додаток для візуального перегляду diff та кількох сесій
Список завдань: Постійне відстеження завдань між стисненнями контексту
Підказки промптів: Розумні підказки команд на основі контексту
Git Worktrees: Ізольовані робочі дерева для паралельної роботи
Пісочниця: Ізоляція файлової системи та мережі на рівні ОС
Керовані налаштування: Корпоративне розгортання через plist, Registry або керовані файли
Конфігурація: Налаштування поведінки за допомогою JSON-файлів конфігурації

Режим планування

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

Що таке режим планування?

Режим планування — це двофазний підхід:

Фаза планування: Claude аналізує завдання та створює детальний план реалізації
Фаза реалізації: Після затвердження Claude виконує план

Коли використовувати режим планування

✅ Використовуйте для:

Складного рефакторингу кількох файлів
Реалізації нових функцій
Архітектурних змін
Міграцій баз даних
Масштабних змін API

❌ Не використовуйте для:

Простого виправлення помилок
Змін форматування
Редагування одного файлу
Швидких запитів

Активація режиму планування

Слеш-команда:

/plan Implement user authentication system

Прапорець CLI:

claude --permission-mode plan

Встановити за замовчуванням:

{
  "permissions": {
    "defaultMode": "plan"
  }
}

Клавіатурне скорочення:

Shift + Tab — Перемикання режимів дозволів (включно з plan)
Alt + M — Перемикання режимів дозволів (лише Windows, коли середовище виконання не вмикає режим VT-вводу)

Переваги режиму планування

Структурований підхід до реалізації: Детальна розбивка кроків реалізації
Перегляд та затвердження: Затвердіть або скоригуйте план перед виконанням
Виявлення ризиків: Визначення потенційних проблем до реалізації
Чіткі фази: Організовані фази та етапи реалізації

Приклад: Реалізація функції

User: /plan Add a real-time notification system

Claude: I'll create a plan for implementing real-time notifications.

## Implementation Plan

### Phase 1: Infrastructure Setup
1. Install WebSocket libraries (socket.io)
2. Set up WebSocket server
3. Configure connection management

### Phase 2: Backend Implementation
4. Create notification service
5. Implement notification queue
6. Add database schema for notifications
7. Create API endpoints

### Phase 3: Frontend Integration
8. Set up WebSocket client
9. Create notification UI components
10. Implement notification state management
11. Add notification permissions

### Phase 4: Testing & Deployment
12. Write unit tests
13. Write integration tests
14. Update documentation
15. Deploy to staging

Estimated time: 3-4 hours
Files to modify: 12
New files to create: 8

Ready to proceed? (yes/no/modify plan)

User: yes

Claude: [Begins implementation following the plan]

Модифікація планів

User: Modify the plan - skip the queue for now, we'll add it later

Claude: Updated plan:
[Shows modified plan with queue removed]

User: Looks good, proceed

Claude: [Implements modified plan]

Конфігурація режиму планування

Режим планування активується через прапорець CLI або слеш-команду:

# Активація режиму планування через CLI
claude --permission-mode plan

# Або використовуйте слеш-команду /plan всередині REPL
/plan Implement user authentication system

Псевдонім моделі для планування: Використовуйте opusplan як псевдонім моделі, щоб використовувати Opus для планування та Sonnet для виконання:

claude --model opusplan "design and implement the new API"

Редагування плану зовні: Натисніть Ctrl+G, щоб відкрити поточний план у зовнішньому редакторі для детальних змін.

Розширене мислення

Розширене мислення дозволяє Claude витрачати більше часу на обмірковування складних проблем перед наданням рішення.

Що таке розширене мислення?

Розширене мислення — це цілеспрямований покроковий процес міркування, де Claude:

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

Активація розширеного мислення

Клавіатурне скорочення:

Option + T (macOS) / Alt + T (Windows/Linux) — Перемикання розширеного мислення

Автоматична активація:

Увімкнено за замовчуванням для всіх моделей (Opus 4.6, Sonnet 4.6, Haiku 4.5)
Opus 4.6: Адаптивне міркування з рівнями зусиль: low (○), medium (◐), high (●), max (тільки Opus 4.6)
Інші моделі: Фіксований бюджет до 31 999 токенів

Методи конфігурації:

Перемикання: Alt+T / Option+T, або через /config
Перегляд міркувань: Ctrl+O (детальний режим)
Встановлення зусиль: команда /effort або прапорець --effort

Власний бюджет:

export MAX_THINKING_TOKENS=1024

Рівень зусиль (тільки Opus 4.6):

export CLAUDE_CODE_EFFORT_LEVEL=high   # low (○), medium (◐), high (●), або max (тільки Opus 4.6)

Прапорець CLI:

claude --effort high "complex architectural review"

Слеш-команда:

/effort high

Примітка: Ключове слово "ultrathink" у промптах активує режим глибокого міркування. Рівні зусиль low, medium, high та max (тільки Opus 4.6) контролюють обсяг міркувань Claude.

Переваги розширеного мислення

Глибоке міркування: Більше часу на обдумування складних проблем
Кращі архітектурні рішення: Обґрунтовані рішення з комплексною оцінкою
Розгляд граничних випадків: Продумування потенційних проблем і сценаріїв
Ретельний аналіз: Структурований підхід до вирішення складних проблем

Приклад: Архітектурне рішення

User: ultrathink Should we use microservices or a monolith for our e-commerce platform?

Claude: Let me think through this architectural decision carefully...

<extended_thinking>
## Context Analysis
- Team size: 5 developers
- Expected traffic: 10k daily users initially
- Need to scale to 100k+ users
- Limited DevOps resources
- 6-month timeline to MVP

## Approach 1: Microservices
Pros:
+ Independent scaling
+ Technology flexibility
+ Team independence
+ Fault isolation

Cons:
- Operational complexity
- Network overhead
- Distributed tracing needed
- Requires DevOps expertise
- Slower initial development

## Approach 2: Monolith
Pros:
+ Simpler deployment
+ Faster initial development
+ Easier debugging
+ Lower operational overhead
+ Single codebase

Cons:
- Scaling challenges later
- All-or-nothing deployments
- Technology lock-in
- Potential for tight coupling

## Decision Factors
1. Team size (5 devs) → Favors monolith
2. DevOps resources (limited) → Favors monolith
3. Timeline (6 months) → Favors monolith
4. Future scale (100k users) → Achievable with monolith + caching
5. Complexity budget → Limited

## Recommendation
Start with a **modular monolith**:
- Single deployment unit
- Clear module boundaries
- Clean interfaces between modules
- Prepare for future extraction to microservices if needed

This gives you:
✓ Fast initial development
✓ Low operational complexity
✓ Option to extract services later
✓ Clear architecture

Migration path: When you reach 50k+ users or specific modules need independent scaling, extract those modules into microservices.
</extended_thinking>

**Recommendation**: Implement a modular monolith with clean module boundaries.

This approach balances your current constraints (team size, timeline, DevOps resources) with future scalability needs. You can migrate specific modules to microservices later when there's a clear business need.

Конфігурація розширеного мислення

Розширене мислення контролюється через змінні оточення, клавіатурні скорочення та прапорці CLI:

# Встановлення бюджету токенів мислення
export MAX_THINKING_TOKENS=16000

# Встановлення рівня зусиль (тільки Opus 4.6): low (○), medium (◐), high (●), або max (тільки Opus 4.6)
export CLAUDE_CODE_EFFORT_LEVEL=high

Перемикання під час сесії за допомогою Alt+T / Option+T, встановлення зусиль через /effort або конфігурація через /config.

Auto Mode

Auto Mode — це режим дозволів, який використовує фоновий класифікатор безпеки для перевірки кожної дії перед виконанням. Він дозволяє Claude працювати автономно, блокуючи небезпечні операції. Доступний на всіх планах, але вимагає відповідної моделі та провайдера.

Вимоги

План: Team, Enterprise або API (недоступно на планах Pro або Max)
Модель: Claude Sonnet 4.6 або Opus 4.6
Провайдер: Тільки Anthropic API (не підтримується на Bedrock, Vertex або Foundry)
Класифікатор: Додаткова вартість токенів, окрім планів Enterprise та акаунтів Claude API, де v2.1.278+ виконує перевірку на боці сервера без оплати

Увімкнення Auto Mode

# Інтерактивні сесії запускаються в auto mode, якщо режим дозволів не налаштовано (v2.1.284+)
# Щоб вибрати його явно, наприклад коли ваші налаштування задають інший режим за замовчуванням:
claude --permission-mode auto

# Або перемикайтеся на нього через Shift+Tab у REPL

Або встановіть як режим дозволів за замовчуванням:

claude --permission-mode auto

Встановлення через конфігурацію:

{
  "permissions": {
    "defaultMode": "auto"
  }
}

Як працює класифікатор

Фоновий класифікатор оцінює кожну дію в такому порядку:

Правила дозволу/заборони — Спочатку перевіряються явні правила дозволів
Читання/редагування автоматично затверджуються — Читання та редагування файлів проходять автоматично
Класифікатор — Фоновий класифікатор перевіряє дію
Запасний варіант — Повертається до запиту після 3 послідовних або 20 загальних блокувань

Заблоковані дії за замовчуванням

Auto mode блокує наступне за замовчуванням:

Заблокована дія	Приклад
Встановлення через pipe-to-shell	`curl \| bash`
Надсилання конфіденційних даних назовні	API-ключі, облікові дані через мережу
Деплой на продакшн	Команди деплою на продакшн
Масове видалення	`rm -rf` на великих директоріях
Зміни IAM	Зміни дозволів та ролей
Force push у main	`git push --force origin main`

Дозволені дії за замовчуванням

Дозволена дія	Приклад
Локальні операції з файлами	Читання, запис, редагування файлів проєкту
Встановлення оголошених залежностей	`npm install`, `pip install` з маніфесту
HTTP тільки для читання	`curl` для отримання документації
Push у поточну гілку	`git push origin feature-branch`

Конфігурація Auto Mode

Вивести правила за замовчуванням у JSON:

claude auto-mode defaults

Налаштування довіреної інфраструктури через керовану настройку autoMode.environment для корпоративних розгортань. Це дозволяє адміністраторам визначати довірені середовища CI/CD, цілі деплою та шаблони інфраструктури.

Запасна поведінка

Коли класифікатор невпевнений, auto mode повертається до запиту користувача:

Після 3 послідовних блокувань класифікатором
Після 20 загальних блокувань класифікатором за сесію

Це гарантує, що користувач завжди зберігає контроль, коли класифікатор не може впевнено затвердити дію.

Посів дозволів Auto-Mode

Якщо ви хочете простіший підхід без фонового класифікатора, ви можете наповнити ваш ~/.claude/settings.json консервативним базовим набором безпечних правил дозволів. Скрипт починає з правил тільки для читання та локального інспектування, потім дозволяє вам додавати редагування, тести, локальний запис у git, встановлення пакетів та дії запису GitHub лише за потреби.

Файл: 09-advanced-features/setup-auto-mode-permissions.py

# Попередній перегляд змін (без запису)
python3 09-advanced-features/setup-auto-mode-permissions.py --dry-run

# Застосувати консервативний базовий набір
python3 09-advanced-features/setup-auto-mode-permissions.py

# Додавати більше можливостей лише за потреби
python3 09-advanced-features/setup-auto-mode-permissions.py --include-edits --include-tests
python3 09-advanced-features/setup-auto-mode-permissions.py --include-git-write --include-packages

Скрипт додає правила в таких категоріях:

Категорія	Приклади
Базові інструменти тільки для читання	`Read()`, `Grep()`, `Agent()`, `WebSearch()`, `WebFetch(*)`
Локальне інспектування	`Bash(git status:)`, `Bash(git log:)`, `Bash(git diff:)`, `Bash(cat:)`
Опціональне редагування	`Edit(*)`
Опціональні тести/збірка	`Bash(pytest:)`, `Bash(python3 -m pytest:)`, `Bash(cargo test:*)`
Опціональний запис у git	`Bash(git add:)`, `Bash(git commit:)`, `Bash(git checkout:)`, `Bash(git switch:)`, `Bash(git stash:)`, `Bash(git tag:)`
Менеджери пакетів	`Bash(npm ci:)`, `Bash(npm install:)`, `Bash(pip install:)`, `Bash(pip3 install:)`
Збірка та тести	`Bash(make:)`, `Bash(pytest:)`, `Bash(go test:*)`
Звичайні shell-команди	`Bash(ls:)`, `Bash(cat:)`, `Bash(find:*)`
GitHub CLI	`Bash(gh pr view:)`, `Bash(gh pr create:)`, `Bash(gh issue list:*)`

Небезпечні операції (rm -rf, sudo, force push, DROP TABLE, terraform destroy тощо) навмисно виключені. Скрипт ідемпотентний — повторний запуск не дублює правила.

Фонові завдання

Фонові завдання дозволяють виконувати тривалі операції без блокування вашої розмови.

Що таке фонові завдання?

Фонові завдання виконуються асинхронно, поки ви продовжуєте працювати:

Тривалі набори тестів
Процеси збірки
Міграції баз даних
Скрипти деплою
Інструменти аналізу

Базове використання:

User: Run tests in background

Claude: Started task bg-1234

/tasks    # Переглянути й керувати фоновою роботою (оболонки та субагенти); звідси можна зупинити завдання
Ctrl+B    # Перевести запущену Bash-команду або агента у фон

Запуск фонових завдань

User: Run the full test suite in the background

Claude: Starting tests in background (task-id: bg-1234)
You can continue working while tests run.

[You can continue the conversation]

User: Meanwhile, let's refactor the auth module

Claude: [Works on auth module while tests run in background]

[Later, when tests complete]

Claude: 📢 Background task bg-1234 completed:
✅ 245 tests passed
❌ 3 tests failed
View results: /tasks

Управління фоновими завданнями

Запустіть /tasks (псевдонім /bashes), щоб переглянути запущені оболонки й субагенти, відкрити один із них і побачити його вивід або зупинити його. Підкоманд /task не існує.

User: /tasks

[Opens the background-work view: running shells and subagents,
 including subagents that have finished. Select one to see its
 output, or stop it from here.]

Приклад: Паралельна розробка

User: Run the build in the background

Claude: Starting build... (task-id: bg-5001)

User: Also run the linter in background

Claude: Starting linter... (task-id: bg-5002)

User: While those run, let's implement the new API endpoint

Claude: [Implements API endpoint while build and linter run]

[10 minutes later]

Claude: 📢 Build completed successfully (bg-5001)
📢 Linter found 12 issues (bg-5002)

User: Show me the linter issues

Claude: [Shows linter output from bg-5002]

Конфігурація

Немає блоку settings.json для фонових завдань. Функція керується змінною середовища:

# Повністю вимкнути фонові завдання
export CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=true

Паралельність теж не є налаштуванням фонових завдань — кількість одночасно запущених агентів визначає CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS (за замовчуванням 20).

Заплановані завдання

Заплановані завдання дозволяють автоматично запускати промпти за розкладом або як одноразові нагадування. Завдання привʼязані до сесії — вони працюють, поки Claude Code активний, і очищуються при завершенні сесії. Доступно з v2.1.72+.

Команда `/loop`

# Явний інтервал
/loop 5m check if the deployment finished

# Природна мова
/loop check build status every 30 minutes

Також підтримуються стандартні 5-польні cron-вирази для точного планування.

Одноразові нагадування

Встановлення нагадувань, які спрацьовують один раз у визначений час:

remind me at 3pm to push the release branch
in 45 minutes, run the integration tests

Управління запланованими завданнями

Інструмент	Опис
`CronCreate`	Створити нове заплановане завдання
`CronList`	Показати всі активні заплановані завдання
`CronDelete`	Видалити заплановане завдання

Обмеження та поведінка:

До 50 запланованих завдань на сесію
Привʼязані до сесії — очищуються при завершенні сесії
Повторювані завдання автоматично закінчуються через 3 дні
Завдання спрацьовують лише під час роботи Claude Code — пропущені запуски не компенсуються

Деталі поведінки

Аспект	Деталь
Джитер повторюваних	До 10% від інтервалу (макс. 15 хвилин)
Джитер одноразових	До 90 секунд на межах :00/:30
Пропущені запуски	Без компенсації — пропускаються, якщо Claude Code не працював
Збереження	Не зберігаються між перезапусками

Хмарні заплановані завдання

Використовуйте /schedule для створення хмарних запланованих завдань, які працюють на інфраструктурі Anthropic:

/schedule daily at 9am run the test suite and report failures

Хмарні заплановані завдання зберігаються між перезапусками і не потребують локально запущеного Claude Code.

Вимкнення запланованих завдань

export CLAUDE_CODE_DISABLE_CRON=1

Приклад: Моніторинг деплою

/loop 5m check the deployment status of the staging environment.
        If the deploy succeeded, notify me and stop looping.
        If it failed, show the error logs.

Порада: Заплановані завдання привʼязані до сесії. Для постійної автоматизації, яка переживає перезапуски, використовуйте CI/CD пайплайни, GitHub Actions або заплановані завдання десктопного додатку.

Режими дозволів

Режими дозволів контролюють, які дії Claude може виконувати без явного схвалення.

Доступні режими дозволів

Режим	Поведінка
`default`	Тільки читання файлів; запитує дозвіл на всі інші дії
`acceptEdits`	Читання та редагування файлів; запитує дозвіл на команди
`plan`	Тільки читання файлів (режим дослідження, без редагувань)
`auto`	Усі дії з перевірками фонового класифікатора безпеки
`bypassPermissions`	Усі дії, без перевірки дозволів (небезпечно)
`dontAsk`	Виконуються лише попередньо затверджені інструменти; всі інші відхиляються

Перемикайте режими через Shift+Tab у CLI. Встановіть режим за замовчуванням через прапорець --permission-mode або налаштування permissions.defaultMode. Якщо режим дозволів не налаштовано, інтерактивні сесії в терміналі та VS Code починаючи з v2.1.284 запускаються в режимі auto на будь-якому плані та в будь-якого провайдера (у v2.1.283 так було лише у сторонніх провайдерів, як-от Bedrock, Agent Platform від Google Cloud і Foundry, або з вимкненою телеметрією); permissions.defaultMode і далі має пріоритет, а сесія, де режим auto недоступний, натомість запускається в режимі default (Manual). Починаючи з v2.1.302, сесії claude -p та Agent SDK, у яких не задано режим дозволів, запускаються в режимі default у сторонніх провайдерів, з вимкненою телеметрією або на свіжій інсталяції; передайте --permission-mode auto, щоб зберегти режим auto.

Методи активації

Клавіатурне скорочення:

Shift + Tab  # Цикл default → acceptEdits → plan, далі bypassPermissions/auto, коли доступні (dontAsk ніколи не зʼявляється в циклі)

Слеш-команда:

/plan                  # Увійти в режим планування

Прапорець CLI:

claude --permission-mode plan
claude --permission-mode auto

Налаштування:

{
  "permissions": {
    "defaultMode": "auto"
  }
}

Приклади режимів дозволів

Режим Default

Claude запитує підтвердження на значущі дії:

User: Fix the bug in auth.ts

Claude: I need to modify src/auth.ts to fix the bug.
The change will update the password validation logic.

Approve this change? (yes/no/show)

Режим Plan

Перегляд плану реалізації перед виконанням:

User: /plan Implement user authentication system

Claude: I'll create a plan for implementing authentication.

## Implementation Plan
[Detailed plan with phases and steps]

Ready to proceed? (yes/no/modify)

Режим Accept Edits

Автоматичне прийняття змін у файлах:

User: acceptEdits
User: Fix the bug in auth.ts

Claude: [Makes changes without asking]

Випадки використання

Ревʼю коду:

User: claude --permission-mode plan
User: Review this PR and suggest improvements

Claude: [Reads code, provides feedback, but cannot modify]

Парне програмування:

User: claude --permission-mode default
User: Let's implement the feature together

Claude: [Asks for approval before each change]

Автоматизовані завдання:

User: claude --permission-mode acceptEdits
User: Fix all linting issues in the codebase

Claude: [Auto-accepts file edits without asking]

Headless Mode

Режим друку (claude -p) дозволяє запускати Claude Code без інтерактивного вводу, ідеально для автоматизації та CI/CD. Це неінтерактивний режим, що замінює старий прапорець --headless.

Що таке режим друку?

Режим друку забезпечує:

Автоматизоване виконання скриптів
Інтеграцію з CI/CD
Пакетну обробку
Виконання запланованих завдань

Запуск у режимі друку (неінтерактивний)

# Запуск конкретного завдання
claude -p "Run all tests"

# Обробка переданого вмісту
cat error.log | claude -p "Analyze these errors"

# Інтеграція CI/CD (GitHub Actions)
- name: AI Code Review
  run: claude -p "Review PR"

Додаткові приклади використання режиму друку

# Запуск завдання з захопленням виводу
claude -p "Run all tests and generate coverage report"

# Зі структурованим виводом
claude -p --output-format json "Analyze code quality"

# З вводом через stdin
echo "Analyze code quality" | claude -p "explain this"

Приклад: Інтеграція CI/CD

GitHub Actions:

# .github/workflows/code-review.yml
name: AI Code Review

on: [pull_request]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Install Claude Code
        run: npm install -g @anthropic-ai/claude-code

      - name: Run Claude Code Review
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
        run: |
          claude -p --output-format json \
            --max-turns 3 \
            "Review this PR for:
            - Code quality issues
            - Security vulnerabilities
            - Performance concerns
            - Test coverage
            Output results as JSON" > review.json

      - name: Post Review Comment
        uses: actions/github-script@v7
        with:
          script: |
            const fs = require('fs');
            const review = JSON.parse(fs.readFileSync('review.json', 'utf8'));
            github.rest.issues.createComment({
              issue_number: context.issue.number,
              owner: context.repo.owner,
              repo: context.repo.repo,
              body: JSON.stringify(review, null, 2)
            });

Конфігурація режиму друку

Режим друку (claude -p) підтримує кілька прапорців для автоматизації:

# Обмеження автономних ходів
claude -p --max-turns 5 "refactor this module"

# Структурований вивід JSON
claude -p --output-format json "analyze this codebase"

# З валідацією схеми
claude -p --json-schema '{"type":"object","properties":{"issues":{"type":"array"}}}' \
  "find bugs in this code"

# Вимкнення збереження сесії
claude -p --no-session-persistence "one-off analysis"

Управління сесіями

Ефективне управління кількома сесіями Claude Code.

Команди управління сесіями

Команда	Опис
`/resume`	Відновити розмову за ID або назвою
`/rename`	Назвати поточну сесію
`/fork`	Розгалужити поточну сесію в нову гілку
`claude -c`	Продовжити останню розмову
`claude -r "session"`	Відновити сесію за назвою або ID

Відновлення сесій

Продовжити останню розмову:

claude -c

Відновити іменовану сесію:

claude -r "auth-refactor" "finish this PR"

Перейменувати поточну сесію (всередині REPL):

/rename auth-refactor

Розгалуження сесій

Розгалужте сесію, щоб спробувати альтернативний підхід без втрати оригіналу:

/fork

Або з CLI:

claude --resume auth-refactor --fork-session "try OAuth instead"

Збереження сесій

Сесії автоматично зберігаються і можуть бути відновлені:

# Продовжити останню розмову
claude -c

# Відновити конкретну сесію за назвою або ID
claude -r "auth-refactor"

# Відновити та розгалужити для експериментів
claude --resume auth-refactor --fork-session "alternative approach"

Інтерактивні функції

Клавіатурні скорочення

Claude Code підтримує клавіатурні скорочення для ефективності. Ось повний довідник з офіційної документації:

Скорочення	Опис
`Ctrl+C`	Скасувати поточний ввід/генерацію
`Ctrl+D`	Вийти з Claude Code
`Ctrl+G`	Редагувати план у зовнішньому редакторі
`Ctrl+L`	Перемалювати екран (лише перемальовування — подвійне натискання для `/clear` вилучено у v2.1.238)
`Ctrl+O`	Перемкнути детальний вивід (перегляд міркувань)
`Ctrl+R`	Зворотний пошук в історії
`Ctrl+T`	Перемкнути перегляд списку завдань
`Ctrl+B`	Перевести завдання у фоновий режим
`Esc+Esc`	Відкотити код/розмову
`Shift+Tab` / `Alt+M`	Перемикання режимів дозволів
`Option+P` / `Alt+P`	Перемкнути модель
`Option+T` / `Alt+T`	Перемкнути розширене мислення

Редагування рядка (стандартні скорочення readline):

Скорочення	Дія
`Ctrl + A`	Перейти на початок рядка
`Ctrl + E`	Перейти на кінець рядка
`Ctrl + K`	Вирізати до кінця рядка
`Ctrl + U`	Вирізати до початку рядка
`Ctrl + W`	Видалити слово назад
`Ctrl + Y`	Вставити (yank)
`Tab`	Автодоповнення
`↑ / ↓`	Історія команд

Кастомізація клавіатурних скорочень

Створюйте власні клавіатурні скорочення, запустивши /keybindings, що відкриває ~/.claude/keybindings.json для редагування (v2.1.18+).

Формат конфігурації:

{
  "$schema": "https://www.schemastore.org/claude-code-keybindings.json",
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+e": "chat:externalEditor",
        "ctrl+u": null,
        "ctrl+k ctrl+s": "chat:stash"
      }
    },
    {
      "context": "Confirmation",
      "bindings": {
        "ctrl+a": "confirmation:yes"
      }
    }
  ]
}

Встановіть привʼязку в null, щоб відвʼязати скорочення за замовчуванням.

Доступні контексти

Клавіатурні скорочення привʼязані до конкретних контекстів UI:

Контекст	Ключові дії
Chat	`submit`, `cancel`, `cycleMode`, `modelPicker`, `thinkingToggle`, `undo`, `externalEditor`, `stash`, `imagePaste`
Confirmation	`yes`, `no`, `previous`, `next`, `nextField`, `cycleMode`, `toggleExplanation`
Global	`interrupt`, `exit`, `toggleTodos`, `toggleTranscript`
Autocomplete	`accept`, `dismiss`, `next`, `previous`
HistorySearch	`search`, `previous`, `next`
Settings	Навігація налаштуваннями
Tabs	Перемикання та управління вкладками
Help	Навігація панеллю допомоги

Загалом 18 контекстів, включаючи Transcript, Task, ThemePicker, Attachments, Footer, MessageSelector, DiffDialog, ModelPicker та Select.

Підтримка акордів

Клавіатурні скорочення підтримують послідовності акордів (комбінації з кількох клавіш):

"ctrl+k ctrl+s"   → Двоклавішна послідовність: натисніть ctrl+k, потім ctrl+s
"ctrl+shift+p"    → Одночасне натискання модифікаторів

Синтаксис клавіш:

Модифікатори: ctrl (або control), alt (або opt, option, meta), shift і cmd (або command, super, win) — cmd є окремим модифікатором, а не псевдонімом meta, і розпізнається лише в терміналах, які передають клавішу Super
Великі літери включають Shift: K еквівалентно shift+k
Спеціальні клавіші: escape, enter, return, tab, space, backspace, delete, клавіші стрілок

Зарезервовані та конфліктні клавіші

Клавіша	Статус	Примітки
`Ctrl+C`	Зарезервовано	Неможливо перепривʼязати (переривання)
`Ctrl+D`	Зарезервовано	Неможливо перепривʼязати (вихід)
`Ctrl+B`	Конфлікт терміналу	Префіксна клавіша tmux
`Ctrl+A`	Конфлікт терміналу	Префіксна клавіша GNU Screen
`Ctrl+Z`	Конфлікт терміналу	Призупинення процесу

Порада: Якщо скорочення не працює, перевірте конфлікти з вашим емулятором терміналу або мультиплексором.

Tab-доповнення

Claude Code забезпечує інтелектуальне tab-доповнення:

User: /rew<TAB>
→ /rewind

User: /plu<TAB>
→ /plugin

User: /plugin <TAB>
→ /plugin install
→ /plugin enable
→ /plugin disable

Історія команд

Доступ до попередніх команд:

User: <↑>  # Попередня команда
User: <↓>  # Наступна команда
User: Ctrl+R  # Пошук в історії

(reverse-i-search)`test': run all tests

Багаторядковий ввід

Для складних запитів переходьте на новий рядок через \ + Enter, Option+Enter (macOS), Shift+Enter або Ctrl+J. Термінатора \end немає — натисніть Enter, щоб надіслати:

User: Long complex prompt \
spanning multiple lines

Приклад:

User: Implement a user authentication system \
with the following requirements: \
- JWT tokens \
- Email verification \
- Password reset \
- 2FA support

Claude: [Processes the multi-line request]

Inline-редагування

Редагування команд перед відправкою:

User: Deploy to prodcution<Backspace><Backspace>uction

[Edit in-place before sending]

Режим Vim

Увімкнення Vi/Vim-клавіатурних привʼязок для редагування тексту:

Активація:

Використовуйте команду /vim або /config для увімкнення
Перемикання режимів: Esc для NORMAL, i/a/o для INSERT

Клавіші навігації:

h / l — Рух вліво/вправо
j / k — Рух вниз/вгору
w / b / e — Рух по словах
0 / $ — Перейти на початок/кінець рядка
gg / G — Перейти на початок/кінець тексту

Текстові обʼєкти:

iw / aw — Внутрішнє/зовнішнє слово
i" / a" — Внутрішній/зовнішній рядок у лапках
i( / a( — Внутрішнє/зовнішнє у дужках

Режим Bash

Виконання shell-команд безпосередньо з префіксом !:

! npm test
! git status
! cat src/index.js

Використовуйте це для швидкого виконання команд без перемикання контексту.

Голосовий ввід

Голосовий ввід забезпечує push-to-talk голосове введення для Claude Code, дозволяючи промовляти ваші промпти замість друкування.

Активація голосового вводу

/voice

Можливості

Можливість	Опис
Push-to-talk	Утримуйте клавішу для запису, відпустіть для відправки
20 мов	Розпізнавання мовлення підтримує 20 мов
Власна клавіша	Налаштуйте клавішу push-to-talk через `/keybindings`
Вимога облікового запису	Потрібен обліковий запис Claude.ai для обробки STT

Конфігурація

Налаштуйте клавішу push-to-talk у файлі привʼязок (/keybindings). Голосовий ввід використовує ваш обліковий запис Claude.ai для обробки мовлення в текст.

Канали

Канали — це функція Research Preview, яка надсилає події від зовнішніх сервісів у запущену сесію Claude Code через MCP-сервери. Джерела включають Telegram, Discord, iMessage та довільні вебхуки, дозволяючи Claude реагувати на повідомлення в реальному часі без опитування.

Підписка на канали

# Підписка на плагін каналу при запуску
claude --channels plugin:telegram@claude-plugins-official

# Підписка на кілька джерел (через пробіл)
claude --channels plugin:discord@claude-plugins-official plugin:telegram@claude-plugins-official

Підтримувані інтеграції

Інтеграція	Опис
Discord	Отримання та відповіді на повідомлення Discord у вашій сесії
Telegram	Отримання та відповіді на повідомлення Telegram у вашій сесії
iMessage	Отримання сповіщень iMessage у вашій сесії
Webhooks	Отримання подій від довільних джерел вебхуків

Конфігурація

Налаштуйте канали прапорцем --channels при запуску. Для корпоративних розгортань використовуйте керовану настройку для контролю дозволених плагінів каналів:

{
  "channelsEnabled": true,
  "allowedChannelPlugins": [
    { "marketplace": "claude-plugins-official", "plugin": "discord" },
    { "marketplace": "claude-plugins-official", "plugin": "telegram" }
  ]
}

Керована настройка allowedChannelPlugins контролює, які плагіни каналів дозволені в організації. Вона замінює підтримуваний Anthropic список дозволених і потребує channelsEnabled: true.

Як це працює

MCP-сервери діють як плагіни каналів, що підключаються до зовнішніх сервісів
Вхідні повідомлення та події надсилаються в активну сесію Claude Code
Claude може читати та відповідати на повідомлення в контексті сесії
Плагіни каналів мають бути в списку дозволених, який підтримує Anthropic, або в списку allowedChannelPlugins вашої організації, якщо адміністратор його задав
Опитування не потрібне — події надсилаються в реальному часі

Інтеграція Chrome

Інтеграція Chrome підключає Claude Code до вашого браузера Chrome або Microsoft Edge для автоматизації та відлагодження веб-сторінок у реальному часі. Це бета-функція, доступна з v2.0.73+ (потрібне розширення Claude in Chrome v1.0.36+).

Увімкнення інтеграції Chrome

При запуску:

claude --chrome      # Увімкнути зʼєднання з Chrome
claude --no-chrome   # Вимкнути зʼєднання з Chrome

Всередині сесії:

/chrome

Оберіть "Enabled by default" для активації інтеграції Chrome для всіх майбутніх сесій. Claude Code використовує стан входу вашого браузера, тому може взаємодіяти з автентифікованими веб-додатками.

Можливості

Можливість	Опис
Відлагодження в реальному часі	Читання логів консолі, інспектування DOM-елементів, відлагодження JavaScript в реальному часі
Перевірка дизайну	Порівняння відрендерених сторінок з макетами дизайну
Валідація форм	Тестування відправки форм, валідації вводу та обробки помилок
Тестування веб-додатків	Взаємодія з автентифікованими додатками (Gmail, Google Docs, Notion тощо)
Витягування даних	Збір та обробка контенту з веб-сторінок
Запис сесії	Запис взаємодій з браузером у GIF-файли

Дозволи на рівні сайтів

Розширення Chrome управляє доступом до окремих сайтів. Надавайте або відкликайте доступ для конкретних сайтів у будь-який час через спливаюче вікно розширення. Claude Code взаємодіє лише з сайтами, які ви явно дозволили.

Як це працює

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

Відомі обмеження

Підтримка браузерів: Chrome та Edge; Claude Code також підключається в інших браузерах на базі Chromium, як-от Brave, Arc, Vivaldi та Opera
WSL: Недоступно у Windows Subsystem for Linux
Сторонні провайдери: Не підтримується з провайдерами API Bedrock, Vertex або Foundry
Idle service worker: Service worker розширення Chrome може переходити у неактивний стан під час тривалих сесій

Порада: Інтеграція Chrome є бета-функцією. Підтримка браузерів може розширитись у майбутніх релізах.

Remote Control

Remote Control дозволяє продовжити локально запущену сесію Claude Code з телефону, планшета або будь-якого браузера. Ваша локальна сесія продовжує працювати на вашому компʼютері — нічого не переміщується у хмару. Доступно на планах Pro, Max, Team та Enterprise (v2.1.51+).

Запуск Remote Control

З CLI:

# Запуск із назвою сесії за замовчуванням
claude remote-control

# Запуск із власною назвою
claude remote-control --name "Auth Refactor"

Зсередини сесії:

/remote-control
/remote-control "Auth Refactor"

Доступні прапорці:

Прапорець	Опис
`--name "title"`	Власна назва сесії для зручної ідентифікації
`--verbose`	Показувати детальні логи зʼєднання

Примітка (v2.1.300): claude remote-control більше не приймає --sandbox чи --no-sandbox (вони ніколи не мали ефекту; передача будь-якого з них тепер завершується помилкою). Щоб запускати сесії Remote Control у пісочниці, встановіть sandbox.enabled у файлі налаштувань.

Підключення до сесії

Три способи підключення з іншого пристрою:

URL сесії — Виводиться в термінал при запуску сесії; відкрийте у будь-якому браузері
QR-код — Натисніть пробіл після запуску для відображення QR-коду для сканування
Пошук за назвою — Перегляньте ваші сесії на claude.ai/code або у мобільному додатку Claude (iOS/Android)

Безпека

Жодних вхідних портів не відкривається на вашому компʼютері
Тільки вихідний HTTPS через TLS
Обмежені облікові дані — кілька короткоживучих токенів з вузькою областю дії
Ізоляція сесій — кожна віддалена сесія незалежна

Remote Control проти Claude Code у вебі

Аспект	Remote Control	Claude Code у вебі
Виконання	Працює на вашому компʼютері	Працює у хмарі Anthropic
Локальні інструменти	Повний доступ до локальних MCP-серверів, файлів та CLI	Без локальних залежностей
Випадок використання	Продовження локальної роботи з іншого пристрою	Початок роботи з нуля в будь-якому браузері

Обмеження

Одна віддалена сесія на інтерактивний процес Claude Code — серверний режим (claude remote-control) обслуговує кілька одночасно (--capacity, за замовчуванням 32)
Термінал має залишатись відкритим на хост-машині
Якщо мережа недоступна, серверний режим завершується приблизно через 10 хвилин; інтерактивна сесія продовжує повторні спроби й перепідключається, коли мережа повертається

Випадки використання

Управління Claude Code з мобільного пристрою або планшета, перебуваючи далеко від робочого місця
Використання багатшого UI claude.ai зі збереженням локального виконання інструментів
Швидке ревʼю коду на ходу з повним локальним середовищем розробки

Веб-сесії

Веб-сесії дозволяють запускати Claude Code безпосередньо у браузері на claude.ai/code або створювати веб-сесії з CLI.

Створення веб-сесії

# Створення нової веб-сесії з CLI
claude --remote "implement the new API endpoints"

Це запускає сесію Claude Code на claude.ai, до якої можна отримати доступ з будь-якого браузера.

Відновлення веб-сесій локально

Якщо ви почали сесію у вебі і хочете продовжити локально:

# Відновити веб-сесію в локальному терміналі
claude --teleport

Або зсередини інтерактивного REPL:

/teleport

Випадки використання

Почати роботу на одному компʼютері і продовжити на іншому
Поділитися URL сесії з членами команди
Використовувати веб-UI для візуального перегляду diff, потім перемкнутися на термінал для виконання

Десктопний додаток

Десктопний додаток Claude Code надає автономний додаток з візуальним переглядом diff, паралельними сесіями та інтегрованими конекторами. Доступний для macOS та Windows (плани Pro, Max, Team та Enterprise).

Встановлення

Завантажте з claude.ai для вашої платформи:

macOS: Універсальна збірка (Apple Silicon та Intel)
Windows: Інсталятори для x64 та ARM64

Дивіться Desktop Quickstart для інструкцій з налаштування.

Передача з CLI

Передайте поточну CLI-сесію в десктопний додаток:

/desktop

Основні функції

Функція	Опис
Перегляд diff	Візуальний перегляд файл за файлом з inline-коментарями; Claude читає коментарі та вносить виправлення
Попередній перегляд додатку	Автозапуск dev-серверів з вбудованим браузером для живої перевірки
Моніторинг PR	Інтеграція GitHub CLI з автовиправленням помилок CI та автозлиттям при проходженні перевірок
Паралельні сесії	Кілька сесій у бічній панелі з автоматичною ізоляцією Git worktree
Заплановані завдання	Повторювані завдання (щогодини, щодня, у робочі дні, щотижня), що працюють при відкритому додатку
Багатий рендеринг	Рендеринг коду, markdown та діаграм з підсвіткою синтаксису

Конфігурація попереднього перегляду додатку

Налаштуйте поведінку dev-сервера в .claude/launch.json:

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "my-app",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "dev"],
      "port": 3000
    }
  ]
}

Конектори

Підключення зовнішніх сервісів для багатшого контексту:

Конектор	Можливість
GitHub	Моніторинг PR, трекінг issues, ревʼю коду
Slack	Сповіщення, контекст каналів
Linear	Трекінг issues, управління спринтами
Notion	Документація, доступ до бази знань
Asana	Управління завданнями, трекінг проєктів
Calendar	Обізнаність про розклад, контекст зустрічей

Примітка: Конектори недоступні для віддалених (хмарних) сесій.

Віддалені та SSH-сесії

Віддалені сесії: Працюють на хмарній інфраструктурі Anthropic; продовжуються навіть після закриття додатку. Доступні з claude.ai/code або мобільного додатку Claude
SSH-сесії: Підключення до віддалених машин через SSH з повним доступом до віддаленої файлової системи та інструментів. Claude Code повинен бути встановлений на віддаленій машині

Режими дозволів у десктопному додатку

Десктопний додаток підтримує ті самі режими дозволів, що й CLI:

Режим	Поведінка
Manual (за замовчуванням)	Перегляд та затвердження кожного редагування та команди
Accept edits	Редагування файлів автозатверджуються; команди потребують ручного затвердження
Plan	Перегляд підходу перед будь-якими змінами
Auto	Робота без рутинних запитів; фоновий класифікатор спершу перевіряє дії
Bypass permissions	Автоматичне виконання (лише у пісочниці, контролюється адміністратором)

Корпоративні функції

Консоль адміністратора: Контроль доступу до вкладки Code та налаштувань дозволів для організації
Розгортання через MDM: Розгортання через MDM на macOS або MSIX на Windows
Інтеграція SSO: Вимога єдиного входу для членів організації
Керовані налаштування: Централізоване управління конфігурацією команди та доступністю моделей

Список завдань

Функція списку завдань забезпечує постійне відстеження завдань, яке переживає стиснення контексту (коли історія розмови обрізається для вміщення в контекстне вікно).

Перемикання списку завдань

Натисніть Ctrl+T для перемикання перегляду списку завдань під час сесії.

Постійні завдання

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

Іменовані директорії завдань

Використовуйте змінну оточення CLAUDE_CODE_TASK_LIST_ID для створення іменованих директорій завдань, спільних між сесіями:

export CLAUDE_CODE_TASK_LIST_ID=my-project-sprint-3

Це дозволяє кільком сесіям використовувати один список завдань, що корисно для командних робочих процесів або проєктів з кількома сесіями.

Підказки промптів

Підказки промптів відображають напівпрозорі приклади команд на основі вашої git-історії та поточного контексту розмови.

Як це працює

Підказки зʼявляються як напівпрозорий текст під вашим вводом
Натисніть Tab для прийняття підказки
Натисніть Enter для прийняття та негайної відправки
Підказки враховують контекст, використовуючи git-історію та стан розмови

Вимкнення підказок промптів

export CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=false

Git Worktrees

Git Worktrees дозволяють запускати Claude Code в ізольованому робочому дереві, забезпечуючи паралельну роботу на різних гілках без stash або перемикання.

Запуск у Worktree

# Запуск Claude Code в ізольованому робочому дереві
claude --worktree
# або
claude -w

Розташування Worktree

Робочі дерева створюються за адресою:

<repo>/.claude/worktrees/<n>

Sparse Checkout для монорепозиторіїв

Використовуйте налаштування worktree.sparsePaths для виконання sparse-checkout у монорепозиторіях, зменшуючи використання диску та час клонування:

{
  "worktree": {
    "sparsePaths": ["packages/my-package", "shared/"]
  }
}

Інструменти та хуки Worktree

Елемент	Опис
`ExitWorktree`	Інструмент для виходу та очищення поточного робочого дерева
`WorktreeCreate`	Подія хуку при створенні робочого дерева
`WorktreeRemove`	Подія хуку при видаленні робочого дерева

Автоочищення

Якщо в робочому дереві не було зроблено змін, воно автоматично очищується при завершенні сесії.

Випадки використання

Робота над feature-гілкою зі збереженням незміненої основної гілки
Запуск тестів в ізоляції без впливу на робочу директорію
Спроба експериментальних змін у одноразовому середовищі
Sparse-checkout конкретних пакетів у монорепозиторіях для швидшого запуску

Пісочниця

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

Увімкнення пісочниці

Слеш-команда (зберігає ваш вибір у .claude/settings.local.json для цього проєкту):

/sandbox

Файл налаштувань (усі проєкти): встановіть "sandbox": { "enabled": true } у ~/.claude/settings.json.

Для однієї сесії, без запису у файл налаштувань:

claude --settings '{"sandbox": {"enabled": true}}'

Прапорців claude --sandbox / --no-sandbox не існує. Починаючи з v2.1.300, передача їх у claude remote-control завершується помилкою.

Налаштування конфігурації

Налаштування	Опис
`sandbox.enabled`	Увімкнути або вимкнути пісочницю
`sandbox.failIfUnavailable`	Зупинитись, якщо пісочницю неможливо активувати
`sandbox.filesystem.allowWrite`	Шляхи з дозволом на запис
`sandbox.filesystem.allowRead`	Шляхи з дозволом на читання
`sandbox.filesystem.denyRead`	Шляхи з забороною читання
`sandbox.enableWeakerNetworkIsolation`	Увімкнути слабшу ізоляцію мережі на macOS

Приклад конфігурації

{
  "sandbox": {
    "enabled": true,
    "failIfUnavailable": true,
    "filesystem": {
      "allowWrite": ["/Users/me/project"],
      "allowRead": ["/Users/me/project", "/usr/local/lib"],
      "denyRead": ["/Users/me/.ssh", "/Users/me/.aws"]
    }
  }
}

Як це працює

Bash-команди виконуються у пісочниці з обмеженим доступом до файлової системи
Мережевий доступ може бути ізольований для запобігання небажаним зовнішнім зʼєднанням
Працює разом з правилами дозволів для глибокого захисту
На macOS Seatbelt блокує всі мережеві зʼєднання, крім зʼєднання з проксі пісочниці; sandbox.enableWeakerNetworkIsolation послаблює цю ізоляцію і потрібен лише для інструментів на кшталт Go CLI за MITM-проксі httpProxyPort

Випадки використання

Безпечний запуск ненадійного або згенерованого коду
Запобігання випадковим змінам файлів за межами проєкту
Обмеження мережевого доступу під час автоматизованих завдань

Керовані налаштування (Enterprise)

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

Методи розгортання

Платформа	Метод	Починаючи з
macOS	Керовані plist-файли (MDM)	v2.1.51+
Windows	Реєстр Windows	v2.1.51+
Кросплатформний	Керовані файли конфігурації	v2.1.51+
Кросплатформний	Керовані drop-ins (директорія `managed-settings.d/`)	v2.1.83+

Керовані Drop-ins

Починаючи з v2.1.83, адміністратори можуть розгортати кілька файлів керованих налаштувань у директорію managed-settings.d/. Файли обʼєднуються в алфавітному порядку, дозволяючи модульну конфігурацію між командами. Директорія розташована поруч із managed-settings.json у системній директорії (/Library/Application Support/ClaudeCode/ на macOS, /etc/claude-code/ на Linux, C:\Program Files\ClaudeCode\ на Windows):

/etc/claude-code/managed-settings.d/
  00-org-defaults.json
  10-team-policies.json
  20-project-overrides.json

Доступні керовані налаштування

Налаштування	Опис
`permissions.disableBypassPermissionsMode`	Встановіть `"disable"`, щоб заборонити користувачам вмикати обхід дозволів
`availableModels`	Обмежити моделі, доступні для вибору
`allowedChannelPlugins`	Контролювати дозволені плагіни каналів
`autoMode.environment`	Налаштувати довірену інфраструктуру для auto mode
Власні політики	Організаційні політики дозволів та інструментів

Приклад: macOS Plist

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN"
  "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>permissions</key>
  <dict>
    <key>disableBypassPermissionsMode</key>
    <string>disable</string>
  </dict>
  <key>availableModels</key>
  <array>
    <string>claude-sonnet-4-6</string>
    <string>claude-haiku-4-5</string>
  </array>
</dict>
</plist>

Конфігурація та налаштування

Розташування файлів конфігурації

Налаштування користувача: ~/.claude/settings.json
Налаштування проєкту: .claude/settings.json (у репозиторії)
Локальні налаштування проєкту: .claude/settings.local.json (не в репозиторії)
Керовані налаштування: managed-settings.json у системній директорії (див. розділ про керовані налаштування вище)

Повний приклад конфігурації

Конфігурація основних розширених функцій (.claude/settings.json):

{
  "permissions": {
    "defaultMode": "manual"
  },
  "hooks": {
    "PreToolUse": [
      { "matcher": "Edit", "hooks": [{ "type": "command", "command": "~/.claude/hooks/eslint-fix.sh" }] }
    ],
    "PostToolUse": [
      { "matcher": "Write", "hooks": [{ "type": "command", "command": "~/.claude/hooks/security-scan.sh" }] }
    ]
  }
}

Скрипти хуків отримують вхідні дані інструмента як JSON через stdin (наприклад, tool_input.file_path); підстановки ${file_path} немає. MCP-сервери не є ключем налаштувань — визначайте їх у .mcp.json у корені проєкту:

{
  "mcpServers": {
    "github": {
      "type": "http",
      "url": "https://api.githubcopilot.com/mcp/",
      "headers": { "Authorization": "Bearer ${GITHUB_PERSONAL_ACCESS_TOKEN}" }
    }
  }
}

Розширений приклад конфігурації:

{
  "permissions": {
    "defaultMode": "manual",
    "allow": ["Bash(git log:*)", "Read"],
    "deny": ["Bash(rm -rf:*)"]
  },

  "hooks": {
    "PreToolUse": [{ "matcher": "Edit", "hooks": [{ "type": "command", "command": "~/.claude/hooks/eslint-fix.sh" }] }],
    "PostToolUse": [{ "matcher": "Write", "hooks": [{ "type": "command", "command": "~/.claude/hooks/security-scan.sh" }] }],
    "Stop": [{ "hooks": [{ "type": "command", "command": "~/.claude/hooks/notify.sh" }] }]
  }
}

GitHub MCP-сервер для цього налаштування розміщується в .mcp.json, як показано вище.

Змінні оточення

Перевизначення конфігурації через змінні оточення:

# Вибір моделі
export ANTHROPIC_MODEL=claude-opus-4-6
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-6
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-6
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

# Конфігурація API
export ANTHROPIC_API_KEY=sk-ant-...

# Конфігурація мислення
export MAX_THINKING_TOKENS=16000
export CLAUDE_CODE_EFFORT_LEVEL=high

# Перемикачі функцій
export CLAUDE_CODE_DISABLE_AUTO_MEMORY=1    # Вимкнути auto memory (файли auto memory не створюються і не завантажуються)
export CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=true
export CLAUDE_CODE_DISABLE_CRON=1
export CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS=true
export CLAUDE_CODE_DISABLE_TERMINAL_TITLE=true
export CLAUDE_CODE_DISABLE_1M_CONTEXT=true
export CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK=true
export CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=false
export CLAUDE_CODE_ENABLE_TASKS=0          # Інструменти Task використовуються за замовчуванням; 0 повертає застарілий інструмент TodoWrite
export CLAUDE_CODE_SIMPLE=true              # Встановлюється прапорцем --bare

# Конфігурація MCP
export MAX_MCP_OUTPUT_TOKENS=50000
export ENABLE_TOOL_SEARCH=true

# Управління завданнями
export CLAUDE_CODE_TASK_LIST_ID=my-project-tasks

# Agent teams (експериментально)
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

# Конфігурація субагентів та плагінів
export CLAUDE_CODE_SUBAGENT_MODEL=sonnet
export CLAUDE_CODE_PLUGIN_SEED_DIR=./my-plugins
export CLAUDE_CODE_NEW_INIT=1

# Підпроцеси та стрімінг
export CLAUDE_CODE_SUBPROCESS_ENV_SCRUB="SECRET_KEY,DB_PASSWORD"
export CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=80
export CLAUDE_STREAM_IDLE_TIMEOUT_MS=30000
export ANTHROPIC_CUSTOM_MODEL_OPTION=my-custom-model
export SLASH_COMMAND_TOOL_CHAR_BUDGET=50000

Команди управління конфігурацією

User: /config
[Opens interactive configuration menu]

Команда /config надає інтерактивне меню для перемикання налаштувань, таких як:

Розширене мислення увімк./вимк.
Детальний вивід
Режим дозволів
Вибір моделі

Конфігурація на рівні проєкту

Створіть .claude/settings.json у вашому проєкті:

{
  "hooks": {
    "PreToolUse": [{ "matcher": "Bash", "hooks": [{ "type": "command", "command": "npm test && npm run lint" }] }]
  },
  "permissions": {
    "defaultMode": "manual"
  }
}

MCP-сервери проєкту розмістіть у .mcp.json у корені проєкту:

{
  "mcpServers": {
    "project-db": {
      "command": "mcp-postgres",
      "env": {
        "DATABASE_URL": "${PROJECT_DB_URL}"
      }
    }
  }
}

Agent Teams

Agent Teams — це експериментальна функція, яка дозволяє кільком екземплярам Claude Code співпрацювати над завданням. Вимкнена за замовчуванням.

Увімкнення Agent Teams

Увімкнення через змінну оточення або налаштування:

# Змінна оточення
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

Або додайте до вашого JSON-файлу налаштувань:

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

Як працюють Agent Teams

Лідер команди координує загальне завдання та делегує підзавдання товаришам по команді
Товариші по команді працюють незалежно, кожен зі своїм контекстним вікном
Спільний список завдань забезпечує самокоординацію між членами команди
Використовуйте визначення субагентів (.claude/agents/ або прапорець --agents) для визначення ролей та спеціалізацій товаришів

Режими відображення

Agent Teams підтримують два режими відображення, що налаштовуються прапорцем --teammate-mode:

Режим	Опис
`in-process` (за замовчуванням)	Товариші працюють у тому ж процесі терміналу
`tmux`	Кожен товариш отримує окрему розділену панель (потрібен tmux або iTerm2)
`auto`	Автоматичний вибір найкращого режиму відображення

# Використання tmux для відображення товаришів
claude --teammate-mode tmux

# Явне використання in-process режиму
claude --teammate-mode in-process

Випадки використання

Великі завдання рефакторингу, де різні товариші обробляють різні модулі
Паралельне ревʼю коду та реалізація
Координовані зміни кількох файлів по всій кодовій базі

Примітка: Agent Teams є експериментальною функцією і може змінитися у майбутніх релізах. Дивіться code.claude.com/docs/en/agent-teams для повного довідника.

Найкращі практики

Режим планування

✅ Використовуйте для складних багатоетапних завдань
✅ Переглядайте плани перед затвердженням
✅ Модифікуйте плани за потреби
❌ Не використовуйте для простих завдань

Розширене мислення

✅ Використовуйте для архітектурних рішень
✅ Використовуйте для вирішення складних проблем
✅ Переглядайте процес мислення
❌ Не використовуйте для простих запитів

Фонові завдання

✅ Використовуйте для тривалих операцій
✅ Моніторте прогрес завдань
✅ Коректно обробляйте помилки завдань
❌ Не запускайте занадто багато паралельних завдань

Дозволи

✅ Використовуйте plan для ревʼю коду (тільки читання)
✅ Використовуйте default для інтерактивної розробки
✅ Використовуйте acceptEdits для автоматизованих робочих процесів
✅ Використовуйте auto для автономної роботи із запобіжниками безпеки
❌ Не використовуйте bypassPermissions без крайньої необхідності

Сесії

✅ Використовуйте окремі сесії для різних завдань
✅ Зберігайте важливі стани сесій
✅ Очищайте старі сесії
❌ Не змішуйте неповʼязану роботу в одній сесії

Додаткові ресурси

Для отримання додаткової інформації про Claude Code та повʼязані функції:

Офіційна документація інтерактивного режиму
Офіційна документація Headless Mode
Довідник CLI
Посібник з контрольних точок — Управління сесіями та відкат
Слеш-команди — Довідник команд
Посібник з памʼяті — Постійний контекст
Посібник з навичок — Автономні можливості
Посібник з субагентів — Делеговане виконання завдань
Посібник з MCP — Доступ до зовнішніх даних
Посібник з хуків — Автоматизація на основі подій
Посібник з плагінів — Пакетні розширення
Офіційна документація запланованих завдань
Офіційна документація інтеграції Chrome
Офіційна документація Remote Control
Офіційна документація клавіатурних скорочень
Офіційна документація десктопного додатку
Офіційна документація Agent Teams

Останнє оновлення: 18 жовтня 2026 Версія Claude Code: 2.1.302 Джерела:

FilesExpand file tree

09-advanced-features

Directory actions

More options

Directory actions

More options

Latest commit

History

09-advanced-features

Folders and files

parent directory

README.md

Розширені функції

Зміст

Огляд

Режим планування

Що таке режим планування?

Коли використовувати режим планування

Активація режиму планування

Переваги режиму планування

Приклад: Реалізація функції

Модифікація планів

Конфігурація режиму планування

Розширене мислення

Що таке розширене мислення?

Активація розширеного мислення

Переваги розширеного мислення

Приклад: Архітектурне рішення

Конфігурація розширеного мислення

Auto Mode

Вимоги

Увімкнення Auto Mode

Як працює класифікатор

Заблоковані дії за замовчуванням

Дозволені дії за замовчуванням

Конфігурація Auto Mode

Запасна поведінка

Посів дозволів Auto-Mode

Фонові завдання

Що таке фонові завдання?

Запуск фонових завдань

Управління фоновими завданнями

Приклад: Паралельна розробка

Конфігурація

Заплановані завдання

Команда /loop

Одноразові нагадування

Управління запланованими завданнями

Деталі поведінки

Хмарні заплановані завдання

Вимкнення запланованих завдань

Приклад: Моніторинг деплою

Режими дозволів

Доступні режими дозволів

Методи активації

Приклади режимів дозволів

Режим Default

Режим Plan

Режим Accept Edits

Випадки використання

Headless Mode

Що таке режим друку?

Запуск у режимі друку (неінтерактивний)

Додаткові приклади використання режиму друку

Приклад: Інтеграція CI/CD

Конфігурація режиму друку

Управління сесіями

Команди управління сесіями

Відновлення сесій

Розгалуження сесій

Збереження сесій

Інтерактивні функції

Клавіатурні скорочення

Кастомізація клавіатурних скорочень

Доступні контексти

Підтримка акордів

Зарезервовані та конфліктні клавіші

Tab-доповнення

Історія команд

Багаторядковий ввід

Команда `/loop`