Modo interactivo

Referencia completa de atajos de teclado, modos de entrada y características interactivas en sesiones de Claude Code.

Atajos de teclado

Controles generales

Edición de texto

Límites de palabras en atajos de edición

Los atajos de palabras Alt+B, Alt+F, Alt+D, Option+Delete y Ctrl+Backspace tratan una palabra como una secuencia de letras y dígitos, por lo que la puntuación como _, . y / separa palabras. Con src/utils/foo.ts en el símbolo del sistema, las pulsaciones repetidas de Alt+B se detienen al inicio de ts, foo, utils y src.

Ctrl+W es diferente: ignora la puntuación y elimina hacia atrás hasta el espacio en blanco anterior, por lo que una pulsación elimina todo src/utils/foo.ts.

En texto escrito sin espacios, como chino o japonés, los atajos de palabras aún se mueven o eliminan una palabra a la vez.

Estas convenciones de readline se aplican en Claude Code v2.1.261 y posterior. La configuración keybindingFlavor que las activó en versiones anteriores está deprecada y no tiene efecto.

No puede remapear estos atajos en el archivo de configuración de atajos de teclado, que no tiene acciones para ellos.

Tema y pantalla

Entrada multilínea

Comandos rápidos

Visor de transcripción

Cuando el visor de transcripción está abierto (alternado con Ctrl+O), estos atajos están disponibles. Ejecute /tui sin argumento para verificar qué renderizador está activo. Ctrl+E puede ser remapeado a través de transcript:toggleShowAll.

Entrada de voz

Comandos

Escriba / en Claude Code para ver los comandos disponibles, o escriba / seguido de cualquier letra para filtrar. El menú / enumera comandos integrados, skills agrupadas y creadas por usuarios, 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, y algunos comandos disponibles están ocultos en el menú por diseño y se ejecutan cuando escribe su nombre completo.

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.

Completar un comando a mitad de la solicitud

La finalización de comandos también funciona a mitad de una solicitud: escriba / después de un espacio, luego las primeras letras de un nombre, como en ejecutar las pruebas, luego /com. Solo los comandos cuyos nombres comienzan con esas letras coinciden, por lo que una ruta de archivo como /tmp/notes.md no mantiene una lista abierta. Claude Code ejecuta un comando solo cuando el comando inicia su mensaje.

• En renderizado a pantalla completa: las coincidencias se abren como una lista mientras escribe, sin ninguna fila resaltada, por lo que Enter sigue enviando su solicitud tal como está escrita. Presione Tab para insertar la coincidencia superior, o seleccione una fila con las teclas de flecha y Enter.
• Fuera del renderizado a pantalla completa: el resto de la coincidencia superior aparece como texto fantasma en su cursor, con un recuento como +2 cuando hay más comandos que coinciden. Presione Tab para insertar la única coincidencia, o para abrir la lista cuando varias coinciden, luego seleccione una fila con las teclas de flecha y Enter.

En ambos renderizadores, presione Tab en un / desnudo a mitad de la solicitud para enumerar todos los comandos.

Una skill de plugin coincide también con su nombre desnudo, por lo que /deploy encuentra una skill denominada myplugin:deploy-app. Cuando inserta la coincidencia, Claude Code escribe el /myplugin:deploy-app completo.

Modo editor Vim

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

Claude Code mantiene su modo vim y la posición del cursor cuando alterna el visor de transcripción con Ctrl+O o abre y cierra un panel como /config. Si deja el prompt en modo NORMAL, sigue en modo NORMAL cuando regresa, con el cursor donde lo dejó.

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:

{
  "editorMode": "vim",
  "vimInsertModeRemaps": { "jj": "<Esc>" }
}

Cada clave es exactamente dos caracteres imprimibles escritos en secuencia, y "<Esc>" es el único destino admitido. 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 sigue una tecla diferente, 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.

Navegación (modo NORMAL)

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 por carácter o V para selección 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 un historial de los prompts que escribe, y la recuperación con la flecha hacia arriba accede a prompts de sesiones anteriores del mismo proyecto:

• El historial de entrada se almacena por directorio de trabajo
• Ejecutar /clear inicia una nueva sesión: la recuperación luego enumera los prompts de la nueva sesión primero, con los prompts de sesiones anteriores después de ellos. La conversación de la sesión anterior se conserva y se puede reanudar.
• Enviar el mismo prompt dos veces seguidas registra una entrada de historial, por lo que presionar Arriba va al prompt anterior distinto
• Cuando recupera un prompt que incluía texto pegado, Claude Code envía el contenido pegado completo nuevamente cuando lo reenvía. Si el contenido ha sido limpiado, Claude Code no envía la cadena literal [Pasted text #N]; consulte Pegar contenido grande para ver qué sucede con el prompt
• La expansión del historial con ! está deshabilitada de forma predeterminada

Búsqueda inversa con Ctrl+R

Presione Ctrl+R para buscar interactivamente en su historial de comandos. En renderizado a pantalla completa, Ctrl+R abre un diálogo de búsqueda en su lugar: escriba para filtrar, presione Arriba y Abajo para moverse entre coincidencias, y presione Ctrl+S para cambiar el alcance entre esta sesión, este proyecto y todos los proyectos. Presione Intro o Tab para colocar una coincidencia en la entrada del prompt, o Esc para cancelar. Los pasos a continuación describen la búsqueda en línea del renderizador clásico:

1. Iniciar búsqueda: presione Ctrl+R para activar la búsqueda inversa del historial
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 recorrer coincidencias más antiguas
4. Alcance de búsqueda: la búsqueda en línea siempre busca prompts de todos los proyectos
5. Aceptar coincidencia:
   • Presione Tab o Esc para aceptar la coincidencia actual y continuar editando
   • Presione Intro para aceptar y ejecutar el comando inmediatamente
6. Cancelar búsqueda:
   • Presione Ctrl+C para cancelar y restaurar su entrada original
   • Presione Retroceso en búsqueda vacía para cancelar

La búsqueda en línea escanea su historial de prompts completo, el más reciente primero, con duplicados contraídos a la ocurrencia más reciente. El diálogo a pantalla completa busca en todo su historial de prompts en el alcance seleccionado, el más reciente primero, con duplicados contraídos a la ocurrencia más reciente: los prompts más recientes aparecen inmediatamente, y las coincidencias de prompts más antiguos se rellenan a medida que Claude Code carga el resto. Los prompts 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 tiene efecto inmediatamente, incluso mientras Claude Code aún está cargando el historial.

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 la ejecución en segundo plano

Cuando Claude Code ejecuta un comando en segundo plano, lo ejecuta de forma asincrónica y devuelve inmediatamente un ID de tarea en segundo plano. 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
• Presionar Ctrl+B para mover una invocación regular de la 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 en segundo plano tienen ID únicos para el seguimiento y la recuperación de salida
• Las tareas en segundo plano se limpian automáticamente cuando Claude Code se cierra. En macOS y Linux, cuando detiene una tarea en segundo plano desde /tasks o Claude Code la detiene al salir, los procesos que se desvincularon del shell de la tarea, como los iniciados bajo setsid o timeout, también se detienen
• Si coloca la sesión en segundo plano en lugar de salir, sus tareas en segundo plano continúan ejecutándose en la sesión en segundo plano. Consulte colocar una sesión en ejecución en segundo plano
• Las tareas en segundo plano se terminan automáticamente si la salida excede 5GB, con una nota en stderr explicando por qué
• En macOS y Linux, Claude Code detiene sus tareas en segundo plano en ejecución cuando el sistema operativo señala presión de memoria crítica, siempre que la sesión haya estado inactiva durante al menos 30 minutos y no se esté ejecutando ningún turno o subagente. Requiere Claude Code v2.1.193 o posterior
  • El registro de depuración indica por qué se detuvieron las tareas, o por qué un evento de presión las dejó en ejecución
  • Establezca CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP en 1 para desactivar las detenciones por presión de memoria
• Los comandos en segundo plano propiedad de un subagente no tienen límite de tiempo, excepto que un comando propiedad de un subagente que se ejecuta en primer plano termina cuando ese subagente da su respuesta final; consulte Comandos en segundo plano en la referencia de herramientas. Antes de v2.1.218, ni la recolección de presión de memoria ni el límite anterior de 60 minutos en comandos de subagente cubrían comandos movidos al segundo plano con Ctrl+B

Para desactivar toda la funcionalidad de tareas en segundo plano, establezca la variable de entorno CLAUDE_CODE_DISABLE_BACKGROUND_TASKS en 1. Consulte Variables de entorno para obtener más detalles.

Comandos comúnmente colocados en 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 !:

! npm test
! git status
! ls -la

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 backgrounding 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 \
• Salga con Escape, Backspace, o Ctrl+U en un indicador vacío
• Pegar texto que comienza con ! en un indicador vacío entra en modo shell automáticamente, coincidiendo con el comportamiento de ! escrito

A menos que su sesión sea una de las enumeradas en modo sandbox estricto, los comandos que escribe en modo shell se ejecutan fuera del sandbox incluso cuando ha habilitado sandboxing, porque el sandbox se aplica a los comandos que ejecuta Claude.

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 errores 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 salida al contexto sin una respuesta.

Encolar mensajes mientras Claude trabaja

Escriba un mensaje y presione Enter mientras Claude está trabajando. Claude Code encola el mensaje en lugar de interrumpir el turno, y lista las entradas encoladas encima del cuadro de entrada hasta que las envía. Puede encolar comandos ! shell y la mayoría de comandos de la misma manera, aparte de los comandos, como /status, que Claude Code ejecuta tan pronto como los envía.

Los mensajes enviados y encolados se muestran en gris hasta que Claude comienza a responder a ellos, por lo que puede saber qué mensajes Claude aún no ha comenzado.

Cuándo Claude Code envía lo que encoló

Cuándo una entrada encolada llega a Claude depende de lo que encoló.

• Mensajes: si encola un mensaje mientras Claude está ejecutando llamadas de herramientas, Claude Code lo pasa a Claude tan pronto como esas llamadas de herramientas terminen, dentro del mismo turno. Cuando el turno termina con mensajes aún encolados, salen sin otra pulsación de tecla, en el orden en que los escribió
• Comandos y comandos shell: Claude Code los retiene hasta que el turno termina, luego los ejecuta uno a la vez, manteniendo el orden en que los encoló

Para enviar lo que encoló sin esperar a que el turno termine, presione Ctrl+Enter. Claude Code interrumpe el turno, y sus mensajes encolados salen de inmediato, con su borrador encolado detrás si había escrito uno. En modo shell, la tecla encola su comando sin interrumpir el turno. Requiere Claude Code v2.1.275 o posterior.

En terminales que no reportan teclas extendidas, Ctrl+Enter llega como Enter simple y encola el borrador en su lugar; Ctrl+X Ctrl+S funciona en cualquier terminal. Ambas teclas son vinculaciones de la acción chat:sendNow.

Presione Esc para interrumpir el turno sin enviar su borrador. Claude Code mantiene lo que encoló y lo envía de inmediato.

Claude Code ejecuta algunos comandos tan pronto como los envía en lugar de encolarlos, entre ellos /model, /effort, y /fast. Cada uno de los tres cambia una configuración: el modelo, el nivel de esfuerzo, o el modo rápido. Si Claude Code aplica la nueva configuración al turno en el que Claude ya está trabajando, o solo desde su siguiente turno, difiere por comando:

• /model: una vez que confirme la advertencia de caché, si Claude Code muestra una, Claude Code aplica su cambio a la siguiente solicitud que realiza en ese turno
• /effort: una vez que confirme la advertencia de caché, si Claude Code muestra una, Claude Code aplica su cambio a la siguiente solicitud que realiza en ese turno
• /fast: Claude Code mantiene la configuración de modo rápido que estaba activa cuando el turno comenzó, por lo que su cambio de velocidad se aplica desde su siguiente turno. Si su modelo actual no admite modo rápido, activarlo también cambia su modelo, y Claude Code usa el nuevo modelo desde su siguiente solicitud en ese turno

Recupere lo que encoló

Presione Up desde la primera línea del cuadro de entrada para recuperar los mensajes y comandos encolados. Claude Code los elimina de la cola y los coloca en el cuadro de entrada, uno por línea, antes de cualquier texto que haya escrito. Edite el texto y presione Enter para encolarlo nuevamente como una entrada, o borre el cuadro de entrada para descartarlo.

Claude Code recupera comandos shell encolados solo cuando el cuadro de entrada está vacío y no tiene nada más encolado, y cambia el cuadro de entrada al modo shell cuando lo hace. De lo contrario, los deja en la cola, listados con su prefijo !, y los ejecuta después de que el turno termina.

Sugerencias de prompt

Cuando abre una sesión por primera vez, Claude Code muestra un comando de ejemplo atenuado en la entrada del prompt para ayudarle a comenzar. Lo selecciona del historial de git de su proyecto, por lo que el ejemplo refleja los archivos en los que ha estado trabajando recientemente.

Después de que Claude responda, Claude Code puede sugerir su próximo prompt basándose en el historial de su 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 del prompt, luego Intro para enviar
• Comience a escribir para descartar la sugerencia

Claude Code genera cada una de estas sugerencias de próximo prompt con una solicitud de fondo que reutiliza la caché de prompts de la conversación, por lo que el costo adicional es mínimo.

Cuándo Claude Code omite sugerencias

En modo interactivo, Claude Code deja las sugerencias de prompt desactivadas de forma predeterminada y oculta el botón de alternancia Prompt suggestions en /config en una sesión que no obtiene indicadores de características, como una en un proveedor de terceros o a través de una puerta de enlace de aplicaciones Claude, y en una primera sesión después de una instalación o actualización cuyos indicadores aún no han llegado.

Claude Code también omite sugerencias individuales en varias situaciones, incluyendo:

• La caché de prompts está fría, para evitar costos innecesarios
• Después del primer turno de una conversación, en algunas sesiones
• La respuesta anterior terminó en un error
• Mientras está en Plan Mode
• Su cuenta está cerca o en su límite de uso. Para mantener las sugerencias activadas hasta que alcance el límite, establezca CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION en true. Antes de v2.1.238, Claude Code las omitía cerca del límite incluso con la variable establecida en true
• En un equipo de agentes, en las sesiones de compañeros de equipo de forma predeterminada. La sesión del líder muestra sugerencias

En modo de impresión, Claude Code no genera sugerencias de forma predeterminada. Pase --prompt-suggestions con -p "<prompt>" --output-format stream-json --verbose para que Claude Code emita un mensaje prompt_suggestion después de cada turno que genere uno. El generador también omite conversaciones muy cortas y cachés de prompts frías aquí, por lo que una única consulta -p corta puede no emitir ninguna.

Desactivar sugerencias de prompt

Para desactivar completamente las sugerencias de prompt, use cualquiera de las siguientes opciones:

• Desactive Prompt suggestions en /config
• Establezca promptSuggestionEnabled en false en su archivo de configuración
• Establezca la variable de entorno CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION en false, que tiene prioridad sobre la configuración:

  export CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=false
  

Para desactivar las sugerencias de prompt en toda una organización, establezca promptSuggestionEnabled en false en configuración administrada. También establezca CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION en false bajo la clave env administrada para que los usuarios no puedan reactivarlas con su propia variable de entorno.

Códigos de emoji

Escriba un : seguido de un código de emoji en la entrada del prompt para insertar el emoji. Requiere Claude Code v2.1.217 o posterior.

• Escriba un código completo como :heart: y Claude Code lo reemplaza con ❤️ tan pronto como escriba el : de cierre
• Escriba : más al menos dos caracteres de un nombre, como :hea, para abrir una ventana emergente de sugerencias, luego presione Tab o Enter para insertar el emoji resaltado

El código debe comenzar la entrada o seguir un espacio, por lo que un : dentro de una palabra o URL no abre sugerencias.

Para desactivar la función, establezca emojiCompletionEnabled en false en settings.json. Esto desactiva tanto la ventana emergente de sugerencias como el reemplazo en línea.

Verificar la ortografía mientras escribe

Claude Code puede subrayar palabras mal escritas en la entrada del símbolo del sistema mientras escribe. Solo verifica el texto en el cuadro de entrada, nunca las respuestas de Claude ni sus archivos. Tampoco verifica nada mientras el cuadro de entrada está en modo shell, búsqueda del historial Ctrl+R, o dictado de voz.

La verificación ortográfica está desactivada de forma predeterminada, y Claude Code no verifica nada en modo lector de pantalla. Requiere Claude Code v2.1.235 o posterior.

Requisitos previos

• Instale aspell, hunspell, o ispell y asegúrese de que esté en su PATH. Claude Code ejecuta el primero de los tres que encuentra, en ese orden, en todas las plataformas, incluido un shim .cmd que un gestor de paquetes instala en Windows.
• Para verificar que el programa está en su PATH, ejecute aspell --version, hunspell --version, o ispell -v en su terminal. Un error "command not found" significa que aún no está en su PATH.

Activar o desactivar la verificación ortográfica

Claude Code lee la configuración spellcheck desde tres lugares e la ignora en el archivo .claude/settings.json y .claude/settings.local.json de un proyecto. Actívela desde el que utilice:

{
"spellcheck": { "enabled": true }
}

{
"spellcheck": { "enabled": true }
}

claude --settings spellcheck.json

{
"spellcheck": { "enabled": true }
}

Para verificar que la verificación ortográfica está activada, escriba una palabra mal escrita y un espacio. Claude Code subraya la palabra. Si no lo hace, consulte Cuando Claude Code no subraya nada. Para desactivar la verificación ortográfica nuevamente, establezca enabled en false en el mismo lugar, o elimine spellcheck.

Para elegir cuál de los tres programas ejecuta Claude Code, qué diccionario utiliza, o el color del subrayado, agregue cualquiera de estos campos junto a enabled, en el mismo lugar:

• checker: aspell, hunspell, o ispell. Claude Code no retrocede desde un verificador que nombre, y trata cualquier otro valor como auto.
• language: un nombre de diccionario en la forma de su verificador, como en_GB. Claude Code ignora cualquier valor que no sea un nombre de diccionario simple, como una ruta o un nombre con espacios, y el verificador utiliza su diccionario predeterminado.
• color: un nombre de color como yellow, o un valor #rrggbb, #rgb, rgb(r,g,b), ansi256(n), o ansi:<name>. Claude Code utiliza el color de error de su tema de forma predeterminada y para cualquier valor que no reconozca.

Por ejemplo, esta configuración spellcheck ejecuta hunspell con su diccionario en_GB y subraya palabras en amarillo. Funciona igual en ~/.claude/settings.json, en el archivo que pasa a --settings, y en la configuración administrada:

{
  "spellcheck": {
    "enabled": true,
    "checker": "hunspell",
    "language": "en_GB",
    "color": "yellow"
  }
}

Si más de uno de los tres lugares tiene una configuración spellcheck, Claude Code utiliza solo uno de ellos: primero la configuración administrada, luego --settings, luego la configuración de usuario. No combina campos de dos lugares. Por ejemplo, cuando --settings establece spellcheck, un language en su configuración de usuario no tiene efecto.

Qué subraya Claude Code

Poco después de que deje de escribir, Claude Code subraya las palabras que el diccionario no conoce. Deja sola la palabra que aún está escribiendo hasta que se mueva más allá de ella, y nunca cambia su texto. También omite el texto que parece código:

• Comandos como /help, menciones @, URLs, rutas de archivo, y banderas como --verbose
• Palabras con dígitos, guiones bajos, o una letra mayúscula después de la primera, y texto entre comillas invertidas

Claude Code también omite texto en chino, japonés, coreano, tailandés, lao, jemer y birmano.

Claude Code no tiene su propia lista de palabras: una palabra está mal escrita cuando su verificador dice que lo está. Para evitar que Claude Code subraye una palabra, agregue la palabra al diccionario personal de su verificador, siguiendo la documentación del verificador. Claude Code recoge la palabra nueva después de reiniciarlo.

Cuando Claude Code no subraya nada

Claude Code no subraya nada cuando no puede mantener un verificador en ejecución:

• No hay verificador instalado, o el que nombró en checker falta
• El verificador falla dos veces seguidas, al inicio o más tarde en la sesión. Claude Code lo reinicia después del primer fallo y deja de verificar después del segundo, hasta que reinicie Claude Code
• El verificador tarda más de 15 segundos en responder, tres veces. Cada vez, Claude Code deja sin marcar las palabras en las que estaba esperando; después de la tercera, deja de verificar hasta que reinicie Claude Code

Para averiguar cuál de estos sucedió, inicie claude --debug con la verificación ortográfica activada y escriba una palabra. Luego busque las líneas [spellcheck] en el registro de depuración en ~/.claude/debug/<session-id>.txt. Una línea nombra el programa que Claude Code inició, o enumera los que buscó y no encontró. Las líneas posteriores dicen por qué se detuvo. Un error de diccionario faltante allí significa que el verificador no tiene diccionario para su valor language, o ninguno predeterminado cuando language no está establecido. Instale uno, o establezca language en un diccionario que tenga.

Caracteres invisibles en indicaciones

El texto pegado puede contener caracteres Unicode que una terminal dibuja como nada en absoluto, como caracteres de etiqueta, controles bidireccionales y espacios de ancho cero, por lo que una indicación puede contener texto que nunca ve. Para evitar que el texto copiado lleve instrucciones que su terminal no dibuja, Claude Code elimina esos caracteres cuando presiona Intro, antes de enviar nada. Limpia tanto la indicación como el contenido de cualquier referencia de texto pegado que la indicación incluya. Claude Code mantiene los conectores que escriben los scripts persa e índico y los selectores dentro de secuencias de emoji.

Si Claude Code eliminó algo, ese Intro no envía nada. La indicación limpia vuelve al cuadro de entrada con un aviso como Se eliminaron 3 caracteres invisibles · revise y presione Intro para enviar, y presionar Intro nuevamente envía el texto tal como se muestra.

Cuando pasa una indicación en la línea de comandos, como en claude "fix the login bug", o canaliza una en una sesión interactiva, Claude Code no espera un segundo Intro. Elimina los caracteres, muestra un aviso y envía la indicación limpia. Si la indicación limpia comenzaría con /, Claude Code la coloca en el cuadro de entrada para que la revise y envíe.

Revise cambios con /diff

Ejecute /diff para revisar los cambios en su árbol de trabajo sin salir de Claude Code. Verá las ediciones que Claude ha realizado hasta ahora junto con cualquier otra cosa que no haya confirmado.

En los cambios que /diff lee de git, un submódulo aparece como una única entrada, y solo cuando cambia la confirmación a la que apunta; las ediciones a archivos dentro del submódulo no aparecen allí.

En renderizado a pantalla completa, /diff abre el panel de diff junto a la conversación, que permanece abierto y se actualiza mientras continúa trabajando. En el renderizador clásico, /diff abre el visor de diff en lugar del mensaje, y lo cierra cuando termine de leer.

Panel de diff

El panel de diff enumera los archivos modificados con sus recuentos de líneas añadidas y eliminadas, y muestra el diff de cada archivo bajo la lista. Claude Code lo actualiza cada vez que Claude edita un archivo o ejecuta un comando de shell. Para cerrarlo, ejecute /diff nuevamente o haga clic en la ✕ en su encabezado.

Para usar el panel necesita:

• Renderizado a pantalla completa
• Un repositorio git
• Una terminal con al menos 110 columnas de ancho
• Claude Code v2.1.260 o posterior

Cuando el panel no puede abrirse, /diff abre el visor de diff en su lugar o le indica por qué.

El panel también se abre por sí solo una vez que Claude comienza a editar archivos, si su terminal tiene al menos 144 columnas de ancho. Después de haberlo abierto usted mismo con /diff, las sesiones posteriores lo abren tan pronto como Claude edita un archivo en cualquier terminal lo suficientemente ancha para contenerlo. Cierre el panel y permanecerá cerrado, en esta sesión y en las posteriores, hasta que ejecute /diff nuevamente.

Mientras el panel está abierto, puede:

• Saltar a un archivo: haga clic en su fila en la lista. Desplace el panel con la rueda del ratón. Cuando la lista de archivos en sí es demasiado larga para caber, desplácela con Alt+Arriba y Alt+Abajo, o Ctrl+Arriba y Ctrl+Abajo.
• Pregunte a Claude sobre líneas específicas: selecciónelas en el panel con el ratón. Claude Code adjunta la selección a su siguiente mensaje y muestra un recuento de líneas en la entrada hasta que lo envíe.
  • Para enviar el mensaje sin la selección, mueva el cursor justo después del indicador de recuento de líneas y presione Retroceso para eliminarlo. Requiere Claude Code v2.1.271 o posterior.
• Muestre los archivos que el panel omite: la lista omite archivos de prueba y archivos generados, y colapsa los cambios anteriores a esta sesión en una línea en la parte inferior. Haga clic en cualquier línea de recuento para expandirla.
• Cambie con qué compara el panel: presione Ctrl+X B para cambiar entre los cambios de esta sesión, sus cambios sin confirmar como una lista, y todo desde que su rama se dividió de la rama predeterminada. Claude Code recuerda la opción para cada proyecto.

Para vincular teclas a estas acciones, consulte Acciones del panel de diff.

Visor de diff

El visor de diff ocupa el lugar del mensaje hasta que lo cierre. Su vista Actual muestra sus cambios sin confirmar de git, o, cuando no hay ninguno, lo que su rama añade en la rama predeterminada. El visor también tiene una vista de turno para cada mensaje después del cual Claude editó archivos, mostrando solo esas ediciones. Claude Code construye las vistas de turno a partir de las ediciones de archivos de Claude en lugar de git, por lo que un cambio que Claude realiza a través de un comando de shell aparece solo bajo Actual.

Use estas teclas en el visor:

• Izquierda y Derecha: moverse entre Actual y las vistas de turno.
• Arriba y Abajo: seleccionar un archivo.
• Intro: abrir el diff del archivo seleccionado. Desplácelo con Arriba y Abajo, o AvPág y RePág.
• Esc: volver del diff de un archivo a la lista, o cerrar el visor desde la lista.

Para reasignar estas teclas, consulte Acciones de diff.

Preguntas laterales con /btw

Use /btw para hacer una pregunta sobre su trabajo actual sin agregar al historial de conversación.

/btw what was the name of that config file again?

Claude responde una pregunta lateral a partir de lo que ya está en la conversación: sus mensajes, sus respuestas y los resultados de herramientas que ha recopilado. Puede preguntar sobre código que Claude ya ha leído, decisiones que tomó anteriormente, o cualquier otra cosa de la sesión. Una pregunta lateral posterior también ve sus preguntas laterales anteriores: Claude Code reproduce los 20 intercambios más recientes con cada pregunta, hasta que los borre. La pregunta y la respuesta nunca entran en el historial de conversación. En la terminal, aparecen en una superposición descartable. La terminal mantiene el hilo en memoria: presione x para borrar los intercambios anteriores, y desaparece cuando sale de Claude Code.

En el panel de chat de la extensión de VS Code, /btw abre un panel en lugar de la superposición que describe esta sección, y hace preguntas de seguimiento directamente en el panel. El hilo del panel sobrevive a las recargas de ventana, según el cronograma de retención que describe esa página. Necesita la extensión en la versión 2.1.227 o posterior. Las versiones anteriores de la extensión no ofrecen /btw.

• 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. Ve todo en la conversación hasta ahora, excepto la respuesta que Claude aún está escribiendo.
• Sin acceso a herramientas: las preguntas laterales responden solo a partir de lo que ya está en contexto. Claude no puede leer archivos, ejecutar comandos o buscar al responder una pregunta lateral. Si Claude escribe llamadas de herramientas como texto de todas formas, la respuesta termina con una nota de que nada fue ejecutado.
• Respuesta única: no hay turnos de seguimiento en la superposición. Para continuar el hilo, haga otra pregunta /btw. Para continuar con acceso completo a herramientas en una sesión local, presione f para bifurcar esta pregunta y respuesta en un subagente de fondo.
• Bajo costo: mientras el almacenamiento en caché de indicaciones de la conversación esté activo, una pregunta lateral cuesta poco más allá de la respuesta en sí.

Sus cinco preguntas laterales anteriores más recientes aparecen como una lista atenuada encima de la respuesta actual, con un recuento de las más antiguas. Se mantienen fuera del historial de conversación.

Para volver a la superposición después de descartarla, ejecute /btw sin pregunta. La superposición se reabre en su intercambio más reciente. Antes de la versión 2.1.212, /btw sin pregunta imprimía un mensaje de uso en su lugar.

Una vez que aparece la respuesta, la superposición acepta estas teclas.

En una sesión de fondo adjunta, Left lo desconecta y lo devuelve a la vista de agente, incluso mientras la respuesta aún está llegando. La pregunta lateral sigue ejecutándose mientras está fuera. La próxima vez que se adjunte a la sesión, la superposición se reabre con la pregunta lateral, o con su respuesta. Antes de v2.1.257, Left no se desconectaba allí.

/btw ve su conversación completa pero no tiene herramientas. Un subagente tiene herramientas y comienza a partir del indicador que recibe, o, para una bifurcación, a partir de una copia de esta conversación. Use /btw para preguntar sobre lo que Claude ya sabe de esta sesión; use un subagente para ir a 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 múltiples pasos, con indicadores que muestran qué está pendiente, en progreso o completado. Es independiente de la vista de tarea en segundo plano. Para ver shells en ejecución y subagentes, use /tasks en su lugar.

La lista se completa solo en sesiones que tienen las herramientas de seguimiento de tareas, que Claude Code proporciona de forma predeterminada en modelos Claude 3.x, Opus 4 a través de 4.7, Sonnet 4 a través de 4.6 y Haiku 4.5. En cualquier otro modelo, incluido un ID de modelo que Claude Code no reconoce, la lista permanece vacía a menos que opte por participar con CLAUDE_CODE_ENABLE_TODO_TOOLS=1 u una de las otras formas en Disponibilidad de herramientas de tareas. Cuando la sesión tiene las herramientas, la lista de tareas funciona de la siguiente manera:

• 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
• Si deja la lista expandida, Claude Code restaura la vista expandida la próxima vez que inicie una sesión que aún tenga tareas, como con --resume o --continue. Cuando la lista de tareas está vacía, Claude Code la inicia contraída
• Para ver todas las tareas o borrarlas, pregúntele directamente a Claude: "muéstrame todas las tareas" o "borra todas las tareas"
• Las tareas persisten en las 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 ha sucedido en la sesión hasta el momento. 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. Claude Code limita tanto los resúmenes automáticos como la salida de /recap a 400 caracteres. Para desactivar los resúmenes automáticos, abra /config y desactive Resumen de sesión.

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.

Esperar a que se reinicie un límite de uso

Cuando un límite de uso de claude.ai detiene a Claude a mitad de una tarea, Claude Code espera en la sesión abierta y continúa la tarea automáticamente después de que se reinicie el límite. La continuación automática está activada de forma predeterminada en sesiones interactivas con sesión iniciada con una suscripción de claude.ai. Requiere Claude Code v2.1.234 o posterior.

Mientras Claude Code espera, una línea en la parte inferior de la sesión muestra cuándo continuará:

Usage limit reached · continuing automatically at 3:45pm · esc to cancel

Mantenga la sesión abierta. Lo que sucede a continuación depende de cómo termine la espera:

• En el reinicio: la línea lee continuing shortly, luego Usage limit reset · continuing automatically, y Claude Code envía a Claude un mensaje fijo para retomar la tarea donde se detuvo. No reenvía su último mensaje.
• Después de que su computadora se durmió: si se durmió durante más de aproximadamente 30 minutos y el límite se reinició mientras dormía, la línea lee Your usage limit has reset · press enter to continue. Presione Enter para continuar. Después de un sueño más corto, Claude Code continúa automáticamente.
• Temprano: cuando termina de agregar créditos de uso con /usage-credits, inicia sesión nuevamente después de /upgrade, o cambia modelos con /model durante la espera, Claude Code verifica si el uso está disponible nuevamente y continúa de inmediato si es así. No verifica después de una actualización o compra que realice en un navegador por su cuenta. En opusplan y otras configuraciones de modelo que ejecutan el modo de plan en un modelo diferente, Claude Code espera el reinicio en su lugar.

La tarea continuada se ejecuta como cualquier otro turno. Claude Code aún solicita permisos como de costumbre, por lo que la tarea puede detenerse en un mensaje mientras está fuera. Si vuelve a alcanzar el límite, Claude Code reactiva la espera automáticamente como máximo dos veces seguidas, luego se detiene y muestra Automatic continue stopped after repeated usage-limit hits · /rate-limit-options to try again.

Cancelar la espera

Presione Esc en un mensaje vacío, o Ctrl+C, mientras se muestra la línea, o ejecute /rate-limit-options y seleccione Don't continue automatically. Claude Code confirma con una línea que comienza con Automatic continue cancelled.

Después de una cancelación, nada continúa hasta que envíe un mensaje o seleccione la fila que comienza con Wait here, then continue automatically de /rate-limit-options nuevamente. Claude Code no inicia una espera por su cuenta nuevamente para esa ventana de reinicio; la siguiente ventana de reinicio comienza de nuevo.

La espera también termina sin continuar la tarea en estos casos:

• Envía un mensaje: Claude Code ejecuta su mensaje en lugar de esperar.
• Sale de Claude Code: la espera no se reinicia cuando reanuda la sesión.
• La conversación cambia de manos: cambia de cuenta con /login, borra o rebobina la conversación, /resume otra sesión, extrae una con /teleport, relanza con /tui, o entrega la sesión a Claude Desktop, una sesión de fondo o la nube.
• La configuración se desactiva, o el reinicio se mueve más allá de 24 horas: esto solo termina una espera que Claude Code inició por su cuenta. Una espera que seleccionó de /rate-limit-options sigue contando hacia atrás.
• La continuación está bloqueada: un hook UserPromptSubmit que bloquea el mensaje de continuación, o una falla antes de que llegue al modelo, termina la espera. Claude Code le indica que la continuación no se ejecutó. Envíe un mensaje para continuar.

Inicie una espera usted mismo

Claude Code no inicia la espera por su cuenta en estos casos:

• Sesiones de Control Remoto y compañero de equipo de agentes: una persona en esa terminal aún puede iniciar una.
• Un reinicio a más de 24 horas de distancia: un límite semanal puede reiniciarse días después.
• Un límite de Opus o Sonnet mientras ejecuta un modelo fuera de esa familia: su próximo turno puede no alcanzar ese límite. opusplan y otras configuraciones de modelo que ejecutan el modo de plan en la familia limitada no obtienen esta excepción.

En esos casos, y siempre que la continuación automática esté desactivada, Claude Code abre el menú de opciones de límite de uso una vez por ventana de reinicio cuando alcanza un límite en su propia terminal. Seleccione la fila que comienza con Wait here, then continue automatically para iniciar la espera. En una sesión de Control Remoto o compañero de equipo de agentes, ejecute /rate-limit-options usted mismo para abrir el menú.

Claude Code no ofrece la espera en absoluto en estos casos:

• Sesiones de fondo y ejecuciones -p: la fila del menú no está disponible.
• Claves API, proveedores en la nube y facturación basada en el uso: el uso allí se mide por solicitud, por lo que no hay reinicio para esperar.
• Un gateway LLM sin un inicio de sesión de claude.ai guardado: Claude Code ofrece la espera solo mientras un inicio de sesión de claude.ai guardado es la credencial activa.

Desactivar la continuación automática

En /config, desactive Continue automatically at usage limit, o establezca autoContinueAtUsageLimit en false en su configuración de usuario. /config autoContinueAtUsageLimit=false también funciona, incluso con -p, pero la forma key=value no puede volver a activarlo, porque la configuración otorga ejecución desatendida. Qué archivos de configuración lee Claude Code para esta clave se encuentra en la referencia de configuración.

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 pie de página, como "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

La insignia desaparece una vez que la solicitud de extracción se fusiona o se cierra.

Cmd+click (macOS) o Ctrl+click (Windows/Linux) en el enlace para abrir la solicitud de extracción en su navegador.

El estado se actualiza tan pronto como un git push, o un comando gh pr que cambie la solicitud de extracción, como gh pr create o gh pr merge, se ejecuta correctamente en la sesión.

Claude Code representa la insignia como un hipervínculo incluso cuando no puede detectar soporte de hipervínculo en su terminal, lo que comúnmente ocurre a través de SSH o en tmux. Establezca FORCE_HYPERLINK=0 para representar la insignia como texto sin formato.

Cuando establece CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, Claude Code no verifica el estado de la solicitud de extracción o solicitud de fusión.

Solicitudes de fusión de GitLab

Cuando trabaja en una rama con una solicitud de fusión abierta de GitLab, Claude Code muestra una insignia MR !N en el espacio del pie de página que de otro modo contendría el enlace de PR de GitHub. !N es la propia sintaxis de referencia de GitLab para el número de solicitud de fusión N. El subrayado de color muestra el estado de la solicitud de fusión:

• Verde: GitLab reporta que la solicitud de fusión es fusionable
• Amarillo: cualquier otro estado abierto
• Gris: borrador

La insignia desaparece una vez que la solicitud de fusión se fusiona o se cierra.

Se actualiza tan pronto como un git push, o un comando glab mr que cambie la solicitud de fusión, como glab mr create o glab mr merge, se ejecuta correctamente en la sesión.

Para obtener la insignia, necesita:

• Claude Code v2.1.234 o posterior
• Un repositorio remoto que apunte a su host de GitLab, ya sea gitlab.com o una instancia autogestionada
• La CLI glab en su PATH, autenticada con glab auth login

Claude Code ignora las variables de entorno del token de glab, como GITLAB_TOKEN, cuando verifica el estado, por lo que no obtiene ninguna insignia de un token exportado solo. Claude Code también busca glab y su inicio de sesión una vez por sesión, por lo que reinicie Claude Code después de instalar glab o ejecutar glab auth login.

Enlaces de referencia de problemas

Cuando Claude menciona un problema como owner/repo#123, puede hacer clic en la referencia para abrirlo, siempre que su terminal admita hipervínculos. Si Claude Code no detecta compatibilidad con hipervínculos en su terminal, establezca FORCE_HYPERLINK en 1 para activar los enlaces, o en 0 para mantener las referencias como texto sin formato.

Solo obtiene un enlace para el formulario de dos partes owner/repo#123. Estos permanecen como texto sin formato:

• Un #123 desnudo
• Una ruta anidada de GitLab como group/subgroup/project#123
• Cualquier referencia dentro de un intervalo de código o bloque de código

Claude Code construye el enlace para el host del repositorio que identifica desde su remoto de git, no para el repositorio que nombra la referencia:

Ver también

• Skills - Indicaciones personalizadas y flujos de trabajo
• Checkpointing - Rebobinar las ediciones de Claude y restaurar estados anteriores
• Referencia de CLI - Banderas y opciones de línea de comandos
• Configuración - Opciones de configuración
• Gestión de memoria - Gestión de archivos CLAUDE.md