[DOCS] Vim mode docs still reference removed `/vim` command

Resolved 💬 2 comments Opened Apr 4, 2026 by coygeek Closed Apr 5, 2026

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/commands

Section/Topic

Built-in commands table (/vim) and the related Vim mode setup guidance

Current Documentation

The docs currently say:

| /vim | Toggle between Vim and Normal editing modes |

Related pages still point users to the removed command:

Enable vim-style editing with /vim command or configure permanently via /config.
Claude Code supports a subset of Vim keybindings that can be enabled with /vim or configured via /config.
When vim mode is enabled (/vim), keybindings and vim mode operate independently:
editorMode | Key binding mode for the input prompt: "normal" or "vim". Default: "normal". Written automatically when you run /vim. Appears in /config as Key binding mode

What's Wrong or Missing?

Changelog v2.1.92 says:

Removed /vim command (toggle vim mode via /config → Editor mode)

The current docs are outdated for that change:

A. The commands reference still lists /vim as an available built-in command

Users checking the commands page will expect /vim to work even though v2.1.92 removed it.

B. Related Vim mode pages still describe /vim as the way to enable or reason about Vim mode

Interactive mode, terminal configuration, keybindings, and settings still refer to /vim instead of the current /config flow. That sends users to a removed command and obscures the current entry point for enabling vim mode.

Suggested Improvement

Update the vim-mode documentation set to match v2.1.92:

  1. Remove /vim from the built-in commands table on the commands page.
  2. Replace /vim setup instructions on related pages with the current settings flow via /config.
  3. Use the current UI label consistently for that setting (the changelog describes it as /config → Editor mode).
  4. Reword command-specific text such as "Written automatically when you run /vim" so it describes the setting-based flow instead.

For example, the setup guidance could say:

Enable vim-style editing from /config → Editor mode, or set editorMode to "vim" in ~/.claude.json.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

| Page | Line(s) | Context |
|------|---------|---------|
| https://code.claude.com/docs/en/commands | 81 | Built-in commands table still lists /vim |
| https://code.claude.com/docs/en/interactive-mode | 107 | Vim editor mode section says to enable it with /vim |
| https://code.claude.com/docs/en/terminal-config | 90 | Terminal config page says Vim keybindings can be enabled with /vim |
| https://code.claude.com/docs/en/keybindings | 403 | Keybindings page describes vim mode as enabled via /vim |
| https://code.claude.com/docs/en/settings | 224 | editorMode row says it is written automatically when you run /vim |

Total scope: 5 pages affected

Source: Changelog v2.1.92

Changelog entry:

Removed /vim command (toggle vim mode via /config → Editor mode)

View original on GitHub ↗

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