Справочник инструментов

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

Claude Code имеет доступ к набору встроенных инструментов, которые помогают ему понять и изменить вашу кодовую базу. Названия инструментов — это точные строки, которые вы используете в правилах разрешений, списках инструментов подагентов и сопоставителях hooks.

Чтобы контролировать, какие инструменты может использовать Claude и когда он запрашивает разрешение, настройте правила разрешений в ваших параметрах, hooks или списке инструментов подагента. См. Настройка инструментов с помощью правил разрешений и hooks для каждого места, которое принимает имя инструмента.

Чтобы добавить пользовательские инструменты, подключите MCP сервер. Чтобы расширить Claude переиспользуемыми рабочими процессами на основе подсказок, напишите skill, который работает через существующий инструмент Skill вместо добавления новой записи инструмента.

Настройка инструментов с правилами разрешений и hooks

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

• в permissions.allow и permissions.deny в параметрах и интерфейсе /permissions
• в флагах CLI --allowedTools и --disallowedTools
• в опциях Agent SDK allowedTools и disallowedTools
• в frontmatter allowed-tools skill
• в условии if hook

Все они принимают один и тот же формат правил: ToolName(specifier). Спецификатор зависит от инструмента, и несколько инструментов используют один формат:

Инструменты, не указанные здесь, такие как ExitPlanMode или ShareOnboardingGuide, принимают только простое имя инструмента без спецификатора.

Правило разрешения Edit(...) также предоставляет доступ на чтение к тому же пути, поэтому вам не нужно соответствующее правило Read(...). Правило запрета Read(...) также блокирует инструменты Edit и Write на том же пути, включая создание нового файла там, потому что оба инструмента изменяют содержимое, которое Claude должен иметь возможность прочитать обратно. Проверка запрета Read требует Claude Code v2.1.208 или более поздней версии при редактировании, и v2.1.228 или более поздней версии при записи.

Поля matcher hook используют простые имена инструментов, а не формат в скобках. Смотрите шаблоны matcher для правил сопоставления. Для имён полей, которые каждый инструмент передаёт в tool_input в hooks, смотрите справочник входных данных PreToolUse.

Поведение инструмента Agent

Инструмент Agent запускает подагента в отдельном окне контекста. Подагент самостоятельно выполняет свою задачу, а затем возвращает один текстовый результат в родительский диалог. Родитель не видит промежуточные вызовы инструментов или выходные данные подагента, только этот финальный результат. Если включены команды агентов, вызов с параметром name может запустить товарища по команде, который отправляет отчет через сообщения команды, а не путем возврата результата.

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

Тот же инструмент Agent также запускает разветвленные подагенты везде, где включен режим fork. Разветвление наследует полный родительский диалог вместо начала с нуля, работает в фоновом режиме, кроме случаев, которые остаются на переднем плане, и по-прежнему выводит запросы разрешений в вашем терминале. Остальная часть этого раздела описывает подагентов без разветвления.

Какие инструменты может использовать подагент без разветвления, зависит от полей tools и disallowedTools в определении подагента:

• Ни одно поле не установлено: подагент наследует каждый инструмент, доступный подагентам.
• Только tools: подагент получает только перечисленные инструменты.
• Только disallowedTools: подагент получает каждый инструмент родителя, кроме перечисленных.
• Оба установлены: disallowedTools имеет приоритет. Инструмент, указанный в обоих, удаляется.

В каждом случае разрешенный набор ограничен инструментами, доступными подагентам: инструмент, который недоступен подагентам, никогда не предоставляется, даже если указан в tools. Где условия в записи таблицы инструментов SubagentHandback выполняются, Claude Code также предоставляет подагенту этот инструмент, даже если вы его опустите в tools или указали в disallowedTools.

Если каждая запись в списке tools подагента не соответствует используемому инструменту, инструмент Agent обычно возвращает ошибку с названием записей вместо запуска подагента; см. Agent would be spawned with zero tools для сообщения и способов исправления каждой записи.

Запуск подагента сам по себе не запрашивает разрешение. Claude Code проверяет вызовы инструментов подагента в соответствии с вашими правилами разрешений по мере его работы.

Где вы видите запросы разрешений подагента, зависит от того, работает ли он на переднем плане или в фоновом режиме. Claude Code запускает подагентов в фоновом режиме по умолчанию, кроме случаев, которые работают на переднем плане.

• Подагенты на переднем плане показывают те же запросы разрешений, которые вы видели бы в основном диалоге, в момент каждого вызова инструмента.
• Подагенты в фоновом режиме выводят запросы разрешений в вашу основную сессию начиная с версии 2.1.186. Запрос указывает, какой подагент запрашивает, и нажатие Esc отклоняет этот вызов инструмента без остановки подагента. До версии 2.1.186 подагенты в фоновом режиме автоматически отклоняли любой вызов инструмента, который иначе запросил бы разрешение, и продолжали работу без этого инструмента.

Чтобы ограничить то, что может достичь подагент с самого начала, сузьте его поле tools, например исключив Bash из списка, или установите правила отказа в ваших настройках.

Поведение инструмента AskUserQuestion

Claude использует AskUserQuestion для задания вам вопросов с несколькими вариантами ответов, когда ему требуется решение или уточнение. Ответьте, выбрав вариант, или введите свой текст через строку Other или поле примечаний.

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

Тайм-аут автоматического продолжения вопроса

Вопросы остаются открытыми до тех пор, пока вы на них не ответите. Если вы хотите, чтобы оставленный без ответа вопрос в конечном итоге закрылся и позволил Claude продолжить без вас, установите параметр askUserQuestionTimeout на 60s, 5m или 10m либо в вашем пользовательском файле settings.json, либо из строки Question auto-continue timeout в /config.

После того как вопрос остается без ввода в течение этого времени, диалог закрывается автоматически: он отправляет все уже выбранные вами варианты и сообщает Claude, что вы можете быть отвлечены от клавиатуры, поэтому Claude действует по собственному усмотрению и может переспросить позже. Вы видите обратный отсчет в течение последних 20 секунд. Нажмите любую клавишу, чтобы перезагрузить таймер; на терминалах, которые сообщают о фокусе, переключение на окно также перезагружает его.

Тайм-аут применяется только к вопросам с несколькими вариантами ответов AskUserQuestion; запросы разрешений, включая одобрение плана, никогда не разрешаются автоматически при неактивности.

Поведение инструмента Bash

Инструмент Bash запускает каждую команду в отдельном процессе.

Что сохраняется между командами

• Когда Claude запускает cd в основной сессии, новый рабочий каталог переносится на последующие команды Bash, пока он остаётся внутри каталога проекта или дополнительного рабочего каталога, который вы добавили с помощью --add-dir, /add-dir или additionalDirectories в параметрах. Это включает команды, которые Claude запускает в ответ на ваши последующие сообщения.
  • Сессии подагентов никогда не переносят изменения рабочего каталога.
  • Если cd приводит за пределы этих каталогов, Claude Code сбрасывает на каталог проекта и добавляет Shell cwd was reset to <dir> к результату инструмента.
  • Чтобы отключить этот перенос, чтобы каждая команда Bash начиналась в каталоге проекта, установите CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1.
• Переменные окружения не сохраняются. export в одной команде не будет доступен в следующей.
• Псевдонимы и функции оболочки, определённые в файле запуска оболочки, доступны. При запуске сессии Claude Code загружает ~/.zshrc, ~/.bashrc или ~/.profile в зависимости от вашей оболочки, захватывает полученные псевдонимы, функции и параметры оболочки и применяет их к каждой команде Bash.

Активируйте виртуальное окружение или окружение conda перед запуском Claude Code. Чтобы переменные окружения сохранялись между командами Bash, установите CLAUDE_ENV_FILE на скрипт оболочки перед запуском Claude Code или используйте hook SessionStart для его динамического заполнения.

Ограничения по времени ожидания и выводу

Каждая команда выполняется с ограничением по времени, и Claude управляет им: когда ему требуется больше времени, чем по умолчанию для команды, он передаёт параметр timeout с этим вызовом — вы никогда не устанавливаете ограничение по времени для отдельной команды. Две переменные окружения ограничивают то, что получает Claude:

• BASH_DEFAULT_TIMEOUT_MS — значение по умолчанию, когда Claude не передаёт ограничение по времени; две минуты из коробки
• BASH_MAX_TIMEOUT_MS — с значением по умолчанию устанавливает потолок, который ограничивает всё, что запрашивает Claude: эффективный потолок — это больший из двух, десять минут из коробки

Ограничения по выводу

Claude Code передаёт вывод команды в рабочий файл по мере выполнения команды; команда, выход которой превышает 5 ГБ, прерывается. Когда команда завершается, Claude Code читает вывод обратно из этого файла, вплоть до окна чтения, описанного ниже. Сколько вывода достигает Claude встроенным образом, зависит от того, рассматривает ли Claude Code результат как ошибку:

Команда, которая выходит с кодом 1, считается действительным результатом для инструмента Bash только когда Claude Code распознаёт код выхода 1 как благоприятный результат для этой команды: grep, rg, egrep, fgrep, find, diff, test и [, плюс git diff и git grep. Каждая другая команда, которая выходит с кодом 1, считается ошибкой, даже когда код выхода 1 — это благоприятный информационный результат: нет совпадений для pgrep и jq -e, файлы, которые отличаются для cmp.

BASH_MAX_OUTPUT_LENGTH устанавливает, сколько символов вывода Claude Code читает обратно из рабочего файла в результат команды: 30 000 по умолчанию, вплоть до жёсткого потолка в 150 000. Увеличьте его, когда ваши команды регулярно переполняют это окно, например, подробная сборка или полный журнал набора тестов. Увеличение его расширяет окно чтения, которое также является окном, из которого вырезается выдержка команды с ошибкой. Оно не повышает встроенные потолки: действительный результат сверх встроенного потолка поступает как путь файла плюс предпросмотр независимо от этой переменной.

Чтобы изменить, сколько действительного результата Claude получает встроенным образом, установите параметр bashOutputMaxChars вместо этого, вплоть до 128 000 символов. Он определяет встроенный потолок и окно чтения вместе, и Claude Code затем игнорирует BASH_MAX_OUTPUT_LENGTH. Требуется Claude Code v2.1.261 или позже.

Фоновые команды

Для долгоживущих процессов, таких как серверы разработки или сборки с отслеживанием, Claude может установить run_in_background: true для запуска команды как фоновой задачи и продолжения работы во время её выполнения. Перечислите и остановите фоновые задачи с помощью /tasks. После того как вы остановите одну там или из подключённого клиента, такого как настольное приложение, Claude переходит дальше вместо ожидания. Если подагент запустил команду, это подагент, который переходит дальше.

Команда, которую запустил подагент переднего плана, останавливается, когда этот подагент даёт свой окончательный ответ. Команда, которую запустила основная беседа или фоновый подагент, продолжает работать после окончательного ответа. В неинтерактивном режиме с флагом -p фоновые команды заканчиваются вскоре после окончательного результата запуска.

Когда команда достигает своего ограничения по времени без завершения, Claude Code перемещает её в фон вместо остановки, если только команда не начинается с sleep. Claude продолжает работать, пока команда продолжает выполняться. Claude Code применяет те же правила жизненного цикла к перемещённой команде, как и к любой другой фоновой команде, поэтому она всё ещё заканчивает команду подагента переднего плана при окончательном ответе этого подагента. Установка CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1 отключает автоматическое перемещение в фон вместе с остальной функциональностью фоновых задач.

Результат команды, перемещённой в фон, указывает, что произошло:

• Когда ограничение по времени запускает перемещение, результат сообщает об этом явно: Command did not complete within its 120s timeout and was moved to the background, с секундами, соответствующими применённому ограничению по времени, за которым следует ID задачи и путь файла, в который записывается вывод.
• cd, pushd, popd или chdir внутри команды, которая перемещается в фон, никогда не переносятся: результат указывает Session cwd remains <dir>; directory changes made by the backgrounded command do not apply to subsequent commands., поэтому Claude не действует на изменение каталога, которое не произошло.

Ограничение памяти на Linux и WSL

На Linux и WSL установите CLAUDE_CODE_TOOL_MEMORY_LIMIT на размер, такой как 4G, чтобы ограничить память, которую могут использовать команды Bash, PowerShell и инструмента Monitor, чтобы одна неконтролируемая сборка не отняла память, которая нужна остальной сессии. Требуется Claude Code v2.1.233 или позже. До v2.1.246 команды инструмента Monitor выполнялись вне ограничения.

• Напишите размер как количество байтов или с суффиксом K, M, G или T. Установите 0, off, false, no или none, чтобы отключить ограничение. Claude Code игнорирует любое другое значение, которое он не может прочитать как размер, например 4e9.
• Claude Code считает все команды Bash, PowerShell и Monitor сессии в одно ограничение, а не каждую команду отдельно.
• Claude Code применяет ограничение с помощью cgroup памяти. Когда он не может установить cgroup, команды выполняются без ограничения, и журнал отладки из claude --debug указывает почему.
• После того как первый процесс, который Claude Code запустил, включил ограничение или отключил его из-за значения off или неудачной установки cgroup, Claude Code удерживает этот результат до перезапуска. Чтобы применить изменённое или удалённое значение или исправленную установку, запустите claude снова.
• Когда команды не могут оставаться в пределах ограничения, ядро убивает команду, и ничто в её результате не называет ограничение.

Claude Code также может считать другие виды процессов, которые он запускает, в одно и то же ограничение. Установите CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE на список, разделённый запятыми, видов, которые нужно исключить из ограничения; Claude Code применяет ограничение к каждому виду, который не в вашем списке. Установите его на none, чтобы ограничить каждый вид, или на all-new, чтобы ограничить только команды Bash, PowerShell и Monitor tool. Требуется Claude Code v2.1.246 или позже. Виды, которые вы можете назвать:

• mcp: локальные серверы MCP
• lsp: языковые серверы
• hooks: команды hook
• plugin: команды, которые запускают плагины
• helper: собственные вспомогательные команды Claude Code, такие как git
• agent: дочерние процессы Claude Code, такие как товарищи агентов

Что бы вы ни указали, применяются эти правила:

• Неизвестные имена: Claude Code игнорирует имена, которые он не распознаёт
• Bash, PowerShell и Monitor: Claude Code держит команды Bash, PowerShell и Monitor tool под ограничением, что бы вы ни указали
• Переменная не установлена: Claude Code берёт набор других ограниченных видов из конфигурации, которую Anthropic доставляет с сервера, и этот набор может меняться со временем, поэтому установите переменную, когда вам нужен набор, который не меняется
• Hooks с контролем разрешений: даже со всеми видами под ограничением, Claude Code исключает из ограничения hook, который может заблокировать или изменить результат действия, и любой сервер MCP, который такой hook вызывает, поэтому ядро, убивающее hook с контролем разрешений, не может разрешить действие, которое он блокировал

Поведение инструмента Edit

Инструмент Edit выполняет точную замену строк. Он принимает old_string и new_string и заменяет первую на вторую. Он не использует регулярные выражения или нечеткое совпадение.

Для применения редактирования должны пройти три проверки. Перед любой из них путь, соответствующий правилу отказа Read, отклоняется, включая создание нового файла там. Отказ требует Claude Code v2.1.208 или позже.

• Read-before-edit: Claude читает файл в текущем разговоре перед его редактированием, и чтение, прерванное уведомлением PARTIAL view, не учитывается. Claude Opus 4.6, Claude Haiku 4.5 и более старые модели всегда требуют чтения. Более новые модели могут редактировать непрочитанный файл при чтении, когда чтение не требует запроса разрешения и инструмент Read доступен.
• Match: old_string должна появиться в файле ровно так, как написано. Даже одного символа пробела или различия в отступе достаточно, чтобы не совпасть.
• Uniqueness: old_string должна появиться ровно один раз. Когда она появляется более одного раза, Claude либо предоставляет более длинную строку с достаточным окружающим контекстом, чтобы определить одно вхождение, либо устанавливает replace_all: true для замены всех вхождений.

Файл, который изменился на диске после последнего чтения Claude, все еще может быть отредактирован, когда old_string точно совпадает с текущим содержимым однозначно и Claude Code может прочитать файл без запроса. Сопоставление с текущим содержимым файла обеспечивает безопасность, и результат отмечает, что файл содержит другие изменения, поэтому Claude перечитывает его перед редактированиями, которые зависят от окружающего содержимого. В любом другом случае, например при устаревшей old_string или той, которая совпадает более одного раза без replace_all, Claude читает файл снова перед редактированием. Расслабленная обработка непрочитанных и измененных файлов требует Claude Code v2.1.208 или позже; до этого Claude Code отказывал в любом редактировании файла, который он не читал в разговоре или который изменился на диске после чтения.

Просмотр файла с помощью Bash также удовлетворяет требованию read-before-edit, когда команда — это cat, nl, bat, batcat, head, tail, sed -n 'X,Yp', grep, egrep, fgrep или rg на одном файле без конвейеров или перенаправлений. Выходные данные конвейера и другие команды Bash не учитываются при проверке read-before-edit.

Просмотр файла с помощью Bash влияет только на право редактирования, а не на разрешения. См. Правила разрешений Read и Edit для информации о том, какие команды Bash охватывают ваши правила отказа Read и Edit.

Поведение инструмента EndConversation

Инструмент EndConversation завершает текущую сессию. Claude использует его только в двух ситуациях:

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

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

После завершения Claude интерактивной сессии сессия блокируется. Новые запросы и большинство команд возвращают Claude ended this conversation. Start a new session (or /clear) to continue., и только /clear, /resume, /help, /exit и /feedback продолжают работать. Claude Code записывает завершение в стенограмму сессии, поэтому возобновление завершенной сессии восстанавливает блокировку; история сессии не удаляется.

Возобновление завершенной сессии в неинтерактивном режиме с флагом -p вызывает ошибку и выходит с кодом 1, поэтому скрипт не читает завершенный запуск как успех.

Инструмент никогда не запрашивает разрешение, и PreToolUse hooks не запускаются для него. Пока остается любой другой инструмент, вы не можете его заблокировать: правила отказа и запроса, называющие EndConversation, не имеют эффекта, и ни --disallowedTools, ни список --tools не могут его удалить. Исключение преднамеренно: инструмент ничего не делает, кроме завершения разговора, никогда не читая и не изменяя файлы или данные, и такая защита работает только если сессия, к которой она применяется, не может ее отключить. Когда ваши правила отказа удаляют все остальные инструменты и также совпадают с EndConversation, как это делает "*", Claude Code удаляет его также, а не оставляет его единственным инструментом, если правило разрешения явно не называет EndConversation. Список отказов, который удаляет все остальные инструменты без совпадения с EndConversation, оставляет его на месте.

Подагенты никогда не получают инструмент. Фоновые задачи, которые совместно используют список инструментов основного разговора, видят его, но вызов его там ничего не завершает.

Инструмент появляется только когда выполняются все следующие условия:

• Версия: Claude Code v2.1.213 или позже.
• Модель: модель сессии — Claude Opus 4.8, Claude Sonnet 5, Claude Fable 5 или более поздняя версия одного из этих семейств.
• Поверхность: интерактивная сессия терминала, включая сессию claude в интегрированном терминале IDE, что является тем, как плагин JetBrains его запускает. Другие поверхности не включают инструмент, такие как:
  • неинтерактивные запуски -p
  • сессии через пакеты TypeScript и Python Agent SDK
  • панель VS Code extension, которая поставляется с собственным CLI
  • GitHub Actions
  • облачные сессии
• Режим запуска: не сессия --bare. Режим bare загружает только инструменты shell и файлов, поэтому инструмент никогда там не регистрируется.
• Поставщик: недоступно на Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform или Microsoft Foundry, или на сессиях, вошедших через облачный шлюз.

Поведение инструмента Glob

Инструмент Glob находит файлы по шаблону имени. На Windows он входит в набор инструментов по умолчанию. На macOS, Linux и WSL Claude Code исключает Glob и Grep из набора инструментов по умолчанию, и Claude выполняет поиск с помощью find и grep через инструмент Bash. В оболочке Claude эти две команды запускают встроенные версии bfs и ugrep, и поиск достигает ваших hooks и правил разрешений как вызовы Bash.

На macOS, Linux и WSL вы получаете инструменты Glob и Grep обратно в этих случаях:

• Вы указываете Glob или Grep в --tools или --allowedTools при запуске сеанса или в эквивалентных параметрах Agent SDK. С --tools вы получаете те, которые указали, а указание любого инструмента в --allowedTools восстанавливает оба. Правило разрешения в файле параметров не имеет этого эффекта.
• Правило разрешений deny, флаг --disallowedTools или --restricted удаляет Bash из сеанса.
• Подагент указывает Glob или Grep в своем поле tools и исключает Bash. Указанные инструменты возвращаются только для этого подагента или для всего сеанса, когда он запускается как основной агент сеанса через --agent или параметр agent.

Glob поддерживает стандартный синтаксис glob, включая ** для рекурсивного сопоставления каталогов:

• **/*.js соответствует всем файлам .js на любой глубине
• src/**/*.ts соответствует всем файлам .ts в каталоге src/
• *.{json,yaml} соответствует файлам .json и .yaml в текущем каталоге

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

Glob не учитывает .gitignore по умолчанию, поэтому он находит файлы, игнорируемые git, наряду с отслеживаемыми. Это отличается от Grep, который пропускает файлы, игнорируемые git. Чтобы заставить Glob учитывать .gitignore, установите CLAUDE_CODE_GLOB_NO_IGNORE=false перед запуском Claude Code.

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

Значение pattern или path, содержащее нулевой байт, возвращает ошибку с просьбой к Claude удалить его.

Поведение инструмента Grep

Инструмент Grep выполняет поиск в содержимом файлов по шаблонам. Если Glob находит файлы по имени, то Grep находит строки внутри них. На macOS, Linux и WSL инструмент Grep отсутствует по умолчанию при тех же условиях, что и Glob. Информацию о том, когда оба инструмента доступны, см. в разделе Поведение инструмента Glob.

Grep построен на основе ripgrep и использует синтаксис регулярных выражений ripgrep, а не POSIX grep. Шаблоны, содержащие метасимволы регулярных выражений, требуют экранирования. Например, поиск interface{} в коде Go требует шаблона interface\{\}.

Шаблон, glob или тип файла, который ripgrep отклоняет, возвращает ошибку, которая включает диагностику ripgrep, чтобы Claude мог исправить входные данные и выполнить поиск снова. До версии 2.1.208 Claude Code сообщал об отклоненном входе как No files found вместо ошибки, даже если искомый текст существовал в целевых файлах.

Три режима вывода контролируют, что возвращается:

• files_with_matches: только пути файлов, без содержимого строк. Это режим по умолчанию.
• content: совпадающие строки с файлом и номером строки. Когда параметр offset инструмента указывает за последнее совпадение для шаблона, который имеет совпадения, Grep возвращает No entries at this offset, поэтому Claude расширяет или сбрасывает смещение вместо того, чтобы заключить, что шаблон не совпадает.
• count: количество совпадений на файл, за которым следует итого по всем совпадающим файлам. Итого охватывает каждое совпадение, даже когда параметры head_limit или offset инструмента усекают перечисленные записи для каждого файла. До версии 2.1.208 итого суммировало только перечисленные записи.

Claude может ограничить результаты по файлу с помощью параметра glob, такого как **/*.tsx, или по языку с помощью параметра type, такого как py или rust. По умолчанию шаблоны совпадают в пределах одной строки. Claude может установить multiline: true для совпадения через границы строк.

Grep соблюдает .gitignore, поэтому файлы, игнорируемые git, пропускаются. Для поиска в файле, игнорируемом git, Claude передает его путь напрямую.

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

Поведение инструмента LSP

Инструмент LSP предоставляет Claude анализ кода от работающего языкового сервера. После каждого редактирования файла он автоматически сообщает об ошибках типов и предупреждениях, чтобы Claude мог исправить проблемы без отдельного этапа сборки. Claude также может вызвать его напрямую для навигации по коду:

• Перейти к определению символа
• Найти все ссылки на символ
• Получить информацию о типе в позиции
• Список символов в файле
• Поиск символа по имени во всём рабочем пространстве
• Найти реализации интерфейса
• Отследить иерархии вызовов

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

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

Инструмент Monitor

Инструмент Monitor позволяет Claude наблюдать за чем-либо в фоновом режиме и реагировать при изменении, не прерывая разговор. Попросите Claude:

• Отслеживать файл журнала и отмечать ошибки по мере их появления
• Опрашивать PR или задачу CI и сообщать об изменении статуса
• Наблюдать за каталогом на предмет изменений файлов
• Отслеживать вывод любого долгоживущего скрипта, на который вы его направите
• Подключиться к потоку WebSocket и сообщать каждое сообщение по мере его поступления

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

Вы продолжаете работать в одном сеансе, а Claude вмешивается при поступлении события.

Каждое наблюдение, которое запускает Claude, имеет крайний срок: 5 минут по умолчанию, максимум 30 минут и максимум 10 минут в неинтерактивном запуске с одним приглашением с флагом -p.

По истечении крайнего срока наблюдение завершается. Claude получает одно уведомление, поэтому оно может снова запустить наблюдение, если оно всё ещё необходимо.

Остановите монитор, попросив Claude отменить его или завершив сеанс. Когда вы останавливаете подагента, который запустил мониторы, например из /tasks, эти мониторы останавливаются вместе с ним.

Когда Monitor запускает команду, он использует те же правила разрешений, что и Bash, поэтому шаблоны allow и deny, которые вы установили для Bash, применяются и здесь. Пока режим auto активен, Claude Code откладывает правила разрешений, которые называют сам Monitor, наряду с другими широкими правилами разрешений, которые он отбрасывает, поэтому классификатор проверяет команды Monitor так же, как он проверяет команды Bash.

Источник WebSocket имеет собственное приглашение на одобрение, которое классификатор также решает в режиме auto.

Инструмент недоступен на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry. Он также недоступен, когда установлены DISABLE_TELEMETRY или CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC.

Плагины могут объявлять мониторы, которые запускаются автоматически при активации плагина, вместо того чтобы просить Claude запустить их. См. мониторы плагинов.

WebSocket source

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

• Текстовые сообщения: каждое становится одним событием, даже если сообщение занимает несколько строк.
• Двоичные сообщения: не передаются. Claude получает строку-заполнитель, такую как [binary frame, 512 bytes].
• Сообщения размером более 1 МиБ: наблюдение завершается, поэтому подпишитесь на отфильтрованный поток, если он существует.
• Закрытие сокета: наблюдение завершается и Claude получает код закрытия.

Наблюдение WebSocket принимает входные данные ws вместо command, и один вызов Monitor не может объединять оба. Входные данные ws имеют два поля:

Крайний срок timeout_ms применяется и к наблюдению WebSocket: наблюдение завершается в крайний срок, и TaskStop отменяет его раньше.

Открытие WebSocket запрашивает одобрение; в режиме auto классификатор решает вместо этого. Приглашение не предлагает опцию пропустить будущие приглашения для одного хоста.

Claude Code отклоняет URL-адреса, указывающие на приватный, link-local или адрес облачных метаданных, включая имена хостов, которые разрешаются в один. Он также отклоняет хосты в sandbox.network.deniedDomains, и когда allowManagedDomainsOnly установлен в управляемых параметрах, любой хост вне управляемого списка разрешений.

Поведение инструмента NotebookEdit

NotebookEdit изменяет Jupyter notebook по одной ячейке за раз, нацеливаясь на ячейки по их cell_id. Он не выполняет замену строк по всему notebook так, как Edit делает на простых файлах.

Три режима редактирования контролируют, что происходит с целевой ячейкой:

• replace: перезаписать источник ячейки. Это значение по умолчанию.
• insert: добавить новую ячейку после целевой. Без cell_id новая ячейка переходит в начало notebook. Требует установки cell_type на code или markdown.
• delete: удалить целевую ячейку.

Правила разрешений используют формат пути Edit(...). Правило, такое как Edit(notebooks/**), охватывает вызовы NotebookEdit на файлы в этом каталоге.

Инструмент PowerShell

Инструмент PowerShell позволяет Claude выполнять команды PowerShell в собственном режиме. В Windows это означает, что команды выполняются в PowerShell вместо маршрутизации через Git Bash. Доступность инструмента зависит от вашей платформы:

• Windows без Git Bash: инструмент включен автоматически.
• Windows с установленным Git Bash: инструмент включен по умолчанию для учетных записей claude.ai и Console; установите CLAUDE_CODE_USE_POWERSHELL_TOOL=1 для включения в сеансах Amazon Bedrock, Google Cloud's Agent Platform и Microsoft Foundry, или 0 для отключения.
• Linux, macOS и WSL: инструмент является дополнительным.

Ваши PreToolUse hooks получают строку команды инструмента в tool_input.command с теми же полями, что и инструмент Bash.

Сопоставьте Bash|PowerShell в hooks, которые проверяют команды оболочки; раздел PowerShell hook input объясняет, почему сопоставления только Bash недостаточно.

Включение инструмента PowerShell

Установите CLAUDE_CODE_USE_POWERSHELL_TOOL=1 в вашей среде или в settings.json:

{
  "env": {
    "CLAUDE_CODE_USE_POWERSHELL_TOOL": "1"
  }
}

В Windows установите переменную на 0 для отключения инструмента. В Linux, macOS и WSL инструмент требует PowerShell 7 или более поздней версии: установите pwsh и убедитесь, что он находится в вашем PATH.

В Windows Claude Code автоматически обнаруживает pwsh.exe для PowerShell 7+ с резервным вариантом powershell.exe для PowerShell 5.1. Когда инструмент включен, Claude рассматривает PowerShell как основную оболочку. Инструмент Bash остается доступным для POSIX-скриптов при установленном Git Bash.

Claude Code запускает PowerShell с -ExecutionPolicy Bypass только в области процесса, поэтому скрипты .ps1 и импорт модулей работают на установках Windows по умолчанию без изменения политики машины. Обход области процесса не переопределяет Group Policy MachinePolicy или UserPolicy, поэтому политики предприятия по-прежнему применяются. Чтобы вместо этого соблюдать эффективную политику выполнения машины, установите CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY=1.

Выбор оболочки в параметрах, hooks и skills

Три дополнительных параметра контролируют, где используется PowerShell:

• "defaultShell": "powershell" в settings.json: маршрутизирует интерактивные команды ! через PowerShell. Требует включения инструмента PowerShell.
• "shell": "powershell" на отдельных command hooks: запускает этот hook в PowerShell. Hooks запускают PowerShell напрямую, поэтому это работает независимо от CLAUDE_CODE_USE_POWERSHELL_TOOL.
• shell: powershell в skill frontmatter: запускает блоки !`command` в PowerShell. Требует включения инструмента PowerShell.

То же поведение сброса рабочего каталога основного сеанса, описанное в разделе инструмента Bash, применяется к командам PowerShell, включая переменную среды CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR.

Начиная с v2.1.196, код выхода 1 из grep, rg, egrep, fgrep, findstr и git grep означает отсутствие совпадений. Код выхода 1 из git diff означает наличие различий. Ни один из этих результатов не сообщается Claude как ошибка команды. Для robocopy коды выхода от 0 до 7 являются информационными результатами, такими как скопированные файлы или обнаруженные дополнительные файлы. Коды выхода 8 или выше считаются ошибками.

Кодировка Windows и коды выхода

В Windows следующие поведения кодировки PowerShell и кодов выхода требуют Claude Code v2.1.214 или более поздней версии:

• Перенаправление с > и >> записывает файлы UTF-8 в PowerShell 5.1
• Claude Code кодирует текст, переданный в стандартный ввод собственной команды, как UTF-8
• Claude Code захватывает вывод ошибок без последовательностей экранирования ANSI
• Команда, дочерний процесс которой ожидает стандартного ввода, получает конец файла вместо зависания
• Код выхода 1 из where.exe означает отсутствие совпадения, а из fc.exe и diff.exe означает, что файлы отличаются, поэтому когда команда выдает вывод, Claude Code рассматривает этот код выхода как действительный отрицательный ответ, а не ошибку команды. Claude Code по-прежнему сообщает о подавленной форме, такой как where.exe /Q или перенаправление в $null, как об ошибке при коде выхода 1

До v2.1.214 > в PowerShell 5.1 записывал файлы UTF-16LE, не-ASCII входные данные, переданные по конвейеру, поступали как ?, и скрипты Python могли аварийно завершиться с UnicodeEncodeError при выводе символов не-ASCII.

Ограничения предварительного просмотра

Инструмент PowerShell имеет следующие известные ограничения во время предварительного просмотра:

• Профили PowerShell не загружаются
• В Windows sandboxing не поддерживается

Поведение инструмента Read

Инструмент Read принимает путь к файлу и возвращает его содержимое с номерами строк. Claude инструктирован всегда передавать абсолютные пути.

По умолчанию Read возвращает файл с начала. Когда чтение всего файла превышает лимит токенов, Read возвращает первую страницу с уведомлением PARTIAL view, которое сообщает Claude, сколько файла он получил и как прочитать больше с помощью offset и limit. Чтение, которое передает явный offset или limit и все еще превышает лимит токенов, возвращает ошибку.

Чтение с явным limit останавливается, как только выбранные строки превышают то, что лимит токенов когда-либо мог бы вместить, и возвращает ошибку без загрузки остальной части диапазона. Ошибка сообщает Claude использовать меньший limit или искать конкретное содержимое с помощью Grep вместо этого, когда одна строка такая большая. До версии 2.1.208 Claude Code загружал весь диапазон в память перед его отклонением, поэтому чтение файла с чрезвычайно длинной одной строкой могло привести к нехватке памяти.

Чтение пустого файла возвращает уведомление о том, что файл существует, но его содержимое пусто, а offset за последней строкой возвращает уведомление, дающее количество строк файла. До версии 2.1.208 чтение пустого файла возвращало уведомление о конце вместо этого.

Read обрабатывает несколько типов файлов помимо простого текста:

• Изображения: PNG, JPG и другие форматы изображений возвращаются как визуальное содержимое, которое Claude может видеть, а не как необработанные байты. Claude Code изменяет размер и переупаковывает большие изображения, чтобы они соответствовали ограничениям размера изображения модели перед отправкой, поэтому Claude может видеть уменьшенную версию большого снимка экрана. Начиная с версии 2.1.196, изображение, которое все еще больше 500 КБ после этого изменения размера, переупаковывается как JPEG с пониженным качеством с неизменными размерами пикселей. Если Claude пропустит мелкие детали на уровне пикселей в большом изображении, попросите его сначала обрезать интересующий регион, например с помощью ImageMagick через Bash.
• PDF-файлы: Claude читает короткие файлы .pdf целиком. Для PDF-файлов длиннее 10 страниц он читает диапазоны с параметром pages, таким как "1-5", до 20 страниц за раз.
• Jupyter notebooks: файлы .ipynb возвращают все ячейки с их выводом, включая код, markdown и визуализации. Claude Code отказывается читать файл notebook размером более 100 МБ; ошибка сообщает Claude, как прочитать часть notebook вместо этого, например срез ячеек, с помощью команды shell.

Read читает только файлы, а не директории. Claude выводит содержимое директории с помощью команды shell, такой как ls.

Поведение инструмента SendFeedback

Отзыв, написанный Claude, — это отчет об обратной связи о Claude Code, который Claude пишет для вас. Для этого требуется Claude Code версии 2.1.238 или более поздней. Claude Code сохраняет каждый черновик на вашем компьютере в папке ~/.claude/feedback/drafts/, и ничего не попадает в Anthropic до тех пор, пока вы его не отправите. Claude создает черновик с помощью инструмента SendFeedback в следующих случаях:

• Инструмент или команда продолжает давать сбой
• Он не может помочь с тем, что вы просили
• Вы указываете на ошибку, которую он допустил, или он сам ее замечает
• Вы просите его отправить отзыв

Что вы видите, когда Claude создает черновик

После того как Claude ставит черновик в очередь, над вашей подсказкой появляется карточка с названием черновика. Нажмите 1, чтобы просмотреть черновик, нажмите 2 дважды, чтобы отправить его как есть, или нажмите 0, чтобы отклонить его. Отклоненный черновик остается в вашей очереди. После того как вы отклоните карточку, Claude Code спросит, хотите ли вы отключить функцию отзывов, написанных Claude. Он перестанет спрашивать после того, как вы дважды откажетесь.

По умолчанию в сеансе отображается не более трех карточек; Anthropic может изменить это ограничение с сервера без выпуска новой версии. После достижения лимита и всякий раз, когда вы устанавливаете feedbackDrafts на quiet, вы видите только количество черновиков в очереди в нижнем колонтитуле подсказки.

Просмотр и редактирование черновика

Запустите /feedback без аргументов, чтобы открыть вашу очередь. Она содержит список всех черновиков в очереди из всех ваших сеансов, включая черновики, карточки которых вы отклонили или никогда не видели. Выберите черновик, чтобы открыть его для просмотра, где вы можете:

• Редактировать название, область и детали
• Установить Send transcript на yes или no. Когда стенограмма сеанса, в котором Claude поставил черновик в очередь, все еще доступна, она по умолчанию установлена на yes, что отправляет эту беседу в Anthropic; no отправляет только отчет
• Отправить черновик, удалить его или оставить в очереди на потом

Чтобы вместо этого написать отчет самостоятельно, нажмите w для стандартного диалога обратной связи. /feedback с текстом после него и /bug открывают этот диалог напрямую.

Отправка черновика

Когда вы отправляете черновик, Claude Code отправляет его так же, как отчет /feedback, с тем же сроком хранения, и удаляет черновик с вашего компьютера. Когда вы отправляете с карточки, она показывает ✓ Sent; когда вы отправляете из очереди, она закрывается с квитанцией ID.

Отчет содержит:

• Ваше название, область и детали
• Информацию об окружении, такую как версия Claude Code, операционная система и модель
• ID недавних запросов API
• Стенограмму беседы, когда вы оставили Send transcript на yes на экране просмотра. Отправка с карточки никогда не включает стенограмму

Claude Code сохраняет ваш рабочий каталог в локальном черновике, чтобы он мог найти стенограмму, и не отправляет каталог.

В организациях с нулевым сроком хранения данных Claude Code исключает этот инструмент, как и для /feedback. Если сеанс в такой организации все еще предлагает инструмент, черновики остаются на вашем компьютере, и отправка завершается с ошибкой Feedback collection is not available for organizations with custom data retention policies.

Удаление или сохранение черновика

Когда вы удаляете черновик, Claude Code удаляет его с вашего компьютера. Черновик, который вы оставляете в очереди, истекает через 30 дней или через cleanupPeriodDays, если это значение меньше. Очередь содержит 10 черновиков из всех ваших сеансов, и когда Claude ставит одиннадцатый, Claude Code удаляет самый старый. Когда вы запускаете /exit с черновиками из сеанса, все еще находящимися в очереди, Claude Code спрашивает, хотите ли вы их просмотреть или удалить перед выходом.

Отключение отзывов, написанных Claude

Установите Claude-drafted feedback на off в /config, что запишет параметр feedbackDrafts, или установите CLAUDE_CODE_SEND_FEEDBACK=0 на один сеанс. В любом случае Claude не сможет ставить черновики в очередь. Чтобы продолжить создание черновиков без карточек, установите feedbackDrafts на quiet. Администраторы могут установить feedbackDrafts в управляемых параметрах, которые имеют приоритет над вашим собственным параметром.

Сеансы без отзывов, написанных Claude

Claude Code включает инструмент в интерактивные сеансы терминала на вашем собственном компьютере, которые используют Claude API вместо облачного провайдера. Он исключает инструмент из:

• Неинтерактивных запусков -p и сеансов Agent SDK, которые не имеют экрана для просмотра очереди
• Облачных сеансов, таких как Claude Code в веб-версии, которые не могут писать в очередь на вашем компьютере
• Сеансов на Amazon Bedrock, Claude Platform на AWS, Google Cloud's Agent Platform или Microsoft Foundry
• Сеансов, где вы установили CLAUDE_CODE_SEND_FEEDBACK=0 или DISABLE_FEEDBACK_COMMAND=1, установили CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC на любое непустое значение или отключили получение флагов функций
• Организаций, которые отключили отзывы о продукте, и организаций с нулевым сроком хранения данных

Доступность инструмента Task

Инструменты отслеживания задач TaskCreate, TaskGet, TaskUpdate, TaskList и TodoWrite доступны по умолчанию только на моделях Claude 3.x, Opus 4 через 4.7, Sonnet 4 через 4.6 и Haiku 4.5. Везде, где инструменты доступны, вы получаете четыре инструмента Task или TodoWrite вместо них, когда вы установите CLAUDE_CODE_ENABLE_TASKS=0.

На всех остальных моделях Claude Code исключает инструменты, если вы не согласитесь на их использование. То же самое применяется к ID модели, который Claude Code не распознает, например к пользовательскому имени модели, обслуживаемому через LLM gateway. На более новых моделях Claude отслеживает многоэтапную работу без письменного контрольного списка, а определения инструментов и напоминания занимают контекст. Без инструментов Claude ничего не добавляет в список задач во время работы.

Если вы хотите использовать эти инструменты на модели, которая не имеет их по умолчанию, выполните одно из следующих действий:

• Экспортируйте CLAUDE_CODE_ENABLE_TODO_TOOLS=1 перед запуском Claude Code, например CLAUDE_CODE_ENABLE_TODO_TOOLS=1 claude. Claude Code затем предоставляет одинаковые инструменты на каждой модели и каждом провайдере
• Назовите один из инструментов в --allowedTools, например claude --allowedTools TaskCreate
• Перечислите инструменты в --tools, что ограничивает встроенные инструменты сеанса только теми, которые он называет. Включите нужные вам инструменты вместе с другими встроенными инструментами, которые вы используете
• В Agent SDK параметры allowedTools и tools работают так же, как два флага

В фоновых сеансах и в облачных сеансах Claude Code предоставляет одинаковые инструменты на каждой модели, независимо от того, указана она в списке или нет.

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

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

Поведение инструмента WebFetch

WebFetch принимает URL и подсказку, описывающую, что нужно извлечь. Он загружает страницу, преобразует ответ в Markdown, когда сервер возвращает HTML, и запускает подсказку против содержимого, используя небольшую быструю модель. Для большинства загрузок Claude получает ответ этой модели, а не исходную страницу. Этап преобразования не настраивается.

Это делает WebFetch с потерей данных по замыслу. Подсказка извлечения определяет, что достигает Claude, поэтому результат, который говорит, что страница не упоминает что-то, может означать только то, что подсказка об этом не спрашивала. Попросите Claude загрузить снова с более конкретной подсказкой или используйте curl через Bash для необработанной страницы.

Несколько поведений формируют ответ, который получает Claude:

• WebFetch отказывает localhost и любому другому имени хоста без точки, например простому имени интранета, перед выполнением запроса. Ошибка, которую он возвращает, говорит Claude достичь локальных серверов с помощью curl через Bash вместо этого.
• HTTP URL-адреса автоматически обновляются до HTTPS.
• Большие страницы усекаются до фиксированного ограничения символов перед обработкой.
• WebFetch кэширует каждый ответ на 15 минут по умолчанию, поэтому повторные загрузки одного и того же URL возвращаются быстро. На Claude Code v2.1.233 или позже установите CLAUDE_CODE_WEBFETCH_CACHE_TTL_MS для изменения того, как долго WebFetch хранит каждый ответ.
• Страница, которая не завершила загрузку в течение пяти минут, включая любые перенаправления, которые следует WebFetch, завершается ошибкой истечения срока. На Claude Code v2.1.268 или позже установите CLAUDE_CODE_WEBFETCH_DEADLINE_MS для изменения ограничения или на 0 для его удаления.
• Когда URL перенаправляет на другой хост, WebFetch возвращает текстовый результат, который называет исходный URL и цель перенаправления вместо его следования. Claude затем загружает новый URL со вторым вызовом WebFetch.
• Когда этап извлечения попадает на перегруженный API, Claude Code повторяет попытку с отступом; загрузка, которая все еще не удается, возвращает результат ошибки. До v2.1.212 текст ошибки API мог достичь Claude как если бы это было извлеченное содержимое страницы.

В режимах Manual и acceptEdits режимы разрешений, WebFetch запрашивает перед загрузкой, за исключением доменов, которые ваши правила разрешений уже разрешают или запрещают, и встроенный набор предварительно одобренных доменов документации, которые загружаются без запроса. Независимо от того, что разрешают ваши правила, загрузка также проходит проверку безопасности домена WebFetch в первую очередь; этот раздел охватывает то, что отправляет проверка, и параметр, который ее пропускает. Подсказка предлагает три варианта:

• Да: одобряет эту загрузку только. Следующий вызов WebFetch снова запрашивает, даже для одного и того же домена.
• Да, и больше не спрашивайте для <domain>: одобряет загрузку и сохраняет правило разрешения WebFetch(domain:...) для этого домена в .claude/settings.local.json для этого репозитория. См. как сохраненные одобрения сохраняются. Когда ваша организация устанавливает allowManagedPermissionRulesOnly, Claude Code скрывает этот вариант.
• Нет, и скажите Claude, что делать по-другому: отклоняет загрузку.

Чтобы разрешить домен заранее без запроса, добавьте правило разрешения, такое как WebFetch(domain:example.com); WebFetch(domain:*) разрешает каждый домен. Режимы разрешений auto и bypassPermissions режимы разрешений пропускают подсказку, за исключением домена, который соответствует явному правилу ask.

Явное правило WebFetch(domain:...) в deny, ask или allow имеет приоритет над предварительно одобренным набором, поэтому вы можете заблокировать предварительно одобренный домен или потребовать для него подсказку.

WebFetch устанавливает заголовок User-Agent, начинающийся с Claude-User, и заголовок Accept, который предпочитает Markdown перед HTML, чтобы серверы, поддерживающие согласование содержимого, могли возвращать Markdown напрямую.

Изолированные команды не наследуют встроенный набор предварительно одобренных доменов документации WebFetch. Чтобы позволить изолированной команде достичь домена без запроса, добавьте домен в allowedDomains или разрешите его с помощью правила WebFetch(domain:...), которое песочница также соблюдает. WebFetch никогда не читает список разрешений песочницы в ответ, поэтому добавление домена в песочницу или список разрешений сети организации не останавливает WebFetch от запроса для него.

Поведение инструмента WebSearch

WebSearch выполняет запрос к серверной части веб-поиска Anthropic и возвращает названия результатов и URL-адреса. Он не загружает страницы результатов. Чтобы прочитать страницу, найденную Claude в результатах поиска, он выполняет последующий запрос с помощью WebFetch.

Инструмент может выполнить до восьми серверных поисков за один вызов, внутренне уточняя поиск перед возвратом результатов. Claude может ограничить результаты с помощью allowed_domains для включения только определённых хостов или blocked_domains для их исключения. Эти два списка нельзя объединять в одном вызове.

Когда запрос поиска попадает на перегруженный API, Claude Code повторяет его с экспоненциальной задержкой; вызов, который всё ещё не удаётся, возвращает результат ошибки. До версии 2.1.212 текст ошибки API мог поступить к Claude как результаты поиска.

Правила разрешений WebSearch не требуют спецификатора. Простая запись WebSearch в allow или deny — это единственная форма.

Серверная часть поиска не настраивается. Для поиска с использованием другого поставщика добавьте MCP сервер, который предоставляет инструмент поиска.

Лимит поиска сеанса

Сеанс может выполнить максимум 200 вызовов WebSearch, подсчитанных во всей основной беседе и каждом подагенте, который он порождает, поэтому поиски, выполняемые параллельными веерообразными развёртываниями исследований, учитываются в одном и том же лимите. Лимит требует Claude Code версии 2.1.212 или позже. Когда Claude достигает лимита, дальнейшие вызовы возвращают уведомление, указывающее Claude продолжить с информацией, которую он уже собрал, вместо ошибки, которая могла бы пригласить повторную попытку. Вы не видите уведомление: ограниченный вызов отображается в беседе как поиск, который ничего не сделал, и если Claude нужны дополнительные поиски, уведомление указывает ему попросить вас повысить лимит.

Установите переменную окружения CLAUDE_CODE_MAX_WEB_SEARCHES_PER_SESSION для изменения лимита; она принимает положительное целое число, поэтому лимит можно повысить, но не отключить. Запуск /clear сбрасывает счётчик. Если работа, которая всё ещё может порождать подагентов, сохраняется после очистки, например запущенный рабочий процесс, счётчик переносится вместо этого.

Поведение инструмента Write

Инструмент Write создает новый файл или перезаписывает существующий полным содержимым. Он не добавляет и не объединяет.

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

• Claude Opus 4.6, Claude Haiku 4.5 и более старые модели всегда требуют чтения, поэтому Write в непрочитанный существующий файл завершается с ошибкой.
• Более новые модели могут перезаписать файл, который они никогда не читали в этом сеансе, при тех же условиях, что и read-before-edit: чтение его не потребует запроса разрешения и инструмент Read доступен.
• Jupyter notebooks и файлы, которые Claude прочитал только частично с уведомлением PARTIAL view, требуют чтения на всех моделях.

Это ограничение не применяется к новым файлам. До версии 2.1.228 каждая модель требовала чтения перед перезаписью существующего файла.

Просмотр файла с помощью Bash также удовлетворяет этому требованию в соответствии с теми же правилами, описанными в Edit tool behavior.

Для частичных изменений существующего файла Claude использует Edit вместо Write.

Проверка доступных инструментов

Ваш точный набор инструментов зависит от вашего поставщика, платформы и параметров. Чтобы проверить, что загружено в работающем сеансе, спросите Claude напрямую:

What tools do you have access to?

Claude дает разговорное резюме. Для точных имен инструментов MCP запустите /mcp.

См. также

• MCP servers: добавляйте пользовательские инструменты, подключая внешние серверы
• Разрешения: система разрешений, синтаксис правил и шаблоны для конкретных инструментов
• Subagents: настройка доступа к инструментам для subagents
• Hooks: запуск пользовательских команд до или после выполнения инструмента