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+D, Alt+Y, Alt+P) requieren configurar Option como Meta en su terminal. Consulte Habilitar atajos de tecla Option en macOS para la configuración en cada terminal.Controles generales
Edición de texto
Límites de palabras en atajos de edición
Los atajos de palabrasAlt+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 conCtrl+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
Entersigue enviando su solicitud tal como está escrita. PresioneTabpara insertar la coincidencia superior, o seleccione una fila con las teclas de flecha yEnter. - Fuera del renderizado a pantalla completa: el resto de la coincidencia superior aparece como texto fantasma en su cursor, con un recuento como
+2cuando hay más comandos que coinciden. PresioneTabpara insertar la única coincidencia, o para abrir la lista cuando varias coinciden, luego seleccione una fila con las teclas de flecha yEnter.
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ónvimInsertModeRemaps 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:
"<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)
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 ↑/↓ navegan por el historial de comandos en su lugar. ← en un prompt vacío abre vista de agente desde modo NORMAL así como INSERT; antes de v2.1.219, ← en un prompt vacío no hacía nada en modo NORMAL.Edición (modo NORMAL)
Objetos de texto (modo NORMAL)
Los objetos de texto funcionan con operadores comod, c e y:
Modo visual
Presionev 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
/clearinicia 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
PresioneCtrl+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:
- Iniciar búsqueda: presione
Ctrl+Rpara activar la búsqueda inversa del historial - Escribir consulta: ingrese texto para buscar en comandos anteriores. El término de búsqueda se resalta en los resultados coincidentes
- Navegar coincidencias: presione
Ctrl+Rnuevamente para recorrer coincidencias más antiguas - Alcance de búsqueda: la búsqueda en línea siempre busca prompts de todos los proyectos
- Aceptar coincidencia:
- Presione
TaboEscpara aceptar la coincidencia actual y continuar editando - Presione
Intropara aceptar y ejecutar el comando inmediatamente
- Presione
- Cancelar búsqueda:
- Presione
Ctrl+Cpara cancelar y restaurar su entrada original - Presione
Retrocesoen búsqueda vacía para cancelar
- Presione
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+Bpara mover una invocación regular de la herramienta Bash al segundo plano. Los usuarios de Tmux deben presionarCtrl+Bdos veces debido a la tecla de prefijo de tmux.
sleep. Para cambiar cuánto tiempo se ejecutan los comandos antes de que esto suceda, establezca las variables de entorno de tiempo de espera de Bash.
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
/taskso Claude Code la detiene al salir, los procesos que se desvincularon del shell de la tarea, como los iniciados bajosetsidotimeout, 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_REAPen1para 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
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 !:
- 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+Bpara 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
Tabpara 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 presioneTabpara aceptar. Use barras diagonales en Windows también; la lista desplegable se activa con/, no con\ - Salga con
Escape,Backspace, oCtrl+Uen 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
! 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 presioneEnter mientras Claude está trabajando. Claude Code encola el mensaje en lugar de interrumpir el turno, y lista las entradas encoladas en la conversación 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.
Si encola un mensaje con una selección adjunta desde un IDE conectado o el panel de diferencias, mantiene la selección que tenía cuando presionó Enter, sin importar lo que seleccione después.
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ó
Ctrl+Enter. Sus mensajes encolados salen de inmediato, con su borrador encolado detrás si había escrito uno. Requiere Claude Code v2.1.275 o posterior.
Si encoló un comando shell ! antes de sus mensajes, la tecla interrumpe el turno. De lo contrario, lo que sucede con el turno depende de lo que Claude esté haciendo cuando presione la tecla:
- Ejecutando comandos shell, subagentes u otro trabajo que pueda moverse al fondo: ese trabajo se mueve al fondo y sigue ejecutándose, y Claude lee sus mensajes en el mismo turno
- Solo escribiendo una respuesta, o ejecutando algo que no pueda moverse al fondo: Claude Code interrumpe el turno y envía sus mensajes a continuación. Antes de v2.1.281, la tecla interrumpía el turno en ambos casos
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ó
PresioneUp 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
TaboFlecha derechapara colocar la sugerencia en la entrada del prompt, luegoIntropara enviar - Comience a escribir para descartar la sugerencia
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_SUGGESTIONentrue. Antes de v2.1.238, Claude Code las omitía cerca del límite incluso con la variable establecida entrue - En un equipo de agentes, en las sesiones de compañeros de equipo de forma predeterminada. La sesión del líder muestra sugerencias
--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
promptSuggestionEnabledenfalseen su archivo de configuración - Establezca la variable de entorno
CLAUDE_CODE_ENABLE_PROMPT_SUGGESTIONenfalse, que tiene prioridad sobre la configuración:
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 presioneTaboEnterpara insertar el emoji resaltado
: 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 historialCtrl+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.cmdque un gestor de paquetes instala en Windows. - Para verificar que el programa está en su
PATH, ejecuteaspell --version,hunspell --version, oispell -ven su terminal. Un error “command not found” significa que aún no está en suPATH.
Activar o desactivar la verificación ortográfica
Claude Code lee la configuraciónspellcheck 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:
- Configuración de usuario
- Línea de comandos
- Configuración administrada
Agregue
spellcheck a ~/.claude/settings.json. Se aplica en cada proyecto que abre, como el resto de su configuración de usuario: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, oispell. Claude Code no retrocede desde un verificador que nombre, y trata cualquier otro valor comoauto.language: un nombre de diccionario en la forma de su verificador, comoen_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 comoyellow, o un valor#rrggbb,#rgb,rgb(r,g,b),ansi256(n), oansi:<name>. Claude Code utiliza el color de error de su tema de forma predeterminada y para cualquier valor que no reconozca.
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, 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
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
checkerfalta - 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
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 comoSe 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
/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+ArribayAlt+Abajo, oCtrl+ArribayCtrl+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
Retrocesopara eliminarlo. Requiere Claude Code v2.1.271 o posterior.
- Para enviar el mensaje sin la selección, mueva el cursor justo después del indicador de recuento de líneas y presione
- 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 Bpara 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.
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.
Preguntas laterales con /btw
Use/btw para hacer una pregunta sobre su trabajo actual sin agregar al historial de conversación.
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
/btwincluso 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, presionefpara 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í.
/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+Tpara 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
--resumeo--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_IDpara 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á:- En el reinicio: la línea lee
continuing shortly, luegoUsage 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. PresioneEnterpara 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/modeldurante 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. Enopusplany otras configuraciones de modelo que ejecutan el modo de plan en un modelo diferente, Claude Code espera el reinicio en su lugar.
Automatic continue stopped after repeated usage-limit hits · /rate-limit-options to try again.
Cancelar la espera
PresioneEsc 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,/resumeotra 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-optionssigue contando hacia atrás. - La continuación está bloqueada: un hook
UserPromptSubmitque 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.
opusplany otras configuraciones de modelo que ejecutan el modo de plan en la familia limitada no obtienen esta excepción.
/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
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.
El estado de PR para repositorios de GitHub necesita un token de GitHub. Claude Code encuentra uno basado en el host remoto:
- github.com:
GH_TOKENoGITHUB_TOKEN, o el token guardado porgh auth login. Sin uno, el pie de página muestrainstall gh for PR statuscuando la CLIghno está instalada, ogh auth login for PR statuscuando lo está - Un host de GitHub Enterprise establecido como
GH_HOST:GH_ENTERPRISE_TOKENoGITHUB_ENTERPRISE_TOKEN, o el token guardado porgh auth login --hostname <host>. Sin uno, el pie de página muestra las mismas sugerencias - Cualquier otro host de GitHub: el token guardado por
gh auth login --hostname <host>. Sin uno, Claude Code no muestra ninguna insignia ni sugerencia
Solicitudes de fusión de GitLab
Cuando trabaja en una rama con una solicitud de fusión abierta de GitLab, Claude Code muestra una insigniaMR !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
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
glaben suPATH, autenticada conglab auth login
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 comoowner/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
#123desnudo - Una ruta anidada de GitLab como
group/subgroup/project#123 - Cualquier referencia dentro de un intervalo de código o bloque de código
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