Claude CodeのVimモードの使い方 — 有効化とキー操作一覧
Claude CodeでVimを使うには/configのEditor modeをvimにします。3モードのキー操作、jjでEscを代用する設定、Ctrl+Gで外部のVimを開く方法を解説します。
Claude CodeでVimを使うには、/configのEditor modeをvimにします。settings.jsonなら"editorMode": "vim"です。プロンプト全体を本物のVimで編集したいときは、Ctrl+Gで既定のテキストエディタを開く方法もあります。
Claude Codeの入力欄には、標準的なVimのモーション・編集コマンド・テキストオブジェクトをほぼそのまま備えたVimモードがあります。/configのEditor modeから切り替えると、NORMAL・INSERT・VISUALの3モードで文字入力を操作できるようになります。この記事では有効化の手順から、NORMAL modeでの移動・編集、VISUALモードでの選択、INSERTモードの2キー脱出シーケンス設定までを順に扱います。入力欄の絵文字ショートコードはClaude Codeの絵文字ショートコード入力方法にまとめています。
Vimモードの適用範囲と前提条件
対象はClaude Codeの入力ボックス内の編集操作です。OSのターミナルやエディタが持つVimエミュレーションとは別物で、Claude Codeのプロンプト入力欄だけに効く独立した実装です。前提はClaude Codeのインストール済み環境のみで、実際のVimを使ったことがなくても本文のキー対応表だけで操作を覚えられます。
真価が出やすいのは、複数行にまたがる長いプロンプトを書き直すときです。矢印キーとBackspaceだけで移動・削除する場合と比べ、dwやciwのようなオペレータ+モーションの組み合わせは移動と削除を1操作にまとめられます。指示文を数行書いてから途中の1単語だけ直す、といった編集が多い人ほど効果を感じやすい機能です。
ステップ1: Vimモードを有効にする
/configを開き、Editor modeをvimに切り替えます。
/configsettings.jsonに直接書いて恒久化することもできます。
{
"editorMode": "vim"
}INSERTモードでEscを押すとNORMALモードに切り替わり、そこから移動・編集コマンドが使えるようになります。現在のモードは入力欄の下に-- INSERT --のように表示されます。この表示は、自作のステータスラインがvim.mode(NORMAL・INSERT・VISUAL・VISUAL LINEのいずれか)を描画するならhideVimModeIndicatorで消せます。
モードはパネルや別画面を挟んでも保たれます。Ctrl+Oでトランスクリプトビューアーを開閉したり/configのようなパネルを閉じたりしても、NORMALモードのままカーソル位置も戻ります(v2.1.235以降)。
| コマンド | 動作 | 遷移元 |
|---|---|---|
EscまたはCtrl+[ | 動作NORMALモードへ | 遷移元INSERT、VISUAL |
i | 動作カーソルの前にInsert | 遷移元NORMAL |
I | 動作行頭にInsert | 遷移元NORMAL |
a | 動作カーソルの後にInsert | 遷移元NORMAL |
A | 動作行末にInsert | 遷移元NORMAL |
o | 動作下に行を開いてInsert | 遷移元NORMAL |
O | 動作上に行を開いてInsert | 遷移元NORMAL |
v | 動作文字単位のVISUAL選択を開始 | 遷移元NORMAL |
V | 動作行単位のVISUAL選択を開始 | 遷移元NORMAL |
ステップ2: NORMALモードで移動する
NORMALモードの移動コマンドは本家Vimとほぼ一致します。
| コマンド | 動作 |
|---|---|
h/j/k/l | 動作左/下/上/右へ移動 |
Space | 動作右へ移動 |
w/e/b | 動作次の単語/単語末尾/前の単語 |
0/$/^ | 動作行頭/行末/最初の非空白文字 |
gg/G | 動作入力全体の先頭/末尾 |
f{char}/F{char} | 動作次/前の指定文字へジャンプ |
t{char}/T{char} | 動作次/前の指定文字の直前/直後へ |
;/, | 動作直前のf/F/t/Tモーションを繰り返す/逆方向で繰り返す |
% | 動作対応する()・[]・{}へジャンプ。カーソルが括弧の上にないときは、現在行の次の括弧から数える(v2.1.301以降) |
/ | 動作逆順履歴検索を開く(Ctrl+Rと同じ)。空の検索プロンプトに、Esc→i→/でコマンドメニューを開くヒントが出る |
カーソルが入力の先頭または末尾にあってそれ以上動けないとき、j/kと↑/↓はコマンド履歴のナビゲーションに切り替わります。入力が空の状態で←を押すとagent viewが開き、v2.1.219以降はNORMALモードでも使えます。
ステップ3: 編集コマンドとテキストオブジェクト
編集はオペレータ(d/c/y)とモーション・テキストオブジェクトの組み合わせで成立します。
| コマンド | 動作 |
|---|---|
x | 動作1文字削除 |
r{char} | 動作カーソル位置の1文字を指定文字に置換 |
dd | 動作行削除 |
D | 動作カーソルから行末まで削除 |
dw/de/db | 動作単語/単語末尾まで/単語頭まで削除 |
df{char}/dt{char} | 動作指定文字まで(含む/直前まで)削除 |
dj/dk | 動作現在行と下/上の行を削除 |
dgg/dG | 動作現在行から最初/最後の行まで削除 |
d0/c0/y0 | 動作カーソルから行頭まで削除/変更/ヤンク(v2.1.281以降) |
d%/c%/y% | 動作カーソルから%の移動先の括弧までを削除/変更/ヤンク(v2.1.301以降) |
cc/C | 動作行を変更/行末まで変更 |
cw/ce/cb | 動作単語/単語末尾/単語頭を変更 |
s/S | 動作1文字を削除してInsert/行を消してInsert(v2.1.211以降) |
yy/Y | 動作行をヤンク(コピー) |
yw/ye/yb | 動作単語/単語末尾まで/単語頭までヤンク |
p/P | 動作カーソルの後/前に貼り付け |
>>/<< | 動作インデント/デデント |
J | 動作行を連結 |
u | 動作取り消し |
. | 動作直前の変更を繰り返す |
d・c・yはテキストオブジェクトとも組み合わせられます。iw/aw(単語の内側/周囲)、空白区切りの塊を1語とみなすiW/aW、i"/a"、i'/a'、i(/a(、i[/a[、i{/a{が使え、ciw(単語を丸ごと変更)やdi((括弧の中身を削除)のような操作がそのまま通ります。
実際の場面では、ファイルパスやコマンド名を書き直すときにci"(ダブルクオートの中身を変更)が特に便利です。カーソルがクオート内のどこにあっても、対象を正確に選び直す手間なく中身だけを丸ごと差し替えられます。単語単位の移動よりも「意味のある単位」で編集できる点が、矢印キー操作との一番の違いです。
ステップ4: VISUALモードで範囲選択する
v(文字単位)またはV(行単位)でVISUALモードに入ると、モーションで選択範囲を広げてからオペレータを当てられます。vjjdなら「下2行を含めて選択し削除」、Vyなら「現在行をヤンク」という要領です。VISUALモードでの選択と可視フィードバックはv2.1.118で追加された機能で、それ以前のClaude Codeにはありませんでした。
VISUALモードで選択した範囲には、以下のコマンドを当てられます。
| コマンド | 動作 |
|---|---|
d/x | 動作選択範囲を削除 |
y | 動作選択範囲をヤンク(コピー) |
c/s | 動作選択範囲を削除してInsert |
p | 動作選択範囲をレジスタの内容で置換 |
r{char} | 動作選択範囲の各文字を指定文字に置換 |
~/u/U | 動作大文字小文字を反転/すべて小文字化/すべて大文字化 |
>/< | 動作選択範囲をインデント/デデント |
J | 動作選択範囲の行を連結 |
o | 動作カーソルと選択の起点(アンカー)を入れ替え |
v/V | 動作文字単位選択/行単位選択に切り替え。同じ種類のキーをもう一度押すとVISUALを抜ける |
iw/aw/i"など | 動作テキストオブジェクトを選択 |
VISUALモードが便利なのは、削除や変更の範囲を先に目で確認してから実行できる点です。dwのようなオペレータ+モーションは一発で確定しますが、範囲が複雑なときや初めて使うモーションを試すときは、まずvで選択して見た目を確認し、それからdやcを当てるほうが事故を防げます。慣れてきたらオペレータ+モーションに戻す、という使い分けが現実的です。
なお、Ctrl+Vによるブロック選択(矩形選択)には対応していません。選択は文字単位(v)と行単位(V)の2種類のみです。
ステップ5: INSERTモードの2キー脱出シーケンスを設定する
ホームポジションを離れずにNORMALモードへ戻りたい場合、vimInsertModeRemaps設定でjjのような2キーシーケンスをEscに割り当てられます。v2.1.208以降で使えます。
{
"editorMode": "vim",
"vimInsertModeRemaps": { "jj": "<Esc>" }
}キーは印字可能な2文字ちょうどで、割り当て先に使えるのは"<Esc>"だけです。長さや割り当て先が違うエントリは無視されます。1文字目はいったん通常どおり挿入され、2文字目の打ち方で結果が分かれます。
`jj`を打ったときの2通りの結果
1秒以内に2文字目
先に挿入された1文字目が取り消され、どちらの文字も入力に残らないままNORMALモードに切り替わります。
1秒を過ぎる/別のキーを挟む
2文字とも通常の文字として残ります。間を空ければ、jjを含む単語も普通に打てます。
この設定は自分のユーザー設定ファイル・--settingsフラグ・管理者設定からのみ読み込まれます。チェックアウトしたリポジトリの.claude/settings.jsonや.claude/settings.local.jsonに書いても無視されるので、リポジトリ側から自分のキー入力を書き換えられることはありません。
keybindings.jsonとの関係
Vimモードとキーバインドシステムは独立して動きます。VimのEscapeキーは、INSERTモードではNORMALへの切り替えに使われ、応答を中断するchat:cancelは発火しません。ほとんどのCtrl系ショートカットはVimモードを素通りしてキーバインドシステムに届きます。NORMALモードで?を押すとヘルプメニューが開き、/を押すとCtrl+Rと同じ履歴検索が開くのは、いずれもVimモード側の挙動です。
Vimのモーションキー自体はkeybindings.jsonでリマップできません。 h/j/k/lのような基本移動キーを変更する手段は用意されておらず、変更できるのは前述のvimInsertModeRemapsによるINSERTモード脱出シーケンスだけです。
設定ファイルを編集する前に、どちらの管轄かを切り分けます。keybindings.jsonを開いてVimのモーションを探しても見つからないのは仕様どおりで、設定漏れではありません。
どちらの設定で変えるか
Vimモード側
入力欄の中の動き(カーソル移動・モード切替・オペレータ)です。変えられるのは
vimInsertModeRemapsだけです。キーバインド側
入力欄の外の動き(権限モードの切り替えやトランスクリプトビューアーの開閉など)です。
Ctrl系ショートカットの大半はこちらに届きます。
プロンプトを外部のVimで編集する(Ctrl+G)
入力欄のVimモードとは別に、Ctrl+G(またはCtrl+X Ctrl+E)でプロンプトを既定のテキストエディタに渡せます。既定のテキストエディタがVimになっている環境なら、本物のVimでプロンプトを書き直せます。エディタの選ばれ方や保存後の流れはCtrl+Gで外部エディタにプロンプトを開く方法にまとめています。Neovimを使う場合はClaude CodeをNeovimで使う方法も参照してください。
行番号を受け取れるエディタは、入力欄のカーソルがある行で開きます。/configの「Show last response in external editor」を有効にすると、Claudeの直前の返信が#のコメントとして上に付きます。保存時にそのコメントは取り除かれます。
この操作はkeybindings.jsonのchat:externalEditorで別のキーに割り当て直せます。入力欄のVimモードをオンにしたまま併用できます。
よくあるつまずき
/vimコマンドが見つからない: v2.1.92で廃止されており、切り替えは/configのEditor modeからのみ行います。- INSERTモードでEscを押しても応答が止まらない: INSERT中の1回目の
EscはNORMALへの切り替えで、chat:cancelは発火しません。NORMALモードでもう一度Escを押すと中断できます(v2.1.119以降)。Ctrl+CならINSERT・VISUALモード中でも中断できます(v2.1.141で修正)。 - 入力欄の先頭で
j/kを押しても動かない: カーソルが入力の境界にあるとき、これらのキーはコマンド履歴の移動に切り替わる仕様です。バグではなく、意図した挙動です。 - ヤンクした内容が消える: ダイアログや履歴検索、トランスクリプト表示を経由するとヤンクレジスタが空になる不具合がv2.1.220以前にありました。v2.1.221で修正済みです。
- Ctrl+Vでブロック選択できない: Vimモードの選択は文字単位(
v)と行単位(V)のみで、矩形選択(ブロック選択)には対応していません。 vimInsertModeRemapsが効かない: v2.1.208より前のバージョンでは存在しない設定です。.claude/settings.json(プロジェクト側)に書いても読み込まれない点にも注意します。ユーザー設定ファイルか--settingsフラグで指定します。Claude Codeのバージョンはclaude --versionで確認できます。
Vimモードの機能はこれまでどう拡張されてきたか
Vimモードの拡張履歴
- v2.1.0`;`/`,`・ヤンク・テキストオブジェクト
;/,のモーション繰り返し、y/p/P、テキストオブジェクト一式、>>/<<、Jが加わりました。 - v2.1.92`/vim`を廃止
切り替えは
/configのEditor modeに一本化されました。 - v2.1.98`j`/`k`が履歴移動に対応
入力の境界でコマンド履歴を移動できるようになりました。
- v2.1.118VISUALモードを追加
v/Vで選択・オペレータ・可視フィードバックが使えるようになりました。 - v2.1.208`vimInsertModeRemaps`を追加
2キーのINSERT脱出シーケンスを設定できます。
- v2.1.211`s`/`S`がVim標準の挙動に
文字/行の置換がNORMALモードで使えます。
- v2.1.219空の入力の`←`がNORMALでも有効
NORMALモードからもagent viewに入れるようになりました。
- v2.1.235・v2.1.242・v2.1.281状態保持・`Ctrl+[`・`d0`系
v2.1.235でトランスクリプトやパネルを挟んでもモードとカーソルが保たれ、v2.1.242でKittyキーボードプロトコルの端末でも
Ctrl+[が効き、v2.1.281でd0/c0/y0が動きます。 - v2.1.301`%`モーションを追加
対応する括弧へジャンプでき、
d%/c%/y%で括弧までの範囲を操作できます。
v2.1.0でテキストオブジェクトとヤンク/ペーストがそろい、v2.1.118のVISUALモード追加で選択操作が本格的になりました。v2.1.208以降は、キーボードから手を離さずに使い続けるための細部の詰めが中心で、v2.1.281でd0系、v2.1.301で%が加わっています。
まとめ
Vimに慣れているなら/configで有効化するだけで持ち込めます。つまずきやすい差は、Ctrl+Vの矩形選択がないことと、モーションキーをリマップできないことです。Vimモード以外のキー操作全般はClaude Codeショートカット一覧、settings.jsonの全体像はClaude Code設定ガイド、Claude Codeの基本機能はClaude Code(クロードコード)とはで確認できます。
参照した一次ソース
この記事の記述は、次の一次ソースと照合しています。更新時に参照先が変わった場合は一覧も更新します。