キーボードショートカットのカスタマイズ

キーボードショートカットをカスタマイズして、Claude Code でキーバインディング設定ファイルを使用します。

Claude Code はカスタマイズ可能なキーボードショートカットをサポートしています。/keybindings を実行して、~/.claude/keybindings.json に設定ファイルを作成または開きます。

設定ファイル

キーバインディング設定ファイルは、bindings 配列を持つオブジェクトです。各ブロックはコンテキストとキーストロークからアクションへのマップを指定します。

この例では、チャットコンテキストで Ctrl+E を外部エディタを開くにバインドし、Ctrl+U をアンバインドします。

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

コンテキスト

各バインディングブロックは、バインディングが適用されるコンテキストを指定します。

利用可能なアクション

アクションは namespace:action 形式に従います。例えば、chat:submit はメッセージを送信し、app:toggleTodos はタスクリストを表示します。各コンテキストには特定のアクションが利用可能です。

アプリアクション

Global コンテキストで利用可能なアクション：

履歴アクション

コマンド履歴をナビゲートするためのアクション：

チャットアクション

Chat コンテキストで利用可能なアクション：

*VT モードなし（Node <24.2.0/<22.17.0、Bun <1.2.23）の Windows では、デフォルトは Meta+M です。

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

Autocomplete コンテキストで利用可能なアクション：

確認アクション

Confirmation コンテキストで利用可能なアクション：

権限アクション

権限ダイアログの Confirmation コンテキストで利用可能なアクション：

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

Transcript コンテキストで利用可能なアクション：

履歴検索アクション

HistorySearch コンテキストで利用可能なアクション：

タスクアクション

Task コンテキストで利用可能なアクション：

テーマアクション

ThemePicker コンテキストで利用可能なアクション：

ヘルプアクション

Help コンテキストで利用可能なアクション：

タブアクション

Tabs コンテキストで利用可能なアクション：

添付ファイルアクション

Attachments コンテキストで利用可能なアクション：

フッターアクション

Footer コンテキストで利用可能なアクション：

メッセージセレクタアクション

MessageSelector コンテキストで利用可能なアクション：

Diff アクション

DiffDialog コンテキストで利用可能なアクション：

モデルピッカーアクション

ModelPicker コンテキストで利用可能なアクション：

選択アクション

Select コンテキストで利用可能なアクション：

プラグインアクション

Plugin コンテキストで利用可能なアクション：

設定アクション

Settings コンテキストで利用可能なアクション：

Doctor アクション

Doctor コンテキストで利用可能なアクション：

音声アクション

音声ディクテーションが有効な場合、Chat コンテキストで利用可能なアクション：

スクロールアクション

フルスクリーンレンダリングが有効な場合、Scroll コンテキストで利用可能なアクション：

キーストロークシンタックス

モディファイア

+ セパレータでモディファイアキーを使用します。

• ctrl または control - Control キー
• shift - Shift キー
• alt、opt、option、または meta - Windows と Linux の Alt キー、macOS の Option キー
• cmd、command、super、または win - macOS の Command キー、Windows の Windows キー、Linux の Super キー

cmd グループは Super モディファイアを報告するターミナル（Kitty キーボードプロトコルまたは xterm の modifyOtherKeys モードをサポートするターミナルなど）でのみ検出されます。ほとんどのターミナルはこれを送信しないため、すべての場所で機能するバインディングには ctrl または meta を使用してください。

例えば：

ctrl+k          Ctrl + K
shift+tab       Shift + Tab
meta+p          macOS の Option + P、その他の場所では Alt + P
ctrl+shift+c    複数のモディファイア

大文字

スタンドアロンの大文字は Shift を意味します。例えば、K は shift+k と同等です。これは大文字と小文字のキーが異なる意味を持つ vim スタイルのバインディングに便利です。

モディファイア付きの大文字（例：ctrl+K）はスタイル的に扱われ、Shift を意味しません — ctrl+K は ctrl+k と同じです。

コード

コードはスペースで区切られたキーストロークのシーケンスです。

ctrl+k ctrl+s   Ctrl+K を押して、リリースしてから Ctrl+S

特殊キー

• escape または esc - Escape キー
• enter または return - Enter キー
• tab - Tab キー
• space - スペースバー
• up、down、left、right - 矢印キー
• backspace、delete - Delete キー

デフォルトショートカットをアンバインド

アクションを null に設定して、デフォルトショートカットをアンバインドします。

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

これはコードバインディングでも機能します。プレフィックスを共有するすべてのコードをアンバインドすると、そのプレフィックスを単一キーバインディングとして使用できるようになります。

{
  "bindings": [
    {
      "context": "Chat",
      "bindings": {
        "ctrl+x ctrl+k": null,
        "ctrl+x ctrl+e": null,
        "ctrl+x": "chat:newline"
      }
    }
  ]
}

プレフィックス上の一部のコードをアンバインドしても、すべてをアンバインドしない場合、プレフィックスを押すと残りのバインディングのコード待機モードに入ります。

予約済みショートカット

これらのショートカットは再バインドできません。

ターミナルの競合

一部のショートカットはターミナルマルチプレクサと競合する可能性があります。

Vim モードの相互作用

Vim モードが /config → エディタモードで有効な場合、キーバインディングと Vim モードは独立して動作します。

• Vim モード はテキスト入力レベルで入力を処理します（カーソル移動、モード、モーション）
• キーバインディング はコンポーネントレベルでアクションを処理します（todos を切り替え、送信など）
• Vim モードの Escape キーは INSERT から NORMAL モードに切り替わります。chat:cancel をトリガーしません
• ほとんどの Ctrl+key ショートカットは Vim モードを通過してキーバインディングシステムに渡されます
• Vim NORMAL モードでは、? はヘルプメニューを表示します（Vim の動作）

検証

Claude Code はキーバインディングを検証し、以下の警告を表示します。

• 解析エラー（無効な JSON または構造）
• 無効なコンテキスト名
• 予約済みショートカットの競合
• ターミナルマルチプレクサの競合
• 同じコンテキスト内の重複バインディング

/doctor を実行して、キーバインディングの警告を確認します。