Выполнение вызовов инструментов из кода с помощью Code Mode

Как работает Code Mode

const files = await $`rg -l "function retryPolicy" src`.text();
const target = files.trim().split("\n")[0];
await edit(target, "maxAttempts: 3", "maxAttempts: 5");
({ edited: target, tests: $`npm test -- retryPolicy`.nothrow() });

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

• Изменение, которое повторяется во многих файлах
• Поиск, результаты которого нужно отфильтровать, прежде чем Claude их прочитает
• Несколько независимых команд, которые можно выполнять одновременно

Ограничения Code Mode

• Возобновление: сессию с Code Mode можно возобновить только в терминале и только с включённым Code Mode
• Авторежим: классификатор авторежима проверяет код, а не каждый вызов инструмента
• Долго выполняющийся код: если код не может выполняться в фоновом режиме, вы ждёте его завершения, и он останавливается через десять минут
• Хуки: вы можете увидеть отклонённые вызовы инструментов, когда хук PreToolUse не может запуститься или превышает таймаут, а также вывод кода, заблокированный хуком UserPromptSubmit
• Недоступные функции: вы не можете использовать Remote Control, Claude in Chrome или computer use
• Перенос сессии: вы не можете перенести сессию в приложение Desktop или превратить её в фоновую сессию, а /fork не может запустить фоновую копию

Требования

• Версия: Claude Code v2.1.323 или новее, на любом канале релизов. Более старая версия запускается без Code Mode — с причиной it isn't open to your account yet или без неё
• Аккаунт: подписка Claude или аккаунт Console. Использовать Code Mode через шлюз, Amazon Bedrock, Claude Platform on AWS, Google Cloud’s Agent Platform или Microsoft Foundry нельзя
• Организация: ваша организация не использует ни конфигурацию HIPAA, ни нулевое хранение данных
• Модель: Claude Opus 5.5, Sonnet 5.5, Haiku 5.5 или Fable 5.2
• Интерфейс: интерактивная сессия claude в терминале. Code Mode не работает с -p, Agent SDK, панелью VS Code, приложением Desktop и облачными сессиями
• Установка: нативная сборка Claude Code
• Windows: установлен Git for Windows

Попробуйте Code Mode

CLAUDE_CODE_EXPERIMENTAL_CODE_MODE=1 claude

$env:CLAUDE_CODE_EXPERIMENTAL_CODE_MODE = "1"
claude

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "1"
  }
}

Code Mode (experimental) is on · this session can be resumed only with Code Mode on

Read every Markdown file in this project and list the links that point to local files that don't exist.

Отключение Code Mode

Блокировка Code Mode для вашей организации

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_CODE_MODE": "0"
  }
}

Разрешения и долго выполняющийся код

Проверки разрешений

• Авторежим: классификатор проверяет каждый фрагмент кода перед его запуском, а не каждый вызов инструмента. Он не видит значения, вычисляемые во время выполнения, например путь, взятый из вывода поиска, поэтому сохраняйте правила или хуки для вызовов, которые вы обязаны контролировать. Вы по-прежнему можете получить запрос разрешения, когда новый код запускается, пока выполняется предыдущий
• Другие режимы разрешений: код запускается без проверки, а запрос разрешения появляется для каждого вызова инструмента, для которого он появился бы в этом режиме

Долго выполняющийся код

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

• Вы переключились на другой режим: нажимайте Shift+Tab, пока не вернётесь в режим, в котором начали
• Вы начали в другом режиме или выбрали сессию из списка claude --resume: если авторежим вам доступен, выйдите, а затем выполните claude --continue --permission-mode auto с включённым Code Mode
• Вы передали имена инструментов в --tools: начните заново в авторежиме без этого флага

Устранение неполадок

Code Mode не запускается

Запрос разрешения с обратным отсчётом

Claude Code will automatically block this request in 1:59, to avoid holding up an unattended session

Tool call refused by a hook

• the hook failed: при вызове из кода Claude ваш хук не смог запуститься, был принудительно завершён, завершился с кодом 126, 127 или кодом выше 128 либо вернул HTTP-ошибку или некорректный вывод. Исправьте хук
• the hook did not finish: ваш хук превысил таймаут при вызове из кода Claude или при любом другом вызове инструмента после того, как Claude выполнил код в сессии. Увеличьте timeout хука

Вывод кода, задержанный хуком

Связанные ресурсы

• Режимы разрешений: сравнение авторежима с режимами, которые запрашивают подтверждение
• Справочник по хукам: написание хуков PreToolUse и UserPromptSubmit
• Управляемые настройки: применение единой конфигурации во всей организации