[DOCS] Vim mode docs still reference removed `/vim` command
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/vimcommand or configure permanently via/config.
Claude Code supports a subset of Vim keybindings that can be enabled with/vimor 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/configas Key binding mode
What's Wrong or Missing?
Changelog v2.1.92 says:
Removed/vimcommand (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:
- Remove
/vimfrom the built-in commands table on the commands page. - Replace
/vimsetup instructions on related pages with the current settings flow via/config. - Use the current UI label consistently for that setting (the changelog describes it as
/config→ Editor mode). - 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 seteditorModeto"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/vimcommand (toggle vim mode via/config→ Editor mode)
This issue has 2 comments on GitHub. Read the full discussion on GitHub ↗