Referencia de herramientas
Referencia completa de las herramientas que Claude Code puede utilizar, incluidos los requisitos de permisos.
Claude Code tiene acceso a un conjunto de herramientas integradas que le ayudan a entender y modificar su base de código. Los nombres de herramientas son las cadenas exactas que utiliza en reglas de permisos, listas de herramientas de subagents y coincidencias de hooks. Para desactivar una herramienta completamente, agregue su nombre al array deny en su configuración de permisos.
Para agregar herramientas personalizadas, conecte un servidor MCP. Para extender Claude con flujos de trabajo basados en prompts reutilizables, escriba una skill, que se ejecuta a través de la herramienta Skill existente en lugar de agregar una nueva entrada de herramienta.
| Herramienta | Descripción | Permiso requerido |
|---|---|---|
Agent |
Genera un subagent con su propia ventana de contexto para manejar una tarea | No |
AskUserQuestion |
Hace preguntas de opción múltiple para recopilar requisitos o aclarar ambigüedades | No |
Bash |
Ejecuta comandos de shell en su entorno. Consulte comportamiento de la herramienta Bash | Sí |
CronCreate |
Programa una solicitud recurrente o única dentro de la sesión actual. Las tareas tienen alcance de sesión y se restauran en --resume o --continue si no han expirado. Consulte tareas programadas |
No |
CronDelete |
Cancela una tarea programada por ID | No |
CronList |
Lista todas las tareas programadas en la sesión | No |
Edit |
Realiza ediciones dirigidas a archivos específicos | Sí |
EnterPlanMode |
Cambia a Plan Mode para diseñar un enfoque antes de codificar | No |
EnterWorktree |
Crea un git worktree aislado y cambia a él. Pase un path para cambiar a un worktree existente del repositorio actual en lugar de crear uno nuevo. No disponible para subagents |
No |
ExitPlanMode |
Presenta un plan para aprobación y sale de Plan Mode | Sí |
ExitWorktree |
Sale de una sesión de worktree y regresa al directorio original. No disponible para subagents | No |
Glob |
Encuentra archivos basados en coincidencia de patrones | No |
Grep |
Busca patrones en el contenido de archivos | No |
ListMcpResourcesTool |
Lista recursos expuestos por servidores MCP conectados | No |
LSP |
Inteligencia de código a través de servidores de lenguaje: saltar a definiciones, encontrar referencias, reportar errores de tipo y advertencias. Consulte comportamiento de la herramienta LSP | No |
Monitor |
Ejecuta un comando en segundo plano y devuelve cada línea de salida a Claude, para que pueda reaccionar a entradas de registro, cambios de archivos, o estado sondeado a mitad de la conversación. Consulte herramienta Monitor | Sí |
NotebookEdit |
Modifica celdas de cuadernos Jupyter | Sí |
PowerShell |
Ejecuta comandos de PowerShell de forma nativa. Consulte herramienta PowerShell para disponibilidad | Sí |
Read |
Lee el contenido de archivos | No |
ReadMcpResourceTool |
Lee un recurso MCP específico por URI | No |
SendMessage |
Envía un mensaje a un miembro del equipo de agentes, o reanuda un subagent por su ID de agente. Los subagents detenidos se reanudan automáticamente en segundo plano. Solo disponible cuando CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 está establecido |
No |
Skill |
Ejecuta una skill dentro de la conversación principal | Sí |
TaskCreate |
Crea una nueva tarea en la lista de tareas | No |
TaskGet |
Recupera detalles completos para una tarea específica | No |
TaskList |
Lista todas las tareas con su estado actual | No |
TaskOutput |
(Obsoleto) Recupera la salida de una tarea de fondo. Prefiera Read en la ruta del archivo de salida de la tarea |
No |
TaskStop |
Mata una tarea de fondo en ejecución por ID | No |
TaskUpdate |
Actualiza el estado de la tarea, dependencias, detalles, o elimina tareas | No |
TeamCreate |
Crea un equipo de agentes con múltiples compañeros de equipo. Solo disponible cuando CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 está establecido |
No |
TeamDelete |
Disuelve un equipo de agentes y limpia los procesos de compañeros de equipo. Solo disponible cuando CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 está establecido |
No |
TodoWrite |
Gestiona la lista de verificación de tareas de la sesión. Disponible en modo no interactivo y el Agent SDK; las sesiones interactivas utilizan TaskCreate, TaskGet, TaskList y TaskUpdate en su lugar | No |
ToolSearch |
Busca y carga herramientas diferidas cuando búsqueda de herramientas está habilitada | No |
WebFetch |
Obtiene contenido de una URL especificada | Sí |
WebSearch |
Realiza búsquedas web | Sí |
Write |
Crea o sobrescribe archivos | Sí |
Las reglas de permisos se pueden configurar usando /permissions o en configuración de permisos. Consulte también Reglas de permisos específicas de herramientas.
Comportamiento de la herramienta Bash
La herramienta Bash ejecuta cada comando en un proceso separado con el siguiente comportamiento de persistencia:
- Cuando Claude ejecuta
cden la sesión principal, el nuevo directorio de trabajo se mantiene en comandos Bash posteriores siempre que permanezca dentro del directorio del proyecto o un directorio de trabajo adicional que agregó con--add-dir,/add-dir, oadditionalDirectoriesen la configuración. Las sesiones de subagents nunca mantienen cambios de directorio de trabajo.- Si
cdcae fuera de esos directorios, Claude Code se reinicia al directorio del proyecto y añadeShell cwd was reset to <dir>al resultado de la herramienta. - Para desactivar este mantenimiento para que cada comando Bash comience en el directorio del proyecto, establezca
CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR=1.
- Si
- Las variables de entorno no persisten. Un
exporten un comando no estará disponible en el siguiente.
Active su entorno virtualenv o conda antes de lanzar Claude Code. Para hacer que las variables de entorno persistan entre comandos Bash, establezca CLAUDE_ENV_FILE en un script de shell antes de lanzar Claude Code, o use un hook SessionStart para poblarlo dinámicamente.
Comportamiento de la herramienta LSP
La herramienta LSP proporciona a Claude inteligencia de código desde un servidor de lenguaje en ejecución. Después de cada edición de archivo, reporta automáticamente errores de tipo y advertencias para que Claude pueda corregir problemas sin un paso de compilación separado. Claude también puede llamarlo directamente para navegar por el código:
- Saltar a la definición de un símbolo
- Encontrar todas las referencias a un símbolo
- Obtener información de tipo en una posición
- Listar símbolos en un archivo o espacio de trabajo
- Encontrar implementaciones de una interfaz
- Rastrear jerarquías de llamadas
La herramienta está inactiva hasta que instale un plugin de inteligencia de código para su lenguaje. El plugin agrupa la configuración del servidor de lenguaje, e instala el binario del servidor por separado.
Herramienta Monitor
La herramienta Monitor permite que Claude observe algo en segundo plano y reaccione cuando cambia, sin pausar la conversación. Pida a Claude que:
- Siga un archivo de registro y marque errores a medida que aparecen
- Sondee una PR o trabajo de CI y reporte cuando su estado cambia
- Observe un directorio para cambios de archivos
- Rastrear la salida de cualquier script de larga duración que señale
Claude escribe un pequeño script para la observación, lo ejecuta en segundo plano, y recibe cada línea de salida a medida que llega. Continúa trabajando en la misma sesión y Claude interviene cuando llega un evento. Detenga un monitor pidiendo a Claude que lo cancele o terminando la sesión.
Monitor utiliza las mismas reglas de permisos que Bash, por lo que los patrones allow y deny que tiene establecidos para Bash se aplican aquí también. No está disponible en Amazon Bedrock, Google Vertex AI, o Microsoft Foundry. Tampoco está disponible cuando DISABLE_TELEMETRY o CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC está establecido.
Los plugins pueden declarar monitores que se inician automáticamente cuando el plugin está activo, en lugar de pedirle a Claude que los inicie. Consulte monitores de plugins.
Herramienta PowerShell
La herramienta PowerShell permite que Claude ejecute comandos de PowerShell de forma nativa. En Windows, esto significa que los comandos se ejecutan en PowerShell en lugar de enrutarse a través de Git Bash. En Windows sin Git Bash, la herramienta se habilita automáticamente. En Windows con Git Bash instalado, la herramienta se está implementando progresivamente. En Linux, macOS y WSL, la herramienta es opcional.
Habilitar la herramienta PowerShell
Establezca CLAUDE_CODE_USE_POWERSHELL_TOOL=1 en su entorno o en settings.json:
{
"env": {
"CLAUDE_CODE_USE_POWERSHELL_TOOL": "1"
}
}
En Windows, establezca la variable a 0 para optar por no participar en la implementación. En Linux, macOS y WSL, la herramienta requiere PowerShell 7 o posterior: instale pwsh y asegúrese de que esté en su PATH.
En Windows, Claude Code detecta automáticamente pwsh.exe para PowerShell 7+ con una alternativa a powershell.exe para PowerShell 5.1. Cuando la herramienta está habilitada, Claude trata PowerShell como el shell principal. La herramienta Bash permanece disponible para scripts POSIX cuando Git Bash está instalado.
Selección de shell en configuración, hooks y skills
Tres configuraciones adicionales controlan dónde se usa PowerShell:
"defaultShell": "powershell"ensettings.json: enruta comandos interactivos!a través de PowerShell. Requiere que la herramienta PowerShell esté habilitada."shell": "powershell"en hooks de comando individuales: ejecuta ese hook en PowerShell. Los hooks generan PowerShell directamente, por lo que esto funciona independientemente deCLAUDE_CODE_USE_POWERSHELL_TOOL.shell: powershellen frontmatter de skill: ejecuta bloques!`command`en PowerShell. Requiere que la herramienta PowerShell esté habilitada.
El mismo comportamiento de reinicio del directorio de trabajo de la sesión principal descrito en la sección de la herramienta Bash se aplica a los comandos de PowerShell, incluida la variable de entorno CLAUDE_BASH_MAINTAIN_PROJECT_WORKING_DIR.
Limitaciones de vista previa
La herramienta PowerShell tiene las siguientes limitaciones conocidas durante la vista previa:
- Los perfiles de PowerShell no se cargan
- En Windows, el sandboxing no es compatible
Verificar qué herramientas están disponibles
Su conjunto exacto de herramientas depende de su proveedor, plataforma y configuración. Para verificar qué está cargado en una sesión en ejecución, pregúntele a Claude directamente:
¿Qué herramientas tienes disponibles?
Claude proporciona un resumen conversacional. Para nombres exactos de herramientas MCP, ejecute /mcp.
Véase también
- Servidores MCP: agregue herramientas personalizadas conectando servidores externos
- Permisos: sistema de permisos, sintaxis de reglas y patrones específicos de herramientas
- Subagents: configure el acceso a herramientas para subagents
- Hooks: ejecute comandos personalizados antes o después de la ejecución de herramientas