Skip to main content

Atajos de teclado

Los atajos de teclado pueden variar según la plataforma y la terminal. En renderizado a pantalla completa, presione ? en el visor de transcripción para ver los atajos disponibles allí.Usuarios de macOS: Los atajos de la tecla Option/Alt (Alt+B, Alt+F, Alt+Y, Alt+M, Alt+P) requieren configurar Option como Meta en su terminal:
  • iTerm2: Configuración → Perfiles → Teclas → General → establecer la tecla Option izquierda/derecha en “Esc+”
  • Terminal de Apple: Configuración → Perfiles → Teclado → marcar “Usar Option como tecla Meta”
  • VS Code: establecer "terminal.integrated.macOptionIsMeta": true en la configuración de VS Code
Consulte Configuración de terminal para obtener más detalles.

Controles generales

Edición de texto

Tema y visualización

Entrada multilínea

Shift+Enter funciona sin configuración en iTerm2, WezTerm, Ghostty, Kitty, Warp, Terminal de Apple y Windows Terminal. Para VS Code, Cursor, Devin Desktop, Alacritty y Zed, ejecute /terminal-setup para instalar el enlace.

Comandos rápidos

Visor de transcripción

Cuando el visor de transcripción está abierto (alternado con Ctrl+O), estos atajos están disponibles. En renderizado a pantalla completa, presione ? para mostrar el panel de referencia de atajos de teclado completo dentro del visor. Ctrl+E se puede reasignar a través de transcript:toggleShowAll.

Entrada de voz

Comandos

Escriba / en Claude Code para ver todos los comandos disponibles, o escriba / seguido de cualquier letra para filtrar. El menú / muestra todo lo que puede invocar: comandos integrados, skills incluidos y creados por el usuario, y comandos contribuidos por plugins y servidores MCP. No todos los comandos integrados son visibles para todos los usuarios ya que algunos dependen de su plataforma o plan. En renderizado a pantalla completa, el comando / y las listas de sugerencias de archivos @ también responden al ratón: pasar el cursor destaca una fila y hacer clic la acepta. Consulte la referencia de comandos para obtener la lista completa de comandos incluidos en Claude Code.

Modo editor Vim

Habilite la edición de estilo vim a través de /config → Editor mode.

Cambio de modo

Remapear secuencias de teclas en modo INSERT

La configuración vimInsertModeRemaps mapea una secuencia de dos teclas en modo INSERT a Escape, por lo que un mapeo como jj lo devuelve al modo NORMAL. Requiere Claude Code v2.1.208 o posterior. El siguiente ejemplo de ~/.claude/settings.json activa el modo vim y mapea jj a Escape:
Cada clave es exactamente dos caracteres imprimibles escritos en secuencia, y "<Esc>" es el único destino compatible. Las entradas con una longitud o destino diferente se ignoran. Escribir el primer carácter de una secuencia lo inserta normalmente. Presionar el segundo carácter dentro de un segundo elimina ese carácter pendiente y cambia al modo NORMAL, sin dejar ningún carácter en su entrada. Después de la ventana de un segundo, o si una tecla diferente sigue, ambos caracteres permanecen como texto literal, por lo que aún puede escribir una palabra que contenga la secuencia haciendo una pausa entre las dos teclas. Claude Code lee esta configuración desde su archivo de configuración de usuario, la bandera --settings y configuración administrada solamente. Las entradas en el archivo .claude/settings.json o .claude/settings.local.json de un proyecto se ignoran, por lo que un repositorio extraído no puede remapear sus pulsaciones de teclas.
En modo normal de vim, si el cursor está al principio o al final de la entrada y no puede moverse más, j/k y las teclas de flecha navegan por el historial de comandos en su lugar.

Edición (modo NORMAL)

Objetos de texto (modo NORMAL)

Los objetos de texto funcionan con operadores como d, c e y:

Modo visual

Presione v para selección carácter por carácter o V para selección línea por línea. Los movimientos extienden la selección, y los operadores actúan sobre ella directamente. El modo visual por bloques con Ctrl+V no es compatible.

Historial de comandos

Claude Code mantiene el historial de comandos para la sesión actual:
  • El historial de entrada se almacena por directorio de trabajo
  • El historial de entrada se reinicia cuando ejecuta /clear para iniciar una nueva sesión. La conversación de la sesión anterior se conserva y se puede reanudar.
  • Enviar el mismo indicador dos veces seguidas registra una entrada de historial, por lo que presionar Arriba va al indicador anterior distinto
  • Use las flechas Arriba/Abajo para navegar (consulte los atajos de teclado anteriores)
  • La expansión del historial con ! está deshabilitada de forma predeterminada

Búsqueda inversa con Ctrl+R

Presione Ctrl+R para buscar de forma interactiva a través de su historial de comandos:
  1. Iniciar búsqueda: presione Ctrl+R para activar la búsqueda de historial inverso
  2. Escribir consulta: ingrese texto para buscar en comandos anteriores. El término de búsqueda se resalta en los resultados coincidentes
  3. Navegar coincidencias: presione Ctrl+R nuevamente para ciclar a través de coincidencias más antiguas
  4. Cambiar alcance: la búsqueda se establece de forma predeterminada en indicaciones de todos los proyectos. Presione Ctrl+S para ciclar el alcance entre esta sesión, este proyecto y todos los proyectos
  5. Aceptar coincidencia:
    • Presione Tab o Esc para aceptar la coincidencia actual y continuar editando
    • Presione Enter para aceptar y ejecutar el comando inmediatamente
  6. Cancelar búsqueda:
    • Presione Ctrl+C para cancelar y restaurar su entrada original
    • Presione Backspace en búsqueda vacía para cancelar
La búsqueda carga los 100 indicadores únicos más recientes en el alcance seleccionado, con duplicados contraídos a la ocurrencia más reciente. Los indicadores coincidentes se muestran con el término de búsqueda resaltado, para que pueda encontrar y reutilizar entradas anteriores. Aceptar una coincidencia o cancelar la búsqueda surte efecto inmediatamente, incluso mientras Claude Code aún está cargando el historial. Antes de v2.1.202, aceptar o cancelar durante esa carga podría informar un error interno.

Comandos bash en segundo plano

Claude Code admite la ejecución de comandos bash en segundo plano, lo que le permite continuar trabajando mientras se ejecutan procesos de larga duración.

Cómo funciona el envío a segundo plano

Cuando Claude Code ejecuta un comando en segundo plano, ejecuta el comando de forma asincrónica e inmediatamente devuelve un ID de tarea de fondo. Claude Code puede responder a nuevas indicaciones mientras el comando continúa ejecutándose en segundo plano. Para ejecutar comandos en segundo plano, puede:
  • Indicar a Claude Code que ejecute un comando en segundo plano
  • Presione Ctrl+B para mover una invocación regular de herramienta Bash al segundo plano. Los usuarios de Tmux deben presionar Ctrl+B dos veces debido a la tecla de prefijo de tmux.
Características clave:
  • La salida se escribe en un archivo y Claude puede recuperarla usando la herramienta Read
  • Las tareas de fondo tienen ID únicos para el seguimiento y la recuperación de salida
  • Las tareas de fondo se limpian automáticamente cuando Claude Code sale. Enviar la sesión a segundo plano en lugar de salir las entrega a la sesión de fondo, donde continúan ejecutándose. Consulte enviar una sesión en ejecución a segundo plano
  • Las tareas de fondo se terminan automáticamente si la salida excede 5GB, con una nota en stderr explicando por qué
  • A partir de v2.1.193, en macOS y Linux, las tareas de fondo en ejecución se terminan cuando el sistema operativo señala presión de memoria, siempre que la sesión haya estado inactiva durante al menos 30 minutos sin ningún turno o subagenteejecutándose. Establezca CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP en 1 para desactivar esto
Para deshabilitar toda la funcionalidad de tareas de fondo, establezca la variable de entorno CLAUDE_CODE_DISABLE_BACKGROUND_TASKS en 1. Consulte Variables de entorno para obtener más detalles. Comandos comúnmente enviados a segundo plano:
  • Herramientas de compilación (webpack, vite, make)
  • Gestores de paquetes (npm, yarn, pnpm)
  • Ejecutores de pruebas (jest, pytest)
  • Servidores de desarrollo
  • Procesos de larga duración (docker, terraform)

Modo shell con prefijo !

Ejecute comandos shell directamente sin pasar por Claude prefijando su entrada con !:
Modo shell:
  • Agrega el comando y su salida al contexto de la conversación
  • Muestra el progreso y la salida en tiempo real
  • Admite el mismo envío a segundo plano Ctrl+B para comandos de larga duración
  • No requiere que Claude interprete o apruebe el comando
  • Admite autocompletado basado en historial: escriba un comando parcial y presione Tab para completar desde comandos ! anteriores en el proyecto actual
  • Admite autocompletado de ruta de archivo en vivo a partir de v2.1.193 en todas las plataformas: escriba un token que contenga una barra diagonal, como ./src/ o ~/, para ver una lista desplegable de archivos y directorios coincidentes, luego presione Tab para aceptar. Use barras diagonales en Windows también; la lista desplegable se activa con /, no con \
  • Salir con Escape, Backspace o Ctrl+U en un indicador vacío
  • Pegar texto que comienza con ! en un indicador vacío entra automáticamente en modo shell, coincidiendo con el comportamiento de ! escrito
A partir de v2.1.186, Claude responde automáticamente a la salida del comando una vez que llega a la transcripción, por lo que puede ejecutar ! npm test y obtener una explicación de los fallos sin un segundo indicador. La respuesta cuesta lo mismo que enviar un indicador normal. Para restaurar el comportamiento anterior donde la salida se agrega al contexto sin una respuesta, establezca respondToBashCommands en false en settings.json. Antes de v2.1.186, el modo shell siempre agregaba la salida al contexto sin una respuesta. Esto es útil para operaciones rápidas de shell mientras se mantiene el contexto de la conversación.

Sugerencias de indicación

Cuando abre una sesión por primera vez, aparece un comando de ejemplo atenuado en la entrada de indicación para ayudarle a comenzar. Claude Code elige esto del historial de git de su proyecto, por lo que refleja archivos en los que ha estado trabajando recientemente. Después de que Claude responde, las sugerencias continúan apareciendo según su historial de conversación, como un paso de seguimiento de una solicitud de varias partes o una continuación natural de su flujo de trabajo.
  • Presione Tab o Flecha derecha para colocar la sugerencia en la entrada de indicación, luego Intro para enviar
  • Comience a escribir para descartarla
La sugerencia se ejecuta como una solicitud de fondo que reutiliza el caché de indicación de la conversación principal, por lo que el costo adicional es mínimo. Claude Code omite la generación de sugerencias cuando el caché está frío para evitar costos innecesarios. Las sugerencias se omiten automáticamente después del primer turno de una conversación y en plan mode. En print mode están deshabilitadas de forma predeterminada. Pase --prompt-suggestions con --output-format stream-json --verbose para emitir un mensaje prompt_suggestion después de cada turno en su lugar. Para deshabilitar completamente las sugerencias de indicación, establezca la variable de entorno o alterne la configuración en /config:

Preguntas laterales con /btw

Use /btw para hacer una pregunta rápida sobre su trabajo actual sin agregar al historial de conversación. Esto es útil cuando desea una respuesta rápida pero no desea saturar el contexto principal o desviar a Claude de una tarea de larga duración.
Las preguntas laterales tienen visibilidad completa de la conversación actual, por lo que puede preguntar sobre código que Claude ya ha leído, decisiones que tomó anteriormente, o cualquier otra cosa de la sesión. La pregunta y la respuesta son efímeras: aparecen en una superposición descartable y nunca entran en el historial de conversación.
  • Disponible mientras Claude está trabajando: puede ejecutar /btw incluso mientras Claude está procesando una respuesta. La pregunta lateral se ejecuta de forma independiente y no interrumpe el turno principal.
  • Sin acceso a herramientas: las preguntas laterales responden solo desde lo que ya está en contexto. Claude no puede leer archivos, ejecutar comandos o buscar al responder una pregunta lateral.
  • Respuesta única: no hay turnos de seguimiento en la superposición. Para continuar el hilo, divídalo en su propia sesión con f.
  • Bajo costo: la pregunta lateral reutiliza el caché de indicación de la conversación principal, por lo que el costo adicional es mínimo.
Las preguntas laterales anteriores de la misma sesión aparecen como una lista atenuada encima de la respuesta actual. Se mantienen fuera del historial de conversación pero permanecen visibles en la superposición hasta que las borre. Una vez que aparece la respuesta, la superposición acepta estas teclas. /btw es lo opuesto a un subagent: ve su conversación completa pero no tiene herramientas, mientras que un subagent tiene herramientas completas pero comienza con un contexto vacío. Use /btw para preguntar sobre lo que Claude ya sabe de esta sesión; use un subagent para descubrir algo nuevo.

Lista de tareas

La lista de tareas es la lista de verificación de Claude: elementos que Claude creó para planificar trabajo de varios pasos, con indicadores que muestran qué está pendiente, en progreso o completado. Es independiente de la vista de tareas en segundo plano. Para ver shells en ejecución y subagentes, use /tasks en su lugar.
  • Presione Ctrl+T para alternar la vista de la lista de tareas. La pantalla muestra hasta cinco tareas a la vez. Cuando Claude aún no ha creado ningún elemento de lista de verificación, el botón de alternancia no tiene efecto visible porque no hay nada que mostrar
  • Para ver todas las tareas o borrarlas, pregunte a Claude directamente: “show me all tasks” o “clear all tasks”
  • Las tareas persisten en compactaciones de contexto, ayudando a Claude a mantenerse organizado en proyectos más grandes
  • Para compartir una lista de tareas entre sesiones, establezca CLAUDE_CODE_TASK_LIST_ID para usar un directorio nombrado en ~/.claude/tasks/: CLAUDE_CODE_TASK_LIST_ID=my-project claude

Resumen de sesión

Cuando regresa a la terminal después de alejarse, Claude Code muestra un resumen de una línea de lo que sucedió en la sesión hasta ahora. El resumen se genera en segundo plano una vez que han pasado al menos tres minutos desde el último turno completado y la terminal no está enfocada, por lo que está listo cuando vuelve a cambiar. Los resúmenes solo aparecen una vez que la sesión tiene al menos tres turnos, y nunca dos seguidas. Ejecute /recap para generar un resumen bajo demanda. Para desactivar los resúmenes automáticos, abra /config y desactive Session recap. El resumen de sesión está activado de forma predeterminada para todos los planes y proveedores. El resumen siempre se omite en modo no interactivo.

Estado de revisión de PR

Cuando trabaja en una rama con una solicitud de extracción abierta, Claude Code muestra un enlace de PR en el que se puede hacer clic en el pie de página (por ejemplo, “PR #446”). El enlace tiene un subrayado de color que indica el estado de revisión:
  • Verde: aprobado
  • Amarillo: revisión pendiente
  • Rojo: cambios solicitados
  • Gris: borrador
El distintivo desaparece una vez que la solicitud de extracción se fusiona o se cierra. Cmd+clic (macOS) o Ctrl+clic (Windows/Linux) en el enlace para abrir la solicitud de extracción en su navegador. El estado se actualiza cada 60 segundos, e inmediatamente después de que se ejecute un comando gh pr o git push en la sesión.
El estado de PR requiere que la CLI gh esté instalada y autenticada (gh auth login).

Ver también