mirror of https://github.com/luongnv89/claude-howto.git synced 2026-04-30 21:57:48 +02:00

Files

T

History

Evgenij I 1a567be793 i18n(uk): add missing files, translate P4 root docs

- Copy code/image/config files across all modules
- Translate brand-voice and code-review templates
- Translate CONTRIBUTING, CODE_OF_CONDUCT, SECURITY, STYLE_GUIDE
- Copy CHANGELOG as-is (technical log)

Ref: luongnv89/claude-howto#63

2026-04-09 23:59:59 +03:00

config-examples.json

i18n(uk): add missing files, translate P4 root docs

2026-04-09 23:59:59 +03:00

planning-mode-examples.md

feat(uk): translate P3 examples for skills/refactor, subagents, checkpoints, advanced

2026-04-09 22:57:13 +03:00

README.md

fix(uk): complete translations for modules 06, 07, 09, 10

2026-04-09 19:55:57 +03:00

setup-auto-mode-permissions.py

i18n(uk): add missing files, translate P4 root docs

2026-04-09 23:59:59 +03:00

README.md

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

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

Зміст

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

Огляд

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

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

Режим планування: Створення детальних планів реалізації перед кодуванням
Розширене мислення: Глибоке міркування для складних проблем
Auto Mode: Фоновий класифікатор безпеки перевіряє кожну дію перед виконанням (Research Preview)
Фонові завдання: Виконання тривалих операцій без блокування розмови
Режими дозволів: Контроль дій 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/Linux)

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

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

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

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, щоб відкрити поточний план у зовнішньому редакторі для детальних змін.

Ultraplan

Використовуйте /ultraplan <prompt> для наскрізного робочого процесу планування: Claude складає детальний план, відкриває його у браузері для перегляду, потім виконує план віддалено або повертає його у ваш термінал для локального виконання.

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

Розширене мислення дозволяє 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: /think 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 — це режим дозволів Research Preview (березень 2026), який використовує фоновий класифікатор безпеки для перевірки кожної дії перед виконанням. Він дозволяє Claude працювати автономно, блокуючи небезпечні операції.

Вимоги

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

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

# Розблокування auto mode за допомогою прапорця CLI
claude --enable-auto-mode

# Потім перемикайте через 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 без Team-плану

Якщо у вас немає Team-плану або ви хочете простіший підхід без фонового класифікатора, ви можете наповнити ваш ~/.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()`, `Glob()`, `Grep()`, `Agent()`, `WebSearch()`, `WebFetch()`
Локальне інспектування	`Bash(git status:)`, `Bash(git log:)`, `Bash(git diff:)`, `Bash(cat:)`
Опціональне редагування	`Edit()`, `Write()`, `NotebookEdit(*)`
Опціональні тести/збірка	`Bash(pytest:)`, `Bash(python3 -m pytest:)`, `Bash(cargo test:*)`
Опціональний запис у git	`Bash(git add:)`, `Bash(git commit:)`, `Bash(git stash:*)`
Git (локальний запис)	`Bash(git add:)`, `Bash(git commit:)`, `Bash(git checkout:*)`
Менеджери пакетів	`Bash(npm install:)`, `Bash(pip install:)`, `Bash(cargo build:*)`
Збірка та тести	`Bash(make:)`, `Bash(pytest:)`, `Bash(go test:*)`
Звичайні shell-команди	`Bash(ls:)`, `Bash(cat:)`, `Bash(find:)`, `Bash(cp:)`, `Bash(mv:*)`
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

/task list           # Показати всі завдання
/task status bg-1234 # Перевірити прогрес
/task show bg-1234   # Переглянути вивід
/task cancel bg-1234 # Скасувати завдання

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

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: /task show bg-1234

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

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

User: /task list

Active background tasks:
1. [bg-1234] Running tests (50% complete, 2min remaining)
2. [bg-1235] Building Docker image (25% complete, 8min remaining)
3. [bg-1236] Deploying to staging (90% complete, 30sec remaining)

Перевірка статусу завдання:

User: /task status bg-1234

Task bg-1234: Running tests
Status: In progress
Progress: 120/245 tests (49%)
Started: 2025-11-08 10:30:15
Estimated completion: 2025-11-08 10:34:22

Перегляд виводу завдання:

User: /task show bg-1234

[Shows live output from the test run]

Скасування завдання:

User: /task cancel bg-1234

Cancelled background task bg-1234

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

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]

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

{
  "backgroundTasks": {
    "enabled": true,
    "maxConcurrentTasks": 5,
    "notifyOnCompletion": true,
    "autoCleanup": true,
    "logOutput": true
  }
}

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

Заплановані завдання дозволяють автоматично запускати промпти за розкладом або як одноразові нагадування. Завдання привʼязані до сесії — вони працюють, поки 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`	Усі дії з перевірками фонового класифікатора безпеки (Research Preview)
`bypassPermissions`	Усі дії, без перевірки дозволів (небезпечно)
`dontAsk`	Виконуються лише попередньо затверджені інструменти; всі інші відхиляються

Перемикайте режими через Shift+Tab у CLI. Встановіть режим за замовчуванням через прапорець --permission-mode або налаштування permissions.defaultMode.

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

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

Shift + Tab  # Перемикання між усіма 6 режимами

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

/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`	Очистити екран терміналу
`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, alt (або opt), shift, meta (або cmd)
Великі літери включають 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

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

Для складних запитів використовуйте багаторядковий режим:

User: \
> Long complex prompt
> spanning multiple lines
> \end

Приклад:

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

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 discord,telegram

# Підписка на кілька джерел
claude --channels discord,telegram,imessage,webhooks

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

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

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

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

{
  "allowedChannelPlugins": ["discord", "telegram"]
}

Керована настройка allowedChannelPlugins контролює, які плагіни каналів дозволені в організації.

Як це працює

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

Інтеграція Chrome

Інтеграція Chrome підключає Claude Code до вашого браузера Chrome або Microsoft Edge для автоматизації та відлагодження веб-сторінок у реальному часі. Це бета-функція, доступна з v2.0.73+ (підтримка Edge додана в 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 — Brave, Arc та інші браузери на базі Chromium не підтримуються
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`	Показувати детальні логи зʼєднання
`--sandbox`	Увімкнути ізоляцію файлової системи та мережі
`--no-sandbox`	Вимкнути пісочницю (за замовчуванням)

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

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

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

Безпека

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

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

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

Обмеження

Одна віддалена сесія на екземпляр Claude Code
Термінал має залишатись відкритим на хост-машині
Сесія закінчується через ~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:

{
  "command": "npm run dev",
  "port": 3000,
  "readyPattern": "ready on",
  "persistCookies": true
}

Конектори

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

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

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

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

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

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

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

Режим	Поведінка
Ask permissions (за замовчуванням)	Перегляд та затвердження кожного редагування та команди
Auto accept edits	Редагування файлів автозатверджуються; команди потребують ручного затвердження
Plan mode	Перегляд підходу перед будь-якими змінами
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. Це доповнює правила дозволів і забезпечує додатковий рівень безпеки.

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

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

/sandbox

Прапорці CLI:

claude --sandbox       # Увімкнути пісочницю
claude --no-sandbox    # Вимкнути пісочницю

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

Налаштування	Опис
`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"]
    },
    "enableWeakerNetworkIsolation": true
  }
}

Як це працює

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

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

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

Керовані налаштування (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/. Файли обʼєднуються в алфавітному порядку, дозволяючи модульну конфігурацію між командами:

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

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

Налаштування	Опис
`disableBypassPermissionsMode`	Заборонити користувачам вмикати обхід дозволів
`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>disableBypassPermissionsMode</key>
  <true/>
  <key>availableModels</key>
  <array>
    <string>claude-sonnet-4-6</string>
    <string>claude-haiku-4-5</string>
  </array>
</dict>
</plist>

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

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

Глобальна конфігурація: ~/.claude/config.json
Конфігурація проєкту: ./.claude/config.json
Конфігурація користувача: ~/.config/claude-code/settings.json

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

Конфігурація основних розширених функцій:

{
  "permissions": {
    "mode": "default"
  },
  "hooks": {
    "PreToolUse:Edit": "eslint --fix ${file_path}",
    "PostToolUse:Write": "~/.claude/hooks/security-scan.sh"
  },
  "mcp": {
    "enabled": true,
    "servers": {
      "github": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-github"]
      }
    }
  }
}

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

{
  "permissions": {
    "mode": "default",
    "allowedTools": ["Bash(git log:*)", "Read"],
    "disallowedTools": ["Bash(rm -rf:*)"]
  },

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

  "mcp": {
    "enabled": true,
    "servers": {
      "github": {
        "command": "npx",
        "args": ["-y", "@modelcontextprotocol/server-github"],
        "env": {
          "GITHUB_TOKEN": "${GITHUB_TOKEN}"
        }
      }
    }
  }
}

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

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

# Вибір моделі
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=true
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=true
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/config.json у вашому проєкті:

{
  "hooks": {
    "PreToolUse": [{ "matcher": "Bash", "hooks": ["npm test && npm run lint"] }]
  },
  "permissions": {
    "mode": "default"
  },
  "mcp": {
    "servers": {
      "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-файлу налаштувань:

{
  "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

Останнє оновлення: 9 квітня 2026 Версія Claude Code: 2.1.97 Сумісні моделі: Claude Sonnet 4.6, Claude Opus 4.6, Claude Haiku 4.5

README.md Unescape Escape

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

Зміст

Огляд

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

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

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

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

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

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

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

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

Ultraplan

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

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

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

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

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

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

Auto Mode

Вимоги

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

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

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

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

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

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

Посів дозволів Auto-Mode без Team-плану

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

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

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

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

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

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

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

Команда /loop

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

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

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

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

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

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

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

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

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

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

Режим Default

Режим Plan

Режим Accept Edits

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

Headless Mode

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Режим Vim

Режим Bash

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

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

Можливості

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

Канали

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

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

README.md

Команда `/loop`