Feature Request: Allow remapping ESC keybinding

Resolved 💬 3 comments Opened Jan 3, 2026 by HomeHeartTherapy Closed Jan 7, 2026

Problem

The ESC key triggers a rewind operation (ESC + ESC) in Claude Code CLI. This keybinding is hardcoded with no way to remap or disable it.

ESC is commonly used for:

  • Push-to-talk (voice input / hands-free coding)
  • Vim-style navigation
  • General cancel/escape muscle memory in other tools

When using ESC for push-to-talk, accidentally double-tapping can trigger an unintended rewind.

Impact

  • Cognitive load: Users must consciously avoid double-tapping a key they use reflexively
  • Flow interruption: Switching push-to-talk to F1 or another key requires looking at keyboard, breaks hands-free workflow
  • Accessibility: Voice input users rely on easy-to-reach keys like ESC for hands-free operation

Proposed Solution

Allow keybinding customization via:

  • claude config set keybinding.rewind <key>
  • settings.json configuration
  • /terminal-setup command

ESC can remain the default, but users should be able to remap or disable it.

Environment

Claude Code CLI (terminal), Windows 11, but applies to all platforms

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗