Claude CodeがIntelliJでEscが効かないときの原因と回避策
IntelliJ系IDEのターミナルでClaude Codeを動かすと、Escで応答を止められずCtrl+Cで終了するしかなくなる症状があります。公式の設定手順と、issueで報告された回避策の効き方を比べます。
IntelliJ IDEAのターミナルでClaude Codeを動かしているとき、Escを押しても応答が止まらず、Ctrl+Cでセッションごと終了するしかなくなる症状があります。Claude Code側のバグというより、IDEが先にEscを取っている可能性が高い症状です。
この症状は公式リポジトリのissue #10618で報告されています。ラベルはbug、has repro、platform:macos、area:ide、area:tui、staleで、修正済みの記録はありません。報告者の環境はmacOS、Claude Code 2.0.29です。
先に対処の骨子を挙げます。
- IDEの設定で「Move focus to the editor with Escape」を外す
- 「Configure terminal keybindings」で「Switch focus to Editor」のショートカットを削除する(issueでは、こちらで直ったという報告が複数ある)
- 当座の逃げ道として
Ctrl+[かCtrl+Escを使う(issueのコメントによる報告) - ターミナルエンジンを「Reworked 2025」に切り替える方法は、効かなかった報告があり当てにならない
どんな症状か — Escが効かないとは何が起きているのか
Claude Codeでは、Escは「応答やツール呼び出しを途中で止める」キーです。公式のキーボードショートカット表では、止めた時点までの作業は残り、キューに積んだメッセージがあれば次に送られると説明されています。Escを2回押すと、入力欄に文字があれば消去、空なら巻き戻しメニューが開きます。
つまりEscが効かないと、次の3つが一度に失われます。
- 暴走した応答や長いツール実行を途中で止める操作
- 権限確認ダイアログで「拒否」を返す操作(Escは
Noと同じ扱い) - 入力欄の下書き消去と、巻き戻しメニューの呼び出し
issue本文の報告者は「特定のコマンドから抜け出せず、CTRL+Cでセッションごと終了するしかない」と書いています。Ctrl+Cは実行中の処理を中断するキーですが、何も動いていないときは2回目で終了します。作業中の会話を捨てずにEscだけ使いたいのに、それができないのが痛い点です。
起動経路で変わるのか — プラグインのボタンと直接起動
issue本文は、IntelliJのプラグインからClaude Codeを起動するとEscが効かず、IntelliJのターミナルでclaudeを直接実行すると正常に動く、と報告しています。ここは読み方に注意が要ります。
公式のJetBrains連携ページでは、プラグインは「IDEの統合ターミナルでclaudeコマンドを実行して接続する」仕組みだと説明されています。プラグインが独自のCLIを同梱するわけではありません。起動経路が違っても、最終的に動いているのは統合ターミナル上の同じclaudeプロセスです。
そのため、起動経路の違いそのものが原因とは言い切れません。コメントを読むと、経路ではなくIDE側のキー割り当てが原因と見たほうが整合します。
- 別の報告者はdevcontainerの中でClaude Codeを動かしていて、同じ症状に当たった
- 公式のJetBrains連携ページには、Escが効かないときのキー設定の手順が独立した節として載っている
issue本文の「直接起動なら動く」は、その報告者の環境での観察です。ほかの環境で同じ切り分けが成り立つかは、issueからは分かりません。
原因として疑う設定は2つ
IntelliJのターミナルは、Escを押すとフォーカスをエディタに戻すことがあります。このとき、キー入力はClaude Codeに届く前にIDEに消費されます。公式ページが挙げる設定は次の2つです。
| 設定 | 場所 | 公式の指示 |
|---|---|---|
| Move focus to the editor with Escape | 場所Settings → Tools → Terminal | 公式の指示チェックを外す |
| Switch focus to Editor | 場所同じ画面の「Configure terminal keybindings」 | 公式の指示ショートカットを削除する |
公式の手順は、どちらか一方を実施して変更を適用する、というものです。
設定を直す手順
IDEのメニューは次の順に開きます。
- Settings → Tools → Terminalを開く
- 「Move focus to the editor with Escape」のチェックを外す
- それでも直らなければ「Configure terminal keybindings」を開き、「Switch focus to Editor」に割り当てられたショートカットを削除する
- 変更を適用する
注意点が1つあります。issueの最初のコメントに、「Move focus to the editor with Escape」を外しても直らなかったという報告があります。ほかにも同じ報告が2件あります。チェックが最初から外れていた環境で、次のキーバインド削除によって直ったという報告もあります。チェックを外すだけでは足りない環境がある、ということです。
その場合に効いたと報告されたのが、キーバインド側の削除です。IntelliJ IDEA 2025.3(Ubuntu 25.04)で「Switch focus to Editor」を削除したら直った、というコメントがあります。別のコメントはスクリーンショットを添えて、ターミナルのキーマップに割り当てられたキーをすべて削除する方法を示しています。
表示される割り当ての名前はIDEのバージョンによって違うことがあります。
ターミナルエンジンを替えても直らない
コメントには、ターミナルエンジンを「Classic」から「Reworked 2025」に切り替えると直ったという報告もありました。ただし、同じ人が後で「やはり問題が残る」と訂正しています。別の人も、Reworked 2025を使っていてもEscが効かないと報告しています。
このため、エンジンの切り替えは対処として当てにならない、と考えるのが安全です。上の2つの設定を先に疑うのが筋です。
設定で直らないとき — Ctrl+[ とCtrl+Esc
どうしても直らない環境では、Esc以外のキーで同じ操作を代替できます。
Ctrl+[は、端末の制御文字としてEscと同じ信号になります。公式のキーバインド一覧は、Ctrl+[を「Claude Codeが常にEscapeとして受け取る」予約済みのショートカットとして載せています。Kittyキーボードプロトコルを使う端末では、v2.1.242以降が必要です。IntelliJの組み込みターミナルがその対象かは公式ページに記載がありません。
issueでは、devcontainer内で使っている報告者がCtrl-[とCtrl-Escを回避策に挙げ、別の人もCtrl-[とCtrl-Escのほうが安定して効くと書いています。Ctrl+EscはJetBrainsプラグインのクイック起動キー(Windows/Linux)でもあるため、役割が重なる環境では、期待と違う動きをする可能性があります。使うなら、まずCtrl+[を試す順が安全です。
切り分けの手順
原因が設定なのか別物なのかを、短い手順で切り分けます。
claude --version最初にバージョンを確かめます。報告は2.0.29ですが、後のコメントはより新しい環境でも再現しています。バージョンを上げるだけでは直らない前提で進めます。
次に、Claude Codeを動かした状態で、応答が流れている最中にEscを押します。止まらなければ、Ctrl+[を押します。Ctrl+[で止まるなら、Claude Codeはキーを正しく扱えていて、IDE側がEscを取っています。この場合はIDE側のキー設定を疑い、前の節の削除を試します。
Ctrl+[でも止まらない場合は、このissueの症状とは別の問題を疑います。端末の表示や入力まわりの切り分けには、JetBrainsの中クリック貼り付けが二重になる件やPyCharmでの表示崩れも、同じJetBrains統合ターミナル固有の挙動として参考になります。
設定したあとの確認
設定を変えたら、次の順で確かめます。
- IDEのターミナルタブを開き直す
claudeを起動し、長めの応答を依頼する- 応答の途中でEscを押し、止まることを確認する
- 止まったあと、Escを2回押して巻き戻しメニューが開くことも確認する
issueのコメントは、設定変更の反映に再起動が必要かどうかには触れていません。反映されないと感じたら、IDEそのものを再起動してから試す選択肢があります。
この症状はまだ解消されていない
issueのラベルにはstaleが付き、自動ボットが「30日間更新がない」と通知したあとも、2026-01-30までコメントが続いていました。最後のコメントはキーマップの掃除方法でした。修正バージョンはissueに書かれていません。
JetBrains側のターミナルの仕様に由来する部分が大きいため、Claude Code側が更新されても症状が残る環境があります。報告の経緯を見る限り、設定を直すか、Ctrl+[で逃げるかのどちらかが現実的な運用です。
JetBrains全般の導入手順と、プラグインがターミナルに接続する仕組みはClaude Code JetBrainsプラグインの導入と設定にまとめています。devcontainerで連携が効かない場合はdevcontainerでJetBrains連携が効かないときも参照できます。
よくある質問
Escが効かないとき、作業内容は失われますか
Ctrl+Cで終了すると、実行中だった処理は中断されます。まずはCtrl+[で止められないか試すと、セッションを残したまま対処できます。
設定を変えるとIDE側のEsc操作は使えなくなりますか
「Move focus to the editor with Escape」を外すと、ターミナルからEscでエディタへ戻る操作が使えなくなります。エディタへ戻りたいときは、別のショートカットかマウスで切り替えます。