Configura tu terminal para Claude Code

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

Shift+Enter envía en lugar de insertar un salto de línea
Los atajos de tecla Option no funcionan en macOS
Sin sonido ni alerta cuando Claude termina
Ejecutas Claude Code dentro de tmux
La pantalla parpadea o el desplazamiento salta
Quieres teclas Vim en el indicador

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

Ingresa indicadores multilínea

Presionar Enter envía tu mensaje. Para agregar un salto de línea sin enviar, presiona Ctrl+J, o escribe \ y luego presiona Enter. Ambos funcionan en cada terminal sin configuración. En la mayoría de terminales también puedes presionar Shift+Enter, pero el soporte varía según el emulador de terminal:

Terminal	Shift+Enter para salto de línea
Ghostty, Kitty, iTerm2, WezTerm, Warp, Apple Terminal, Windows Terminal	Funciona sin configuración
VS Code, Cursor, Devin Desktop, Alacritty, Zed	Ejecuta `/terminal-setup` una vez
gnome-terminal, IDEs de JetBrains como PyCharm y Android Studio	No disponible; usa Ctrl+J o `\` luego Enter

Para VS Code, Cursor, Devin Desktop, Alacritty y Zed, /terminal-setup escribe Shift+Enter y otros atajos de teclado en el archivo de configuración de la terminal. Los enlaces existentes se dejan en su lugar; 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 del host en lugar de dentro de tmux o screen, ya que necesita escribir en la configuración de la terminal del host. En VS Code, Cursor y Devin Desktop, /terminal-setup también actualiza dos configuraciones 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 suave en modo pantalla completa. Para deshacer el cambio de aceleración de GPU, establécelo de nuevo en "auto" y recarga la ventana del editor. Si estás ejecutando dentro de tmux, Shift+Enter también requiere la configuración de tmux a continuación incluso cuando la terminal externa la soporta. Para vincular salto de línea a una tecla diferente, o para intercambiar el comportamiento de modo que Enter inserte un salto de línea y Shift+Enter envíe, mapea las acciones chat:newline y chat:submit en tu archivo de atajos de teclado.

Habilita atajos de tecla Option en macOS

Algunos atajos de Claude Code usan la tecla Option, como Option+Enter para un salto de línea u Option+P para cambiar modelos. En macOS, la mayoría de terminales no envían Option como modificador por defecto, por lo que estos atajos no hacen nada hasta que lo habilites. La configuración de terminal para esto generalmente se etiqueta como “Use Option as Meta Key”; Meta es el nombre histórico de Unix para la tecla ahora etiquetada como Option o Alt.

Apple Terminal
iTerm2
VS Code

Abre Configuración → Perfiles → Teclado y marca “Use Option as Meta Key”.Si aceptaste el indicador de primera ejecución de Claude Code que ofrecía “Option+Enter para saltos de línea y campana visual”, esto ya está hecho. Ese indicador ejecuta /terminal-setup para ti, que habilita Option como Meta y cambia la campana de audio a un destello de pantalla visual en tu perfil de Apple Terminal.

Abre Configuración → Perfiles → Teclas → General y establece la tecla Option Izquierda y la tecla Option Derecha en “Esc+”.Ejecutar /terminal-setup en iTerm2 habilita “Applications in terminal may access clipboard” en Configuración → General → Selection para que el comando /copy pueda escribir en tu portapapeles del sistema. El comando detecta iTerm2 incluso cuando se ejecuta desde dentro de tmux. Reinicia iTerm2 para que el cambio surta efecto.

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

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

Obtén una campana de terminal o notificación

Cuando Claude termina una tarea o se pausa para un indicador de permiso, dispara un evento de notificación. Mostrar esto como una campana de terminal o notificación de escritorio te permite cambiar a otro trabajo mientras se ejecuta una tarea larga. Por defecto, Claude Code envía una notificación de escritorio solo en Ghostty, Kitty e iTerm2. En otras terminales, establezca preferredNotifChannel en "terminal_bell" para sonar la campana de terminal en su lugar, o configure un gancho de Notificación para un sonido personalizado o comando. 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:

Abra la configuración de notificaciones de iTerm2

Vaya a Configuración → Perfiles → Terminal.

Habilite 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 tenga permiso de notificación en su configuración del SO, y si está ejecutando dentro de tmux, habilite passthrough.

Reproduzca un sonido con un gancho de Notificación

En cualquier terminal puede configurar un gancho de Notificación para reproducir un sonido o ejecutar un comando personalizado cuando Claude necesite su atención. Los ganchos se ejecutan junto con la notificación de escritorio 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 gancho 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.

~/.claude/settings.json

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

Configura tmux

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

~/.tmux.conf

set -g allow-passthrough 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 tragadas por tmux. Las líneas extended-keys permiten que tmux distinga Shift+Enter de Enter simple para que el atajo de salto de línea funcione.

Haz coincidir el tema de color

Usa el comando /theme, o el selector de tema en /config, para elegir un tema de Claude Code que coincida con tu terminal. Seleccionar la opción auto detecta el fondo claro u oscuro de tu terminal, por lo que el tema sigue los cambios de apariencia del SO siempre que tu terminal lo haga. Claude Code no controla el esquema de color de la terminal, que se establece por 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, directorio de trabajo, rama de git u otro contexto.

Crea un tema personalizado

Los temas personalizados requieren Claude Code v2.1.118 o posterior.

Además de los preajustes integrados, /theme enumera cualquier tema personalizado que hayas definido y cualquier tema contribuido por los plugins instalados. Selecciona Nuevo tema personalizado… al final de la lista para crear uno de forma interactiva: nombras el tema y luego seleccionas tokens de color individuales para anular. Presiona Ctrl+E mientras un tema personalizado está resaltado para editarlo. Cada tema personalizado es un archivo JSON en ~/.claude/themes/. El nombre de archivo sin la extensión .json es el slug del tema, y seleccionar el tema almacena custom:<slug> como tu preferencia de tema. El archivo tiene tres campos opcionales:

Campo	Tipo	Descripción
`name`	string	Etiqueta de visualización mostrada en `/theme`. Por defecto es el slug del nombre de archivo
`base`	string	Preajuste integrado desde el que comienza el tema: `dark`, `light`, `dark-daltonized`, `light-daltonized`, `dark-ansi`, o `light-ansi`. Por defecto es `dark`
`overrides`	object	Mapa de nombres de tokens de color a valores de color. Los tokens no enumerados aquí se transfieren al preajuste base

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 color ANSI estándar como red o cyanBright. Los tokens desconocidos y los valores de color inválidos se ignoran, por lo que un error tipográfico no puede romper la representación. El siguiente ejemplo define un tema que mantiene el preajuste oscuro pero recolora el acento del prompt, el texto de error y el texto de éxito:

~/.claude/themes/dracula.json

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

Claude Code observa ~/.claude/themes/ y recarga cuando un archivo cambia, por lo que las ediciones realizadas en tu editor se aplican a una sesión en ejecución sin necesidad de reiniciar. La referencia a continuación cubre los tokens que puede establecer en overrides. El editor interactivo en /theme muestra los mismos tokens con una vista previa en vivo, además de algunos acentos de propósito único como colores de pantalla de incorporación que se omiten aquí.

Referencia de tokens de color

El siguiente ejemplo combina tokens de varios de los grupos a continuación: el acento de marca, el borde del modo plan, los fondos de diff y el fondo del mensaje de pantalla completa.

~/.claude/themes/midnight.json

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

Colores de texto y acento

Controla el acento de marca principal y los matices de texto de primer plano utilizados en toda la interfaz.

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

Colores de estado

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

Token	Controla
`success`	Mensajes de éxito y comprobaciones aprobadas
`error`	Mensajes de error y fallos
`warning`	Advertencias, mensajes de precaución y el borde del modo auto
`merged`	Estado de solicitud de extracción fusionada

Cuadro de entrada e indicadores de modo

Establece el color del borde del cuadro de entrada y el acento mostrado mientras un modo de permiso o indicador está activo.

Token	Controla
`promptBorder`	Borde del cuadro de entrada en el modo de permiso predeterminado
`planMode`	Acento y borde del modo plan
`autoAccept`	Acento y borde del modo aceptar ediciones
`bashBorder`	Borde del cuadro de entrada al ingresar un comando de shell `!`
`ide`	Indicador de conexión IDE
`fastMode`	Indicador del modo rápido

Representación de diff

Colorea el código añadido y eliminado en ediciones y revisiones de archivos.

Token	Controla
`diffAdded`	Fondo de líneas añadidas
`diffRemoved`	Fondo de líneas eliminadas
`diffAddedDimmed`	Fondo de contexto sin cambios cerca de líneas añadidas
`diffRemovedDimmed`	Fondo de contexto sin cambios cerca de líneas eliminadas
`diffAddedWord`	Resaltado a nivel de palabra dentro de una línea añadida
`diffRemovedWord`	Resaltado a nivel de palabra dentro de una línea eliminada

Modo de pantalla completa

Se aplica solo en modo de representación de pantalla completa, donde los mensajes tienen un relleno de fondo.

Token	Controla
`userMessageBackground`	Fondo detrás de tus mensajes en la transcripción
`userMessageBackgroundHover`	Fondo detrás de un mensaje mientras está desplazado o expandido
`messageActionsBackground`	Fondo detrás del mensaje seleccionado cuando la barra de acciones está abierta
`bashMessageBackgroundColor`	Fondo detrás de entradas de comando de shell `!` en la transcripción
`memoryBackgroundColor`	Fondo detrás de entradas de memoria `#` en la transcripción
`selectionBg`	Fondo del texto seleccionado con el ratón

Medidor de uso y etiquetas de altavoz

Ajusta la barra mostrada en la vista /usage y las etiquetas que distinguen tus mensajes de los de Claude.

Token	Controla
`rate_limit_fill`	Porción llena del medidor de uso
`rate_limit_empty`	Porción 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 shimmer y colores de subagentes

Varios tokens tienen una variante de shimmer emparejada que proporciona el color más claro utilizado en el gradiente animado del spinner. Anula el shimmer junto con su token base si la animación se ve desajustada.

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

Cada subagente y tarea paralela se muestra en uno de ocho colores nombrados 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. Anula estos para cambiar el aspecto de cada color nombrado. Por ejemplo, un subagente con color: blue en su definición se dibuja usando el valor blue_FOR_SUBAGENTS_ONLY.Las palabras clave ultrathink y ultraplan en la entrada del prompt se representan con un gradiente 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.

Cambia a renderizado a pantalla completa

Si la pantalla parpadea o la posición de desplazamiento salta mientras Claude está trabajando, cambia al modo de renderizado a pantalla completa. Dibuja en una pantalla separada que la terminal reserva para aplicaciones a pantalla completa en lugar de agregar a tu desplazamiento normal, lo que mantiene el uso de memoria plano y agrega soporte de ratón para desplazamiento y selección. En este modo desplazas con el ratón o PageUp dentro de Claude Code en lugar de con el desplazamiento nativo de tu terminal; consulta la página de pantalla completa para saber cómo buscar y copiar. Ejecuta /tui fullscreen para cambiar y guardar la preferencia. Tu conversación se reinicia intacta y las futuras sesiones comienzan en pantalla completa. También puedes 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"
  }
}

Pega contenido grande

Cuando pegas más de 10,000 caracteres en el indicador, Claude Code colapsa la entrada a un marcador de posición [Pasted text] para que la caja de entrada siga siendo utilizable. El contenido completo aún se envía a Claude cuando envías. La terminal integrada de VS Code puede soltar caracteres de pegados muy grandes antes de que lleguen a Claude Code, así que prefiere flujos de trabajo basados en archivos allí. Para entradas muy grandes como archivos completos o registros largos, escribe el contenido en un archivo y pide a Claude que lo lea en lugar de pegar. Esto mantiene la transcripción de conversación legible y permite que Claude haga referencia al archivo por ruta en turnos posteriores.

Edita indicadores con atajos de teclado Vim

Claude Code incluye un modo de edición de estilo Vim para la entrada del indicador. Habilítalo a través de /config → Editor mode, o estableciendo editorMode en "vim" en ~/.claude/settings.json. Establece Editor mode de nuevo en normal para desactivarlo. El modo Vim soporta un subconjunto de movimientos y operadores de modo NORMAL y VISUAL, como navegación hjkl, selección v/V, y d/c/y con objetos de texto. Consulta la referencia del modo editor Vim para la tabla de teclas completa. Los movimientos Vim no son remapeables a través del archivo de atajos de teclado. Presionar Enter aún envía tu indicador en modo INSERT, a diferencia del Vim estándar. Usa o u O en modo NORMAL, o Ctrl+J, para insertar un salto de línea en su lugar.

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

Configuración y permisos

Modelo y respuestas

Interfaz

Configura tu terminal para Claude Code

Ingresa indicadores multilínea

Habilita atajos de tecla Option en macOS

Obtén una campana de terminal o notificación

Reproduzca un sonido con un gancho de Notificación

Configura tmux

Haz coincidir el tema de color

Crea un tema personalizado

Colores de texto y acento

Colores de estado

Cuadro de entrada e indicadores de modo

Representación de diff

Modo de pantalla completa

Medidor de uso y etiquetas de altavoz

Variantes de shimmer y colores de subagentes

Cambia a renderizado a pantalla completa

Pega contenido grande

Edita indicadores con atajos de teclado Vim

​Ingresa indicadores multilínea

​Habilita atajos de tecla Option en macOS

​Obtén una campana de terminal o notificación

​Reproduzca un sonido con un gancho de Notificación

​Configura tmux

​Haz coincidir el tema de color

​Crea un tema personalizado

Colores de texto y acento

Colores de estado

Cuadro de entrada e indicadores de modo

Representación de diff

Modo de pantalla completa

Medidor de uso y etiquetas de altavoz

Variantes de shimmer y colores de subagentes

​Cambia a renderizado a pantalla completa

​Pega contenido grande

​Edita indicadores con atajos de teclado Vim

​Recursos relacionados

Ingresa indicadores multilínea

Habilita atajos de tecla Option en macOS

Obtén una campana de terminal o notificación

Reproduzca un sonido con un gancho de Notificación

Configura tmux

Haz coincidir el tema de color

Crea un tema personalizado

Cambia a renderizado a pantalla completa

Pega contenido grande

Edita indicadores con atajos de teclado Vim

Recursos relacionados