Skip to content
BENIBIX Learn

vimInsertModeRemaps

AI⌨️ Claude CodeConfiguration

Also known as vimInsertModeRemaps setting, jj to Escape

The key that lets two letters in a row, such as jj, act as Esc in vim mode.

Think of it like

It is like a secret knock. Two quick taps mean the same as one big knock.

Example

Leo's hands are used to jj in his editor. He maps jj to <Esc>, and Claude Code feels the same.

Why it matters

Esc is far from the keys you type with, and two letters are close.

Definition

vimInsertModeRemaps is a settings key for vim mode that turns two keys typed in a row into Esc. With jj set, typing j then j within a second leaves INSERT mode, and neither j stays in the text. Each entry is two letters, and <Esc> is the only target. It is read from user or managed settings only. So a project cannot change your keys.

Example code

json
{
  "editorMode": "vim",
  "vimInsertModeRemaps": { "jj": "<Esc>" }
}
Turn on vim mode, and make jj leave INSERT mode.

Common mistake

Putting it in the project settings file. Claude Code ignores it there.

Key takeaways

  1. 1
    Two keys to Esc. Such as jj.
  2. 2
    Only <Esc>. As the target.
  3. 3
    User or managed only. Not a project.