Claude Codeのキーバインディング

Ctrl+Kを押せばコマンドパレットが開く、そう指が覚えています。Claude Codeは別の動作をします。その誤った反射のたびに、一瞬の思考とフローの中断が生じます。

そのコストは積み重なります。長いClaude Codeセッションは筋肉の記憶で動いており、悪いデフォルト設定がそのキーストロークごとに筋肉の記憶と戦います。VS Code、Vim、Emacsの長年の習慣はコマンドで消えません。他人のショートカットレイアウトに合わせて手を再訓練するのは無駄な努力です。

修正方法は組み込まれています。コンテキストで整理された1つのJSONファイルで、気になるすべてのショートカットを管理できます。コードシーケンス、モディファイアスタック、デフォルトを完全に無効にするオプションも使えます。保存した瞬間に変更が有効になります。ツールが自分のものに感じられるよう設定する方法を説明します。

カスタムキーバインディングの最初のステップ

Claude Codeの中で/keybindingsと入力します。このスラッシュコマンドが~/.claude/keybindings.jsonを作成または開きます。ファイルは他の設定と同じく通常の~/.claude/フォルダに保存されます。

ファイルの形は単純です:

{
  "$schema": "https://platform.claude.com/docs/schemas/claude-code/keybindings.json",
  "$docs": "https://code.claude.com/docs/en/keybindings",
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+e": "chat:externalEditor",
        "ctrl+u": null
      }
    }
  ]
}

3つのトップレベルキーがすべてを担います:

• $schema - オプション。JSON SchemaのURLを指定するとエディタが無料のオートコンプリートとバリデーションを提供します。残しておく価値があります。
• $docs - オプション。素早い参照のためのドキュメントリンク。
• bindings - ショートカットが入る配列。コンテキストごとに1エントリ。

このschemaフィールドには地味なメリットがあります。JSON Schemaをサポートするエディタが、入力中に有効なアクションとコンテキスト名を提案してくれます。

保存したファイルはその場で反映されます。編集して保存すれば、新しいバインディングがすぐに機能します。再起動不要です。

コンテキストの仕組み

各バインディングはコンテキストの中に置かれ、コンテキストがそのショートカットが有効なタイミングを決定します。Chatバインディングはメインのチャット入力にフォーカスがある場合のみ起動します。コンテキストをまたいで同じキーを再利用すれば、それぞれ異なる動作をさせることができます。

Claude Codeには17のコンテキストがあります:

Globalは特別です。ここのショートカットはどのビューにいても起動します。注意して使いましょう。グローバルのCtrl+Kは、チャット内でも、オートコンプリート内でも、diffのレビュー中でもトリガーされます。

すべてのアクション一覧

アクション名はnamespace:actionパターンに従います。以下はすべてのコンテキストにある、デフォルトキーとともにすべてのアクションです。

グローバルアクション

どこからでも起動します:

タスクリストをよく使うユーザーはapp:toggleTodosを一日中使います。Ctrl+Tがターミナルと衝突する場合は、別の場所に移動させましょう。

チャットアクション

ほとんどのキーストロークが着地する場所:

VTモードのないWindowsでは、chat:cycleModeはMeta+Mにフォールバックします。これはNode.js 24.2.0/22.17.0より古いビルドおよびBun 1.2.23より古いバージョンに適用されます。このショートカットは権限モードを制御し、Claudeが許可される操作をゲートします。

履歴アクション

過去のプロンプトを遡る:

オートコンプリートアクション

候補メニューが開いている間に有効:

確認アクション

権限と承認ダイアログのバインディング:

トランスクリプトアクション

履歴検索アクション

タスクアクション

テーマ、ヘルプ、設定アクション

ナビゲーションアクション

タブ、添付ファイル、フッター、diff、モデルピッカー、セレクト、メッセージセレクターはすべてここにあります:

キーストロークの構文

キーの組み合わせを定義する構文は見やすいものです。

モディファイア

モディファイアキーを対象キーに+で接続します:

• ctrl または control: Controlキー
• alt、opt、または option: Alt/Optionキー
• shift: Shiftキー
• meta、cmd、または command: Meta/Commandキー

いくつかの例:

ctrl+k          Single modifier + key
shift+tab       Shift + Tab
meta+p          Command/Meta + P
ctrl+shift+c    Multiple modifiers

大文字とShift

裸の大文字はすでにShiftを意味します。バインディング内のKはshift+kと同じです。jとJ（またはkとK）が異なるアクションにマップされるVimスタイルのレイアウトに便利です。

1つの注意点。モディファイアが付くと、大文字小文字は区別されなくなります。ctrl+Kとctrl+kは同じバインディングです。モディファイアがある場合、大文字は見た目だけです。

コードシーケンス

コードはマルチキーのショートカットを提供します。キーストロークの間にスペースを入れます:

ctrl+k ctrl+s Press Ctrl+K, release, then press Ctrl+S

これにより単一キーのバインディングよりもはるかに多くの余裕が生まれます。使える未使用のキーコンボが少なくなってきた場合、コードは何もステップオンせずに数百の新しい選択肢を追加します。

特殊キー

文字以外のキーには独自の名前があります:

• escape または esc
• enter または return
• tab
• space
• up、down、left、right
• backspace、delete

デフォルトショートカットのオフ

アクションをnullに設定するとデフォルトが消えます:

{
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+s": null
      }
    }
  ]
}

デフォルトがターミナル、OS、またはClaude Codeの隣で実行している別のツールと競合するときに便利です。デフォルトをnullにして同じキーに新しいアクションを割り当てることもできます。

予約済みショートカット

2つのキーはハードコードされており、変更できません:

Claude Codeはこれらを変更する試みを拒否します。これは正しい判断です。すべてのターミナルユーザーはCtrl+Cが中断し、Ctrl+Dが終了することを期待しています。これらはUnixの慣習です。

ターミナルマルチプレクサとの競合

tmux、GNU screen、または類似のマルチプレクサ内でClaude Codeを実行している場合、プレフィックスキーが問題を起こします:

task:backgroundはデフォルトでCtrl+Bに設定されており、これはtmuxのプレフィックスと完全に一致します。tmuxを使っている場合は初日に変更しましょう:

{
  "bindings": [
    {
      "context": "Task",
      "bindings": {
        "ctrl+b": null,
        "ctrl+shift+b": "task:background"
      }
    }
  ]
}

この競合は、マルチプレクスされたセッション内でClaude Codeを実行する多くの開発者を悩ませています。

Vimモードとの相互作用

/vimでvimモードをオンにすると、キーバインディングとは別のレイヤーで動作します:

• Vimモード: テキスト編集を担当します。カーソル移動、INSERTとNORMALモード、モーション、テキストオブジェクト。
• キーバインディング: アプリレベルのアクションを担当します。タスクリストの切り替え、メッセージの送信、モデルピッカーのオープン。

Escapeキーが最も明確な分岐点です。vimモード内では、EscapeはINSERTを抜けてNORMALに入ります。chat:cancelは呼び出されません。ほとんどのCtrl+keyショートカットはvimモードをそのまま通過してキーバインディングレイヤーに入るため、NORMALモードからでもCtrl+Tがタスクリストを切り替えます。

NORMALモードでは、?はClaude Codeのヘルプ画面ではなく、vimスタイルのヘルプを表示します。

vimモードで思考モードをよく使う場合は、chat:thinkingToggleをvimのモーションと衝突しないコードに配置しましょう。インタラクティブモードガイドでは、vimモード、スラッシュコマンド、その他のインタラクティブ機能がどのように組み合わさるかを説明しています。

バリデーションと診断

Claude Codeは保存ごとにキーバインディングファイルをチェックし、以下をフラグします:

• JSON構文または構造の解析エラー
• サポートされている17のコンテキストと一致しない無効なコンテキスト名
• Ctrl+CまたはCtrl+Dを変更しようとする予約済みショートカットの競合
• Ctrl+B、Ctrl+A、Ctrl+Zのターミナルマルチプレクサとの競合
• 同じコンテキスト内の重複したバインディング

/doctorを実行すると、すべてのキーバインディング警告が一覧表示されます。ショートカットが誤動作する原因を特定するための最短経路です。

実用的な設定例

実際の使用環境から引用したいくつかの設定です。

VS Codeユーザー向けの設定

VS Codeから来てよく使うショートカットを戻したい場合:

{
  "$schema": "https://platform.claude.com/docs/schemas/claude-code/keybindings.json",
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+k ctrl+s": "chat:stash",
        "ctrl+shift+p": "chat:modelPicker",
        "ctrl+g": "chat:externalEditor"
      }
    },
    {
      "context": "Global",
      "bindings": {
        "ctrl+shift+t": "app:toggleTodos"
      }
    }
  ]
}

tmuxフレンドリーな設定

tmuxのプレフィックスとの衝突を回避します:

{
  "$schema": "https://platform.claude.com/docs/schemas/claude-code/keybindings.json",
  "bindings": [
    {
      "context": "Task",
      "bindings": {
        "ctrl+b": null,
        "ctrl+shift+b": "task:background"
      }
    }
  ]
}

最小限の干渉設定

誤って押してしまうショートカットを削除します:

{
  "$schema": "https://platform.claude.com/docs/schemas/claude-code/keybindings.json",
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+s": null,
        "ctrl+u": null
      }
    }
  ]
}

コードベースのパワーユーザー設定

よく使わない機能をコードに配置して、単一キーのコンボを解放します:

{
  "$schema": "https://platform.claude.com/docs/schemas/claude-code/keybindings.json",
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+k ctrl+t": "chat:thinkingToggle",
        "ctrl+k ctrl+m": "chat:modelPicker",
        "ctrl+k ctrl+e": "chat:externalEditor"
      }
    }
  ]
}

最もよく使うアクションが1キーのバインディングをキープします。それ以外はコード1つで呼び出せます。

独自の設定を構築する

ゆっくり進めましょう。アプリ全体を一度に変更するのは罠です。より賢明なアプローチを紹介します:

1. /keybindingsを実行して設定ファイルを生成する
2. 最悪の3つの問題点を選ぶ（ショートカットの衝突、欠けているバインディング、誤動作）
3. まずその3つを修正するターゲットを絞ったエントリで
4. /doctorを実行してファイルを検証する
5. Claude Codeのフルセッションを費やすと何がまだひっかかるかメモする
6. 繰り返し改善する摩擦が現れたらバインディングを追加または調整する

すべての可能なショートカットをカスタマイズすることは目標ではありません。目標は、手が期待することとClaude Codeが実行することのギャップを閉じることです。5〜10個のバインディングで通常はツールが自分のものとして感じられるようになります。

キーバインディングは物理的な側面を担います。CLAUDE.mdとカスタムスラッシュコマンドが動作面を担います。これらを組み合わせると、Claude Codeがあなたのワークフローに合わせて構築されたかのように感じられます。