キーボードショートカット

Claude Code の操作キーを一覧にし、~/.claude/keybindings.json で自分の好みに変える方法を説明します。入力欄の接頭辞（!・@・/）や Vim モードなど、入力の仕組みは対話モードの操作にあります。

• 既定のショートカットは、全般・テキスト編集・複数行入力・クイックコマンド・トランスクリプト・音声入力に分けて載せています
• /keybindings を実行すると、設定ファイルが作られて開きます
• 設定ファイルの変更は、再起動なしで自動的に反映されます
• 割り当ては「コンテキスト」ごとに書き、操作は chat:submit のような「アクション」で指します
• null を割り当てると、既定のキーを外せます

既定のショートカット#

全般#

権限モードは権限モード、モデルと fast mode はモデル・effort・fast modeを参照してください。

テキスト編集#

単語系のショートカット（Alt+B・Alt+F・Alt+D・Option+Delete・Ctrl+Backspace）は、英数字の連なりを1単語と数え、_・.・/ などの記号で区切ります。src/utils/foo.ts で Alt+B を繰り返すと、ts・foo・utils・src の頭で止まります。Ctrl+W は記号を無視して直前の空白まで消すので、1回で src/utils/foo.ts 全体が消えます。空白を置かない中国語や日本語でも、単語ごとに動きます。この挙動は v2.1.261 以降のもので、以前に有効化していた設定 keybindingFlavor は非推奨で効果がありません。これらのキーには設定ファイル側のアクションが無く、割り当て直せません。

テーマと表示#

複数行入力#

クイックコマンド#

トランスクリプトビューア#

Ctrl+O で開いているときに使えます。どちらのレンダラーが有効かは、引数なしの /tui で確かめます。Ctrl+E は transcript:toggleShowAll で割り当て直せます。

フルスクリーン表示の詳細はターミナル・表示・音声入力にあります。

音声入力#

設定ファイル#

~/.claude/keybindings.json は、bindings 配列を持つオブジェクトです。配列の要素は、コンテキストとキーとアクションの対応表の組です。

次の例は、Chat コンテキストで Ctrl+E を外部エディタの起動に割り当て、Ctrl+S を外します。

{
  "$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",
        "ctrl+s": null
      }
    }
  ]
}

コンテキスト#

割り当てのブロックごとに、効く場面を context で指定します。

v2.1.205 より前には、/doctor の診断画面向けの Doctor コンテキストと doctor:fix アクションがありました。

アクション#

アクションは chat:submit（メッセージ送信）や app:toggleTodos（タスクリストの表示）のように 名前空間:動作 の形です。使えるアクションはコンテキストごとに決まっています。

App（Global）#

History#

Chat#

*VT モードが無効な Windows（Node が 24.2.0 未満・22.17.0 未満、または Bun が 1.2.23 未満）では、既定が Meta+M になります。

Autocomplete#

Confirmation#

ダイアログは、はい・いいえを聞く形でなくても confirm:yes と confirm:no で承認と取り消しを行います。y や n のような素の文字をこのコンテキストに割り当てると、その文字を表示していないダイアログにも効きます。y・n をキーとして表示するダイアログは、それらの文字を自分で読むので割り当てが要りません。多くのダイアログでは Ctrl+C か Ctrl+D を2回押すと、Claude Code を終了せずにダイアログだけが閉じます。この2つは予約済みで割り当て直せません。

次の例は、y を承認に、n を拒否に割り当てます。

{
  "bindings": [
    {
      "context": "Confirmation",
      "bindings": {
        "y": "confirm:yes",
        "n": "confirm:no"
      }
    }
  ]
}

この割り当てでも、後述のテキスト欄にフォーカスがある間は y と n は文字として入力できます。v2.1.280 より前は、y と n が既定でこの2つに割り当てられていました。それより前に /keybindings で作ったファイルにはその2行が書かれており、消すまで効き続けます。v2.1.257 より前には、Bash と PowerShell の権限プロンプトで、コマンドの説明をモデルに生成させて表示する confirm:toggleExplanation（既定は Ctrl+E）がありました。

Transcript#

HistorySearch#

next・accept・cancel・execute の既定は、従来のレンダラーのインライン検索に効きます（常にすべてのプロジェクトのプロンプトを検索します）。historySearch:cycleScope が効くのはフルスクリーン表示だけで、そこでは Ctrl+R が検索ダイアログを開き、Ctrl+S で範囲が切り替わります。ダイアログのほかのキーは固定です（Enter か Tab で候補を入力欄に入れ、Esc で取り消し）。

Task#

ThemePicker・Help#

Tabs#

タブ付きダイアログでは、タブの行にフォーカスがある間にタブが切り替わります。/help や /sandbox などでは、タブの中身の中からも切り替えられます。Up と Down でタブの行と中身の間をフォーカスが移り、中身のリストはフォーカスがある間だけキーに反応します。

Attachments#

Footer#

フッターの項目（プロンプトの下のエージェントパネルの行など）を選択している間は、Chat で Enter を chat:queueSubmit や chat:newline に割り当て直していても、Enter で項目が開きます。Footer が割り当てていないキー（chat:cycleMode の Shift+Tab など）の Chat の割り当ては、項目の選択中も効きます。

MessageSelector#

巻き戻しメニューのメッセージ一覧では、後述の Select アクションとその既定のキーでメッセージを移動して選びます。Select への割り当てもここに効きます。MessageSelector コンテキスト自体にアクションと既定のキーはありません。この一覧だけキーを変えたいときに使い、MessageSelector のブロックで select:accept などの Select アクションを割り当てます。

次の例は、巻き戻しメニューで強調中のメッセージを o で選べるようにします（ほかのリストは変わりません）。

{
  "bindings": [
    {
      "context": "MessageSelector",
      "bindings": {
        "o": "select:accept"
      }
    }
  ]
}

v2.1.283 より前は、この一覧は Select の割り当てを無視し、独自の messageSelector:up・messageSelector:down・messageSelector:top・messageSelector:bottom・messageSelector:select を持っていました。これらの名前を書いた keybindings.json は、同じ動作の Select アクションとして今も効きます。Home と End は一覧の両端へ移動します（v2.1.283 より前は Shift+K と Shift+J などが既定でした）。

DiffDialog（diff ビューア）#

ここのアクションが効くのは、Claude Code の従来の diff ビューアだけです。フルスクリーン表示でない /diff は、組み込みの cc-plugin-diff mod（/plugin で無効にできる）が有効なあいだ diff ダイアログを開きます。この従来のビューアが開くのは、mod を無効にしたあとだけです。これらのアクションを書いた keybindings.json は、どちらの場合もエラーなく読み込まれます。

ファイル一覧は Select アクションにも反応します。select:previous と select:next で前後のファイルへ移り、Enter は select:accept で選んだファイルの diff を開きます。一覧だけキーを変えるなら、DiffDialog のブロックに Select アクションを割り当てます。v2.1.283 より前は、一覧は Select の割り当てを無視し、Enter は別アクション diff:viewDetails でした。この名前を書いたファイルは、一覧で select:accept として効き続けます。

diff の詳細表示には、ページャ風のキーが標準のスクロールアクションに割り当てられています。これらは DiffDialog の一部で詳細表示だけに効き、Scroll コンテキストの既定は変わりません。

Diff パネル#

フルスクリーン表示で /diff が開く diff パネルのアクションです。app:cycleDiffBase はパネルが開いている間だけ有効な DiffPanel コンテキスト、ほかは Global です。

このパネルは、組み込みの cc-plugin-diff mod が描きます。mod が扱うのは app:cycleDiffBase・app:diffFileListUp・app:diffFileListDown です。app:toggleReplTab・app:toggleDiffNoiseFilter・app:toggleDiffPreSession が届くのは、/plugin で cc-plugin-diff を無効にしたときに /diff が開く従来のパネルだけです。

ModelPicker#

EffortSlider#

/effort を引数なしで実行すると開くスライダーのアクションです。スライダーの Enter と Escape は割り当て直せません。

Select#

/skills・/mcp・/tasks のようなリストパネルでは、select:pageUp・select:pageDown・select:first・select:last の割り当てが効きます。/model ピッカーなどそれ以外の多くのリストでは select:first と select:last の割り当てが効き、PageUp と PageDown は割り当てに関係なくページ送りになります。v2.1.280 より前は、それらのリストは Home・End と、select:first・select:last の割り当てを無視しました。v2.1.283 より前は、/mcp のツール一覧は割り当てに関係なく固定の PageUp・PageDown でページ送りしていました。

Plugin#

Settings#

Settings コンテキストでは、select:accept と confirm:no を設定画面向けの動作で使い回します。変更は1項目ごとにすぐ適用されるので、Escape は拒否ではなく、変更を保存したままパネルを閉じます。

Agents#

エージェントビュー（claude agents）で効く Agents コンテキストです。v2.1.257 以降。

エージェントビューを開いている間、Agents が割り当てているキーは Agents の割り当てが使われ、同じキーの Chat や Global の割り当ては無視されます。たとえば Ctrl+S は、既定の chat:stash ではなくグループ分けの切り替えになります。送信入力の外部エディタのキーは Agents のアクションではなく、Chat の chat:externalEditor（既定は Ctrl+G）に従います。エージェントビューでは1キーの割り当てだけが動くので、Ctrl+X Ctrl+E の連続キーはエディタを開きません。

Voice#

音声ディクテーションが有効なとき、Chat コンテキストで使えます。

Scroll#

フルスクリーン表示が有効なときの Scroll コンテキストです。

キーの書き方#

修飾キー#

修飾キーは + でつなぎます。

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    修飾キーを複数

キー名は大文字小文字を区別せず、K と k、ctrl+K と ctrl+k は同じ割り当てです。Shift と文字を組み合わせるなら shift+k と書きます。

英語配列以外のキーボード#

Ctrl のショートカットのキー名は、いま使っている配列がほかの文字を打つ場合でも、ラテン文字で書きます。

• キリル文字のような非ラテン配列では、端末が Kitty キーボードプロトコルを使いキーの位置を報告する場合に、US 配列での位置で Ctrl のショートカットが照合されます。ロシア語配列で Ctrl と物理的な W キーを押すと ctrl+w になります。位置を報告しない端末では、端末が送ったものがそのまま照合されます。ASCII の制御コードならラテン文字のショートカットが働き、キリル文字として届いたキー入力はどの割り当てにも一致しません
• AZERTY のようにラテン文字を並べ替えた配列では、そのキーが打つ文字で照合されます。Ctrl と「A」と書かれたキーを押すと ctrl+a になります

コード（連続キー）#

スペースで区切ったキーの並びがコード（chord）です。

ctrl+k ctrl+s   Ctrl+K を押して離し、続けて Ctrl+S

各キーは直前のキーから3秒以内に押します。超えると、コードは取り消され、短い通知が出ます。

特殊キー#

既定のキーを外す#

アクションに null を割り当てると、既定のショートカットを外せます。

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

コードでも同じです。同じプレフィックスを持つコードをすべて外すと、そのプレフィックスを1キーの割り当てに使えます。有効なコンテキストのどれかにコードが残っていれば、プレフィックスは予約されたままなので、コードを定義しているコンテキストごとに外します。

既定で ctrl+x をプレフィックスにしているコードは、コンテキストごとに次のとおりです。

• Chat：ctrl+x ctrl+k・ctrl+x ctrl+e・ctrl+x enter・ctrl+x ctrl+a・ctrl+x ctrl+s・ctrl+x tab
• Task：ctrl+x ctrl+b
• DiffPanel：ctrl+x b
• Pane：ctrl+x left・ctrl+x right・ctrl+x up・ctrl+x down・ctrl+x x
• PaneField：ctrl+x x

ctrl+x enter は v2.1.247 以降、ctrl+x b・ctrl+x ctrl+a・ctrl+x tab は v2.1.260 以降、ctrl+x ctrl+s は v2.1.275 以降が必要です。

ctrl+x 自体を1キーの割り当てに取り戻すには、これらをすべて外します。

{
  "bindings": [
    {
      "context": "Task",
      "bindings": {
        "ctrl+x ctrl+b": null
      }
    },
    {
      "context": "DiffPanel",
      "bindings": {
        "ctrl+x b": null
      }
    },
    {
      "context": "Pane",
      "bindings": {
        "ctrl+x left": null,
        "ctrl+x right": null,
        "ctrl+x up": null,
        "ctrl+x down": null,
        "ctrl+x x": null
      }
    },
    {
      "context": "PaneField",
      "bindings": {
        "ctrl+x x": null
      }
    },
    {
      "context": "Chat",
      "bindings": {
        "ctrl+x ctrl+k": null,
        "ctrl+x ctrl+e": null,
        "ctrl+x enter": null,
        "ctrl+x ctrl+a": null,
        "ctrl+x ctrl+s": null,
        "ctrl+x tab": null,
        "ctrl+x": "chat:newline"
      }
    }
  ]
}

プレフィックスのコードを一部だけ外した場合、残りの割り当てのために、プレフィックスを押すとコード待ちの状態に入ります。

割り当て直せないキー#

端末との衝突#

ターミナルマルチプレクサなどのショートカットとぶつかることがあります。

テキスト欄#

素の文字・数字・Space を割り当てても、ダイアログやパネルの中のテキスト欄では、その文字を入力できます。Claude が聞いてくる質問の「Other」の回答欄がその例です。欄にフォーカスがある間、Ctrl・Alt・Cmd なしで押した文字キーは欄に入り、割り当てとは照合されません。

次のキーは、欄にフォーカスがあっても割り当てが動きます。

• 文字を打たないキー（Enter・Escape・Tab・矢印キー）
• Ctrl・Alt・Cmd と一緒に押したキー
• すでに始まっているコードの2打目

メインのプロンプトでは、すべてのキーを Chat などの有効なコンテキストと照合し、どの割り当ても取らなかったキーだけが文字として入ります。

Vim モードとの関係#

/config の Editor mode で Vim モードを有効にしているとき、Vim モードとキー割り当ては別々に動きます。

• Vim モードは入力欄の中の動き（カーソル移動・モード・モーション）を扱い、キー割り当ては、ToDo の表示や送信のような部品レベルの動作を扱う
• Vim モードの Escape は INSERT から NORMAL への切り替えで、chat:cancel は呼ばない
• ほとんどの Ctrl キーのショートカットは Vim モードを通り抜けてキー割り当てへ届く
• Vim のキーは設定ファイルでは割り当て直せない。jj のような2キーの INSERT モードの並びを Escape にしたいときは、設定 vimInsertModeRemaps を使う（対話モードの操作を参照）
• NORMAL モードの ? は、Vim の挙動でヘルプメニューを出す
• NORMAL モードの / は、標準モードの Ctrl+R と同じく履歴検索を開く

検証#

Claude Code は、割り当てファイルを検証し、次の場合にデバッグログへ警告を書きます。

• 解析エラー（不正な JSON や構造）
• ctl+k のような、綴りの誤った修飾キー。分からない部分は捨てられ、残ったキー（この例では k）への割り当てとして適用される
• 不正なコンテキスト名
• 文字列でも null でもないアクション値などの不正な値
• 登録済みアクションの綴り違いなど、未知のアクション名。その割り当ては飛ばされ、そのキーの既定の割り当てが残る
• 予約済みのショートカットとの衝突
• 同じコンテキスト内の重複した割り当て

詳細を見るには、--debug を付けて Claude Code を起動します。