Saltar al contenido principal

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

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. 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:
TerminalShift+Enter para salto de línea
Ghostty, Kitty, iTerm2, WezTerm, Warp, Apple Terminal, Windows TerminalFunciona sin configuración
VS Code, Cursor, Windsurf, Alacritty, ZedEjecuta /terminal-setup una vez
gnome-terminal, IDEs de JetBrains como PyCharm y Android StudioNo disponible; usa Ctrl+J o \ luego Enter
Para VS Code, Cursor, Windsurf, Alacritty y Zed, /terminal-setup escribe Shift+Enter y otros atajos de teclado en el archivo de configuración de la terminal. En VS Code, Cursor y Windsurf también establece terminal.integrated.mouseWheelScrollSensitivity en la configuración del editor para un desplazamiento más suave en modo pantalla completa. Los enlaces existentes y la configuración 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. 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.
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.
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:
1

Abra la configuración de notificaciones de iTerm2

Vaya a Configuración → Perfiles → Terminal.
2

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:
CampoTipoDescripción
namestringEtiqueta de visualización mostrada en /theme. Por defecto es el slug del nombre de archivo
basestringPreajuste integrado desde el que comienza el tema: dark, light, dark-daltonized, light-daltonized, dark-ansi, o light-ansi. Por defecto es dark
overridesobjectMapa 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í.
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.
TokenControla
claudeAcento de marca principal, utilizado para el spinner y la etiqueta del asistente
textTexto de primer plano predeterminado
inverseTextTexto dibujado sobre un fondo de color, como insignias de estado
inactiveTexto secundario como sugerencias, marcas de tiempo y elementos deshabilitados
subtleBordes tenues y texto secundario de énfasis reducido
suggestionSugerencias de autocompletado y resaltado de selección en selectores
permissionBordes de diálogo, incluidas solicitudes de permiso y selectores
rememberIndicadores de memoria y CLAUDE.md

​
Colores de estado

Señala estados de éxito, fallo y advertencia en mensajes e indicadores.
TokenControla
successMensajes de éxito y comprobaciones aprobadas
errorMensajes de error y fallos
warningAdvertencias, mensajes de precaución y el borde del modo auto
mergedEstado 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.
TokenControla
promptBorderBorde del cuadro de entrada en el modo de permiso predeterminado
planModeAcento y borde del modo plan
autoAcceptAcento y borde del modo aceptar ediciones
bashBorderBorde del cuadro de entrada al ingresar un comando de shell !
ideIndicador de conexión IDE
fastModeIndicador del modo rápido

​
Representación de diff

Colorea el código añadido y eliminado en ediciones y revisiones de archivos.
TokenControla
diffAddedFondo de líneas añadidas
diffRemovedFondo de líneas eliminadas
diffAddedDimmedFondo de contexto sin cambios cerca de líneas añadidas
diffRemovedDimmedFondo de contexto sin cambios cerca de líneas eliminadas
diffAddedWordResaltado a nivel de palabra dentro de una línea añadida
diffRemovedWordResaltado 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.
TokenControla
userMessageBackgroundFondo detrás de tus mensajes en la transcripción
userMessageBackgroundHoverFondo detrás de un mensaje mientras está desplazado o expandido
messageActionsBackgroundFondo detrás del mensaje seleccionado cuando la barra de acciones está abierta
bashMessageBackgroundColorFondo detrás de entradas de comando de shell ! en la transcripción
memoryBackgroundColorFondo detrás de entradas de memoria # en la transcripción
selectionBgFondo 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.
TokenControla
rate_limit_fillPorción llena del medidor de uso
rate_limit_emptyPorción vacía del medidor de uso
briefLabelYouColor de la etiqueta You en tus mensajes
briefLabelClaudeColor 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 en la sesión actual con tu conversación intacta. Para hacerlo el predeterminado, establece la variable de entorno CLAUDE_CODE_NO_FLICKER antes de iniciar Claude Code: 
CLAUDE_CODE_NO_FLICKER=1 claude

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

​
Recursos relacionados