Referência de ferramentas
Referência completa para as ferramentas que Claude Code pode usar, incluindo requisitos de permissão.
Claude Code tem acesso a um conjunto de ferramentas integradas que o ajudam a entender e modificar sua base de código. Os nomes das ferramentas são as strings exatas que você usa em regras de permissão, listas de ferramentas de subagent e correspondências de hooks. Para desabilitar uma ferramenta completamente, adicione seu nome ao array deny em suas configurações de permissão.
Para adicionar ferramentas personalizadas, conecte um servidor MCP. Para estender Claude com fluxos de trabalho baseados em prompts reutilizáveis, escreva uma skill, que é executada através da ferramenta Skill existente em vez de adicionar uma nova entrada de ferramenta.
| Ferramenta | Descrição | Permissão Necessária |
|---|---|---|
Agent |
Cria um subagent com sua própria janela de contexto para lidar com uma tarefa | Não |
AskUserQuestion |
Faz perguntas de múltipla escolha para coletar requisitos ou esclarecer ambiguidades | Não |
Bash |
Executa comandos de shell em seu ambiente. Veja comportamento da ferramenta Bash | Sim |
CronCreate |
Agenda uma solicitação recorrente ou única dentro da sessão atual. As tarefas têm escopo de sessão e são restauradas em --resume ou --continue se não expiradas. Veja tarefas agendadas |
Não |
CronDelete |
Cancela uma tarefa agendada por ID | Não |
CronList |
Lista todas as tarefas agendadas na sessão | Não |
Edit |
Faz edições direcionadas em arquivos específicos | Sim |
EnterPlanMode |
Muda para Plan Mode para projetar uma abordagem antes de codificar | Não |
EnterWorktree |
Cria um git worktree isolado e muda para ele. Passe um path para mudar para um worktree existente do repositório atual em vez de criar um novo. Não disponível para subagents |
Não |
ExitPlanMode |
Apresenta um plano para aprovação e sai do Plan Mode | Sim |
ExitWorktree |
Sai de uma sessão de worktree e retorna ao diretório original. Não disponível para subagents | Não |
Glob |
Encontra arquivos com base em correspondência de padrões | Não |
Grep |
Pesquisa padrões no conteúdo de arquivos | Não |
ListMcpResourcesTool |
Lista recursos expostos por servidores MCP conectados | Não |
LSP |
Inteligência de código via servidores de linguagem: ir para definições, encontrar referências, relatar erros de tipo e avisos. Veja comportamento da ferramenta LSP | Não |
Monitor |
Executa um comando em segundo plano e alimenta cada linha de saída de volta para Claude, para que ele possa reagir a entradas de log, mudanças de arquivo ou status consultado no meio da conversa. Veja ferramenta Monitor | Sim |
NotebookEdit |
Modifica células de notebook Jupyter | Sim |
PowerShell |
Executa comandos PowerShell nativamente. Veja ferramenta PowerShell para disponibilidade | Sim |
Read |
Lê o conteúdo de arquivos | Não |
ReadMcpResourceTool |
Lê um recurso MCP específico por URI | Não |
SendMessage |
Envia uma mensagem para um membro da equipe de agentes, ou retoma um subagent por seu ID de agente. Subagents parados retomam automaticamente em segundo plano. Disponível apenas quando CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 está definido |
Não |
Skill |
Executa uma skill dentro da conversa principal | Sim |
TaskCreate |
Cria uma nova tarefa na lista de tarefas | Não |
TaskGet |
Recupera detalhes completos para uma tarefa específica | Não |
TaskList |
Lista todas as tarefas com seu status atual | Não |
TaskOutput |
(Descontinuado) Recupera saída de uma tarefa em segundo plano. Prefira Read no caminho do arquivo de saída da tarefa |
Não |
TaskStop |
Mata uma tarefa em segundo plano em execução por ID | Não |
TaskUpdate |
Atualiza status da tarefa, dependências, detalhes ou deleta tarefas | Não |
TeamCreate |
Cria uma equipe de agentes com múltiplos membros. Disponível apenas quando CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 está definido |
Não |
TeamDelete |
Dissolve uma equipe de agentes e limpa processos de membros. Disponível apenas quando CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 está definido |
Não |
TodoWrite |
Gerencia a lista de verificação de tarefas da sessão. Disponível em modo não interativo e no Agent SDK; sessões interativas usam TaskCreate, TaskGet, TaskList e TaskUpdate em vez disso | Não |
ToolSearch |
Pesquisa e carrega ferramentas diferidas quando pesquisa de ferramentas está ativada | Não |
WebFetch |
Busca conteúdo de uma URL especificada | Sim |
WebSearch |
Realiza pesquisas na web | Sim |
Write |
Cria ou sobrescreve arquivos | Sim |
As regras de permissão podem ser configuradas usando /permissions ou em configurações de permissão. Veja também Regras de permissão específicas da ferramenta.
Comportamento da ferramenta Bash
A ferramenta Bash executa cada comando em um processo separado com o seguinte comportamento de persistência:
- Quando Claude executa
cdna sessão principal, o novo diretório de trabalho é mantido para comandos Bash posteriores, desde que permaneça dentro do diretório do projeto ou um diretório de trabalho adicional que você adicionou com--add-dir,/add-dirouadditionalDirectoriesnas configurações. Sessões de subagent nunca mantêm mudanças de diretório de trabalho.- Se
cdsair desses diretórios, Claude Code redefine para o diretório do projeto e anexaShell cwd was reset to <dir>ao resultado da ferramenta. - Para desabilitar esse carregamento para que cada comando Bash comece no diretório do projeto, defina
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1.
- Se
- As variáveis de ambiente não persistem. Um
exportem um comando não estará disponível no próximo.
Ative seu virtualenv ou ambiente conda antes de iniciar Claude Code. Para fazer as variáveis de ambiente persistirem entre comandos Bash, defina CLAUDE_ENV_FILE para um script de shell antes de iniciar Claude Code, ou use um hook SessionStart para preenchê-lo dinamicamente.
Comportamento da ferramenta LSP
A ferramenta LSP fornece a Claude inteligência de código de um servidor de linguagem em execução. Após cada edição de arquivo, ela relata automaticamente erros de tipo e avisos para que Claude possa corrigir problemas sem uma etapa de compilação separada. Claude também pode chamá-la diretamente para navegar no código:
- Ir para a definição de um símbolo
- Encontrar todas as referências a um símbolo
- Obter informações de tipo em uma posição
- Listar símbolos em um arquivo ou workspace
- Encontrar implementações de uma interface
- Rastrear hierarquias de chamadas
A ferramenta fica inativa até que você instale um plugin de inteligência de código para sua linguagem. O plugin agrupa a configuração do servidor de linguagem, e você instala o binário do servidor separadamente.
Ferramenta Monitor
A ferramenta Monitor permite que Claude observe algo em segundo plano e reaja quando muda, sem pausar a conversa. Peça a Claude para:
- Acompanhar um arquivo de log e sinalizar erros conforme aparecem
- Consultar um PR ou trabalho de CI e relatar quando seu status muda
- Observar um diretório para mudanças de arquivo
- Rastrear saída de qualquer script de longa duração que você apontar
Claude escreve um pequeno script para a observação, o executa em segundo plano e recebe cada linha de saída conforme chega. Você continua trabalhando na mesma sessão e Claude intervém quando um evento chega. Pare um monitor pedindo a Claude para cancelá-lo ou encerrando a sessão.
Monitor usa as mesmas regras de permissão que Bash, portanto os padrões allow e deny que você definiu para Bash se aplicam aqui também. Não está disponível no Amazon Bedrock, Google Vertex AI ou Microsoft Foundry. Também não está disponível quando DISABLE_TELEMETRY ou CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC está definido.
Plugins podem declarar monitores que iniciam automaticamente quando o plugin está ativo, em vez de pedir a Claude para iniciá-los. Veja monitores de plugin.
Ferramenta PowerShell
A ferramenta PowerShell permite que Claude execute comandos PowerShell nativamente. No Windows, isso significa que os comandos são executados no PowerShell em vez de serem roteados através do Git Bash. No Windows sem Git Bash, a ferramenta é ativada automaticamente. No Windows com Git Bash instalado, a ferramenta está sendo lançada progressivamente. No Linux, macOS e WSL, a ferramenta é opcional.
Ativar a ferramenta PowerShell
Defina CLAUDE_CODE_USE_POWERSHELL_TOOL=1 em seu ambiente ou em settings.json:
{
"env": {
"CLAUDE_CODE_USE_POWERSHELL_TOOL": "1"
}
}
No Windows, defina a variável como 0 para desativar o lançamento. No Linux, macOS e WSL, a ferramenta requer PowerShell 7 ou posterior: instale pwsh e certifique-se de que está em seu PATH.
No Windows, Claude Code detecta automaticamente pwsh.exe para PowerShell 7+ com fallback para powershell.exe para PowerShell 5.1. Quando a ferramenta está ativada, Claude trata PowerShell como o shell primário. A ferramenta Bash permanece disponível para scripts POSIX quando Git Bash está instalado.
Seleção de shell em configurações, hooks e skills
Três configurações adicionais controlam onde PowerShell é usado:
"defaultShell": "powershell"emsettings.json: roteia comandos!interativos através do PowerShell. Requer que a ferramenta PowerShell esteja ativada."shell": "powershell"em hooks de comando individuais: executa esse hook em PowerShell. Hooks geram PowerShell diretamente, portanto isso funciona independentemente deCLAUDE_CODE_USE_POWERSHELL_TOOL.shell: powershellem frontmatter de skill: executa blocos!`command`em PowerShell. Requer que a ferramenta PowerShell esteja ativada.
O mesmo comportamento de redefinição de diretório de trabalho da sessão principal descrito na seção da ferramenta Bash se aplica aos comandos PowerShell, incluindo a variável de ambiente CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR.
Limitações da visualização
A ferramenta PowerShell tem as seguintes limitações conhecidas durante a visualização:
- Perfis do PowerShell não são carregados
- No Windows, sandboxing não é suportado
Verificar quais ferramentas estão disponíveis
Seu conjunto exato de ferramentas depende do seu provedor, plataforma e configurações. Para verificar o que está carregado em uma sessão em execução, pergunte a Claude diretamente:
What tools do you have access to?
Claude fornece um resumo conversacional. Para nomes exatos de ferramentas MCP, execute /mcp.
Veja também
- Servidores MCP: adicione ferramentas personalizadas conectando servidores externos
- Permissões: sistema de permissões, sintaxe de regras e padrões específicos de ferramentas
- Subagents: configure o acesso a ferramentas para subagents
- Hooks: execute comandos personalizados antes ou depois da execução da ferramenta