Subagentes de Claude Code: qué son y cómo crear el tuyo

El Telar — Fri, 23 Oct 2026 21:08:29 +0000

Un subagente es un asistente especializado que trabaja en su propia ventana de contexto, con su prompt, herramientas limitadas y permisos propios. Saca de tu conversación las tareas que generan mucho texto y te devuelve solo el resumen.

Guarda esto en .claude/agents/code-reviewer.md (proyecto) o ~/.claude/agents/ (todos tus proyectos):

---
name: code-reviewer
description: "Revisa código en busca de calidad y buenas prácticas"
tools: Read, Glob, Grep
model: sonnet
---

Eres un revisor de código. Al ser invocado, analiza el código y da
retroalimentación específica y accionable sobre calidad, seguridad
y buenas prácticas.

Solo name y description son obligatorios. Los campos distinguen mayúsculas y uno mal escrito se ignora sin avisar.

Para usarlo: pídelo en lenguaje natural, escribe @ y elígelo, o abre la sesión con claude --agent code-reviewer.

Guía completa: eltelar.es.

Hooks de Claude Code: qué son y 3 ejemplos para copiar

El Telar — Fri, 23 Oct 2026 21:01:06 +0000

Un hook es un comando que Claude Code ejecuta automáticamente en un momento concreto: después de editar un archivo, antes de ejecutar una orden o cuando te espera. Según la documentación oficial, dan un control determinista: la acción ocurre siempre, sin depender de que el modelo se acuerde.

1. Notificación cuando Claude te espera (macOS)

En ~/.claude/settings.json:

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          { "type": "command", "command": "osascript -e 'display notification \"Claude Code needs your attention\" with title \"Claude Code\"'" }
        ]
      }
    ]
  }
}

Escribe /hooks para comprobar que aparece. Si no suena, activa las notificaciones de Script Editor en Ajustes del Sistema.

2. Prettier tras cada edición

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [{ "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write" }]
      }
    ]
  }
}

3. Bloquear archivos protegidos

Un script que termina con código 2 bloquea la acción y Claude recibe el mensaje:

#!/bin/bash
INPUT=$(cat)
FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')
for pattern in ".env" "package-lock.json" ".git/"; do
  if [[ "$FILE_PATH" == *"$pattern"* ]]; then
    echo "Blocked: $FILE_PATH matches '$pattern'" >&2
    exit 2
  fi
done
exit 0

Regístralo como hook PreToolUse con matcher: "Edit|Write".

Guía completa, con diagrama, dónde se guardan y preguntas frecuentes: eltelar.es.

DEV Community: El Telar

Subagentes de Claude Code: qué son y cómo crear el tuyo

Hooks de Claude Code: qué son y 3 ejemplos para copiar

1. Notificación cuando Claude te espera (macOS)

2. Prettier tras cada edición

3. Bloquear archivos protegidos