Claude Codeのキーバインド設定（keybindings.json）完全ガイド

キーバインドをカスタマイズする意義

こんにちは！今日はClaude Codeの**キーバインド設定（keybindings.json）**をじっくり解説していきます。

Claude Codeには豊富なキーボードショートカットが標準で用意されていますが、人によっては「このキー、別のものに割り当てたいな」と思うことがありますよね。

キーバインドのカスタマイズが効いてくる場面は、たとえばこんなときです。

• 標準の送信キー（Enter）以外で送信したい、改行と送信を入れ替えたい
• tmuxやscreenのプレフィックスキーと競合するショートカットを避けたい
• 普段VS CodeやVimで慣れている操作感にClaude Codeを寄せたい
• 誤爆しやすいキー（うっかり押すと画面がクリアされる等）を無効化したい

💡 ポイント: キーバインドは「効率化」の最後の一押しです。まずは標準ショートカットを覚え、どうしても合わないものだけをリバインドするのが、設定を壊さないコツです。

keybindings.jsonの場所と基本書式

ファイルの場所

設定ファイルはユーザーのホームディレクトリ配下にあります。

~/.claude/keybindings.json

ファイルがまだ存在しない場合は、自分で新規作成すればOKです。Claude Code内から/keybindingsコマンドを実行すると、この設定ファイルを開けます。

JSONの基本構造

keybindings.jsonは、トップレベルにbindingsという配列を持つオブジェクトです。配列の各要素が「あるコンテキストでのキー割り当て」を表します。

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

各フィールドの意味は次の通りです。

ポイントは、外側のbindingsが配列、内側のbindingsがオブジェクトという二段構えになっていることです。ここを取り違えると後述の検証でエラーになります。

コンテキストとは

「コンテキスト」は、そのキーバインドが効く画面や状態のことです。たとえばChatはチャット入力欄にフォーカスがある状態、Confirmationは権限確認ダイアログが出ている状態を指します。同じctrl+eでもコンテキストによって別の動作に割り当てられます。

主なコンテキストは以下の通りです。

アクションとは

「アクション」は実際に実行される動作で、カテゴリ:動作名という形式の文字列です。代表的なものを挙げます。

正確な動作の標準割り当ては環境やバージョンで変わることがあります。手元の割り当ては/doctor（後述）や公式ドキュメントで確認できます。ここに無い細かな既定キーを推測で決め打ちせず、設定で変更可能という前提で扱うのが安全です。

キーストロークの記法

キーの表記ルールを押さえておきましょう。修飾キーは+でつなぎます。

特殊キーの名前は次の通りです。

よく使うリバインド例

ここからは実際の設定例を見ていきます。コピーして自分用に書き換えてください。

例1: 外部エディタのキーを変える

標準の外部エディタ呼び出し（ctrl+g）をctrl+eに移動したい場合は、古いキーをnullで無効化し、新しいキーを追加します。

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

ここが重要なポイントです。ユーザーのバインドは標準設定の後ろに追加されるだけなので、新しいキーを足しただけだと古いキーも生き残ります。完全に「引っ越し」させたいなら、古いキーをnullで消すことを忘れないでください。

例2: 改行と送信のキーを使い分ける

「Enterは改行、別のキーで送信」にしたい人向けの例です。chat:newlineにEnterを割り当て、送信をmeta+enter（Cmd/Option + Enter）に寄せます。

{
  "$schema": "https://www.schemastore.org/claude-code-keybindings.json",
  "$docs": "https://code.claude.com/docs/en/keybindings",
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "meta+enter": "chat:submit"
      }
    }
  ]
}

例3: 誤爆しやすいキーを無効化する

「うっかり押すと困る」キーは、値をnullにすれば無効化できます。たとえば入力欄クリア（ctrl+l）を無効にするなら次のようにします。

{
  "$schema": "https://www.schemastore.org/claude-code-keybindings.json",
  "$docs": "https://code.claude.com/docs/en/keybindings",
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+l": null
      }
    }
  ]
}

例4: グローバルなトグルを足す

タスクリストの表示切替（app:toggleTodos）に、標準キーとは別のキーを追加することもできます。Globalコンテキストに足せば、どの画面からでも使えます。

{
  "$schema": "https://www.schemastore.org/claude-code-keybindings.json",
  "$docs": "https://code.claude.com/docs/en/keybindings",
  "bindings": [
    {
      "context": "Global",
      "bindings": {
        "ctrl+shift+t": "app:toggleTodos"
      }
    }
  ]
}

チョード（連続キー）の設定

VS Codeのように、複数のキーを順番に押す割り当て（チョード）も書けます。スペース区切りで複数のキーストロークを並べます。

{
  "$schema": "https://www.schemastore.org/claude-code-keybindings.json",
  "$docs": "https://code.claude.com/docs/en/keybindings",
  "bindings": [
    {
      "context": "Global",
      "bindings": {
        "ctrl+k ctrl+t": "app:toggleTodos"
      }
    }
  ]
}

"ctrl+k ctrl+t"は「Ctrl+Kを押してからCtrl+Tを押す」という意味です。キーとキーの間には短いタイムアウトがあり、それを超えるとチョードはリセットされる仕様です（具体的な待ち時間は環境やバージョンで異なります）。

予約済み・競合に注意するキー

どんなキーでも自由に割り当てられるわけではありません。次のキーはターミナルやOSが先に処理するため、リバインドできない、または競合します。

Vimモード

「キーバインドそのものをVim風にしたい」という人には、Claude Code標準のVimモードがあります。これはkeybindings.jsonとは別の仕組みで、入力欄の操作をVim流（ノーマル / インサート）にするものです。

有効化

Claude Code内で次のコマンドを実行するとトグルできます。

/vim

有効にすると、入力欄でEscからノーマルモードに入り、h / j / k / lの移動、ddの行削除、yyのヤンクなどVimの基本操作が使えます。具体的な操作一覧はキーボードショートカット完全ガイドのVimモード節にまとめてあります。

keybindings.jsonとの関係

VimモードとカスタムキーバインドはどちらもClaude Codeの操作系に関わるため、組み合わせるとキーの取り合いが起きることがあります。とくにノーマルモードの英字キー（d、y、pなど）と、Chatコンテキストに足したカスタムバインドが重ならないよう注意してください。

反映されない時の対処

設定したのに効かない、というときは次の順で確認しましょう。

1. JSONの構文を疑う

keybindings.jsonはJSONなので、末尾カンマ・クォート漏れ・括弧の閉じ忘れがあると全体が読み込まれません。エディタの構文チェックや$schemaの補完を活用してください。

2. 構造を確認する

ありがちなのが、外側と内側のbindingsの取り違えです。

{
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+e": "chat:externalEditor"
      }
    }
  ]
}

外側のbindingsは配列（[...]）、内側はオブジェクト（{...}）です。"bindings" must be an arrayのようなエラーが出たら、ここを見直します。

3. /doctorで検証する

Claude Codeの/doctorコマンドには「Keybinding Configuration Issues」という検証項目があり、設定ファイルの問題点を指摘してくれます。

Errorは修正必須、Warningは競合の可能性を示すもの（動く場合もある）と覚えておきましょう。

4. 予約キーでないか確認する

前述の予約済みキー（ctrl+cなど）に割り当てていないかを確認します。/doctorは予約キーへの割り当ても警告してくれます。

5. 古いキーが残っていないか

「新しいキーは効くのに、古いキーも反応してしまう」場合は、ユーザーバインドが追加である性質を思い出してください。引っ越しのつもりなら、古いキーをnullで無効化する必要があります。

よくある質問

まとめ

今回はClaude Codeの**キーバインド設定（keybindings.json）**を体系的に学びました。

要点をまとめます。

まずは効きにくい1キーだけをリバインドして挙動を確かめ、慣れてきたら少しずつ自分好みに育てていくのがおすすめです。標準のショートカット自体を先に押さえておきたい人はキーボードショートカット完全ガイドを、セッションのやり直しを極めたい人はrewindとforkを、複数エージェントの並行作業に興味がある人はcmuxのマルチエージェントワークフローもあわせてどうぞ！