Funciones no documentadas de Claude Code: Hooks, Memoria, Clasificador YOLO y más

André Figueira leyó el código fuente de Claude Code (v2.1.87) y encontró docenas de opciones de configuración no documentadas. La documentación oficial cubre lo básico, pero el paquete real (inspeccionable libremente en node_modules) expone campos para hooks, memoria del agente, reglas de modo automático y más. Esto es lo que realmente puedes configurar ahora mismo.

YOLO Classifier: Autoaprobación de Acciones con Español Sencillo

Llamado internamente "YOLO Classifier" (yoloClassifier.ts), este sistema te permite describir tu entorno en español sencillo para decidir cuándo Claude puede autoaprobar operaciones. En settings.json, agrega una descripción como "este es un servidor de staging, las operaciones destructivas son aceptables" para permitir ciertas acciones sin avisar.

Valores de Retorno de Hooks que Cambian el Comportamiento en Plena Ejecución

Los hooks reciben JSON en stdin y pueden devolver JSON específico del evento en stdout. Estos son los campos de retorno clave:

• PreToolUse: updatedInput (reescribe la entrada de la herramienta antes de ejecutar), permissionDecision (forzar permitir/denegar), permissionDecisionReason, additionalContext
• SessionStart: watchPaths (monitoreo automático de archivos que desencadena eventos FileChanged), initialUserMessage (anteponer contenido al primer mensaje del usuario), additionalContext
• PostToolUse: updatedMCPToolOutput, additionalContext
• PermissionRequest: decision (permitir/denegar programáticamente con updatedInput o updatedPermissions)

Ejemplo: un hook PreToolUse que agrega --dry-run a cada comando git push. En .claude/settings.json:

{
  "hooks": {
    "PreToolUse": [{
      "matcher": "Bash",
      "hooks": [{
        "type": "command",
        "command": "~/.claude/hooks/dry-run-pushes.sh"
      }]
    }]
  }
}

Script en ~/.claude/hooks/dry-run-pushes.sh:

#!/bin/bash
INPUT=$(jq -r '.tool_input.command' 
Esto reescribe el comando antes de ejecutarlo, un campo no documentado.

Contexto de Sesión y Monitoreo de Archivos

Los hooks SessionStart pueden configurar watchPaths para monitorear archivos como package.json, .env y tsconfig.json en busca de cambios, desencadenando eventos FileChanged. También pueden inyectar initialUserMessage para anteponer contexto, por ejemplo, la rama git actual y la cantidad de cambios sin commit.

Ejemplo de script que devuelve rutas de monitoreo y mensaje inicial:

#!/bin/bash
BRANCH=$(git branch --show-current 2>/dev/null)
CHANGES=$(git status --porcelain 2>/dev/null | wc -l | tr -d ' ')
jq -n \
  --arg branch "$BRANCH" \
  --arg changes "$CHANGES" \
  '{
    "watchPaths": ["package.json", ".env", "tsconfig.json"],
    "initialUserMessage": "Rama actual: \($branch), cambios sin commit: \($changes)"
  }'

Memoria Persistente del Agente y Reglas de Modo Automático

La memoria del agente se puede configurar para que persista entre sesiones usando campos en el directorio ~/.claude/agents/. Las reglas de modo automático se pueden describir en archivos en español sencillo, indicando a Claude cuándo aprobar acciones automáticamente. El código fuente también insinúa "bucles de sueño auto-mejorados" donde Claude puede refinar sus propias configuraciones.

Ubicaciones de Archivos

• Configuración: ~/.claude/settings.json (personal) o .claude/settings.json (proyecto, compartible vía git)
• Habilidades: ~/.claude/skills/<nombre>/SKILL.md (personal) o .claude/skills/<nombre>/SKILL.md (proyecto)
• Agentes: ~/.claude/agents/<nombre>.md (personal) o .claude/agents/<nombre>.md (proyecto)
• Scripts hook: Convencionalmente en ~/.claude/hooks/, deben ser ejecutables (chmod +x)

Estos son prácticos para desarrolladores que quieran personalizar Claude Code más allá de las APIs documentadas. Espera que estas características cambien entre versiones.