M19 · Referencia rápida

Para quién es: quien ya sabe y solo quiere el dato. Qué resuelve: dejar de buscar. Todo en tablas, pensado para imprimir. Qué NO cubre: explicaciones. Para eso están los otros veinte módulos.

Verificado contra Claude Code 2.1.228 el 12 de agosto de 2026.

19.1 · El tamaño real de la superficie

Antes de las tablas, los números, porque calibran expectativas:

Trescientas treinta y seis variables de entorno. Cualquiera que te diga que conoce Claude Code entero está exagerando, y esta guía tampoco lo pretende: lo que pretende es que sepas dónde mirar.

19.2 · Tabla 7 · Herramientas, comportamiento y límites

⚠️ La fila de WebFetch merece un cartel, porque produce diagnósticos falsos:

Un resultado que dice que una página no menciona algo puede significar solo que el prompt no preguntó por ello.

La salida es pedirlo otra vez con un prompt más específico, o usar curl desde Bash para la página sin procesar. Es exactamente la trampa en la que se cae al investigar documentación, y quien escribe esta guía ha caído en ella hoy mismo.

19.3 · Comandos slash

111 documentados. Los que se usan a diario, agrupados por para qué:

Para la lista completa, commands.md. Y para saber cuáles tienes tú disponibles, que depende de plan, proveedor y plugins, /help en tu sesión.

19.4 · Banderas del CLI, y un cruce que merece la pena

Las que sostienen casi todo lo automático de esta guía:

Y los subcomandos: agents, auth, doctor, mcp, plugin, project, import, install, update, setup-token, gateway, auto-mode, ultrareview.

El cruce contra el binario

Este módulo es el sitio natural para aplicar la disciplina de la guía a la propia guía. Comparando cli-reference.md con lo que responde claude --help en la versión 2.1.228 instalada:

⚠️ Dos banderas del binario no aparecen en la referencia del CLI:

• --brief: Enable SendUserMessage tool for agent-to-user communication. No aparece en cli-reference.md ni en ninguna de las páginas descargadas para esta guía.
• --file <specs...>: File resources to download at startup, con formato file_id:ruta_relativa. Se menciona en el changelog y en la página de permisos, pero no en la referencia del CLI.

Matiz honesto y necesario: para esta guía se han descargado unas 70 de las 187 páginas. "No aparece en las páginas descargadas" no es "no está documentada en ningún sitio". Lo verificable es lo que digo: no está en cli-reference.md, y esa es la página donde un lector iría a buscarla.

19.5 · Variables de entorno, por categoría

336 documentadas. Nadie las necesita todas; lo útil es saber por dónde buscar:

Regla de oro: una variable de entorno es otra capa de anulación por encima de tus settings (M3). Cuando un ajuste no se aplica y ya has mirado los cuatro ámbitos, mira el entorno.

19.6 · Sintaxis de reglas de permisos

{
  "permissions": {
    "allow": ["Bash(npm run test *)", "Read(~/.zshrc)"],
    "ask":   ["Bash(git push *)"],
    "deny":  ["Read(./.env)", "Read(./.env.*)", "Read(./secrets/**)", "Bash(curl *)"]
  }
}

19.7 · Los 31 eventos de hooks

Una vez por sesión: SessionStart · SessionEnd Una vez por turno: UserPromptSubmit · Stop · StopFailure En cada llamada a herramienta: PreToolUse · PostToolUse Resto: Setup · InstructionsLoaded · UserPromptExpansion · MessageDisplay · PermissionRequest · PermissionDenied · PostToolUseFailure · PostToolBatch · Notification · SubagentStart · SubagentStop · TaskCreated · TaskCompleted · TeammateIdle · ConfigChange · CwdChanged · DirectoryAdded · FileChanged · WorktreeCreate · WorktreeRemove · PreCompact · PostCompact · Elicitation · ElicitationResult

Cinco tipos de manejador: command · http · mcp_tool · prompt · agent. No todos los eventos admiten los cinco: el reparto exacto está en el M10.

19.8 · Números que conviene tener a mano

19.9 · Glosario mínimo

Checklist de verificación

• [ ] Sé que WebFetch es lossy y cuándo usar curl en su lugar.
• [ ] Sé que Grep usa sintaxis de ripgrep, no de grep POSIX.
• [ ] Sé que un cd fuera del proyecto se resetea solo.
• [ ] Sé que las variables de entorno son otra capa de anulación.
• [ ] Tengo --bare y --debug en la cabeza para diagnosticar.
• [ ] Conozco los números de la tabla del 19.8 sin buscarlos.

Errores típicos

Fuentes usadas en este módulo

Descargadas el 12 de agosto de 2026 desde code.claude.com/docs/en/:

Verificación propia: cruce de cli-reference.md contra claude --help en la versión 2.1.228 instalada, 12 de agosto de 2026.

Marcas pendientes: las dos banderas del 19.4 quedan marcadas como verificadas contra el binario y ausentes de cli-reference.md, con el matiz explícito de que no se han revisado las 187 páginas.