Configura tu terminal para Claude Code

Corrige Shift+Enter para saltos de línea, obtén una campana de terminal cuando Claude termine, configura tmux, coincide con el tema de color y habilita el modo Vim en la CLI de Claude Code.

Claude Code funciona en cualquier terminal sin configuración. Esta página es para cuando algo específico no se comporta como se espera. Encuentre su síntoma a continuación. Si todo ya se siente bien, no necesita esta página.

• Shift+Enter envía en lugar de insertar una salta de línea
• Los atajos de tecla Option no hacen nada en macOS
• Sin sonido ni alerta cuando Claude termina
• Ejecuta Claude Code dentro de tmux
• Retroceso elimina una palabra completa en Windows
• La pantalla parpadea o el desplazamiento hacia atrás salta
• Deseas teclas Vim en el símbolo del sistema

Esta página trata sobre cómo hacer que tu terminal envíe las señales correctas a Claude Code. Para cambiar qué teclas responde Claude Code en sí, consulta atajos de teclado en su lugar.

Ingresar prompts de varias líneas

Al presionar Enter se envía tu mensaje. Para agregar un salto de línea sin enviarlo, presiona Ctrl+J, o escribe \ y luego presiona Enter. Ambas opciones funcionan en cualquier terminal sin necesidad de configuración.

En la mayoría de las terminales también puedes presionar Shift+Enter, pero la compatibilidad varía según el emulador de terminal:

Para VS Code, Cursor, Devin Desktop, Alacritty anterior a 0.16 y Zed, /terminal-setup escribe un atajo de teclado Shift+Enter en el archivo de configuración de la terminal. En la primera ejecución ves una confirmación como Installed VSCode terminal Shift+Enter key binding. Los atajos de teclado existentes se mantienen; si ves un mensaje como VSCode terminal Shift+Enter key binding already configured, no se realizó ningún cambio. Ejecuta /terminal-setup directamente en la terminal anfitriona y no dentro de tmux o screen, ya que necesita escribir en la configuración de la terminal anfitriona.

En VS Code, Cursor y Devin Desktop, /terminal-setup también actualiza dos ajustes del editor: establece terminal.integrated.gpuAcceleration en "off" para evitar texto distorsionado en la terminal integrada, y establece terminal.integrated.mouseWheelScrollSensitivity para un desplazamiento más fluido en el modo de pantalla completa. Para deshacer el cambio de aceleración por GPU, vuelve a establecerlo en "auto" y recarga la ventana del editor.

En Zed, /terminal-setup actualiza tu keymap.json directamente:

• Si el keymap ya tiene atajos de teclado y ninguno de ellos es un shift-enter de Terminal, Claude Code primero crea una copia de seguridad en el mismo directorio, como keymap.json.1a2b3c4d.bak, y luego combina el atajo de teclado Shift+Enter en tu keymap, conservando tus otros atajos de teclado y comentarios
• Si Claude Code no puede leer o analizar el keymap, no puede crear la copia de seguridad o no puede verificar el resultado combinado, deja el archivo sin cambios e imprime el bloque del atajo de teclado para que lo agregues tú mismo

Si estás ejecutando dentro de tmux, Shift+Enter también requiere la configuración de tmux que aparece más abajo, incluso cuando la terminal externa lo admite.

Para asignar la nueva línea a otra tecla, o para intercambiar el comportamiento de modo que Enter inserte una nueva línea y Shift+Enter envíe, asigna las acciones chat:newline y chat:submit en tu archivo de atajos de teclado.

Habilitar atajos con la tecla Option en macOS

Algunos atajos de Claude Code usan la tecla Option, como Option+Enter para una nueva línea u Option+P para cambiar de modelo. En macOS, la mayoría de las terminales no envían Option como modificador de forma predeterminada, así que estos atajos no hacen nada hasta que lo habilites. El ajuste de la terminal para esto suele llamarse "Use Option as Meta Key"; Meta es el nombre histórico en Unix de la tecla que ahora se etiqueta como Option o Alt.

Apple Terminal

Abre Settings → Profiles → Keyboard y marca "Use Option as Meta Key".

Si aceptaste el prompt de configuración de la terminal que Claude Code muestra la primera vez que se ejecuta, esto ya está hecho. Ese prompt ejecuta /terminal-setup por ti, lo que habilita Option como Meta y desactiva la campana audible en tu perfil de Apple Terminal.

En el modo de lector de pantalla, /terminal-setup deja sin cambios el ajuste de la campana para que la campana de la terminal siga siendo audible. Si una ejecución anterior desactivó la campana, vuelve a activarla en Settings → Profiles → Advanced → "Audible bell".

iTerm2

Abre Settings → Profiles → Keys → General y establece Left Option key y Right Option key en "Esc+".

Ejecutar /terminal-setup en iTerm2 habilita "Applications in terminal may access clipboard" en Settings → General → Selection para que el comando /copy pueda escribir en el portapapeles del sistema. El comando detecta iTerm2 incluso cuando se ejecuta dentro de tmux. Reinicia iTerm2 para que el cambio surta efecto.

VS Code

Agrega "terminal.integrated.macOptionIsMeta": true a tu configuración de VS Code.

Para Ghostty, Kitty y otras terminales, busca un ajuste Option-as-Alt u Option-as-Meta en el archivo de configuración de la terminal.

Obtener una campana de terminal o notificación

Cuando Claude termina una tarea o se pausa para solicitar un permiso, y parece que está alejado de la terminal, se dispara un evento de notificación. Consulte cuándo se dispara cada tipo de notificación para conocer el momento exacto. Mostrar esto como una campana de terminal o notificación de escritorio le permite cambiar a otro trabajo mientras se ejecuta una tarea larga.

De forma predeterminada, Claude Code envía una notificación de escritorio en algunas terminales, y un carácter de campana o nada en otras:

• Ghostty, Kitty e iTerm2: una notificación de escritorio, que iTerm2 muestra solo después de que activas su configuración de alertas.
• Apple Terminal: sin sonido; un carácter de campana silencioso cuando Claude Code detecta que "Audible bell" está desactivado en el perfil de la ventana de Terminal en primer plano; de lo contrario, nada. Ese carácter de campana se muestra como un destello de la ventana, o como un rebote en el Dock mientras Terminal está en segundo plano, si la opción "Visual bell" o la de rebote en el Dock de ese perfil está activada.
• Otras terminales: nada.

Para que Claude Code envíe el carácter de campana sin importar la terminal o el perfil, establece preferredNotifChannel en "terminal_bell". En Apple Terminal, activa también Audible bell en Settings > Profiles > Advanced para escucharla. La siguiente entrada de configuración establece el canal:

{
  "preferredNotifChannel": "terminal_bell"
}

La notificación de escritorio llega a su máquina local a través de SSH, por lo que una sesión remota aún puede alertarle. Ghostty y Kitty la reenvían a su centro de notificaciones del SO sin configuración adicional. iTerm2 requiere que habilite el reenvío:

1. Abrir la configuración de notificaciones de iTerm2

Vaya a Configuración → Perfiles → Terminal.

2. Habilitar alertas

Marque "Notification Center Alerts", luego haga clic en "Filter Alerts" y habilite "Send escape sequence-generated alerts".

Si las notificaciones aún no aparecen, confirme que su aplicación de terminal tiene permiso de notificación en la configuración de su SO, y si está ejecutando dentro de tmux, habilite passthrough.

Reproducir un sonido con un hook de Notification

En cualquier terminal puede configurar un hook de Notification para reproducir un sonido o ejecutar un comando personalizado cuando Claude necesite su atención. Los hooks se ejecutan junto con la notificación integrada en lugar de reemplazarla, por lo que las terminales que no reciben una notificación de escritorio, como Warp o la terminal integrada de VS Code, pueden usar un hook o establecer preferredNotifChannel en "terminal_bell" en su lugar.

El ejemplo a continuación reproduce un sonido del sistema en macOS. La guía vinculada tiene comandos de notificación de escritorio para macOS, Linux y Windows.

{
  "hooks": {
    "Notification": [
      {
        "hooks": [{ "type": "command", "command": "afplay /System/Library/Sounds/Glass.aiff" }]
      }
    ]
  }
}

Ver el estado de la sesión en tu terminal

Si tu terminal implementa el OSC 7501 Program Status Protocol, puede mostrar si cada sesión interactiva de Claude Code está trabajando, esperándote o terminada, lo que ayuda cuando ejecutas tareas largas o varias sesiones a la vez. No hay nada que activar en Claude Code. Para saber si tu terminal implementa el protocolo y dónde muestra el estado, consulta su documentación.

Si la terminal sí implementa el protocolo y no ves ningún estado para una sesión, revisa cada una de estas causas:

• Versión de Claude Code: el reporte de estado requiere Claude Code v2.1.295 o posterior. Ejecuta claude --version en tu shell para comprobarlo.
• tmux: dentro de tmux, Claude Code comprueba la compatibilidad en tmux en lugar de en tu terminal, y allow-passthrough no tiene efecto en eso. Inicia la sesión fuera de tmux.
• Sesión en segundo plano: una sesión en segundo plano no reporta su estado a tu terminal, incluso mientras estás conectado a ella. La vista de agentes muestra su estado en su lugar.
• CLAUDE_CODE_DISABLE_TERMINAL_TITLE: si estableces esta variable en 1, Claude Code no comprueba la compatibilidad ni reporta el estado. Elimínala.

El título de la pestaña no comienza con un glifo de estado en una terminal que reporta compatibilidad con el protocolo. La propia terminal muestra el estado de la sesión, por lo que Claude Code omite el glifo que coloca delante del título en otras terminales.

Configurar tmux

Cuando Claude Code se ejecuta dentro de tmux, por defecto Shift+Enter envía en lugar de insertar una nueva línea, y las notificaciones de escritorio y la barra de progreso nunca llegan a la terminal externa. Agregue estas líneas a ~/.tmux.conf, luego ejecute tmux source-file ~/.tmux.conf para aplicarlas al servidor en ejecución:

set -g allow-passthrough on
set -g focus-events on
set -s extended-keys on
set -as terminal-features 'xterm*:extkeys'

La línea allow-passthrough permite que las notificaciones y actualizaciones de progreso lleguen a la terminal externa en lugar de ser absorbidas por tmux. Las líneas extended-keys permiten que tmux distinga Shift+Enter de Enter simple para que el atajo de nueva línea funcione.

Un Image de un mod necesita las líneas allow-passthrough y focus-events, junto con los demás requisitos para dibujar dentro de tmux. Después de agregar las líneas, también desconéctate de tmux, vuelve a conectarte y reinicia Claude Code.

Corregir que Retroceso elimine una palabra completa en Windows

En Windows, Claude Code lee un Retroceso que llega como ^H como Ctrl+Retroceso, que elimina la palabra anterior, excepto cuando TERM_PROGRAM es mintty o TERM es cygwin. En macOS y Linux, Claude Code lo lee como Retroceso simple.

Si cada pulsación de Retroceso elimina una palabra completa, su terminal envía ^H para Retroceso simple. Establezca CLAUDE_CODE_BS_AS_CTRL_BACKSPACE=0. Retroceso y Ctrl+H entonces borran un carácter cada uno. Si Ctrl+Retroceso borra solo un carácter en macOS o Linux porque su terminal envía ^H para ello, establezca la variable a 1 en su lugar.

Ajustar el tema de colores

Usa el comando /theme, o el selector de temas en /config, para elegir un tema de Claude Code que coincida con tu terminal. Al seleccionar la opción automática, se detecta si el fondo de tu terminal es claro u oscuro, por lo que el tema sigue los cambios de apariencia del sistema operativo siempre que tu terminal también lo haga. Claude Code no controla el esquema de colores propio de la terminal, que se configura en la aplicación de terminal.

Para personalizar lo que aparece en la parte inferior de la interfaz, configura una línea de estado personalizada que muestre el modelo actual, el directorio de trabajo, la rama de git u otro contexto.

Crear un tema personalizado

Además de los ajustes preestablecidos integrados, /theme muestra los temas personalizados que hayas definido y los temas aportados por los plugins instalados. Selecciona New custom theme… al final de la lista para crear uno de forma interactiva: le das un nombre al tema y luego eliges los tokens de color individuales que quieres sobrescribir. Presiona Ctrl+E mientras un tema personalizado está resaltado para editarlo.

Cada tema personalizado es un archivo JSON en ~/.claude/themes/. El nombre del archivo sin la extensión .json es el slug del tema, y al seleccionar el tema se guarda custom:<slug> como tu preferencia de tema. El archivo tiene tres campos opcionales:

Los valores de color aceptan #rrggbb, #rgb, rgb(r,g,b), ansi256(n) o ansi:<name>, donde <name> es uno de los 16 nombres de colores ANSI estándar, como red o cyanBright. Los tokens desconocidos y los valores de color no válidos se ignoran, así que un error tipográfico no puede romper la visualización.

El siguiente ejemplo define un tema que mantiene el ajuste preestablecido oscuro, pero cambia el color del acento del prompt, el texto de error y el texto de éxito:

{
  "name": "Dracula",
  "base": "dark",
  "overrides": {
    "claude": "#bd93f9",
    "error": "#ff5555",
    "success": "#50fa7b"
  }
}

Claude Code vigila ~/.claude/themes/ y se recarga cuando se agrega o modifica un archivo, por lo que los cambios que hagas en tu editor se aplican a una sesión en curso sin necesidad de reiniciar. Si la carpeta ~/.claude/themes/ no existía cuando Claude Code se inició, reinicia una vez después de crear tu primer archivo de tema. A partir de entonces, los cambios se aplican sin reiniciar.

La referencia siguiente cubre los tokens que puedes configurar en overrides. El editor interactivo de /theme muestra los mismos tokens con una vista previa en vivo, además de algunos acentos de uso específico, como los colores de la pantalla de incorporación, que se omiten aquí.

Referencia de tokens de color

El siguiente ejemplo combina tokens de varios de los grupos siguientes: el acento de marca, el borde del modo plan, los fondos del diff y el fondo de los mensajes.

{
  "name": "Midnight",
  "base": "dark",
  "overrides": {
    "claude": "#a78bfa",
    "planMode": "#38bdf8",
    "diffAdded": "#14532d",
    "diffRemoved": "#7f1d1d",
    "userMessageBackground": "#1e1b4b"
  }
}

Colores de texto y acento

Controlan el acento principal de la marca y los tonos del texto en primer plano que se usan en toda la interfaz.

Token	Controla
claude	Acento principal de la marca, usado en el indicador de actividad y en la etiqueta del asistente
text	Texto predeterminado en primer plano
inverseText	Texto dibujado sobre un fondo de color, como las insignias de estado
inactive	Texto secundario, como sugerencias, marcas de tiempo y elementos deshabilitados
subtle	Bordes tenues y texto secundario atenuado
suggestion	Sugerencias de autocompletado y resaltado de selección en los selectores
permission	Bordes de los diálogos, incluidas las solicitudes de permiso y los selectores
remember	Indicadores de memoria y de CLAUDE.md

Colores de estado

Señalan estados de éxito, fallo y advertencia en mensajes e indicadores.

Token	Controla
success	Mensajes de éxito y comprobaciones superadas
error	Mensajes de error y fallos
warning	Advertencias, mensajes de precaución y el indicador del modo automático
merged	Estado de pull request fusionado

Cuadro de entrada e indicadores de modo

Configuran el color del borde del cuadro de entrada y el acento que se muestra mientras un modo de permisos o un indicador está activo.

Token	Controla
promptBorder	Borde del cuadro de entrada
planMode	Acento del modo plan, mensajes del plan y diálogos del modo plan
autoAccept	Acento del modo de aceptación de ediciones
bashBorder	Borde del cuadro de entrada al escribir un comando de shell con !
ide	Indicador de conexión con el IDE
fastMode	Indicador del modo rápido
effortUltra	La etiqueta ultracode en el borde del cuadro de entrada mientras ultracode está activado. Tu sobrescritura de este color surte efecto en Claude Code v2.1.239 o posterior

Visualización de diffs

Dan color al código agregado y eliminado en las ediciones de archivos y las revisiones.

Token	Controla
diffAdded	Fondo de las líneas agregadas
diffRemoved	Fondo de las líneas eliminadas
diffAddedDimmed	Fondo de las líneas agregadas en el diff atenuado que se muestra después de rechazar una edición
diffRemovedDimmed	Fondo de las líneas eliminadas en el diff atenuado que se muestra después de rechazar una edición
diffAddedWord	Resaltado a nivel de palabra dentro de una línea agregada
diffRemovedWord	Resaltado a nivel de palabra dentro de una línea eliminada

Modo de pantalla completa

Claude Code usa userMessageBackgroundHover, selectionBg y composerSidebarBackground solo en el modo de visualización en pantalla completa. Pinta userMessageBackground, bashMessageBackgroundColor y memoryBackgroundColor tanto en el renderizador predeterminado como en el de pantalla completa.

Token	Controla
userMessageBackground	Fondo detrás de tus mensajes en la transcripción
userMessageBackgroundHover	Fondo detrás de un mensaje al pasar el cursor por encima o al expandirlo
bashMessageBackgroundColor	Fondo detrás de las entradas de comandos de shell con ! en la transcripción
memoryBackgroundColor	Fondo detrás de las entradas de memoria con # en la transcripción
selectionBg	Fondo del texto seleccionado con el mouse
composerSidebarBackground	Fondo del panel junto a la conversación, como el panel de diff o el panel de un mod

Medidor de uso y etiquetas de interlocutor

Ajustan la barra que se muestra en la vista /usage y las etiquetas que distinguen tus mensajes de los de Claude.

Token	Controla
rate_limit_fill	Parte llena del medidor de uso
rate_limit_empty	Parte vacía del medidor de uso
briefLabelYou	Color de la etiqueta You en tus mensajes
briefLabelClaude	Color de la etiqueta Claude en los mensajes del asistente

Variantes de brillo y colores de subagentes

Varios tokens tienen una variante de brillo asociada que aporta el color más claro usado en el degradado animado del indicador de actividad. Sobrescribe la variante de brillo junto con su token base si la animación no combina bien.

• claude y claudeShimmer
• warning y warningShimmer
• permission y permissionShimmer
• promptBorder y promptBorderShimmer
• inactive y inactiveShimmer
• fastMode y fastModeShimmer

Cada subagente y tarea en paralelo se muestra con uno de ocho colores con nombre para que puedas distinguirlos en la transcripción. Los nombres de los tokens siguen el patrón <color>_FOR_SUBAGENTS_ONLY, donde <color> es red, blue, green, yellow, purple, orange, pink o cyan. Sobrescríbelos para cambiar cómo se ve cada color con nombre. Por ejemplo, un subagente con color: blue en su definición se dibuja con el valor de blue_FOR_SUBAGENTS_ONLY.

Cuando ultrathink puede aumentar el esfuerzo de un turno, Claude Code muestra la palabra en la entrada del prompt con un degradado de arcoíris de siete colores. Los nombres de los tokens siguen el patrón rainbow_<color> y rainbow_<color>_shimmer, donde <color> es red, orange, yellow, green, blue, indigo o violet.

Cambiar a renderizado a pantalla completa

En modo de lector de pantalla, esta sección no aplica. Claude Code siempre se renderiza como texto de desplazamiento simple excepto en sesiones de fondo adjuntas, y si ejecuta /tui fullscreen en cualquier otra sesión, Claude Code imprime una explicación en lugar de cambiar.

Si la pantalla parpadea o la posición de desplazamiento salta mientras Claude está trabajando, cambie a modo de renderizado a pantalla completa. En este modo se desplaza con el ratón o AvPág dentro de Claude Code en lugar de con el desplazamiento nativo de su terminal; consulte la página de pantalla completa para saber cómo buscar y copiar.

Si el parpadeo es el único problema y su terminal admite salida sincronizada pero no se detecta automáticamente, como Emacs eat, establezca CLAUDE_CODE_FORCE_SYNC_OUTPUT=1 para detener el parpadeo sin cambiar renderizadores.

Ejecute /tui fullscreen para cambiar y guardar la preferencia. Su conversación se reinicia intacta y las sesiones futuras comienzan en pantalla completa a menos que falle el inicio de pantalla completa. También puede establecer la variable de entorno CLAUDE_CODE_NO_FLICKER antes de iniciar Claude Code:

CLAUDE_CODE_NO_FLICKER=1 claude

$env:CLAUDE_CODE_NO_FLICKER = "1"; claude

{
  "env": {
    "CLAUDE_CODE_NO_FLICKER": "1"
  }
}

Limitar el ancho de respuesta en terminales amplias

En una terminal amplia, cada línea de prosa en las respuestas de Claude se ejecuta en todo el ancho de la ventana. Para ajustar la prosa a un número establecido de columnas en su lugar, configure maxProseWidth en su configuración.

Pegar contenido extenso

Cuando pegas más de 800 caracteres o más de tres líneas en el prompt, Claude Code contrae la entrada en un marcador de posición como [Pasted text #1 +120 lines] para que el cuadro de entrada siga siendo utilizable, y aun así envía el contenido completo cuando lo envías. Para entradas muy extensas, como archivos completos o registros largos, escribe el contenido en un archivo y pídele a Claude que lo lea en lugar de pegarlo. La transcripción de la conversación se mantiene legible y Claude puede referirse al archivo por su ruta en turnos posteriores. La terminal integrada de VS Code también puede perder caracteres de pegados muy extensos antes de que lleguen a Claude Code, así que usa un archivo en ese caso.

Si lo que pegas contiene caracteres Unicode invisibles, Claude Code los elimina cuando presionas Enter y vuelve a colocar el prompt limpio en el cuadro de entrada para que lo envíes con otro Enter.

Cómo trata Claude el texto pegado

Cuando envías el prompt, Claude ve el contenido detrás de cada marcador [Pasted text #N] marcado como texto que pegaste desde otro lugar en vez de escribirlo. A Claude se le indica que un pegado puede contener instrucciones que tú no escribiste, y que siga las instrucciones que haya dentro solo cuando el mensaje que escribiste se lo pida. En las sesiones que no obtienen feature flags, los pegados no se marcan.

Eliminar y restaurar un pegado contraído

Cuando eliminas con un atajo de palabra o de línea como Ctrl+W o Ctrl+K, o con una eliminación de vim mediante un movimiento f/t como df], y el rango eliminado alcanza el interior de un marcador [Pasted text #N], Claude Code elimina el marcador completo. Para restaurarlo, vuelve a pegar lo eliminado con Ctrl+Y después de un atajo de palabra o de línea, o con p en el modo NORMAL después de una eliminación de vim.

Recuperar un prompt que tenía texto pegado

Claude Code guarda el contenido detrás de cada marcador [Pasted text #N] en ~/.claude/paste-cache/, de modo que cuando recuperas un prompt del historial de comandos y lo vuelves a enviar, el contenido pegado completo se envía de nuevo, incluso en una sesión posterior.

Los archivos de caché con una antigüedad mayor que cleanupPeriodDays se eliminan según las reglas de limpieza por retención, por lo que un prompt recuperado puede hacer referencia a texto pegado que ya no existe. Cuando envías un prompt así, Claude Code nunca envía la cadena literal [Pasted text #N] y muestra una notificación que nombra el pegado faltante:

• En un prompt simple en el que queda texto, Claude Code elimina el marcador y envía el texto restante.
• En un comando de modo shell o un comando /, donde la eliminación cambiaría lo que se ejecuta, y en cualquier prompt que la eliminación deje vacío, Claude Code cancela el envío y conserva el texto original en la entrada, con el marcador todavía en él. Elimina el marcador o edita el comando y luego vuelve a enviarlo.

Editar prompts con atajos de teclado Vim

Claude Code incluye un modo de edición estilo Vim para la entrada de prompts. Actívelo a través de /config → Editor mode, o configurando editorMode a "vim" en ~/.claude/settings.json. Configure el modo Editor nuevamente a normal para desactivarlo.

El modo Vim admite un subconjunto de motions y operadores de modo NORMAL y VISUAL, como navegación hjkl, selección v/V, y d/c/y con objetos de texto. Consulte la referencia del modo editor Vim para la tabla de teclas completa.

Los motions de Vim no se pueden remapear a través del archivo de atajos de teclado. Para mapear una secuencia de modo INSERT de dos teclas como jj a Escape, configure vimInsertModeRemaps en su configuración de usuario.

Presionar Enter sigue enviando su prompt en modo INSERT, a diferencia del Vim estándar. Use o u O en modo NORMAL, o Ctrl+J, para insertar una nueva línea en su lugar.

Recursos relacionados

• Modo interactivo: referencia completa de atajos de teclado y tabla de teclas Vim
• Atajos de teclado: remapea cualquier atajo de Claude Code, incluyendo Enter y Shift+Enter
• Renderizado a pantalla completa: detalles sobre desplazamiento, búsqueda y copia en modo pantalla completa
• Guía de ganchos: más ejemplos de ganchos de Notificación para Linux y Windows
• Solución de problemas: correcciones para problemas fuera de la configuración de terminal