Claude Code /keybindings: Customize Shortcuts to Fit Your Hands

Use a tool long enough and your hands remember first. But when an action you use often is bound to an awkward key combo, that small inconvenience piles up dozens of times a day. The command that lets you remap Claude Code's shortcuts to fit your hands is /keybindings.

Definition (What It Is)

/keybindings is a command that opens Claude Code's shortcut config file, or creates a new one if it doesn't exist.

Keybindings are the connection rules saying "press this key, do this action." For example, a promise like "press Ctrl+L to clear the screen." The shortcut config file is where these connections are collected, and /keybindings lets you open that file directly to edit it.

Defaults are set, but since the keys that fit differ from person to person, it's left open for you to change directly.

How to Use It (By Difficulty)

Basic — Opening the Config File

Type it.

/keybindings

This opens the shortcut config file. On first run the file may not exist, in which case it automatically creates a new one. In the opened file, you can see which keys are currently bound to which actions.

Intermediate — Changing Frequently Used Actions

Once you've opened the file, start by changing the actions you use often that have awkward keys.

The work order goes like this.

1. Open the config file with /keybindings.
2. Find the action item you want to change.
3. Edit the key bound to that action to a comfortable combo, and save.

At first, we recommend changing just one or two. Changing too many at once gets confusing about which key was what, making it even more inconvenient.

Advanced — Tidying Up While Avoiding Conflicts

The thing to watch when changing shortcuts is key conflicts. Binding the same key combo to two actions can produce unintended behavior.

• When setting a new key, first check whether that combo is already used by another action.
• Put frequently used actions on easy-to-press keys and rarely used ones on more complex combos, and they'll stick to your hands well.
• If it feels off after using it for a few days, just adjust again. Your hands decide the right answer.

Common Pitfalls

• Editing the config file wrong can make some shortcuts stop working. Noting the original contents before a big change makes it easy to revert.
• Key combos already claimed by the OS or terminal may not work in Claude Code. In that case, switch to a different combo.

Real-World Example

A beginner developer who used the clear-screen action often kept stalling because the default key combo didn't fit their hands. After opening the config file with /keybindings and changing it to a key they found easy to press, their hands moved on their own without thinking. One small change removed an inconvenience that had piled up all day.

Taking It Further

Adjusting shortcuts is part of tidying your work environment. To overhaul your settings overall, check other environment options with /config, and to tune the terminal itself to fit Claude Code, use it alongside the /terminal-setup family of commands. Building an environment that fits your hands lets you do more work in the same time.

Summary

/keybindings is a command that opens Claude Code's shortcut config file so you can remap the action-to-key connections to fit your hands. Don't try to change everything at once — fix the inconvenient ones you use often, one at a time. A small adjustment makes everyday work noticeably smoother.

Based on: Claude Code v2.1.154 (2026.05)