Glosario de comandos: Claude Code

Referencia rápida de los comandos de Claude Code para tener a mano mientras trabajas. Está organizada en cinco partes: comandos de terminal (CLI) y sus flags, slash commands dentro de la sesión, atajos y prefijos, modos de permisos, y comandos personalizados. Claude Code cambia seguido — esta lista se contrastó con la documentación oficial en septiembre de 2026; si un comando no te aparece, actualiza con claude update y revisa /help.

Comandos de terminal (CLI)

Estos se ejecutan desde tu terminal, fuera o antes de una sesión.

claude — inicia una sesión interactiva en el directorio actual. Es el punto de partida de todo.

claude "tu instrucción" — inicia la sesión interactiva con una primera instrucción ya enviada.

claude -p "tu instrucción" — modo headless (print): ejecuta la tarea, imprime el resultado y termina, sin sesión interactiva. Ideal para scripts y automatizaciones.

cat archivo.txt | claude -p "resume esto" — puedes canalizar (pipe) contenido de entrada al modo headless.

claude -c o claude --continue — retoma la conversación más reciente del directorio, con todo su contexto.

claude -r o claude --resume — abre el selector de sesiones anteriores para elegir cuál retomar; con un ID o un nombre (claude -r "mi-feature") va directo a esa sesión.

claude -n "nombre" — le pone nombre a la sesión para retomarla después por ese nombre en vez de por ID.

claude update — actualiza Claude Code a la última versión.

claude doctor — diagnostica la instalación: versión, permisos, configuración de red.

claude mcp — administra servidores MCP desde la CLI: claude mcp add, claude mcp list, claude mcp remove, y claude mcp login <nombre> para el flujo OAuth de un servidor.

claude plugin — instala, lista y administra plugins (paquetes de skills, agentes y servidores MCP) desde la terminal.

claude auth login / logout / status — inicia o cierra sesión y muestra el estado de autenticación (útil en scripts: status termina con código 0 si hay sesión). El antiguo claude config ya no existe: la configuración vive en ~/.claude/settings.json (usuario) y .claude/settings.json (proyecto).

Flags útiles

Se agregan a los comandos anteriores para modificar su comportamiento.

--model — elige el modelo con el que parte la sesión, por alias (sonnet, opus, haiku) o por ID completo.

--effort — fija el nivel de esfuerzo de razonamiento (low, medium, high, xhigh, max): más esfuerzo, respuestas más pensadas y más lentas.

--permission-mode — arranca en un modo de permisos concreto: default, acceptEdits, plan, auto, dontAsk o bypassPermissions (los modos se explican abajo).

--add-dir ruta — da acceso a directorios adicionales fuera del directorio de trabajo.

--allowed-tools / --disallowed-tools — reglas de herramientas permitidas o bloqueadas para la sesión, con patrones: --allowed-tools "Bash(git log *)" "Read". Las formas --allowedTools / --disallowedTools siguen funcionando.

--output-format json — en modo headless, entrega la respuesta como JSON estructurado (también existe stream-json para streaming). Con --json-schema puedes exigir que el JSON cumpla un esquema.

--max-turns N y --max-budget-usd N — en modo headless, limitan la cantidad de turnos agénticos o el gasto en dólares antes de detenerse. Control de costo.

--verbose — muestra el detalle de cada paso y llamada a herramienta. Útil para depurar.

--dangerously-skip-permissions — ejecuta todo sin pedir confirmación (equivale a --permission-mode bypassPermissions). Solo para entornos aislados (contenedores, CI) — el nombre es una advertencia real.

Slash commands (dentro de la sesión)

Se escriben al inicio del mensaje, partiendo con /.

Sesión y contexto

/help — lista todos los comandos disponibles en tu versión.

/clear — borra el historial de la conversación y parte de cero. El contexto anterior se pierde (puedes pasarle un nombre para etiquetar la conversación que cierras).

/compact — resume la conversación para liberar ventana de contexto sin perder el hilo. Acepta instrucciones: /compact enfócate en los cambios de la API.

/context — visualiza cuánto de la ventana de contexto está ocupado y por qué (mensajes, herramientas, archivos), con sugerencias para aliviarla.

/rewind — vuelve a un punto anterior de la sesión (checkpoint), restaurando conversación y/o código.

/export — exporta la conversación actual como texto plano; con un nombre de archivo la escribe directo ahí.

/resume — cambia a otra sesión anterior (por ID o nombre, o desde el selector) sin salir de Claude Code.

/diff — muestra los cambios en tu árbol de trabajo, incluidas las ediciones que Claude hizo en la sesión. La revisión antes de commitear.

/tasks — lista y administra el trabajo en segundo plano de la sesión: subagentes, comandos largos, tareas terminadas.

Proyecto y configuración

/init — analiza el proyecto y genera el archivo CLAUDE.md con la documentación base que Claude leerá en cada sesión.

/memory — abre los archivos de memoria (CLAUDE.md de proyecto y de usuario) para editarlos, y permite activar o desactivar la memoria automática.

/model — cambia de modelo en plena sesión y lo guarda como predeterminado para las siguientes.

/effort — ajusta el nivel de esfuerzo de razonamiento sin reiniciar la sesión.

/config — abre el panel de configuración: tema, modelo por defecto, estilo de salida, modo de edición (aquí vive hoy el modo vim, que antes era /vim).

/permissions — administra las reglas de permisos: qué herramientas y comandos se ejecutan sin preguntar, cuáles piden confirmación y cuáles quedan bloqueados.

/plan — entra a plan mode: Claude investiga y propone un plan sin tocar nada hasta que lo apruebes.

/add-dir — agrega directorios de trabajo adicionales a la sesión en curso.

/statusline — configura la barra de estado de la terminal (branch, modelo, contexto usado). Le describes lo que quieres y Claude la arma.

/output-style — lista los estilos de respuesta o cambia a uno (por ejemplo concise, explanatory, learning).

/terminal-setup — instala el atajo Shift+Enter para saltos de línea en tu terminal.

Herramientas e integraciones

/mcp — muestra el estado de los servidores MCP conectados, los reconecta o desactiva, y gestiona su autenticación OAuth.

/skills — muestra las skills disponibles (propias, del proyecto, de plugins y las incluidas).

/plugin — instala y administra plugins desde dentro de la sesión.

/agents — ya no abre un asistente propio: te recuerda que los subagentes se crean y editan pidiéndoselo a Claude directamente (viven como archivos en .claude/agents/).

/hooks — muestra la configuración de hooks: comandos que se ejecutan automáticamente antes o después de las acciones de Claude (formatear al guardar, bloquear comandos, notificar).

/code-review (alias /review) — revisa el diff actual, un PR por número, una rama o una ruta buscando errores de corrección; con --fix aplica los hallazgos. Acepta un nivel de esfuerzo (/code-review high). Los comentarios de un PR ya no tienen comando propio (/pr-comments se eliminó): pídeselos a Claude directamente.

/install-github-app — instala la app de GitHub de Claude en un repositorio para invocarlo desde issues y PRs, con la opción de configurar GitHub Actions.

Cuenta y diagnóstico

/status — abre la configuración en la pestaña de estado: versión, modelo activo, cuenta y conectividad.

/usage (alias /cost) — costo de la sesión, límites de tu plan y estadísticas de actividad.

/login / /logout — cambia o cierra la cuenta de Anthropic activa.

/doctor — chequea la salud de la instalación sin salir de la sesión y puede arreglar problemas comunes.

/bug — reporta un problema directamente al equipo de Anthropic; eliges cuánto historial de la sesión adjuntar. /feedback abre el mismo diálogo para sugerencias.

Atajos de teclado y prefijos

Esc — interrumpe a Claude a mitad de una acción (o cierra un diálogo). No cierra la sesión: puedes corregir el rumbo y seguir.

Esc Esc (doble) — limpia el borrador del mensaje o abre el rewind para volver a un punto anterior y restaurar conversación y/o código.

Shift+Tab — alterna los modos de permisos: normal → auto-aceptar ediciones → plan mode (y auto mode, si lo habilitaste). En Windows, si tu terminal no lo toma, Alt+M.

! al inicio del mensaje — ejecuta un comando de shell directamente y su salida queda en la conversación. Ejemplo: ! npm test.

@ — autocompleta rutas de archivos del proyecto para referenciarlos con precisión. Ejemplo: explícame @src/lib/auth.ts.

Ctrl+C — interrumpe la acción en curso o limpia lo que escribiste. Ctrl+D sale de la sesión.

Ctrl+R — busca hacia atrás en el historial de tus mensajes (como en bash).

Ctrl+O — abre o cierra el visor de transcripción: la salida completa y expandida de cada paso.

Ctrl+T — muestra u oculta la lista de tareas que Claude va marcando.

Arrastrar o pegar imágenes — puedes soltar capturas de pantalla en la terminal y Claude las analiza (mockups, errores de UI, diagramas).

Ojo: el antiguo prefijo # para guardar una nota en CLAUDE.md desde el mensaje ya no existe. Hoy Claude Code tiene memoria automática (guarda sola lo que aprende del proyecto en ~/.claude/projects/<proyecto>/memory/) y las reglas fijas se escriben a mano en CLAUDE.md con /memory.

Modos de permisos

Modo normal (default) — Claude pide confirmación antes de editar archivos o ejecutar comandos. El punto de partida seguro.

Auto-accept (acceptEdits) — las ediciones de archivos se aplican sin preguntar; los comandos sensibles siguen pidiendo permiso. Para cuando ya hay confianza en la tarea.

Plan mode (plan) — Claude solo lee y analiza: propone un plan detallado y no toca nada hasta que lo apruebes. Ideal para cambios grandes o proyectos ajenos.

Auto mode (auto) — un clasificador decide por ti: aprueba las acciones seguras y frena las peligrosas sin interrumpirte. Se habilita en la configuración y entra al ciclo de Shift+Tab.

Don’t ask (dontAsk) — todo lo que necesitaría confirmación se niega en vez de preguntarse. Para ejecuciones desatendidas donde prefieres que falle antes que arriesgar.

Skip permissions (bypassPermissions) — todo se ejecuta sin confirmación (el flag --dangerously-skip-permissions). Solo en entornos aislados y descartables.

Comandos personalizados

Skills — carpetas con un SKILL.md que empaquetan instrucciones, scripts y recursos reutilizables: .claude/skills/revisar-seguridad/SKILL.md se invoca como /revisar-seguridad, y Claude también las activa solo cuando la tarea calza con su descripción. Aceptan argumentos con $ARGUMENTS (o $0, $1, y argumentos con nombre).

Custom slash commands (legado) — los archivos markdown en .claude/commands/ siguen funcionando y se fusionaron con las skills: revisar-seguridad.md ahí crea el mismo /revisar-seguridad. Para lo nuevo, usa skills.

CLAUDE.md — no es un comando, pero es la pieza que más cambia la experiencia: el archivo que Claude lee al inicio de cada sesión con las convenciones, comandos de build y reglas de tu proyecto. Se crea con /init y se edita con /memory. Su hermano CLAUDE.local.md guarda preferencias personales que no van al repositorio.

---

Si quieres ver estos comandos aplicados de principio a fin — de la idea a una app desplegada — revisa el Claude Code Workshop for Developers de la academia.