# vimInsertModeRemaps

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

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** vimInsertModeRemaps setting, jj to Escape

## Think of it like

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

## 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

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

## Example code

```json
{
  "editorMode": "vim",
  "vimInsertModeRemaps": { "jj": "<Esc>" }
}
```

Turn on vim mode, and make jj leave INSERT mode.

## Why it matters

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

## Common mistake

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

## Three principles

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

## Related terms

- [editorMode](https://learn.benibix.com/term/ai/editor-mode-setting)
- [Esc Shortcut](https://learn.benibix.com/term/ai/esc-shortcut)
- [keybindings.json](https://learn.benibix.com/term/ai/keybindings-json-file)

---

Source: https://learn.benibix.com/term/ai/vim-insert-mode-remaps-setting
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-16
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
