Расширенные возможности

Исчерпывающее руководство по расширенным возможностям Claude Code: режим планирования, extended thinking, auto mode, фоновые задачи, режимы разрешений, print mode (неинтерактивный запуск), управление сессиями, интерактивные функции, каналы, голосовой ввод, удалённое управление, web-сессии, desktop-приложение, список задач, подсказки промптов, git worktrees, sandboxing, управляемые настройки и конфигурация.

Содержание

1. Обзор
2. Режим планирования
3. Ultraplan (составление планов в облаке)
4. Extended Thinking
5. Auto Mode
6. Фоновые задачи
7. Инструмент Monitor (событийные потоки)
8. Динамические workflow
9. Запланированные задачи
10. Режимы разрешений
11. Headless Mode
12. Управление сессиями
13. Интерактивные функции
14. Стили вывода
15. Строка состояния
16. TUI-режим (полноэкранный)
17. Голосовой ввод
18. Каналы
19. Интеграция с Chrome
20. Удалённое управление
21. Web-сессии
22. Desktop-приложение
23. Список задач
24. Подсказки промптов
25. Git Worktrees
26. Sandboxing
27. Управляемые настройки (Enterprise)
28. Конфигурация и настройки
29. Команды агентов
30. Лучшие практики
31. Дополнительные ресурсы

Обзор

Расширенные возможности Claude Code дополняют базовый функционал механизмами планирования, рассуждений, автоматизации и контроля. Эти возможности позволяют выстраивать сложные workflow для нетривиальных задач разработки, code review, автоматизации и одновременной работы с несколькими сессиями.

Ключевые расширенные возможности:

• Режим планирования: составление подробных планов реализации до начала написания кода
• Extended Thinking: глубокие рассуждения для сложных задач
• Auto Mode: фоновый классификатор безопасности проверяет каждое действие перед выполнением
• Фоновые задачи: выполнение длительных операций без блокировки диалога
• Режимы разрешений: контроль над действиями Claude (manual - ранее default, acceptEdits, plan, auto, dontAsk, bypassPermissions)
• Print Mode: неинтерактивный запуск Claude Code для автоматизации и CI/CD (claude -p)
• Управление сессиями: работа с несколькими рабочими сессиями
• Интерактивные функции: горячие клавиши, многострочный ввод и история команд
• Голосовой ввод: push-to-talk с поддержкой STT на 20 языках
• Каналы: MCP-серверы отправляют сообщения в активные сессии (Research Preview)
• Удалённое управление: управление Claude Code из Claude.ai или приложения Claude
• Web-сессии: запуск Claude Code в браузере по адресу claude.ai/code
• Desktop-приложение: отдельное приложение для визуального просмотра diff и одновременной работы с несколькими сессиями
• Список задач: сохранение задач между уплотнениями контекста
• Подсказки промптов: контекстные подсказки команд
• Git Worktrees: изолированные worktree-ветки для параллельной работы
• Sandboxing: изоляция файловой системы и сети на уровне ОС
• Управляемые настройки: корпоративное развёртывание через plist, Registry или управляемые файлы
• Конфигурация: настройка поведения через JSON-файлы конфигурации

Режим планирования

Режим планирования позволяет Claude продумать сложную задачу до её реализации и составить подробный план, который вы можете просмотреть и утвердить.

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

Режим планирования - это двухэтапный подход:

1. Этап планирования: Claude анализирует задачу и составляет подробный план реализации
2. Этап реализации: после утверждения Claude выполняет план

Когда использовать режим планирования

✅ Используйте режим планирования для:

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

❌ Не используйте режим планирования для:

• Простых багфиксов
• Изменений форматирования
• Правок в одном файле
• Быстрых запросов

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

Slash-команда:

/plan Implement user authentication system

Флаг CLI:

claude --permission-mode plan

Установить по умолчанию:

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

Сочетание клавиш:

• Shift + Tab - переключение режимов разрешений (включая режим планирования)
• 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 или slash-команду:

# Activate plan mode via CLI
claude --permission-mode plan

# Or use the /plan slash command inside the REPL
/plan Implement user authentication system

Псевдоним модели для планирования: используйте псевдоним модели opusplan, чтобы задействовать Opus на этапе планирования и Sonnet - на этапе выполнения:

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

Редактирование плана во внешнем редакторе: нажмите Ctrl+G, чтобы открыть текущий план во внешнем редакторе для детальной правки.

Обновление v2.1.112: файлы планов теперь именуются по prompt, из которого они созданы (вместо случайных слов), - так их проще просматривать и переиспользовать.

Обновление v2.1.136 - блокировка записи в plan mode теперь безусловна: режим планирования теперь блокирует любые записи в файлы, в том числе при наличии подходящего правила Edit(...) в permissions.allow. Раньше разрешающее правило Edit(...) могло пропускать запись в plan mode; эта лазейка закрыта. Если ваш workflow опирался на прежнее поведение, выйдите из plan mode (Shift+Tab) перед редактированием.

Ultraplan (черновики планов в облаке)

Новое в v2.1.101: при первом вызове Ultraplan автоматически создаёт облачное окружение Claude Code on the web - без ручной настройки и без ожидания прогрева контейнера перед началом работы над черновиком.

Примечание: Ultraplan - это research preview, требуется Claude Code v2.1.91 или новее.

/ultraplan передаёт задачу планирования из вашего локального CLI в сессию Claude Code on the web, работающую в plan mode. Claude готовит черновик плана в облаке, пока ваш терминал остаётся свободен для другой работы; затем вы просматриваете черновик в браузере и выбираете, где его выполнить - в той же облачной сессии или телепортировав обратно в терминал.

Когда использовать Ultraplan

• Вам нужны более богатые средства review, чем в терминале: inline-комментарии, emoji-реакции, боковая панель с оглавлением и сохраняемая история.
• Вы хотите, чтобы черновик готовился без вашего участия, пока вы продолжаете писать код локально: облачная сессия изучает репозиторий и пишет план, не блокируя ваш CLI.
• План нужно согласовать со стейкхолдерами перед выполнением - общедоступная веб-ссылка удобнее, чем копирование вывода из терминала.

Требования

• Аккаунт Claude Code on the web.
• Репозиторий на GitHub (облачная сессия клонирует ваш репозиторий, чтобы работать над черновиком на реальном коде).
• Недоступно в Amazon Bedrock, Google Cloud Vertex AI и Microsoft Foundry.

Три способа запуска

• Команда: /ultraplan <prompt> - явный вызов.
• Ключевое слово: добавьте слово ultraplan в любое место обычного prompt, и Claude направит запрос в облако.
• Из локального плана: после того как Claude завершит план локально, выберите «No, refine with Ultraplan on Claude Code on the web» в диалоге подтверждения, чтобы передать черновик на более глубокую проработку.

Пример использования

/ultraplan migrate the auth service from sessions to JWTs

Claude подтверждает запрос, разворачивает облачное окружение (создаётся автоматически при первом запуске в v2.1.101+) и возвращает ссылку на сессию, которую можно открыть в браузере.

Индикаторы статуса

Варианты выполнения

Когда план готов, у вас есть два пути его выполнения. Одобрите план в браузере, чтобы выполнить его в той же облачной сессии - Claude внесёт изменения удалённо и откроет pull request из web UI. Либо выберите «Approve plan and teleport back to terminal», чтобы реализовать план локально. Диалог возврата в терминал предлагает три варианта:

• Implement here - выполнить одобренный план в текущей сессии терминала.
• Start new session - открыть новую сессию в той же рабочей директории и выполнить план в ней.
• Cancel - сохраняет план в файл, чтобы вы могли вернуться к нему позже.

Предупреждение: Remote Control отключается при запуске ultraplan. Обе функции используют один и тот же интерфейс claude.ai/code, поэтому одновременно активной может быть только одна из них.

Extended Thinking

Extended Thinking позволяет Claude уделять больше времени размышлениям над сложными задачами перед тем, как выдать решение.

Что такое Extended Thinking?

Extended Thinking - это целенаправленный пошаговый процесс рассуждения, в ходе которого Claude:

• Разбивает сложные задачи на части
• Рассматривает несколько подходов
• Взвешивает компромиссы
• Прорабатывает граничные случаи

Включение Extended Thinking

Сочетание клавиш:

• Option + T (macOS) / Alt + T (Windows/Linux) - переключение Extended Thinking

Автоматическое включение:

• Включено по умолчанию для всех моделей (Opus 5, Opus 4.8, Opus 4.7, Sonnet 4.6, Haiku 4.5)
• Opus 5 / Opus 4.8: адаптивное рассуждение с уровнями усилий: low (○), medium (◐), high (●), xhigh, max. По умолчанию используется high на Opus 5 (v2.1.219), Opus 4.8 (v2.1.154), Opus 4.6 и Sonnet 4.6, а на Opus 4.7 - xhigh. Уровень xhigh доступен на Opus 5, Opus 4.8 и Opus 4.7 (на Opus 4.6 / Sonnet 4.6 он откатывается до high). max работает на Opus 5, Opus 4.8/4.7/4.6 и Sonnet 4.6 (только в пределах сессии). У Haiku 4.5 уровней усилий нет. Opus 5, Opus 4.8 и Opus 4.7 имеют нативное контекстное окно в 1M токенов (исправление для 1M-контекста появилось в v2.1.117 - до этого /context ошибочно считал использование Opus 4.7 относительно окна в 200K и вызывал преждевременный autocompact). Начиная с v2.1.129, /context показывает свою визуализацию только в UI; ASCII-визуализация больше не попадает в контекст диалога (экономия ~1,6k токенов на вызов), так что /context можно вызывать без опасений.
• Для подписчиков Pro/Max на Opus 4.6 / Sonnet 4.6: уровень effort по умолчанию был повышен с medium до high в v2.1.117.
• Остальные модели: фиксированный бюджет до 31 999 токенов

Способы настройки:

• Переключение: Alt+T / Option+T либо через /config
• Просмотр рассуждений: Ctrl+O (verbose mode)
• Задать effort: команда /effort или флаг --effort

Пользовательский бюджет:

export MAX_THINKING_TOKENS=1024

Уровень усилий (поддерживается в Opus 5, Opus 4.8, Opus 4.7, Opus 4.6 и Sonnet 4.6 - но не в Haiku 4.5):

export CLAUDE_CODE_EFFORT_LEVEL=high   # low (○), medium (◐), high (●), xhigh (Opus 5/4.8/4.7), or max - default is high on Opus 5 and Opus 4.8

Флаг CLI:

claude --effort high "complex architectural review"

Slash-команда:

/effort high

Примечание: Ключевое слово «ultrathink» в промптах активирует режим глубоких рассуждений. Уровни effort low, medium, high и max поддерживаются на Opus 5, Opus 4.8, Opus 4.7, Opus 4.6 и Sonnet 4.6 (у Haiku 4.5 их нет). xhigh доступен на Opus 5, Opus 4.8 и Opus 4.7. Effort по умолчанию - high на Opus 5, Opus 4.8 (а также Opus 4.6 / Sonnet 4.6) и xhigh на Opus 4.7. В отличие от Opus 4.8 и Opus 4.7, которые фиксируют свой effort по умолчанию при первом запуске, у Opus 5 такой фиксации нет - ранее установленный вами уровень сохраняется между запусками. В меню /effort также есть пункт ultracode, который не является уровнем effort модели - он отправляет xhigh и поручает Claude оркестрировать динамические workflow (действует только в рамках текущей сессии).

Fallback safety-классификатора на Opus 5

Помимо настройки fallbackModel (которая обрабатывает перегрузку и недоступность), Claude Code применяет fallback по категориям, когда safety-классификатор помечает запрос. Для этого требуется Claude Code v2.1.219 или новее.

• Opus 5: запросы, помеченные как связанные с кибербезопасностью, повторно выполняются на Opus 4.8. Запросы, помеченные как связанные с биологией, завершаются отказом, поскольку Opus 5 запускает собственные биологические классификаторы, для которых fallback-модели нет. Такие отказы вы получаете сразу с первого помеченного запроса.
• Задачи из области наступательной безопасности или биологии - penetration testing, задания Capture the Flag (CTF) и кодовые базы, смежные с биологией, - часто вызывают fallback, нередко уже на первом запросе.

Почему это важно: если вы запускаете security-review subagents или работу по CTF/pentest на Opus 5, будьте готовы к молчаливым повторным запускам на Opus 4.8 (с другим потолком effort и другим окном контекста) для запросов по кибербезопасности, а также к прямым отказам для запросов, смежных с биологией. Если такое поведение мешает, явно закрепите другую модель.

Управление переключением - настройка switchModelsOnFlag (v2.1.170+, по умолчанию true) определяет, происходит ли fallback молча. Установите её в false, и вместо переключения Claude Code сделает паузу, дав вам выбрать: переключить модель или отредактировать промпт. В /config она отображается как Switch models when a message is flagged.

{
  "switchModelsOnFlag": false
}

Преимущества Extended Thinking

• Глубокие рассуждения: больше времени на обдумывание сложных задач
• Более взвешенные архитектурные решения: осознанный выбор на основе всесторонней оценки
• Учёт пограничных случаев: анализ потенциальных проблем и сценариев
• Тщательный анализ: структурированный подход к решению сложных задач

Пример: архитектурное решение

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.

Настройка extended thinking

Режим extended thinking управляется через переменные окружения, сочетания клавиш и флаги CLI:

# Set thinking token budget
export MAX_THINKING_TOKENS=16000

# Set effort level (Opus 5, Opus 4.8, Opus 4.7, Opus 4.6, Sonnet 4.6): low (○), medium (◐), high (●), xhigh (Opus 5/4.8/4.7), or max - default is high on Opus 5 and Opus 4.8
export CLAUDE_CODE_EFFORT_LEVEL=high

Переключайте режим во время сессии сочетанием Alt+T / Option+T, задавайте уровень усилий командой /effort или настраивайте через /config.

Облегчённый system prompt (v2.1.154): облегчённый system prompt теперь используется по умолчанию для всех моделей, кроме Haiku, Sonnet и Opus 4.7 и более ранних, что снижает базовый расход токенов на Opus 5 и Opus 4.8.

Auto Mode

Auto Mode - это режим выдачи разрешений, в котором фоновый классификатор безопасности проверяет каждое действие перед его выполнением. Он позволяет Claude работать автономно, блокируя при этом опасные операции. Режим доступен на всех тарифных планах, но требует подходящей модели (Claude Opus 5, Opus 4.6+, Sonnet 4.6+ или Fable 5 в Anthropic API и Claude Platform on AWS; Opus 5, Sonnet 5, Opus 4.7, Opus 4.8 или Fable 5 в Bedrock, Vertex, Foundry и в gateway-сессиях приложений Claude с выполненным входом в аккаунт). На тарифах Team и Enterprise он включён по умолчанию - администраторы могут отключить его для организации через managed settings.

Требования

Auto Mode доступен только при выполнении всех перечисленных условий:

• Тарифный план: все планы.
• Организация: на тарифах Team и Enterprise Auto Mode доступен по умолчанию. Администраторы могут отключить его для организации, установив permissions.disableAutoMode в значение "disable" в managed settings.
• Модель: в Anthropic API и Claude Platform on AWS - Claude Opus 4.6 или новее (в том числе Opus 5), Sonnet 4.6 или новее либо Fable 5. В Amazon Bedrock, Google Cloud Agent Platform (Vertex AI), Microsoft Foundry и в gateway-сессиях приложений Claude с выполненным входом - только Claude Sonnet 5, Opus 4.7 или новее (в том числе Opus 5) и Fable 5. Более старые модели - Sonnet 4.5, Opus 4.5, Haiku и модели claude-3 - не поддерживаются ни у одного провайдера.
• Провайдер: доступен по умолчанию в Anthropic API, Claude Platform on AWS, Amazon Bedrock, Google Cloud Agent Platform (Vertex AI), Microsoft Foundry и в gateway-сессиях приложений Claude с выполненным входом. В версиях с v2.1.158 по v2.1.206 Auto Mode был отключён везде, кроме Anthropic API и Claude Platform on AWS, до тех пор пока не была задана переменная CLAUDE_CODE_ENABLE_AUTO_MODE=1; в v2.1.207 это требование убрано. Переменная по-прежнему принимается ради обратной совместимости, но начиная с v2.1.207 ни на что не влияет.
• Классификатор: работает на Claude Sonnet 4.6 (создаёт дополнительный расход токенов).

Включение Auto Mode

# Unlock auto mode with CLI flag (no longer required for Max subscribers on Opus 4.7 - access it directly)
claude --enable-auto-mode

# Then cycle to it with Shift+Tab in the REPL

Обновление v2.1.112: режим Auto больше не требует флага --enable-auto-mode. Подписчикам Max он доступен напрямую на Opus 4.7.

Обновление v2.1.158: режим Auto стал доступен на Bedrock, Vertex и Foundry для Opus 4.7/4.8 - за флагом CLAUDE_CODE_ENABLE_AUTO_MODE=1.

Обновление v2.1.207: требование явного включения снято. Теперь режим Auto доступен по умолчанию на Bedrock, Vertex AI, Microsoft Foundry, а также в gateway-сессиях приложений Claude с выполненным входом - для Claude Sonnet 5, Opus 4.7, Opus 4.8 и Fable 5 (а с v2.1.219 - и Opus 5). Флаг или переменная окружения не нужны. Администраторы могут отключить его через disableAutoMode в managed settings. Переменная CLAUDE_CODE_ENABLE_AUTO_MODE по-прежнему принимается для совместимости, но начиная с v2.1.207 не оказывает никакого действия.

Либо задайте его как режим разрешений по умолчанию:

claude --permission-mode auto

Настройка через конфиг:

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

Как работает классификатор

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

1. Правила allow/deny - сначала проверяются явные правила разрешений и запретов
2. Автоодобрение чтения и правок - чтение файлов и их редактирование пропускаются автоматически
3. Классификатор - фоновый классификатор анализирует действие
4. Fallback - после 3 блокировок подряд или 20 суммарно система переходит к запросу подтверждения у пользователя

Действия, блокируемые по умолчанию

В режиме auto по умолчанию блокируются следующие действия:

Больше решений передано классификатору (v2.1.218): классификатор также выносит решения по удалениям, затрагивающим корень файловой системы или домашний каталог, - таким как rm -rf / и rm -rf ~, - в том числе когда команда удаления находится внутри command substitution или process substitution. До v2.1.218 простые формы запрашивали подтверждение, а формы с подстановкой - в версиях с v2.1.208 по v2.1.217. Проверки фонового & и подозрительных путей Windows также больше не вызывают диалоги запроса разрешений - их выполняет классификатор.

Действия, разрешённые по умолчанию

Настройка Auto Mode

Вывод правил по умолчанию в формате JSON:

claude auto-mode defaults

Восстановить конфигурацию auto-mode по умолчанию (v2.1.212) с запросом подтверждения (--yes - чтобы пропустить):

claude auto-mode reset
claude auto-mode reset --yes

Настройте доверенную инфраструктуру через управляемый параметр autoMode.environment для корпоративных развёртываний. Это позволяет администраторам определять доверенные CI/CD-окружения, целевые площадки развёртывания и шаблоны инфраструктуры.

Расширение значений по умолчанию с помощью "$defaults" (v2.1.118)

Начиная с v2.1.118, autoMode.allow, autoMode.soft_deny и autoMode.environment принимают токен "$defaults", который дополняет встроенный список вашими правилами, а не заменяет его. До v2.1.118 любой пользовательский массив молча затирал встроенные значения.

Безусловные блокировки через autoMode.hard_deny (v2.1.136)

autoMode.hard_deny (v2.1.136+) - это массив правил классификатора, которые блокируют целый класс действий независимо от предполагаемого намерения пользователя. Используйте его для действий, которые никогда не должны выполняться в автоматическом режиме, - например, rm -rf по корневым путям или git push --force в защищённые ветки. В отличие от soft_deny, правила hard-deny не могут быть пересмотрены классификатором.

{
  "autoMode": {
    "hard_deny": ["Bash(rm -rf /:*)", "Bash(git push --force*)"]
  }
}

Было (заменяет встроенные - поведение до v2.1.118):

{
  "autoMode": {
    "allow": ["Bash(gh pr list:*)"]
  }
}

После (расширяет встроенные - v2.1.118+):

{
  "autoMode": {
    "allow": ["$defaults", "Bash(gh pr list:*)"],
    "soft_deny": ["$defaults", "Bash(kubectl delete:*)"],
    "environment": ["$defaults", "trusted-ci.internal"]
  }
}

Используйте "$defaults", чтобы сохранить поставляемые базовые правила и добавить поверх них дополнения, специфичные для организации или проекта.

Классификация всех shell-команд через autoMode.classifyAllShell (v2.1.193)

autoMode.classifyAllShell (boolean, v2.1.193+) пропускает все команды Bash/PowerShell через классификатор auto-mode. Включайте эту опцию, если хотите, чтобы классификатор анализировал каждую shell-команду в сессии.

{
  "autoMode": {
    "classifyAllShell": true
  }
}

В этом же релизе отображается причина отказа, когда auto mode блокирует действие - она видна в транскрипте, во всплывающем уведомлении об отказе и в списке недавно отклонённых действий в /permissions (v2.1.193+).

Встроенная защита на основе намерений (v2.1.183)

Помимо пользовательских правил hard_deny, auto mode по умолчанию блокирует следующие деструктивные команды, если только вы явно не запросили их в текущей сессии:

• git reset --hard, git checkout -- ., git clean -fd, git stash drop
• git commit --amend (если коммит был сделан не агентом в этой сессии)
• terraform destroy, pulumi destroy, cdk destroy (если только вы не указали конкретный стек)

Это встроенная защита по умолчанию, основанная на выводимом намерении, - добавлять эти команды в hard_deny вручную не нужно.

Поведение при неопределённости (fallback)

Когда классификатор не уверен, auto mode переходит к запросу подтверждения у пользователя:

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

Это гарантирует, что контроль всегда остаётся за пользователем, если классификатор не может уверенно одобрить действие.

Предварительная настройка разрешений, эквивалентных auto mode (без Team plan)

Если у вас нет Team plan или вы хотите более простой подход без фонового классификатора, можно заранее наполнить ~/.claude/settings.json консервативным базовым набором безопасных правил доступа. Скрипт стартует с правил только для чтения и локального инспектирования, а затем позволяет по желанию подключать правки, запуск тестов, локальные операции записи в git, установку пакетов и операции записи в GitHub - только когда вам это действительно нужно.

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

# Preview what would be added (no changes written)
python3 09-advanced-features/setup-auto-mode-permissions.py --dry-run

# Apply the conservative baseline
python3 09-advanced-features/setup-auto-mode-permissions.py

# Add more capability only when you need it
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

Скрипт добавляет правила в следующих категориях:

Фоновые задачи

Фоновые задачи позволяют выполнять длительные операции, не блокируя диалог.

Что такое фоновые задачи?

Фоновые задачи выполняются асинхронно, пока вы продолжаете работать:

• Продолжительные прогоны тестов
• Сборка проекта
• Миграции БД
• Скрипты развёртывания
• Инструменты анализа

Базовое использование:

User: Run tests in background

Claude: Started task bg-1234

/task list           # Show all tasks
/task status bg-1234 # Check progress
/task show bg-1234   # View output
/task cancel bg-1234 # Cancel task

Запуск фоновых задач

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)

Текущая дата: вторник, 4 августа 2026 г.

Проверить статус задачи: </query>

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
  }
}

Текущая дата: вторник, 4 августа 2026 г.

Инструмент Monitor (потоки, управляемые событиями)

> Новое в v2.1.98: Инструмент Monitor позволяет Claude следить за stdout фоновой команды и реагировать в тот момент, когда появляется совпадающее событие - заменяя polling loops и sleep при ожидании долгоживущих процессов.

Monitor подключается к любой shell-команде, которая пишет в stdout. Каждая строка stdout от команды становится уведомлением, которое пробуждает сессию. Claude задает команду; среда выполнения передает output потоком и доставляет события по мере их возникновения. См. связанный раздел Фоновые задачи для запуска базовых процессов.

Почему это важно

Polling с /loop или sleep тратит полный API round-trip на каждом цикле, независимо от того, изменилось что-то или нет. Monitor молчит, пока не произойдет событие, потребляя ноль tokens, пока команда не выводит данные. Когда событие все же происходит, Claude реагирует немедленно - без задержки обнаружения в ожидании следующего poll tick. Для всего, что выполняется дольше нескольких минут, это и дешевле, и быстрее, чем poll loops.

Два распространенных паттерна

Stream filters наблюдают за continuous output от долгоживущего источника. Команда выполняется бесконечно; каждая совпадающая строка является событием.

«Запусти мой dev-сервер и отслеживай ошибки». Claude запускает сервер как фоновую задачу, навешивает фильтр Monitor (tail -F server.log | grep --line-buffered -E "ERROR|FATAL"), и сессия затихает. Как только в логе появляется строка с ошибкой, Claude просыпается, читает её и может отреагировать - перезапустить сервер, исправить баг или показать проблему вам - без необходимости проверять что-либо вручную.

Предупреждение: при передаче данных в grep через pipe всегда используйте grep --line-buffered. Без этого флага grep буферизует stdout блоками по 4 КБ, что на потоках с низким трафиком может задерживать события на минуты. Это причина №1, по которой Monitor ломается на практике: если ваш фильтр подозрительно молчит, первым делом проверьте наличие --line-buffered.

Динамические workflow

Новое в v2.1.154

Динамические workflow позволяют Claude детерминированно оркестрировать десятки и сотни фоновых субагентов - fan-out, конвейеры и параллельные этапы, зашитые в скрипт, а не отданные на импровизацию модели. Если один агент располагает одним окном контекста, то workflow декомпозирует задачу между множеством агентов и затем сводит их результаты воедино.

Начиная с v2.1.219, динамические workflow по умолчанию используют рекомендацию среднего размера (ориентируйтесь на менее чем 15 агентов). Выбрать другой размер - или снять ограничения - можно через Dynamic workflow size в /config либо задав ключ workflowSizeGuideline в файле настроек. Строка статуса запущенного workflow показывает активный размер и подсказывает, что его можно изменить в /config.

Когда их использовать

• Полнота охвата - аудит или ревью по множеству файлов/измерений параллельно.
• Уверенность в результате - сгенерировать независимые точки зрения, а затем состязательно проверить выводы перед коммитом.
• Масштаб за пределами одного контекста - крупные миграции, широкие проходы по кодовой базе или исследования, которые не помещаются в один контекст.

Для разовой задачи, которую вы уже понимаете, по-прежнему уместнее один агент (или прямое редактирование) - workflow окупаются, когда работа разветвляется.

Запуск и просмотр

• Запуск: попросите Claude создать workflow под задачу (например, «run a workflow to review every file in src/»). Claude сам напишет оркестрационный скрипт и запустит его в фоне.
• Просмотр: команда /workflows показывает запущенные и завершённые прогоны workflow с прогрессом в реальном времени.
• ultracode: выбор ultracode в меню /effort включает этот режим на всю сессию - он отправляет модели xhigh и заставляет Claude по умолчанию оркестрировать динамические workflow. Действует только в рамках сессии и не принимается в файле настроек. (Начиная с v2.1.160 триггерное ключевое слово - ultracode; голое слово «workflow» больше не запускает прогон.)

Workflow строятся поверх модели субагентов - как отдельные агенты определяются и ограничиваются в правах, см. в разделе Субагенты.

Запланированные задачи

Scheduled Tasks позволяют автоматически запускать промпты по повторяющемуся расписанию или в качестве разовых напоминаний. Задачи привязаны к сессии - они выполняются, пока Claude Code активен, и удаляются по её завершении. Доступно начиная с v2.1.72+.

На claude.com продвигается как «Routines» (2026-05-14): продуктовый блог Anthropic представляет эту функциональность под названием Routines. CLI-команда остаётся /schedule; данное руководство использует исходное название «Scheduled Tasks» для преемственности. Если вы встречаете «Routines» в документации на claude.com или в десктопном приложении, речь об одной и той же возможности.

Команда /loop

# Explicit interval
/loop 5m check if the deployment finished

# Natural language
/loop check build status every 30 minutes

Также поддерживаются стандартные cron-выражения из 5 полей для точного планирования.

Одноразовые напоминания

Настройте напоминания, которые срабатывают однократно в заданное время:

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

Управление запланированными задачами

• До 50 запланированных задач на сессию
• Привязка к сессии - при её завершении задачи очищаются
• Повторяющиеся задачи автоматически истекают через 3 дня
• Задачи срабатывают, только пока Claude Code запущен - пропущенные срабатывания не навёрстываются

Подробности поведения

Облачные запланированные задачи

Используйте /schedule для создания облачных запланированных задач, выполняющихся на инфраструктуре Anthropic:

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

Облачные запланированные задачи сохраняются между перезапусками и не требуют, чтобы Claude Code был запущен локально.

Отключение запланированных задач

export CLAUDE_CODE_DISABLE_CRON=1

/schedule автоматически отключается в зависимости от типа API-ключа (v2.1.139): облачный /schedule незаметно становится недоступен, если задана любая из переменных ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN или apiKeyHelper - даже если вы при этом авторизованы через claude.ai. То же условие отключает Remote Control, MCP-коннекторы claude.ai и настройки уведомлений. Чтобы пользоваться /schedule, снимите API-ключ (или работайте через OAuth на тарифе Pro/Max). На локальный CronCreate это не влияет.

Пример: мониторинг развёртывания

/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 или запланированные задачи Desktop App.

Режимы разрешений

Режимы разрешений определяют, какие действия Claude может выполнять без явного подтверждения.

Доступные режимы разрешений

Примечание: интерактивный режим по умолчанию был переименован из default в Manual в v2.1.200 (в CLI, --help, VS Code и JetBrains), а пока он активен, в футере отображается серый бейдж ⏸ (v2.1.203). Работают как --permission-mode manual, так и --permission-mode default, а в настройках - и "defaultMode": "manual", и "defaultMode": "default". Учтите, что ключ настроек - permissions.defaultMode; ключа permissions.mode не существует, поэтому в примерах ниже используется каноническое написание.

Переключайтесь между режимами по Shift+Tab в CLI. Режим по умолчанию задаётся флагом --permission-mode или настройкой permissions.defaultMode.

Plan mode передаёт shell-команды классификатору (v2.1.218): если доступен auto mode и включена настройка useAutoModeDuringPlan (а по умолчанию она включена), то во время планирования shell-команды проверяет классификатор, а не вы вручную. Одобренные команды выполняются, отклонённые - блокируются. Запись файлов plan mode по-прежнему блокирует безусловно.

Начиная с v2.1.160, даже acceptEdits запрашивает подтверждение перед записью в стартовые файлы shell (.zshenv, .zlogin, .bash_login, ~/.config/git/) и в build-конфиги, способные выполнять код (.npmrc, .yarnrc*, bunfig.toml, .bazelrc, .pre-commit-config.yaml, .devcontainer/, …), - иначе это могло бы привести к непреднамеренному выполнению команд.

Расширенное покрытие путей для --dangerously-skip-permissions (v2.1.121, v2.1.126): CLI-флаг --dangerously-skip-permissions (и эквивалентный ему режим bypassPermissions) теперь пропускает запросы подтверждения при записи в существенно более широкий allowlist - .claude/skills/, .claude/agents/, .claude/commands/, .claude/, .git/, .vscode/, а также в файлы конфигурации shell. Катастрофические команды удаления (rm -rf / и подобные) в этом режиме всё же запрашивают подтверждение (в auto mode их вместо этого оценивает классификатор - см. Auto Mode). Относитесь к этому флагу как к ещё более острому инструменту, чем прежде; применяйте его только в одноразовых песочницах.

Определение shell в Windows (v2.1.120, v2.1.126): Git for Windows / Git Bash больше не требуется. Если Git Bash отсутствует, Claude Code использует в качестве shell-инструмента PowerShell. Начиная с v2.1.126 PowerShell становится основным shell, когда включён инструмент PowerShell, а обнаружение охватывает PowerShell 7, установленный через Microsoft Store, из MSI без прописывания в PATH или как .NET global tool.

Инструмент PowerShell включён по умолчанию в Windows для Bedrock/Vertex/Foundry (v2.1.143): начиная с v2.1.143, инструмент PowerShell включён по умолчанию в Windows для пользователей Bedrock, Vertex и Foundry. Claude Code запускает PowerShell с -ExecutionPolicy Bypass, поэтому скрипты выполняются даже при системной политике Restricted. Чтобы Claude Code учитывал системную execution policy, задайте CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY=1. Чтобы полностью отключить инструмент PowerShell, задайте CLAUDE_CODE_USE_POWERSHELL_TOOL=0.

Способы активации

Сочетание клавиш:

Shift + Tab  # Cycle through all 6 modes

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

/plan                  # Enter plan mode

Флаг CLI:

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

Текущая дата: вторник, 4 августа 2026 г.

Настройка: </query>

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

Примеры режимов разрешений

Режим по умолчанию

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)

Режим планирования

Просмотр плана реализации перед его выполнением:

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)

Режим автопринятия правок

Автоматически принимать изменения файлов:

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

Claude: [Makes changes without asking]

Сценарии использования

Code Review:

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]

Текущая дата: вторник, 4 августа 2026 г.

Headless-режим

Режим вывода (claude -p) позволяет Claude Code работать без интерактивного ввода, что идеально подходит для автоматизации и CI/CD. Это неинтерактивный режим, заменяющий старый флаг --headless.

Что такое режим вывода?

Режим вывода позволяет:

• Автоматическое выполнение скриптов
• Интеграцию с CI/CD
• Пакетную обработку
• Запланированные задачи

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

Process piped content

cat error.log | claude -p "Analyze these errors"

CI/CD integration (GitHub Actions)

• name: AI Code Review run: claude -p "Review PR"

### Дополнительные примеры использования режима print
```bash
# Run a specific task with output capture
claude -p "Run all tests and generate coverage report"

# With structured output
claude -p --output-format json "Analyze code quality"

# With input from 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)
            });

Настройка режима print

Режим print (claude -p) поддерживает несколько флагов для автоматизации:

# Limit autonomous turns
claude -p --max-turns 5 "refactor this module"

# Structured JSON output
claude -p --output-format json "analyze this codebase"

# With schema validation
claude -p --json-schema '{"type":"object","properties":{"issues":{"type":"array"}}}' \
  "find bugs in this code"

# Disable session persistence
claude -p --no-session-persistence "one-off analysis"

Безопасный режим (диагностика неполадок)

Флаг --safe-mode (а также переменная окружения CLAUDE_CODE_SAFE_MODE, например CLAUDE_CODE_SAFE_MODE=1) запускает Claude Code с полностью отключёнными пользовательскими настройками: CLAUDE.md, плагины, skills, hooks и MCP-серверы - всё выключается.

# Launch with every customization disabled
claude --safe-mode

# Equivalent via environment variable
CLAUDE_CODE_SAFE_MODE=1 claude

Это инструмент для диагностики: если пользовательская конфигурация вызывает проблемы, запустите Claude Code в безопасном режиме, чтобы понять, где источник проблемы - в вашей настройке или в самом Claude Code.

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

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

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

Возобновление сессий

Продолжить последний диалог:

claude -c

Возобновление именованной сессии:

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

Переименовать текущую сессию (внутри REPL):

/rename auth-refactor

Обновление v2.1.212: ввод /resume (без аргументов) в представлении агента теперь открывает выбор прошлых сессий - включая сессии, удалённые из видимого списка, - и возобновляет выбранную как фоновую сессию.

Форки и ветвление сессий

Три команды создают копии диалога и различаются тем, где выполняется эта копия:

/subtask <task> порождает форк-субагента, который наследует весь диалог и работает над задачей, пока вы продолжаете свою работу, - со своей отдельной строкой в claude agents; результат возвращается в ваш диалог по завершении:

/subtask Investigate why the auth tests are flaky

/fork [prompt] вместо этого копирует диалог в новую фоновую сессию. Копия содержит всё, что было до этого момента, и выполняется независимо - в текущий диалог ничего не возвращается:

/fork Try the OAuth approach end to end

Чтобы самому переключиться в копию, а не делегировать задачу, используйте /branch [name] - эта команда сохраняет оригинал и позволяет вернуться к нему через /resume:

/branch try-oauth-instead

Примечание: /fork и /subtask поменялись ролями в v2.1.212. До v2.1.161 /fork был псевдонимом для /branch; с v2.1.161 по v2.1.211 он запускал ответвлённый субагент - это поведение теперь закреплено за /subtask. Когда agent view отключён, /subtask недоступен, а /fork сохраняет поведение ответвлённого субагента.

Или выполните fork из CLI:

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

Сохранение сессий

Сессии автоматически сохраняются, и их можно возобновить:

# Continue last conversation
claude -c

# Resume specific session by name or ID
claude -r "auth-refactor"

# Resume and fork for experimentation
claude --resume auth-refactor --fork-session "alternative approach"

Краткая сводка сессии (v2.1.108)

Когда вы возвращаетесь к сессии после перерыва, Claude может показать краткую сводку о том, что было сделано. Эта функция включена по умолчанию для пользователей с отключённой телеметрией (Bedrock, Vertex, Foundry).

Телеметрия OTEL - повторное включение опроса об отзывах (v2.1.136+): организации, собирающие данные OpenTelemetry, могут повторно включить опрос Anthropic о качестве сессии, задав CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL=1. В развёртываниях с OTEL опрос по умолчанию отключён, так как ранее его данные направлялись в обход telemetry-конвейеров.

Телеметрия OTEL - событие журнала assistant_response (v2.1.193+): Claude Code отправляет событие журнала OpenTelemetry claude_code.assistant_response с текстом ответа модели, что позволяет OTEL-конвейерам фиксировать реплики Claude наряду с уже существующей телеметрией инструментов и событий.

Управление поведением сводки:

/recap                                 # manually trigger a recap
/config                                # toggle auto-recap on/off

Или через переменную окружения:

CLAUDE_CODE_ENABLE_AWAY_SUMMARY=0 claude   # disable recap
CLAUDE_CODE_ENABLE_AWAY_SUMMARY=1 claude   # force enable recap

Интерактивные возможности

Горячие клавиши

Для повышения продуктивности Claude Code поддерживает горячие клавиши. Ниже приведён полный список из официальной документации:

Специальные возможности

Режим экранного диктора (v2.1.208+) переключает CLI в режим вывода простого текста, оптимизированный для программ чтения с экрана. Включить его можно через флаг CLI, переменную окружения или параметр в настройках:

claude --ax-screen-reader

export CLAUDE_AX_SCREEN_READER=1

{
  "axScreenReader": true
}

Настройка сочетаний клавиш

Создавайте пользовательские сочетания клавиш командой /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:

Поддержка аккордов

Привязки клавиш поддерживают аккордные последовательности (комбинации из нескольких клавиш):

"ctrl+k ctrl+s"   → Two-key sequence: press ctrl+k, then ctrl+s
"ctrl+shift+p"    → Simultaneous modifier keys

Синтаксис сочетаний клавиш:

• Модификаторы: ctrl, alt (или opt), shift, meta (или cmd)
• Заглавная буква подразумевает Shift: K эквивалентно shift+k
• Специальные клавиши: escape, enter, return, tab, space, backspace, delete, клавиши со стрелками

Зарезервированные и конфликтующие клавиши

Совет: Если сочетание клавиш не работает, проверьте, нет ли конфликтов с вашим эмулятором терминала или мультиплексором.

Автодополнение по Tab

Claude Code предоставляет интеллектуальное автодополнение по клавише Tab:

User: /rew<TAB>
→ /rewind

User: /plu<TAB>
→ /plugin

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

История команд

Доступ к ранее выполненным командам:

User: <↑>  # Previous command
User: <↓>  # Next command
User: Ctrl+R  # Search history

(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]

Инлайн-редактирование

Редактирование команд перед отправкой:

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

[Edit in-place before sending]

Режим Vim

Включение Vi/Vim-раскладки клавиш для редактирования текста:

Активация:

• Включается через /config (переключатель «Editor / Vim mode») или в ~/.claude/settings.json параметром editorMode: "vim". Отдельная slash-команда /vim была удалена (см. issue #43370); режим vim теперь задаётся конфигурацией.
• Переключение режимов: Esc - NORMAL, i/a/o - INSERT, v - VISUAL, V - VISUAL-LINE (v2.1.118+)

Клавиши навигации:

• h / l - влево/вправо
• j / k - вниз/вверх
• w / b / e - перемещение по словам
• 0 / $ - в начало/конец строки
• gg / G - в начало/конец текста

Текстовые объекты:

• iw / aw - слово без учёта / с учётом окружающих пробелов
• i" / a" - содержимое строки в кавычках / вместе с кавычками
• i( / a( - содержимое скобок / вместе со скобками

Визуальные режимы (v2.1.118+):

Режим Bash

Выполняйте shell-команды напрямую с помощью префикса !:

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

Используйте это для быстрого выполнения команд без переключения контекста.

Начиная с v2.1.193: в режиме bash (!) работает автодополнение путей к файлам на лету - пути дополняются прямо по мере ввода shell-команды, без выхода из prompt.

Начиная с v2.1.186: вывод команды ! теперь автоматически отправляется Claude, и тот на него отвечает. Чтобы вернуть прежнее поведение, при котором вывод лишь добавляется в контекст без ответа, задайте "respondToBashCommands": false в settings.json.

Output Styles

Output styles меняют то, как Claude отвечает, а не то, что он знает. Они модифицируют system prompt, задавая роль, тон и формат ответа по умолчанию. Прибегайте к ним, когда приходится в каждом сообщении заново задавать одну и ту же манеру ответа, или когда вы хотите, чтобы Claude выступал в роли кого-то помимо software engineer.

Для инструкций о вашем проекте или кодовой базе используйте CLAUDE.md - это другой механизм со своими компромиссами.

Встроенные стили

Выбор стиля

Выполните /config и выберите пункт Output style. Выбранное значение сохраняется в .claude/settings.local.json. Чтобы задать его без использования меню, отредактируйте параметр напрямую:

{
  "outputStyle": "Explanatory"
}

Примечание: Отдельная команда /output-style объявлена устаревшей в v2.1.73 и удалена в v2.1.91. Используйте /config или настройку outputStyle.

Стиль вывода является частью системного промпта, который Claude Code считывает один раз при запуске сессии - изменения вступают в силу после /clear или в новой сессии.

Пользовательские стили вывода

Пользовательский стиль - это Markdown-файл с frontmatter, сохранённый на одном из трёх уровней:

• Пользовательский: ~/.claude/output-styles/
• Проектный: .claude/output-styles/
• Управляемая политика: .claude/output-styles/ внутри каталога управляемых настроек

Проектные стили загружаются из всех каталогов .claude/output-styles/, находящихся между рабочим каталогом и корнем репозитория. Начиная с v2.1.178, если во вложенных каталогах определены стили с одинаковым именем, приоритет имеет тот, что ближе к рабочему каталогу.

---
name: Diagrams first
description: Lead every explanation with a diagram
keep-coding-instructions: true
---

When explaining code, architecture, or data flow, start with a Mermaid diagram
showing the structure, then explain in prose.

Область действия и стоимость

Output styles применяются только к основному диалогу. У субагента свой system prompt, поэтому стили не влияют на его ответы; исключение - fork, так как он наследует system prompt родителя целиком.

Добавление инструкций увеличивает число input tokens, но после первого запроса основную часть этой нагрузки берёт на себя prompt caching. Стили Explanatory и Learning по своей сути дают более развёрнутые ответы, что увеличивает число output tokens.

Сравнение

Строка состояния

Строка состояния - это пользовательская команда, вывод которой отображается внизу сессии. Настройте её с помощью /statusline или задайте напрямую:

Доступные поля ввода

Пример

#!/bin/bash
# ~/.claude/statusline.sh - model, context usage, and cost
input=$(cat)
model=$(echo "$input" | jq -r '.model.id')
used=$(echo "$input" | jq -r '.context_window.used_percentage')
cost=$(echo "$input" | jq -r '.cost.total_cost_usd')
printf '%s | ctx %.0f%% | $%.2f' "$model" "$used" "$cost"

Примечание: statusLine требует доверия к рабочей области (workspace trust). Скрипты строки состояния также получают переменные окружения COLUMNS и LINES (v2.1.153+), что позволяет им подгонять вывод под размер терминала.

Режим TUI (полноэкранный)

Появилось в v2.1.110

Режим TUI (Text User Interface) отображает Claude Code во весь экран без мерцания - идеальный вариант для терминальных мультиплексоров вроде tmux или разделённых панелей iTerm2.

Включение режима TUI

Режим TUI переключается командой /tui либо включается при запуске с флагом --tui:

/tui          # toggle from within a session
claude --tui  # start directly in TUI mode

Настройка

{
  "autoScrollEnabled": false
}

Режим фокуса

Команда /focus включает и выключает режим фокуса - отображение без отвлекающих элементов, в котором показывается только наиболее релевантный вывод. Ctrl+O теперь переключает только между обычным и подробным режимом расшифровки (режим фокуса вызывается через /focus).

Голосовой ввод

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

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

/voice

Возможности

Настройка

Настройте сочетание клавиш push-to-talk в файле keybindings (/keybindings). Для распознавания речи голосовой ввод использует ваш аккаунт Claude.ai.

Channels

Channels - это функция в статусе Research Preview, которая передаёт события из внешних сервисов в активную сессию Claude Code через MCP-серверы. В качестве источников поддерживаются Telegram, Discord, iMessage и произвольные webhook'и, что позволяет Claude реагировать на уведомления в реальном времени без polling'а.

Аутентификация (v2.1.128+): --channels теперь работает как с OAuth для Pro/Max, так и с аутентификацией по API-ключу (console). В более ранних версиях требовался только OAuth.

Подписка на каналы

# Subscribe to channel plugins at startup
claude --channels discord,telegram

# Subscribe to multiple sources
claude --channels discord,telegram,imessage,webhooks

Поддерживаемые интеграции

Настройка

Каналы задаются флагом --channels при запуске. В корпоративных развёртываниях используйте管ляемую настройку, чтобы ограничить список разрешённых плагинов каналов:

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

Управляемая настройка allowedChannelPlugins определяет, какие channel plugins разрешены к использованию в организации.

Как это работает

1. MCP-серверы выступают в роли channel plugins, подключающихся к внешним сервисам
2. Входящие сообщения и события передаются в активную сессию Claude Code
3. Claude может читать сообщения и отвечать на них в рамках контекста сессии
4. Channel plugins должны быть одобрены через управляемую настройку allowedChannelPlugins
5. Polling не требуется - события доставляются в реальном времени

Интеграция с Chrome

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

Включение интеграции с Chrome

При запуске:

claude --chrome      # Enable Chrome connection
claude --no-chrome   # Disable Chrome connection

В рамках сессии:

/chrome

Выберите «Enabled by default», чтобы активировать интеграцию с Chrome для всех последующих сессий. Claude Code использует состояние авторизации вашего браузера, что позволяет ему взаимодействовать с веб-приложениями, требующими входа.

Возможности

Разрешения на уровне сайта

Расширение Chrome управляет доступом отдельно для каждого сайта. Вы можете в любой момент выдать или отозвать доступ к конкретным сайтам через popup расширения. Claude Code взаимодействует только с теми сайтами, которые вы явно разрешили.

Как это работает

Claude Code управляет браузером в видимом окне - вы можете наблюдать за действиями в реальном времени. Когда браузер попадает на страницу входа или CAPTCHA, Claude приостанавливается и ждёт, пока вы вручную пройдёте этот шаг, прежде чем продолжить работу.

Известные ограничения

• Поддержка браузеров: только Chrome и Edge - Brave, Arc и другие браузеры на Chromium не поддерживаются
• WSL: недоступно в Windows Subsystem for Linux
• Сторонние провайдеры: не поддерживается при использовании Bedrock, Vertex или Foundry API
• Простой service worker: service worker расширения Chrome может переходить в режим простоя во время длительных сессий

Совет: интеграция с Chrome - функция в стадии beta. В будущих релизах список поддерживаемых браузеров может расшириться.

Удалённое управление

Удалённое управление позволяет продолжить локально запущенную сессию Claude Code с телефона, планшета или любого браузера. Ваша локальная сессия продолжает работать на вашей машине - ничего не выгружается в облако. Доступно на планах Pro, Max, Team и Enterprise (v2.1.51+).

Запуск удалённого управления

Из CLI:

# Start with default session name
claude remote-control

# Start with a custom name
claude remote-control --name "Auth Refactor"

Внутри сессии:

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

Доступные флаги:

Подключение к сессии

Три способа подключиться с другого устройства:

1. URL сессии - выводится в терминале при запуске сессии; откройте его в любом браузере
2. QR-код - нажмите spacebar после запуска, чтобы вывести QR-код для сканирования
3. Поиск по имени - просматривайте свои сессии на claude.ai/code или в мобильном приложении Claude (iOS/Android)

Безопасность

• Не открываются входящие порты на вашей машине
• Только исходящий HTTPS поверх TLS
• Ограниченные учётные данные - несколько короткоживущих токенов с узкой областью действия
• Изоляция сессий - каждая удалённая сессия независима

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

Ограничения

• Одна удалённая сессия на экземпляр Claude Code
• Терминал должен оставаться открытым на хост-машине
• Сессия завершается примерно через 10 минут при отсутствии сети

Сценарии использования

• Управление Claude Code со смартфона или планшета, когда вы не за рабочим местом
• Использование более функционального интерфейса claude.ai с сохранением локального выполнения инструментов
• Быстрый code review в дороге с доступом ко всей вашей локальной среде разработки

Push-уведомления (v2.1.110)

Когда Remote Control активен и в /config включена опция Push when Claude decides, Claude может отправлять push-уведомления на ваш телефон - например, о завершении длительной задачи или о необходимости вашего участия.

Как включить:

1. Активируйте Remote Control: /remote-control или claude --rc
2. Откройте /config и включите Push when Claude decides

Для push-уведомлений требуются подписка Claude и мобильное приложение Claude.

Отключение Remote Control (disableRemoteControl, v2.1.128+)

Администраторы тарифов Team и Enterprise могут полностью запретить Remote Control с помощью параметра disableRemoteControl. При значении true ни claude remote-control, ни /remote-control не запустятся.

{
  "disableRemoteControl": true
}

Настройка применяется на уровне managed/policy (например, /Library/Application Support/ClaudeCode/managed-settings.json в macOS), поэтому отдельные пользователи не могут её переопределить. Полезно, когда требование запуска только в локальном режиме нужно принудительно применить в масштабах всей организации.

Автоматическое отключение Remote Control на тарифах с API-ключом (v2.1.139): Remote Control отключается без уведомления, если задан любой из перечисленных ниже параметров, даже если вы одновременно авторизованы через claude.ai:

• ANTHROPIC_API_KEY
• ANTHROPIC_AUTH_TOKEN
• apiKeyHelper (settings.json)

То же условие отключает /schedule, MCP-коннекторы claude.ai и настройки уведомлений - все четыре возможности, завязанные на claude.ai, работают только тогда, когда активными учётными данными является OAuth-логин. Удалите API-ключ (или используйте OAuth-тариф Pro/Max), чтобы пользоваться этими функциями.

Web Sessions

Web Sessions позволяют запускать Claude Code прямо в браузере по адресу claude.ai/code или создавать веб-сессии из CLI.

Создание веб-сессии

# Create a new web session from the CLI
claude --remote "implement the new API endpoints"

Это запустит сессию Claude Code на claude.ai, к которой можно подключиться из любого браузера.

Продолжение веб-сессий локально

Если вы начали сессию в вебе и хотите продолжить её локально:

# Resume a web session in the local terminal
claude --teleport

Или прямо в интерактивном REPL:

/teleport

Сценарии использования

• Начните работу на одной машине и продолжите на другой
• Поделитесь URL сессии с коллегами по команде
• Используйте веб-интерфейс для визуального просмотра diff, а затем переключитесь в терминал для выполнения

Десктопное приложение

Claude Code Desktop App - это отдельное приложение с визуальным просмотром diff, параллельными сессиями и встроенными коннекторами. Доступно для macOS и Windows (тарифы Pro, Max, Team и Enterprise).

Установка

Скачайте версию для вашей платформы с claude.ai:

• macOS: универсальная сборка (Apple Silicon и Intel)
• Windows: установщики для x64 и ARM64

Инструкции по настройке см. в Desktop Quickstart.

Передача сессии из CLI

Перенесите текущую CLI-сессию в Desktop App:

/desktop

Основные возможности

Конфигурация предпросмотра приложения

Настройте поведение dev-сервера в .claude/launch.json:

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

Коннекторы

Подключайте внешние сервисы для получения более полного контекста:

Примечание: коннекторы недоступны в удалённых (облачных) сессиях.

Удалённые и SSH-сессии

• Удалённые сессии: выполняются в облачной инфраструктуре Anthropic и продолжают работать даже после закрытия приложения. Доступны через claude.ai/code или мобильное приложение Claude
• SSH-сессии: подключаются к удалённым машинам по SSH с полным доступом к файловой системе и инструментам на удалённой машине. Claude Code должен быть установлен на удалённой машине

Режимы разрешений в Desktop

Desktop App поддерживает те же 4 режима разрешений, что и CLI:

Корпоративные возможности

• Консоль администратора: управление доступом к вкладке Code и настройками разрешений для организации
• Развёртывание через MDM: развёртывание через MDM в macOS или MSIX в Windows
• Интеграция с SSO: обязательный вход через single sign-on для участников организации
• Управляемые настройки: централизованное управление конфигурацией команды и доступностью моделей

Список задач

Функция «Список задач» обеспечивает постоянное отслеживание задач, которое сохраняется при уплотнении контекста (когда история диалога обрезается, чтобы уместиться в окно контекста).

Переключение списка задач

Нажмите 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

Текущая дата: вторник, 4 августа 2026 г.

Git Worktrees

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

Запуск в Worktree

Worktree создаются по пути:

<repo>/.claude/worktrees/<name>

Sparse checkout для монорепозиториев

Используйте параметр worktree.sparsePaths, чтобы выполнять sparse-checkout в монорепозиториях, сокращая объём занимаемого места на диске и время клонирования:

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

Базовая ветка (worktree.baseRef)

worktree.baseRef (добавлено в v2.1.133) - определяет, от чего claude --worktree создаёт новую ветку: от origin/<default> или от локального HEAD.

• "fresh" (по умолчанию) - ветка создаётся от origin/<default-branch>, локальные неотправленные commit'ы игнорируются. Это возвращает поведение, действовавшее до v2.1.128, поэтому пользователям, которые после v2.1.128 полагались на ветвление от локального HEAD, придётся включить этот режим явно.
• "head" - ветка создаётся от локального HEAD с сохранением неотправленных commit'ов.

Задаётся в ~/.claude/settings.json:

{ "worktree": { "baseRef": "head" } }

Изоляция фоновых сессий (worktree.bgIsolation)

worktree.bgIsolation (добавлено в v2.1.143) - определяет, получают ли фоновые сессии (например, запущенные через /bg, claude --bg или Agent View) собственный worktree или же правят рабочую копию основной сессии напрямую.

• (по умолчанию) - фоновые сессии создают изолированный worktree в <repo>/.claude/worktrees/, аналогично флагу --worktree.
• "none" - фоновые сессии редактируют текущую рабочую копию напрямую. Используйте этот режим, когда worktree неудобны (например, из-за тяжёлых артефактов нативной сборки) или когда фоновому агенту нужно согласовывать правки с основной сессией.

{ "worktree": { "bgIsolation": "none" } }

Компромисс: "none" убирает страховку в виде изоляции worktree - одновременные правки из фоновых и активных сессий могут приводить к merge-конфликтам в текущей рабочей копии.

Инструменты worktree и hooks

Автоочистка

Если в worktree не было внесено изменений, он автоматически удаляется по завершении сессии.

Сценарии использования

• Работа над feature-веткой без затрагивания main
• Запуск тестов в изоляции, не влияя на рабочую директорию
• Проверка экспериментальных изменений в одноразовом окружении
• Sparse-checkout отдельных пакетов в монорепозиториях для ускорения запуска

Песочница (sandboxing)

Песочница обеспечивает изоляцию файловой системы и сети на уровне ОС для Bash-команд, выполняемых Claude Code. Она дополняет правила разрешений и добавляет ещё один уровень безопасности.

Включение песочницы

Slash-команда:

/sandbox

Флаги CLI:

claude --sandbox       # Enable sandboxing
claude --no-sandbox    # Disable sandboxing

Настройки конфигурации

{
  "sandbox": {
    "bwrapPath": "/opt/bubblewrap/bin/bwrap",
    "socatPath": "/opt/socat/bin/socat"
  }
}

Пример того, как deniedDomains переопределяет широкий шаблон (v2.1.113+):

{
  "sandbox": {
    "network": {
      "allowedDomains": ["*.example.com"],
      "deniedDomains": ["evil.example.com"]
    }
  }
}

Подстановочный знак пропускает все запросы к example.com, но deniedDomains всё же блокирует явно указанный хост.

Пример конфигурации

{
  "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 в масштабах организации с помощью штатных инструментов управления соответствующей платформы.

Методы развёртывания

Управляемые drop-in-файлы

Начиная с версии v2.1.83, администраторы могут размещать несколько файлов управляемых настроек в каталоге managed-settings.d/. Файлы объединяются в алфавитном порядке, что позволяет организовать модульную конфигурацию между командами:

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

Доступные управляемые настройки

Пример: 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>

Текущая дата: вторник, 4 августа 2026 г.

Конфигурация и настройки

Расположения файлов конфигурации

1. Глобальная конфигурация: ~/.claude/config.json
2. Конфигурация проекта: ./.claude/config.json
3. Пользовательская конфигурация: ~/.config/claude-code/settings.json

Полный пример конфигурации

Конфигурация основных продвинутых функций:

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

### Дополнительные пользовательские настройки

Эти ключи размещаются в `~/.claude/settings.json` (или в проектном `.claude/settings.json`) и управляют интерактивным поведением для конкретного пользователя:
| Setting | Description |
|---------|-------------|
| `askUserQuestionTimeout` | Auto-continue an unanswered `AskUserQuestion` dialog after an idle interval. As of **v2.1.200** dialogs no longer auto-continue by default - set this to opt back into timed auto-continue. |
| `enableArtifact` | Per-user enable/disable of the Artifact tool (v2.1.196). |
### Резервные модели (`fallbackModel`)

Параметр `fallbackModel` позволяет задать **до трёх** резервных моделей, которые будут использоваться по очереди, если основная модель перегружена или недоступна.
```json
{
  "fallbackModel": ["claude-opus-4-8", "claude-sonnet-4-6", "claude-haiku-4-5"]
}

Начиная с версии v2.1.166, флаг --fallback-model применяется и к интерактивным сессиям (а не только к headless-режиму). При переключении на fallback Claude Code один раз повторяет запрос при неожиданной ошибке, которая обычно не подлежит повторной отправке; ошибки авторизации, превышения rate limit, размера запроса и транспортного уровня по-прежнему приводят к немедленному завершению.

Переменные окружения

Переопределение конфигурации через переменные окружения:

# Model selection
export ANTHROPIC_MODEL=claude-opus-4-8
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-4-8
export ANTHROPIC_DEFAULT_SONNET_MODEL=claude-sonnet-4-6
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5

# API configuration
export ANTHROPIC_API_KEY=sk-ant-...

# Thinking configuration
export MAX_THINKING_TOKENS=16000
export CLAUDE_CODE_EFFORT_LEVEL=high   # low, medium, high, xhigh (Opus 5/4.8/4.7), or max - default is high on Opus 5 and Opus 4.8 (supported on Opus 5, Opus 4.8, Opus 4.7, Opus 4.6, Sonnet 4.6)

# Feature toggles
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              # Set by --bare flag

# MCP configuration
export MAX_MCP_OUTPUT_TOKENS=50000
export ENABLE_TOOL_SEARCH=true

# Prompt caching
export ENABLE_PROMPT_CACHING_1H=1      # Use 1-hour prompt cache TTL (default is 5 min)

# Task management
export CLAUDE_CODE_TASK_LIST_ID=my-project-tasks

# Agent teams (experimental)
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

# Subagent and plugin configuration
export CLAUDE_CODE_SUBAGENT_MODEL=sonnet
export CLAUDE_CODE_PLUGIN_SEED_DIR=./my-plugins
export CLAUDE_CODE_NEW_INIT=1

# Subprocess and streaming
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

# Output and package manager (v2.1.129+)
export CLAUDE_CODE_FORCE_SYNC_OUTPUT=1                      # Force synchronous output for terminals where auto-detect misses (Emacs eat, etc.)
export CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1            # Enable background upgrades for Homebrew/WinGet installs
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1         # Opt in to /v1/models gateway discovery when ANTHROPIC_BASE_URL is set

# Windows PowerShell tool (v2.1.143+) - default-on for Bedrock/Vertex/Foundry on Windows
export CLAUDE_CODE_USE_POWERSHELL_TOOL=0                    # Disable the PowerShell tool entirely
export CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY=1    # Honor system ExecutionPolicy instead of `-ExecutionPolicy Bypass`

# Workload identity federation (v2.1.141+)
export ANTHROPIC_WORKSPACE_ID=ws_abc123                     # Scope the federated token to a specific workspace when the rule covers multiple

# Stop hook safety cap (v2.1.143+)
export CLAUDE_CODE_STOP_HOOK_BLOCK_CAP=8                    # Max consecutive Stop-hook blocks before the session ends with a warning. Set 0 to disable the cap.

# Session-wide spawn caps (v2.1.212)
export CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION=200         # Cap on WebSearch tool calls per session, to stop runaway search loops. Default 200.

# Accessibility (v2.1.208)
export CLAUDE_AX_SCREEN_READER=1                            # Enable plain-text screen reader rendering mode. Same effect as --ax-screen-reader or "axScreenReader": true in settings.

v2.1.108: ENABLE_PROMPT_CACHING_1H=1 - использовать TTL prompt cache в 1 час вместо стандартных 5 минут. Уменьшает количество промахов кэша в длительных стабильных сессиях. (В v2.1.129 исправлена регрессия, из-за которой часовой TTL молча понижался до 5 минут.)

v2.1.129: CLAUDE_CODE_FORCE_SYNC_OUTPUT=1 принудительно включает синхронный вывод для терминалов, в которых не срабатывает автоопределение возможностей (например, Emacs eat). CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1 включает фоновое обновление для установок через Homebrew/WinGet, которые иначе никогда не обновляются автоматически.

Команды управления конфигурацией

User: /config
[Opens interactive configuration menu]

Команда /config открывает интерактивное меню для переключения таких настроек, как:

• Extended thinking (вкл./выкл.)
• Подробный вывод
• Режим разрешений
• Выбор модели
• Динамический размер workflow (v2.1.219) - скрыт, если в файле настроек задан параметр workflowSizeGuideline, см. Dynamic Workflows

В интерактивном меню нажмите Enter или Space, чтобы изменить выбранную настройку, и Esc - чтобы сохранить и закрыть (v2.1.183+).

Также можно задать настройку прямо из prompt, не открывая меню:

/config thinking=false      # set a single setting inline (v2.1.181+)
/config --help              # list available shorthand keys (v2.1.183+)

Сокращение key=value работает в интерактивных сессиях, с -p, а также в Remote Control.

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

Создайте файл .claude/config.json в корне проекта:

{
  "hooks": {
    "PreToolUse": [{ "matcher": "Bash", "hooks": ["npm test && npm run lint"] }]
  },
  "permissions": {
    "defaultMode": "manual"
  },
  "mcp": {
    "servers": {
      "project-db": {
        "command": "mcp-postgres",
        "env": {
          "DATABASE_URL": "${PROJECT_DB_URL}"
        }
      }
    }
  }
}

Текущая дата: вторник, 4 августа 2026 г.

Команды агентов

Команды агентов - это экспериментальная функция, которая позволяет нескольким экземплярам Claude Code совместно работать над задачей. По умолчанию она отключена.

Включение команд агентов

Включите с помощью переменной окружения или настроек:

• Team lead координирует общую задачу и делегирует подзадачи участникам команды
• Teammates работают независимо, каждый со своим окном контекста
• Общий список задач обеспечивает самокоординацию между участниками команды
• Используйте определения субагентов (.claude/agents/ или флаг --agents), чтобы задать роли и специализации участников команды

Режимы отображения

Agent Teams поддерживает два режима отображения, задаваемых флагом --teammate-mode:

# Use tmux split panes for teammate display
claude --teammate-mode tmux

# Explicitly use in-process mode
claude --teammate-mode in-process

Сценарии использования

• Масштабный рефакторинг, когда разные участники команды работают с разными модулями
• Параллельные code review и разработка
• Согласованные изменения сразу в нескольких файлах кодовой базы

Примечание: Agent Teams - экспериментальная возможность и может измениться в будущих релизах. Полный справочник см. на code.claude.com/docs/en/agent-teams.

Лучшие практики

Режим планирования

• ✅ Используйте для сложных многоэтапных задач
• ✅ Просматривайте планы перед утверждением
• ✅ Корректируйте планы при необходимости
• ❌ Не используйте для простых задач

Extended Thinking

• ✅ Используйте для архитектурных решений
• ✅ Используйте для решения сложных проблем
• ✅ Изучайте ход рассуждений
• ❌ Не используйте для простых запросов

Фоновые задачи

• ✅ Используйте для длительных операций
• ✅ Следите за прогрессом выполнения
• ✅ Корректно обрабатывайте сбои
• ❌ Не запускайте слишком много параллельных задач одновременно

Разрешения

• ✅ Используйте plan для code review (только чтение)
• ✅ Используйте default для интерактивной разработки
• ✅ Используйте acceptEdits для сценариев автоматизации
• ✅ Используйте auto для автономной работы с защитными ограничителями
• ❌ Не используйте bypassPermissions без крайней необходимости

Сессии

• ✅ Используйте отдельные сессии для разных задач
• ✅ Сохраняйте важные состояния сессий
• ✅ Удаляйте старые сессии
• ❌ Не смешивайте несвязанные задачи в одной сессии

Дополнительные ресурсы

Подробнее о Claude Code и связанных возможностях:

• Официальная документация по Interactive Mode
• Официальная документация по Headless Mode
• Справочник CLI
• Руководство по Checkpoints - управление сессиями и откат
• Slash Commands - справочник команд
• Руководство по Memory - постоянный контекст
• Руководство по Skills - автономные возможности
• Руководство по Subagents - делегирование задач
• Руководство по MCP - доступ к внешним данным
• Руководство по Hooks - событийная автоматизация
• Руководство по Plugins - комплектные расширения
• Официальная документация по Scheduled Tasks
• Официальная документация по Chrome Integration
• Официальная документация по Remote Control
• Официальная документация по Keybindings
• Официальная документация по Desktop App
• Официальная документация по Agent Teams

Последнее обновление: 4 августа 2026 г. Версия Claude Code: 2.1.220 Источники:

• https://code.claude.com/docs/en/settings
• https://code.claude.com/docs/en/sandboxing
• https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md
• https://code.claude.com/docs/en/model-config
• https://code.claude.com/docs/en/permission-modes Совместимые модели: Claude Fable 5, Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5