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.

Ingrese indicaciones de varias líneas

Presionar Enter envía su mensaje. Para agregar un salto de línea sin enviar, presione Ctrl+J, o escriba \ y luego presione Enter. Ambos funcionan en cada terminal sin necesidad de configuración.

En la mayoría de las terminales también puede presionar Mayús+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 Mayús+Enter en el archivo de configuración de la terminal. En la primera ejecución verá una confirmación como Installed VSCode terminal Shift+Enter key binding. Los enlaces existentes se dejan en su lugar; si ve un mensaje como VSCode terminal Shift+Enter key binding already configured, no se realizó ningún cambio. Ejecute /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 de pantalla completa. Para deshacer el cambio de aceleración de GPU, establézcalo nuevamente en "auto" y recargue la ventana del editor.

En Zed, /terminal-setup actualiza su keymap.json en su lugar:

• Si el mapa de teclas ya tiene enlaces y ninguno de ellos es un shift-enter de Terminal, Claude Code primero lo respalda en una copia en el mismo directorio, como keymap.json.1a2b3c4d.bak, luego fusiona el enlace Mayús+Enter en su mapa de teclas, manteniendo sus otros atajos de teclado y comentarios
• Si Claude Code no puede leer o analizar el mapa de teclas, no puede hacer una copia de seguridad, o no puede verificar el resultado fusionado, deja el archivo sin cambios e imprime el bloque de enlace para que lo agregue usted mismo

Si está ejecutando dentro de tmux, Mayús+Enter también requiere la configuración de tmux a continuación incluso cuando la terminal externa la admite.

Para vincular una nueva línea a una tecla diferente, o para intercambiar el comportamiento de modo que Enter inserte una nueva línea y Mayús+Enter envíe, asigne las acciones chat:newline y chat:submit en su archivo de atajos de teclado.

Habilitar atajos de teclado con la tecla Opción en macOS

Algunos atajos de teclado de Claude Code utilizan la tecla Opción, como Opción+Intro para una nueva línea u Opción+P para cambiar modelos. En macOS, la mayoría de los terminales no envían Opción como modificador de forma predeterminada, por lo que estos atajos no funcionan hasta que los habilite. La configuración del 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 Opción o Alt.

Para Ghostty, Kitty y otros terminales, busque una configuración de Option-as-Alt u Option-as-Meta en el archivo de configuración del 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 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 hook de Notification para un sonido o comando personalizado. La siguiente entrada de configuración activa la campana de terminal:

{
  "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:

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" }]
      }
    ]
  }
}

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 -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.

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.

Coincidir con el tema de color

Utilice el comando /theme, o el selector de temas en /config, para elegir un tema de Claude Code que coincida con su terminal. Al seleccionar la opción automática, se detecta el fondo claro u oscuro de su terminal, por lo que el tema sigue los cambios de apariencia del sistema operativo siempre que lo haga su terminal. Claude Code no controla el esquema de colores de la terminal en sí, que se establece mediante la aplicación de terminal.

Para personalizar lo que aparece en la parte inferior de la interfaz, configure 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 enumera cualquier tema personalizado que haya definido y cualquier tema contribuido por plugins instalados. Seleccione Nuevo tema personalizado… al final de la lista para crear uno de forma interactiva: usted nombra el tema y luego elige tokens de color individuales para anular. Presione 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 su 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 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 ajuste preestablecido oscuro pero recolora el 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 observa ~/.claude/themes/ y se recarga cuando se agrega o cambia un archivo, por lo que las ediciones realizadas en su editor se aplican a una sesión en ejecución sin necesidad de reiniciar. Si la carpeta ~/.claude/themes/ en sí no existía cuando Claude Code se inició, reinicie una vez después de crear su primer archivo de tema. Después de eso, los cambios se aplican 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í.

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

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"
}
}

Pegar contenido grande

Cuando pega más de 800 caracteres o más de tres líneas en el prompt, Claude Code contrae la entrada a un marcador de posición como [Pasted text #1 +120 lines] para que la caja de entrada siga siendo utilizable. En una ventana de terminal más corta que 12 filas, el límite de líneas disminuye, por lo que Claude Code contrae un pegado de tres líneas a 11 filas y cualquier pegado de varias líneas a 10 filas o menos. Claude Code sigue enviando el contenido completo cuando envía.

Cuando elimina con un atajo de palabra o línea como Ctrl+W o Ctrl+K, o con una eliminación vim a través de un movimiento f/t como df], y el rango eliminado llega dentro de un marcador de posición, Claude Code elimina el marcador de posición completo. Puede pegar la eliminación nuevamente para restaurarla, con Ctrl+Y después de un atajo de palabra o línea, o con p en NORMAL mode después de una eliminación vim.

Claude Code mantiene el contenido contraído bajo ~/.claude/paste-cache/, por lo que cuando recupera un prompt del historial de comandos y lo reenvía, Claude Code envía el contenido pegado completo nuevamente, incluso en una sesión posterior, hasta que el barrido de retención elimine el archivo de caché.

Claude Code elimina archivos de caché más antiguos que cleanupPeriodDays, siguiendo las reglas de barrido de retención, por lo que un prompt recuperado puede hacer referencia a texto pegado que ya no existe. Cuando envía tal prompt, Claude Code nunca envía la cadena literal [Pasted text #N], y muestra una notificación nombrando el pegado faltante:

• En un prompt simple con texto restante, Claude Code elimina el marcador de posición y envía el texto restante.
• En un comando de shell mode o un comando /, donde la eliminación cambiaría lo que se ejecuta, y en cualquier prompt donde la eliminación deja vacío, Claude Code cancela el envío y mantiene el texto original en la entrada, con el marcador de posición aún en él. Elimine el marcador de posición o edite el comando, luego reenvíe.

La terminal integrada de VS Code puede descartar caracteres de pegados muy grandes antes de que lleguen a Claude Code, por lo que prefiera flujos de trabajo basados en archivos allí. Para entradas muy grandes como archivos completos o registros largos, escriba el contenido en un archivo y pida a Claude que lo lea en lugar de pegarlo. Esto mantiene la transcripción de la conversación legible y permite que Claude haga referencia al archivo por ruta en turnos posteriores.

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