Comandos, flags y archivos de memoria para una sesión de Claude Code en un repo real. Los flujos de trabajo repetidos pertenecen a comandos slash personalizados. El trabajo que debe mantenerse fuera del chat principal pertenece a un subagente. Las acciones que deben ejecutarse cada vez pertenecen a hooks.
Instala y comienza una sesión
Los instaladores nativos colocan un binario claude en tu PATH y se actualizan a sí mismos en segundo plano. Homebrew, WinGet y las instalaciones de paquetes de Linux se quedan en la versión que instalaste hasta que los actualices.
| Comando | Qué hace | Ejemplo |
|---|---|---|
| Instalador nativo, macOS o Linux | Descarga el binario | curl -fsSL https://claude.ai/install.sh \| bash |
| Instalador nativo, PowerShell | Mismo instalador para Windows PowerShell | irm https://claude.ai/install.ps1 \| iex |
| Instalador nativo, CMD | Usa esto cuando irm no es un comando CMD |
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd |
| Homebrew cask | Canal estable, aproximadamente una semana atrás | brew install --cask claude-code |
| WinGet | Actualizaciones manuales | winget install Anthropic.ClaudeCode |
| Paquete global npm | Requiere Node.js 22 o posterior; el claude que ejecutas sigue siendo un binario nativo |
npm install -g @anthropic-ai/claude-code |
| Revisa el binario | Imprime una versión después de una nueva terminal | claude --version |
| Inicia sesión | Suscripción a Claude por defecto | claude auth login |
| Inicia sesión para facturación de API | Consola Anthropic en lugar de una suscripción | claude auth login --console |
| Actualiza una instalación nativa | También funciona cuando las actualizaciones en segundo plano están deshabilitadas | claude update |
| Comienza | Sesión interactiva en el directorio actual | claude |
| Comienza con un prompt | La sesión se abre en ese primer mensaje | claude "explain this project" |
En Windows nativo, instala Git para Windows para que la herramienta de shell pueda usar Git Bash. Sin él, Claude Code usa PowerShell. Homebrew y WinGet se quedan quietos hasta que ejecutes brew upgrade claude-code o winget upgrade Anthropic.ClaudeCode, a menos que CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE=1. claude install stable reinstala el binario nativo en el canal estable.
Comandos slash
Escribe / al principio de un mensaje. Las letras después de la barra inclinada filtran el menú. El texto después del nombre del comando es el argumento. Un comando slash en el medio de una oración es texto ordinario.
/review es un alias de la habilidad incluida /code-review. Una habilidad del proyecto llamada code-review reemplaza /code-review y deja /review en la habilidad incluida. Una lista de verificación personalizada pertenece a /team:review, como en comandos slash personalizados.
| Comando | Qué hace | Ejemplo |
|---|---|---|
/help |
Lista los comandos disponibles en esta sesión | /help |
/clear [name] |
Nueva conversación, contexto vacío. Alias: /reset, /new |
/clear auth-refactor |
/compact [instructions] |
Resume la conversación actual para liberar contexto | /compact Keep the failing test names |
/model [model] |
Cambia el modelo y lo guarda como el predeterminado para nuevas sesiones. Sin argumento abre un selector. En -p, un argumento de modelo se aplica solo a esa ejecución |
/model sonnet |
/init |
Escribe un CLAUDE.md inicial desde el repo. Si existe uno, sugiere ediciones |
/init |
/review |
Alias de /code-review. Las palabras de esfuerzo incluyen low, medium, high |
/review |
/memory |
Edita archivos CLAUDE.md y memoria automática |
/memory |
/config [key=value] |
UI de configuración. Alias: /settings. Las escrituras directas omiten el panel |
/config theme=dark |
/permissions |
Reglas de permitir, preguntar y denegar. Alias: /allowed-tools |
/permissions |
/cost |
Alias de /usage: costo de sesión, límites de plan, actividad |
/cost |
/agents |
Recordatorio de editar .claude/agents/ o ~/.claude/agents/. En v2.1.197 y anterior esto abría una UI de administrador |
/agents |
/hooks |
Lista los hooks configurados agrupados por evento | /hooks |
/mcp |
Lista de servidores MCP, OAuth, habilitar, deshabilitar, reconectar | /mcp |
/context muestra qué llena la ventana. /tasks lista el trabajo en segundo plano, incluidos subagentes finalizados. /doctor revisa la configuración. /vim se eliminó en v2.1.92. El modo de editor está en /config.
Establece CLAUDE_CODE_NEW_INIT=1 antes de /init para el flujo que también ofrece habilidades, hooks y un archivo de memoria personal. /init no sobrescribirá un CLAUDE.md existente.
Atajos de teclado
Las asociaciones dependen de la terminal. En el visor de transcripción, ? lista los atajos de esa vista.
| Atajo | Qué hace | Ejemplo |
|---|---|---|
Enter |
Envía el prompt | Escribe la tarea, luego Enter |
Ctrl+J |
Nueva línea sin enviar. \ seguido de Enter hace lo mismo |
Un prompt de varias líneas |
Esc |
Detiene la respuesta actual o cierra un diálogo. En un prompt de permiso lo rechaza | Esc mientras se ejecuta un comando largo |
Esc luego Esc |
Limpia un borrador, o abre rebobinar cuando la entrada está vacía | Double Esc en un prompt vacío |
Ctrl+C |
Interrumpe un turno en ejecución. Si nada se está ejecutando, el primer press limpia la entrada y el segundo salida | Ctrl+C, Ctrl+C |
Ctrl+D |
El segundo press dentro de 800 ms sale. Con texto en el prompt elimina el siguiente carácter | Ctrl+D, Ctrl+D |
Ctrl+L |
Redibuja la terminal y mantiene el historial | Después de un render corrupto |
Ctrl+O |
Visor de transcripción: llamadas de herramientas, marcas de tiempo, modelo en cada respuesta | Ctrl+O, luego q para salir |
Ctrl+R |
Búsqueda inversa del historial de prompts | Ctrl+R, luego test |
Ctrl+B |
Coloca en segundo plano un shell o agente corriendo. En tmux, presiona dos veces | Durante una ejecución de prueba larga |
Ctrl+G |
Abre el prompt en tu editor. Ctrl+X Ctrl+E es la misma asociación |
Un prompt que quieres reescribir |
Shift+Tab |
Cicla modos de permiso. El indicador etiqueta default como Manual, luego acceptEdits, plan y cuando esté disponible bypassPermissions y auto |
Shift+Tab hasta que veas plan |
Ctrl+S |
Guarda el borrador, incluido el modo shell. Presiona de nuevo en un prompt vacío para restaurar | Estaciona un prompt en el pensamiento |
@ |
Autocompletado de ruta de archivo | @src/api/server.ts |
! |
Modo shell, descrito a continuación | ! npm test |
Ctrl+J inserta una nueva línea en cada terminal. Shift+Enter solo funciona donde el emulador lo envía.
Flags CLI
El modo print (-p, --print) ejecuta el prompt y sale. Esa es la forma en que CI y scripts deben llamar. Los flags interactivos como --continue siguen aplicándose.
| Flag | Qué hace | Ejemplo |
|---|---|---|
-p, --print |
Único, sin UI interactivo | claude -p "explain this function" |
--continue, -c |
Conversación más reciente en este directorio. Omite sesiones -p anteriores a menos que también pases -p |
claude -c |
--resume, -r |
Sesión por id, nombre o ruta de transcripción. Sin valor abre un selector | claude -r auth-refactor "Finish the PR" |
--model |
Alias (sonnet, opus, haiku, fable) o un id de modelo completo. Anula el modelo de configuración y ANTHROPIC_MODEL |
claude --model sonnet |
--allowedTools, --allowed-tools |
Esas herramientas se ejecutan sin un prompt, excepto lecturas de rutas de red. Esto no elimina otras herramientas. Usa --tools para restringir el conjunto |
claude -p --allowedTools "Read" "Bash(git diff *)" "Summarize the diff" |
--output-format |
Solo modo print: text, json, o stream-json |
claude -p "query" --output-format json |
cat logs.txt | claude -p "Explain the errors" alimenta un archivo al modo print. claude -n "auth-refactor" nombra la sesión para --resume. --fork-session copia una conversación reanudada en una id nueva. --permission-mode plan comienza en modo plan. --dangerously-skip-permissions es --permission-mode bypassPermissions. Déjalo fuera en un repositorio que no confías.
Archivos de memoria
Claude lee CLAUDE.md al principio de cada sesión. El texto es instrucciones, no una política dura: líneas cortas y específicas se siguen más confiablemente que una guía de estilo larga. Intenta mantenerte bajo 200 líneas por archivo. Revisa qué se cargó realmente con /context y busca bajo Archivos de memoria.
Orden de carga, más amplio primero:
| Alcance | Ubicación | A quién se aplica |
|---|---|---|
| Política gestionada | macOS: /Library/Application Support/ClaudeCode/CLAUDE.md. Linux y WSL: /etc/claude-code/CLAUDE.md. Windows: C:\Program Files\ClaudeCode\CLAUDE.md |
Todos a quienes el administrador lo implementó |
| Usuario | ~/.claude/CLAUDE.md |
Todos tus proyectos. En Windows, ~/.claude es %USERPROFILE%\.claude |
| Proyecto | ./CLAUDE.md o ./.claude/CLAUDE.md |
El repo. Haz commit |
| Local | ./CLAUDE.local.md |
Tú, este checkout. Añádelo a .gitignore |
CLAUDE.md y CLAUDE.local.md en directorios por encima del directorio de trabajo se cargan completamente al iniciar. Un CLAUDE.md en un subdirectorio se carga cuando Claude lee archivos en ese directorio.
Mantén comandos de construcción, comandos de prueba y layout aquí. Pon un procedimiento de varios pasos en un comando slash para que se cargue solo cuando lo invokes.
Las importaciones usan @path dentro de CLAUDE.md. Las rutas relativas se resuelven desde el archivo que contiene la importación, e las importaciones pueden anidarse cuatro niveles. Una ruta dentro de backticks es literal, así que `@README` no importa README. La primera vez que un archivo de proyecto importa algo fuera del directorio de trabajo, Claude Code te pide que lo apruebes.
See @README for the layout and @docs/test-commands.md for how CI runs tests.
/memory edita estos archivos y memoria automática, que son propias notas de Claude en el directorio de memoria del proyecto en ~/.claude. Si el repo tiene AGENTS.md, importe desde CLAUDE.md. Claude Code lee CLAUDE.md. Las reglas con alcance de ruta en .claude/rules/ se cargan con los archivos que coinciden.
Refiere archivos con @
En el prompt, @ abre autocompletado de ruta de archivo. Esa mención no es el @import usado dentro de CLAUDE.md. @ también fija un subagente. Ve la guía de subagentes.
@src/auth/session.ts Explain why the cookie is rewritten on every request.
Modo Bash con !
Comienza un mensaje con ! y Claude Code ejecuta tu shell directamente. El comando y su salida llegan a la transcripción, y Claude responde a esa salida. ! npm test es suficiente para obtener una explicación de los fracasos. La respuesta cuesta lo mismo que un prompt normal.
! git status
! git diff --stat
! npm test
La salida se transmite mientras se ejecuta el comando. Ctrl+B lo coloca en segundo plano. Tab completa comandos ! anteriores en este proyecto, y un token que contiene / completa rutas. Deja el modo shell con Escape, Backspace, o Ctrl+U en un prompt vacío. Pegar una línea que comienza con ! entra en modo shell.
Estos comandos se ejecutan fuera del sandbox. El sandbox se aplica a comandos que Claude elige. Establece respondToBashCommands en false en settings.json para mantener la salida sin una respuesta automática. Una línea ! dentro de un archivo de comando es una característica diferente, cubierta en comandos slash personalizados.
Patrones que reutilizarás
# Dentro de la sesión: /init luego /permissions
claude -p --model haiku --allowedTools "Read" "Bash(git diff *)" --output-format json "Summarize risk in the diff"
claude -c -p "Are the type errors from yesterday still present?"
claude -n "billing-webhook"
claude --resume billing-webhook
/compact Keep the webhook payload schema
/cost
! npm test
@deploy/helm/values.yaml What breaks if replicaCount goes from 2 to 1?
/mcp conecta herramientas externas. La configuración está en Servidores MCP explicados. Un modelo que llama herramientas hasta que la tarea está lista es el bucle que IA agentiva describe fuera de esta CLI.
Preguntas frecuentes
¿Cómo instalo Claude Code?
En macOS o Linux ejecuta el instalador nativo desde claude.ai/install.sh. En Windows usa el instalador PowerShell, WinGet o el script CMD. npm install -g @anthropic-ai/claude-code también funciona y descarga el mismo binario nativo. Luego ejecuta claude --version y claude auth login.
¿Cuál es la diferencia entre /clear y /compact?
/clear comienza una nueva conversación con contexto vacío. Puedes pasar un nombre para que el hilo antiguo aparezca en el selector /resume. /compact se queda en la misma conversación y reemplaza turnos anteriores con un resumen para que la ventana tenga espacio de nuevo. Pasa texto de enfoque opcional a /compact cuando el resumen debe mantener un tema.
¿Dónde lee Claude Code el archivo CLAUDE.md?
Carga la política gestionada, luego ~/.claude/CLAUDE.md, luego el archivo del proyecto en ./CLAUDE.md o ./.claude/CLAUDE.md, luego ./CLAUDE.local.md. Los archivos en directorios padre de tu directorio de trabajo se cargan al iniciar. Un CLAUDE.md en un subdirectorio se carga cuando Claude lee archivos allí.
¿Cómo reanudo la sesión de Claude Code de ayer?
Desde el directorio del proyecto ejecuta claude --resume o claude -r para abrir un selector. Pasa una id de sesión o el nombre que estableciste con claude -n o /clear. claude --continue (o -c) reabre la conversación más reciente en ese directorio sin un selector.
¿Qué hace el prefijo ! en Claude Code?
Un prompt que comienza con ! se ejecuta en modo shell. Claude Code ejecuta el comando, pone la salida en la transcripción y responde. No esperas a que Claude decida llamar al shell. Establece respondToBashCommands en falso en settings.json si quieres la salida en contexto sin una respuesta automática.
Cómo se verificó esta guía
Escrita a mano a partir de la documentación oficial, con cada comando comprobado de nuevo y una segunda revisión antes de publicar. Última revisión: .
Fuentes oficiales consultadas para este artículo