Los atajos de teclado personalizables requieren Claude Code v2.1.18 o posterior. Verifique su versión con claude --version.
/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.
| Campo | Descripción |
|---|
$schema | URL de esquema JSON opcional para autocompletado del editor |
$docs | URL de documentación opcional |
bindings | Array de bloques de vinculación por contexto |
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:
| Contexto | Descripción |
|---|
Global | Se aplica en todas partes de la aplicación |
Chat | Área principal de entrada de chat |
Autocomplete | Menú de autocompletado está abierto |
Settings | Menú de configuración (cierre solo con escape) |
Confirmation | Diálogos de permiso y confirmación |
Tabs | Componentes de navegación de pestañas |
Help | Menú de ayuda es visible |
Transcript | Visor de transcripción |
HistorySearch | Modo de búsqueda de historial (Ctrl+R) |
Task | Tarea de fondo está en ejecución |
ThemePicker | Diálogo de selector de tema |
Attachments | Navegación de barra de imagen/adjunto |
Footer | Navegación de indicador de pie de página (tareas, equipos, diff) |
MessageSelector | Selección de mensaje de diálogo de rebobinado y resumen |
DiffDialog | Navegación del visor de diff |
ModelPicker | Nivel de esfuerzo del selector de modelo |
Select | Componentes genéricos de selección/lista |
Plugin | Diá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ón | Predeterminado | Descripción |
|---|
app:interrupt | Ctrl+C | Cancelar operación actual |
app:exit | Ctrl+D | Salir de Claude Code |
app:toggleTodos | Ctrl+T | Alternar visibilidad de lista de tareas |
app:toggleTranscript | Ctrl+O | Alternar transcripción detallada |
Acciones de historial
Acciones para navegar por el historial de comandos:
| Acción | Predeterminado | Descripción |
|---|
history:search | Ctrl+R | Abrir búsqueda de historial |
history:previous | Arriba | Elemento de historial anterior |
history:next | Abajo | Siguiente elemento de historial |
Acciones de chat
Acciones disponibles en el contexto Chat:
| Acción | Predeterminado | Descripción |
|---|
chat:cancel | Escape | Cancelar entrada actual |
chat:killAgents | Ctrl+X Ctrl+K | Matar todos los agentes de fondo |
chat:cycleMode | Shift+Tab* | Ciclar modos de permiso |
chat:modelPicker | Cmd+P / Meta+P | Abrir selector de modelo |
chat:fastMode | Meta+O | Alternar modo rápido |
chat:thinkingToggle | Cmd+T / Meta+T | Alternar pensamiento extendido |
chat:submit | Enter | Enviar mensaje |
chat:undo | Ctrl+_ | Deshacer última acción |
chat:externalEditor | Ctrl+G, Ctrl+X Ctrl+E | Abrir en editor externo |
chat:stash | Ctrl+S | Guardar indicación actual |
chat:imagePaste | Ctrl+V (Alt+V en Windows) | Pegar imagen |
Acciones de autocompletado
Acciones disponibles en el contexto Autocomplete:
| Acción | Predeterminado | Descripción |
|---|
autocomplete:accept | Tab | Aceptar sugerencia |
autocomplete:dismiss | Escape | Descartar menú |
autocomplete:previous | Arriba | Sugerencia anterior |
autocomplete:next | Abajo | Siguiente sugerencia |
Acciones de confirmación
Acciones disponibles en el contexto Confirmation:
| Acción | Predeterminado | Descripción |
|---|
confirm:yes | Y, Enter | Confirmar acción |
confirm:no | N, Escape | Rechazar acción |
confirm:previous | Arriba | Opción anterior |
confirm:next | Abajo | Siguiente opción |
confirm:nextField | Tab | Siguiente campo |
confirm:previousField | (sin vincular) | Campo anterior |
confirm:cycleMode | Shift+Tab | Ciclar modos de permiso |
confirm:toggleExplanation | Ctrl+E | Alternar explicación de permiso |
Acciones de permiso
Acciones disponibles en el contexto Confirmation para diálogos de permiso:
| Acción | Predeterminado | Descripción |
|---|
permission:toggleDebug | Ctrl+D | Alternar información de depuración de permiso |
Acciones de transcripción
Acciones disponibles en el contexto Transcript:
| Acción | Predeterminado | Descripción |
|---|
transcript:toggleShowAll | Ctrl+E | Alternar mostrar todo el contenido |
transcript:exit | Ctrl+C, Escape | Salir de vista de transcripción |
Acciones de búsqueda de historial
Acciones disponibles en el contexto HistorySearch:
| Acción | Predeterminado | Descripción |
|---|
historySearch:next | Ctrl+R | Siguiente coincidencia |
historySearch:accept | Escape, Tab | Aceptar selección |
historySearch:cancel | Ctrl+C | Cancelar búsqueda |
historySearch:execute | Enter | Ejecutar comando seleccionado |
Acciones de tarea
Acciones disponibles en el contexto Task:
| Acción | Predeterminado | Descripción |
|---|
task:background | Ctrl+B | Tarea de fondo actual |
Acciones de tema
Acciones disponibles en el contexto ThemePicker:
| Acción | Predeterminado | Descripción |
|---|
theme:toggleSyntaxHighlighting | Ctrl+T | Alternar resaltado de sintaxis |
Acciones de ayuda
Acciones disponibles en el contexto Help:
| Acción | Predeterminado | Descripción |
|---|
help:dismiss | Escape | Cerrar menú de ayuda |
Acciones de pestañas
Acciones disponibles en el contexto Tabs:
| Acción | Predeterminado | Descripción |
|---|
tabs:next | Tab, Derecha | Siguiente pestaña |
tabs:previous | Shift+Tab, Izquierda | Pestaña anterior |
Acciones de adjuntos
Acciones disponibles en el contexto Attachments:
| Acción | Predeterminado | Descripción |
|---|
attachments:next | Derecha | Siguiente adjunto |
attachments:previous | Izquierda | Adjunto anterior |
attachments:remove | Retroceso, Suprimir | Eliminar adjunto seleccionado |
attachments:exit | Abajo, Escape | Salir de barra de adjuntos |
Acciones de pie de página
Acciones disponibles en el contexto Footer:
| Acción | Predeterminado | Descripción |
|---|
footer:next | Derecha | Siguiente elemento de pie de página |
footer:previous | Izquierda | Elemento de pie de página anterior |
footer:openSelected | Enter | Abrir elemento de pie de página seleccionado |
footer:clearSelection | Escape | Limpiar selección de pie de página |
Acciones del selector de mensajes
Acciones disponibles en el contexto MessageSelector:
| Acción | Predeterminado | Descripción |
|---|
messageSelector:up | Arriba, K, Ctrl+P | Mover hacia arriba en la lista |
messageSelector:down | Abajo, J, Ctrl+N | Mover hacia abajo en la lista |
messageSelector:top | Ctrl+Arriba, Shift+Arriba, Meta+Arriba, Shift+K | Saltar al inicio |
messageSelector:bottom | Ctrl+Abajo, Shift+Abajo, Meta+Abajo, Shift+J | Saltar al final |
messageSelector:select | Enter | Seleccionar mensaje |
Acciones de diff
Acciones disponibles en el contexto DiffDialog:
| Acción | Predeterminado | Descripción |
|---|
diff:dismiss | Escape | Cerrar visor de diff |
diff:previousSource | Izquierda | Fuente de diff anterior |
diff:nextSource | Derecha | Siguiente fuente de diff |
diff:previousFile | Arriba | Archivo anterior en diff |
diff:nextFile | Abajo | Siguiente archivo en diff |
diff:viewDetails | Enter | Ver 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ón | Predeterminado | Descripción |
|---|
modelPicker:decreaseEffort | Izquierda | Disminuir nivel de esfuerzo |
modelPicker:increaseEffort | Derecha | Aumentar nivel de esfuerzo |
Acciones de selección
Acciones disponibles en el contexto Select:
| Acción | Predeterminado | Descripción |
|---|
select:next | Abajo, J, Ctrl+N | Siguiente opción |
select:previous | Arriba, K, Ctrl+P | Opción anterior |
select:accept | Enter | Aceptar selección |
select:cancel | Escape | Cancelar selección |
Acciones de plugin
Acciones disponibles en el contexto Plugin:
| Acción | Predeterminado | Descripción |
|---|
plugin:toggle | Espacio | Alternar selección de plugin |
plugin:install | I | Instalar plugins seleccionados |
Acciones de configuración
Acciones disponibles en el contexto Settings:
| Acción | Predeterminado | Descripción |
|---|
settings:search | / | Entrar en modo de búsqueda |
settings:retry | R | Reintentar carga de datos de uso (en caso de error) |
Acciones de voz
Acciones disponibles en el contexto Chat cuando dictado de voz está habilitado:
| Acción | Predeterminado | Descripción |
|---|
voice:pushToTalk | Espacio | Mantener presionado para dictar una indicación |
Sintaxis de pulsación de tecla
Modificadores
Use teclas modificadoras con el separador +:
ctrl o control - Tecla Controlalt, opt, u option - Tecla Alt/Opciónshift - Tecla Shiftmeta, 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 Escapeenter o return - Tecla Entertab - Tecla Tabspace - Barra espaciadoraup, down, left, right - Teclas de flechabackspace, 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:
| Atajo | Razón |
|---|
| Ctrl+C | Interrupción/cancelación codificada |
| Ctrl+D | Salida codificada |
| Ctrl+M | Idéntico a Enter en terminales (ambos envían CR) |
Conflictos de terminal
Algunos atajos pueden entrar en conflicto con multiplexores de terminal:
| Atajo | Conflicto |
|---|
| Ctrl+B | Prefijo de tmux (presione dos veces para enviar) |
| Ctrl+A | Prefijo de GNU screen |
| Ctrl+Z | Suspensió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.
