Claude CodeのkeybindingFlavorとは — Ctrl+Wの単語削除が変わった理由

Ctrl+Wでパスをひとまとめに消せたのに、別の環境では1単語ずつしか消えない。Claude Codeでこの食い違いに遭遇したら、原因はkeybindingFlavorという設定です。この設定はv2.1.261で非推奨になり、今はどの環境でも同じ方式に統一されています。

長いファイルパスやオプション付きのコマンドを入力していると、消したい範囲が末尾の1階層なのか、パス全体なのかで欲しいキー操作は変わります。同じキーでもバージョンによって消える範囲が違っていた、という食い違いの正体が今回扱う設定です。

Claude CodeのkeybindingFlavorとは

keybindingFlavorは、プロンプト入力欄の単語編集キーの挙動を切り替える設定でした。値は"classic"か"readline"の文字列で、スコープはAny file、既定値は未設定です。Any fileは、ユーザー設定・プロジェクト設定・ローカル設定・管理設定のどこに書いても読み込まれるという意味です。

v2.1.261以降、この設定は非推奨になり効果を持ちません。単語編集キーは常にreadline方式に統一されたためです。設定ファイルにkeybindingFlavorを書いても、Claude Codeはエラーを出さずに読み込みます。値が捨てられるだけで、設定ファイル自体は今も有効です。

チームで共有しているプロジェクトの.claude/settings.jsonに残っていても、grepで見つけて慌てて削除する必要はありません。~/.claude.jsonはAny fileとは別の「Global config」というスコープで、設定を探すときはsettings.jsonとsettings.local.json(と管理設定)に絞れば足ります。

Ctrl+Wは今どんな単位で文字を消すか

readline方式に統一された結果、Ctrl+Wは句読点を無視して直前の空白まで一気に削除します。src/utils/foo.tsと入力した状態で1回押すと、パス全体が消えます。--flag=valueのような形も1回で消えます。bashのデフォルト挙動と同じ動きです。

消した文字列は保持されるため、Ctrl+Yで貼り戻せます。連続して貼り付け履歴を切り替えたいときはAlt+Yを使います。

この貼り付けバッファーはCtrl+W専用ではありません。行末まで消すCtrl+Kや行頭まで消すCtrl+Uで削除した文字列も同じCtrl+Yで復元できます。想定より広い範囲を消してしまったときは、Ctrl+Yで戻す以外にCtrl+_(またはCtrl+Shift+-)で直前の編集そのものを取り消す方法もあります。

長いコマンドを組み立てる途中で引数の一部だけを直したいとき、一括削除はむしろ邪魔になる場面もあります。そのときは単語単位のキーに持ち替えれば、消える範囲を自分で選べます。

以前のkeybindingFlavorが担っていた「単語だけを消す」挙動は、別のキーとして残っています。macOSではOption+Delete、WindowsではCtrl+Backspaceです。設定を書き換える代わりにこちらを使えば、単語単位の削除に切り替えられます。

Alt+B・Alt+F・Alt+DをmacOSで使うには、ターミナル側でOptionキーをMetaとして送る設定が別途必要です。日本語や中国語のようにスペースを使わない文章でも、単語系のキーは1単語ずつ動き、消えます。

Windowsでは、BackspaceがCtrl+Backspaceとして読まれて単語ごと消えることがあります。Claude Codeは^Hとして届いたBackspaceをCtrl+Backspaceとして扱います。例外はTERM_PROGRAMがminttyのときと、TERMがcygwinのときです。

Backspaceを押すたびに単語ごと消えるなら、環境変数CLAUDE_CODE_BS_AS_CTRL_BACKSPACEを0にします。BackspaceとCtrl+Hが1文字ずつ消えるようになります。macOSやLinuxでCtrl+Backspaceが1文字しか消えないときは、同じ変数を1にします。詳しい手順はGit BashのBackspaceが単語ごと消える問題をClaude Codeで直すで扱っています。

キーボードの配列がキリル文字などのときは、Ctrl+Wの届き方がターミナルによって変わります。Kittyキーボードプロトコルでキーの物理位置を報告するターミナルなら、ロシア語配列でもCtrlとWキーの組み合わせがctrl+wになります。位置を報告しないターミナルでは、キーがキリル文字として届き、どのバインドにも一致しません。

Claude Codeの全ショートカット早見表には、行移動や履歴検索など他の操作もまとまっています。

削除系キーは何をどこまで消すか

入力欄の削除キーは、消す範囲と戻し方が少しずつ違います。Ctrl+K・Ctrl+U・Ctrl+W・Alt+Dで消した文字列は、すべてCtrl+Yで貼り戻せます。

macOSのCmd+Backspaceは、iTerm2やTerminal.appなどのターミナルがCtrl+Uに割り当てているため、行頭まで消えます。Alt+Fも同じ形で、現在の単語の末尾か、カーソルが単語の間にあるときは次の単語の末尾へ進みます。

Vimのword(単語)とWORD(空白区切り)と同じ構図

Claude CodeのVimモードには、これと同じ区別がもともとあります。文字種で区切る「word」と、空白だけで区切る「WORD」です。テキストオブジェクトのiw/aw(単語の内側/周囲)とiW/aW(空白区切りの内側/周囲)がその区別にあたります。dw・de・dbは前者の基準で単語単位を扱う操作です。

たとえばsrc/utils/foo.tsのfoo部分にカーソルがある状態で、diwはfooだけを削除し、diWはパス全体を削除します。Alt系のキーがword、Ctrl+WがWORDに相当すると考えると。

Vimのモーションキー自体はNORMALモード専用です。~/.claude/keybindings.jsonの他のアクションはClaude Codeの全体設定リファレンスにまとめています。Vim NORMALモードの操作一覧はClaude Code Vimモードの使い方とキー操作一覧を参照してください。

Ctrl+Wだけではない、readline由来のキーは他にもある

プロンプト入力を編集するCtrl+GにはCtrl+X Ctrl+Eという別の押し方があります。公式ドキュメントはこちらを「readline-nativeな割り当て」と明記しています。どちらもデフォルトのテキストエディターでプロンプトを開く操作で、readlineに慣れた手が自然に伸びるのはCtrl+X Ctrl+Eです。

コマンド履歴を遡るCtrl+Rも、readlineの逆方向インクリメンタルサーチと同じ発想の機能です。履歴検索の細かい挙動やフルスクリーン表示・Vimモードでの違いはCtrl+R履歴検索でClaude Codeの過去プロンプトを再利用するで扱っています。

keybindingFlavorを書いた設定ファイルの扱い

過去に次のような設定を書いていた場合、v2.1.261以降は値が読み込まれるだけで動作には反映されません。

{
  "keybindingFlavor": "readline"
}

この設定は効果を持たないため、消すか残すかは設定ファイルを整理するときに決めれば足ります。

利用形態別keybindingFlavor廃止の影響早見表

分かれ目はv2.1.261をまたいだかどうかです。何も書いていなかった利用者も、更新するとCtrl+Wの消える範囲が広がります。社内のドキュメントや個人のメモに「readlineに設定すると使いやすくなる」という古い手順が残っている場合は、その手順がもう不要になっている点だけ押さえておけば足ります。

自分の環境で挙動を試す

手元のバージョンを確かめてから、入力欄で実際に2つのキーを比べると違いが一目で分かります。版はclaude --versionで確かめます。

claude --version

まとめ

keybindingFlavorはv2.1.238からv2.1.260までの間だけ意味を持った設定で、今は書いても書かなくても同じです。単語だけを消したい場面では、設定を探すよりOption+DeleteかCtrl+Backspaceに持ち替えるのが近道です。"classic"の挙動に慣れた手は、設定ではなくキーで合わせ直します。