Skip to content
Claude Code adds vimInsertModeRemaps for custom insert-mode mappings | My AI Guide

Claude Code adds vimInsertModeRemaps for custom insert-mode mappings

By Harsh Desai
Share

TL;DR

Claude Code added the vimInsertModeRemaps setting to map two-key insert-mode sequences such as jj to Escape in vim mode.

What changed

Claude Code added the vimInsertModeRemaps setting for developers. Vibe Builders and Basic Users can now define two-key sequences such as jj to trigger Escape while in vim insert mode.

Why it matters

Developers gain quicker exits from insert mode during extended sessions, matching common patterns seen in Neovim setups where such remaps see frequent daily application. Basic Users and Vibe Builders avoid extra keystrokes when switching modes in their coding flows.

What to watch for

Compare the behavior against the VS Code vim plugin when testing sequences. Open the settings file and verify that your chosen remap appears correctly after reload.

Who this matters for

  • Vibe Builders: Add "vimInsertModeRemaps": {"jj": "<Esc>"} to your config to keep your hands on the home row.

Harshs take

This update shows Anthropic is serious about winning over terminal-dwelling developers. By adding custom insert-mode remaps like the classic "jj" to Escape, Claude Code is removing the friction that keeps Vim purists from adopting CLI-based AI agents. For builders, this is a clear signal to treat terminal tools as primary workspaces rather than temporary playgrounds. If you are building developer tools, do not ignore these micro-interactions: keyboard ergonomics and muscle memory compatibility drive long-term developer retention.

by Harsh Desai

Source:code.claude.com

About Claude Code

View the full Claude Code page →All Claude Code updates

Go deeper

More AI news

Everything AI. One email.
Every Monday.

New tools. Model launches. Plugins. Repos. Tactics. The moves the sharpest builders are making right now, before everyone else.

No spam. Unsubscribe anytime.