Saltar al contenido principal
Los atajos de teclado personalizables requieren Claude Code v2.1.18 o posterior. Verifique su versión con claude --version.
Claude Code admite atajos de teclado personalizables. Ejecute /keybindings para crear o abrir su archivo de configuración en ~/.claude/keybindings.json.

​
Archivo de configuración

El archivo de configuración de keybindings es un objeto con un array bindings. Cada bloque especifica un contexto y un mapa de pulsaciones de teclas a acciones.
Los cambios en el archivo de keybindings se detectan y aplican automáticamente sin reiniciar Claude Code.
CampoDescripción
$schemaURL de esquema JSON opcional para autocompletado del editor
$docsURL de documentación opcional
bindingsArray de bloques de vinculación por contexto
Este ejemplo vincula Ctrl+E para abrir un editor externo en el contexto de chat, y desvincula Ctrl+U: 
{
  "$schema": "https://www.schemastore.org/claude-code-keybindings.json",
  "$docs": "https://code.claude.com/docs/es/keybindings",
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+e": "chat:externalEditor",
        "ctrl+u": null
      }
    }
  ]
}

​
Contextos

Cada bloque de vinculación especifica un contexto donde se aplican los atajos:
ContextoDescripción
GlobalSe aplica en todas partes de la aplicación
ChatÁrea principal de entrada de chat
AutocompleteMenú de autocompletado está abierto
SettingsMenú de configuración (cierre solo con escape)
ConfirmationDiálogos de permiso y confirmación
TabsComponentes de navegación de pestañas
HelpMenú de ayuda es visible
TranscriptVisor de transcripción
HistorySearchModo de búsqueda de historial (Ctrl+R)
TaskTarea de fondo está en ejecución
ThemePickerDiálogo de selector de tema
AttachmentsNavegación de barra de imagen/adjunto
FooterNavegación de indicador de pie de página (tareas, equipos, diff)
MessageSelectorSelección de mensaje de diálogo de rebobinado y resumen
DiffDialogNavegación del visor de diff
ModelPickerNivel de esfuerzo del selector de modelo
SelectComponentes genéricos de selección/lista
PluginDiálogo de plugin (examinar, descubrir, administrar)

​
Acciones disponibles

Las acciones siguen un formato namespace:action, como chat:submit para enviar un mensaje o app:toggleTodos para mostrar la lista de tareas. Cada contexto tiene acciones específicas disponibles.

​
Acciones de aplicación

Acciones disponibles en el contexto Global:
AcciónPredeterminadoDescripción
app:interruptCtrl+CCancelar operación actual
app:exitCtrl+DSalir de Claude Code
app:toggleTodosCtrl+TAlternar visibilidad de lista de tareas
app:toggleTranscriptCtrl+OAlternar transcripción detallada

​
Acciones de historial

Acciones para navegar por el historial de comandos:
AcciónPredeterminadoDescripción
history:searchCtrl+RAbrir búsqueda de historial
history:previousArribaElemento de historial anterior
history:nextAbajoSiguiente elemento de historial

​
Acciones de chat

Acciones disponibles en el contexto Chat:
AcciónPredeterminadoDescripción
chat:cancelEscapeCancelar entrada actual
chat:cycleModeShift+Tab*Ciclar modos de permiso
chat:modelPickerCmd+P / Meta+PAbrir selector de modelo
chat:thinkingToggleCmd+T / Meta+TAlternar pensamiento extendido
chat:submitEnterEnviar mensaje
chat:undoCtrl+_Deshacer última acción
chat:externalEditorCtrl+GAbrir en editor externo
chat:stashCtrl+SGuardar indicación actual
chat:imagePasteCtrl+V (Alt+V en Windows)Pegar imagen
*En Windows sin modo VT (Node <24.2.0/<22.17.0, Bun <1.2.23), el valor predeterminado es Meta+M.

​
Acciones de autocompletado

Acciones disponibles en el contexto Autocomplete:
AcciónPredeterminadoDescripción
autocomplete:acceptTabAceptar sugerencia
autocomplete:dismissEscapeDescartar menú
autocomplete:previousArribaSugerencia anterior
autocomplete:nextAbajoSiguiente sugerencia

​
Acciones de confirmación

Acciones disponibles en el contexto Confirmation:
AcciónPredeterminadoDescripción
confirm:yesY, EnterConfirmar acción
confirm:noN, EscapeRechazar acción
confirm:previousArribaOpción anterior
confirm:nextAbajoSiguiente opción
confirm:nextFieldTabSiguiente campo
confirm:previousField(sin vincular)Campo anterior
confirm:cycleModeShift+TabCiclar modos de permiso
confirm:toggleExplanationCtrl+EAlternar explicación de permiso

​
Acciones de permiso

Acciones disponibles en el contexto Confirmation para diálogos de permiso:
AcciónPredeterminadoDescripción
permission:toggleDebugCtrl+DAlternar información de depuración de permiso

​
Acciones de transcripción

Acciones disponibles en el contexto Transcript:
AcciónPredeterminadoDescripción
transcript:toggleShowAllCtrl+EAlternar mostrar todo el contenido
transcript:exitCtrl+C, EscapeSalir de vista de transcripción

​
Acciones de búsqueda de historial

Acciones disponibles en el contexto HistorySearch:
AcciónPredeterminadoDescripción
historySearch:nextCtrl+RSiguiente coincidencia
historySearch:acceptEscape, TabAceptar selección
historySearch:cancelCtrl+CCancelar búsqueda
historySearch:executeEnterEjecutar comando seleccionado

​
Acciones de tarea

Acciones disponibles en el contexto Task:
AcciónPredeterminadoDescripción
task:backgroundCtrl+BTarea de fondo actual

​
Acciones de tema

Acciones disponibles en el contexto ThemePicker:
AcciónPredeterminadoDescripción
theme:toggleSyntaxHighlightingCtrl+TAlternar resaltado de sintaxis

​
Acciones de ayuda

Acciones disponibles en el contexto Help:
AcciónPredeterminadoDescripción
help:dismissEscapeCerrar menú de ayuda

​
Acciones de pestañas

Acciones disponibles en el contexto Tabs:
AcciónPredeterminadoDescripción
tabs:nextTab, DerechaSiguiente pestaña
tabs:previousShift+Tab, IzquierdaPestaña anterior

​
Acciones de adjuntos

Acciones disponibles en el contexto Attachments:
AcciónPredeterminadoDescripción
attachments:nextDerechaSiguiente adjunto
attachments:previousIzquierdaAdjunto anterior
attachments:removeRetroceso, SuprimirEliminar adjunto seleccionado
attachments:exitAbajo, EscapeSalir de barra de adjuntos

​
Acciones de pie de página

Acciones disponibles en el contexto Footer:
AcciónPredeterminadoDescripción
footer:nextDerechaSiguiente elemento de pie de página
footer:previousIzquierdaElemento de pie de página anterior
footer:openSelectedEnterAbrir elemento de pie de página seleccionado
footer:clearSelectionEscapeLimpiar selección de pie de página

​
Acciones del selector de mensajes

Acciones disponibles en el contexto MessageSelector:
AcciónPredeterminadoDescripción
messageSelector:upArriba, K, Ctrl+PMover hacia arriba en la lista
messageSelector:downAbajo, J, Ctrl+NMover hacia abajo en la lista
messageSelector:topCtrl+Arriba, Shift+Arriba, Meta+Arriba, Shift+KSaltar al inicio
messageSelector:bottomCtrl+Abajo, Shift+Abajo, Meta+Abajo, Shift+JSaltar al final
messageSelector:selectEnterSeleccionar mensaje

​
Acciones de diff

Acciones disponibles en el contexto DiffDialog:
AcciónPredeterminadoDescripción
diff:dismissEscapeCerrar visor de diff
diff:previousSourceIzquierdaFuente de diff anterior
diff:nextSourceDerechaSiguiente fuente de diff
diff:previousFileArribaArchivo anterior en diff
diff:nextFileAbajoSiguiente archivo en diff
diff:viewDetailsEnterVer detalles de diff
diff:back(específico del contexto)Volver atrás en visor de diff

​
Acciones del selector de modelo

Acciones disponibles en el contexto ModelPicker:
AcciónPredeterminadoDescripción
modelPicker:decreaseEffortIzquierdaDisminuir nivel de esfuerzo
modelPicker:increaseEffortDerechaAumentar nivel de esfuerzo

​
Acciones de selección

Acciones disponibles en el contexto Select:
AcciónPredeterminadoDescripción
select:nextAbajo, J, Ctrl+NSiguiente opción
select:previousArriba, K, Ctrl+POpción anterior
select:acceptEnterAceptar selección
select:cancelEscapeCancelar selección

​
Acciones de plugin

Acciones disponibles en el contexto Plugin:
AcciónPredeterminadoDescripción
plugin:toggleEspacioAlternar selección de plugin
plugin:installIInstalar plugins seleccionados

​
Acciones de configuración

Acciones disponibles en el contexto Settings:
AcciónPredeterminadoDescripción
settings:search/Entrar en modo de búsqueda
settings:retryRReintentar carga de datos de uso (en caso de error)

​
Sintaxis de pulsación de tecla

​
Modificadores

Use teclas modificadoras con el separador +:
  • ctrl o control - Tecla Control
  • alt, opt, u option - Tecla Alt/Opción
  • shift - Tecla Shift
  • meta, cmd, o command - Tecla Meta/Comando
Por ejemplo: 
ctrl+k          Tecla única con modificador
shift+tab       Shift + Tab
meta+p          Comando/Meta + P
ctrl+shift+c    Múltiples modificadores

​
Letras mayúsculas

Una letra mayúscula independiente implica Shift. Por ejemplo, K es equivalente a shift+k. Esto es útil para atajos de estilo vim donde las teclas mayúsculas y minúsculas tienen significados diferentes. Las letras mayúsculas con modificadores (por ejemplo, ctrl+K) se tratan como estilísticas y no implican Shift — ctrl+K es lo mismo que ctrl+k.

​
Acordes

Los acordes son secuencias de pulsaciones de teclas separadas por espacios: 
ctrl+k ctrl+s   Presione Ctrl+K, suelte, luego Ctrl+S

​
Teclas especiales

  • escape o esc - Tecla Escape
  • enter o return - Tecla Enter
  • tab - Tecla Tab
  • space - Barra espaciadora
  • up, down, left, right - Teclas de flecha
  • backspace, delete - Teclas de eliminación

​
Desvinculación de atajos predeterminados

Establezca una acción en null para desvinculación de un atajo predeterminado: 
{
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+s": null
      }
    }
  ]
}

​
Atajos reservados

Estos atajos no se pueden reasignar:
AtajoRazón
Ctrl+CInterrupción/cancelación codificada
Ctrl+DSalida codificada

​
Conflictos de terminal

Algunos atajos pueden entrar en conflicto con multiplexores de terminal:
AtajoConflicto
Ctrl+BPrefijo de tmux (presione dos veces para enviar)
Ctrl+APrefijo de GNU screen
Ctrl+ZSuspensión de proceso Unix (SIGTSTP)

​
Interacción del modo Vim

Cuando el modo vim está habilitado (/vim), los keybindings y el modo vim funcionan de forma independiente:
  • Modo Vim maneja la entrada a nivel de entrada de texto (movimiento del cursor, modos, movimientos)
  • Keybindings manejan acciones a nivel de componente (alternar tareas, enviar, etc.)
  • La tecla Escape en modo vim cambia de modo INSERT a NORMAL; no activa chat:cancel
  • La mayoría de los atajos Ctrl+tecla pasan a través del modo vim al sistema de keybindings
  • En modo NORMAL de vim, ? muestra el menú de ayuda (comportamiento de vim)

​
Validación

Claude Code valida sus keybindings y muestra advertencias para:
  • Errores de análisis (JSON o estructura inválida)
  • Nombres de contexto inválidos
  • Conflictos de atajos reservados
  • Conflictos de multiplexor de terminal
  • Vinculaciones duplicadas en el mismo contexto
Ejecute /doctor para ver cualquier advertencia de keybindings.