Справочник инструментов
Полный справочник инструментов, которые может использовать Claude Code, включая требования к разрешениям.
Claude Code имеет доступ к набору встроенных инструментов, которые помогают ему понять и изменить вашу кодовую базу. Названия инструментов — это точные строки, которые вы используете в правилах разрешений, списках инструментов subagent и сопоставителях hooks. Чтобы полностью отключить инструмент, добавьте его имя в массив deny в параметрах разрешений.
Чтобы добавить пользовательские инструменты, подключите MCP server. Чтобы расширить Claude с помощью переиспользуемых рабочих процессов на основе подсказок, напишите skill, который работает через существующий инструмент Skill вместо добавления новой записи инструмента.
| Инструмент | Описание | Требуется разрешение |
|---|---|---|
Agent |
Создает subagent с собственным контекстным окном для выполнения задачи | Нет |
AskUserQuestion |
Задает вопросы с несколькими вариантами ответов для сбора требований или уточнения неоднозначности | Нет |
Bash |
Выполняет команды оболочки в вашей среде. См. поведение инструмента Bash | Да |
CronCreate |
Планирует повторяющуюся или одноразовую подсказку в текущем сеансе. Задачи привязаны к сеансу и восстанавливаются при --resume или --continue, если не истекли. См. запланированные задачи |
Нет |
CronDelete |
Отменяет запланированную задачу по ID | Нет |
CronList |
Выводит список всех запланированных задач в сеансе | Нет |
Edit |
Вносит целевые изменения в конкретные файлы | Да |
EnterPlanMode |
Переключается в режим плана для разработки подхода перед кодированием | Нет |
EnterWorktree |
Создает изолированный git worktree и переключается в него. Передайте path для переключения в существующий worktree текущего репозитория вместо создания нового. Недоступно для subagents |
Нет |
ExitPlanMode |
Представляет план для утверждения и выходит из режима плана | Да |
ExitWorktree |
Выходит из сеанса worktree и возвращается в исходный каталог. Недоступно для subagents | Нет |
Glob |
Находит файлы на основе сопоставления шаблонов | Нет |
Grep |
Ищет шаблоны в содержимом файлов | Нет |
ListMcpResourcesTool |
Выводит список ресурсов, предоставляемых подключенными MCP servers | Нет |
LSP |
Интеллект кода через языковые серверы: переход к определениям, поиск ссылок, сообщение об ошибках типов и предупреждениях. См. поведение инструмента LSP | Нет |
Monitor |
Запускает команду в фоне и передает каждую строку вывода обратно Claude, чтобы он мог реагировать на записи журнала, изменения файлов или опрашиваемый статус в середине разговора. См. инструмент Monitor | Да |
NotebookEdit |
Изменяет ячейки Jupyter notebook | Да |
PowerShell |
Выполняет команды PowerShell изначально. См. инструмент PowerShell для доступности | Да |
Read |
Читает содержимое файлов | Нет |
ReadMcpResourceTool |
Читает конкретный ресурс MCP по URI | Нет |
SendMessage |
Отправляет сообщение члену команды агентов, или возобновляет subagent по его ID агента. Остановленные subagents автоматически возобновляются в фоне. Доступно только при установке CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 |
Нет |
Skill |
Выполняет skill в основном разговоре | Да |
TaskCreate |
Создает новую задачу в списке задач | Нет |
TaskGet |
Получает полные сведения для конкретной задачи | Нет |
TaskList |
Выводит список всех задач с их текущим статусом | Нет |
TaskOutput |
(Устарело) Получает вывод из фоновой задачи. Предпочитайте Read на пути к файлу вывода задачи |
Нет |
TaskStop |
Завершает выполняющуюся фоновую задачу по ID | Нет |
TaskUpdate |
Обновляет статус задачи, зависимости, сведения или удаляет задачи | Нет |
TeamCreate |
Создает команду агентов с несколькими товарищами по команде. Доступно только при установке CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 |
Нет |
TeamDelete |
Распускает команду агентов и очищает процессы товарищей по команде. Доступно только при установке CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 |
Нет |
TodoWrite |
Управляет контрольным списком задач сеанса. Доступно в неинтерактивном режиме и Agent SDK; интерактивные сеансы используют TaskCreate, TaskGet, TaskList и TaskUpdate вместо этого | Нет |
ToolSearch |
Ищет и загружает отложенные инструменты, когда включен поиск инструментов | Нет |
WebFetch |
Получает содержимое с указанного URL | Да |
WebSearch |
Выполняет веб-поиск | Да |
Write |
Создает или перезаписывает файлы | Да |
Правила разрешений можно настроить с помощью /permissions или в параметрах разрешений. Также см. Правила разрешений для конкретных инструментов.
Поведение инструмента Bash
Инструмент Bash запускает каждую команду в отдельном процессе со следующим поведением сохранения:
- Когда Claude запускает
cdв основном сеансе, новый рабочий каталог переносится в более поздние команды Bash, пока он остается внутри каталога проекта или дополнительного рабочего каталога, который вы добавили с помощью--add-dir,/add-dirилиadditionalDirectoriesв параметрах. Сеансы subagent никогда не переносят изменения рабочего каталога.- Если
cdприводит вне этих каталогов, Claude Code сбрасывает в каталог проекта и добавляетShell cwd was reset to <dir>к результату инструмента. - Чтобы отключить этот перенос, чтобы каждая команда Bash начиналась в каталоге проекта, установите
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1.
- Если
- Переменные окружения не сохраняются.
exportв одной команде не будет доступен в следующей.
Активируйте вашу virtualenv или conda среду перед запуском Claude Code. Чтобы переменные окружения сохранялись между командами Bash, установите CLAUDE_ENV_FILE на скрипт оболочки перед запуском Claude Code или используйте hook SessionStart для динамического заполнения.
Поведение инструмента LSP
Инструмент LSP предоставляет Claude интеллект кода от работающего языкового сервера. После каждого редактирования файла он автоматически сообщает об ошибках типов и предупреждениях, чтобы Claude мог исправить проблемы без отдельного этапа сборки. Claude также может вызвать его напрямую для навигации по коду:
- Переход к определению символа
- Поиск всех ссылок на символ
- Получение информации о типе в позиции
- Список символов в файле или рабочей области
- Поиск реализаций интерфейса
- Трассировка иерархий вызовов
Инструмент неактивен до тех пор, пока вы не установите плагин интеллекта кода для вашего языка. Плагин содержит конфигурацию языкового сервера, и вы устанавливаете двоичный файл сервера отдельно.
Инструмент Monitor
Инструмент Monitor позволяет Claude наблюдать что-то в фоне и реагировать при изменении, без паузы разговора. Попросите Claude:
- Отслеживать файл журнала и отмечать ошибки по мере их появления
- Опрашивать PR или задачу CI и сообщать при изменении статуса
- Наблюдать за каталогом на предмет изменений файлов
- Отслеживать вывод из любого долгоживущего скрипта, на который вы его указываете
Claude пишет небольшой скрипт для наблюдения, запускает его в фоне и получает каждую строку вывода по мере ее поступления. Вы продолжаете работать в том же сеансе, и Claude вмешивается при возникновении события. Остановите монитор, попросив Claude отменить его или завершив сеанс.
Monitor использует те же правила разрешений, что и Bash, поэтому шаблоны allow и deny, которые вы установили для Bash, применяются здесь также. Он недоступен на Amazon Bedrock, Google Vertex AI или Microsoft Foundry. Он также недоступен, когда установлены DISABLE_TELEMETRY или CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC.
Плагины могут объявлять мониторы, которые запускаются автоматически при активации плагина, вместо того чтобы просить Claude запустить их. См. мониторы плагинов.
Инструмент PowerShell
Инструмент PowerShell позволяет Claude запускать команды PowerShell изначально. На Windows это означает, что команды выполняются в PowerShell вместо маршрутизации через Git Bash. На Windows без Git Bash инструмент включается автоматически. На Windows с установленным Git Bash инструмент развертывается постепенно. На Linux, macOS и WSL инструмент является добровольным.
Включение инструмента 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.
Выбор оболочки в параметрах, hooks и skills
Три дополнительных параметра контролируют, где используется PowerShell:
"defaultShell": "powershell"вsettings.json: маршрутизирует интерактивные команды!через PowerShell. Требует включения инструмента PowerShell."shell": "powershell"на отдельных command hooks: запускает этот hook в PowerShell. Hooks запускают PowerShell напрямую, поэтому это работает независимо отCLAUDE_CODE_USE_POWERSHELL_TOOL.shell: powershellв frontmatter skill: запускает блоки!`command`в PowerShell. Требует включения инструмента PowerShell.
Поведение сброса рабочего каталога основного сеанса, описанное в разделе инструмента Bash, применяется к командам PowerShell, включая переменную окружения CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR.
Ограничения предварительного просмотра
Инструмент PowerShell имеет следующие известные ограничения во время предварительного просмотра:
- Профили PowerShell не загружаются
- На Windows sandboxing не поддерживается
Проверка доступных инструментов
Ваш точный набор инструментов зависит от вашего поставщика, платформы и параметров. Чтобы проверить, что загружено в работающем сеансе, спросите Claude напрямую:
What tools do you have access to?
Claude дает разговорное резюме. Для точных имен инструментов MCP запустите /mcp.
См. также
- MCP servers: добавляйте пользовательские инструменты, подключая внешние серверы
- Разрешения: система разрешений, синтаксис правил и шаблоны для конкретных инструментов
- Subagents: настройка доступа к инструментам для subagents
- Hooks: запуск пользовательских команд до или после выполнения инструмента