Claude CodeのCtrl+Gでエディタを開く方法と開かないときの確認点

Claude Codeの入力欄でCtrl+G(別名Ctrl+X Ctrl+E)を押すと、入力中のプロンプトが手元の外部エディタで開きます。保存して閉じれば、内容が入力欄に戻ります。開くのは「システムに設定されたテキストエディタ」で、シェルの$EDITOR/$VISUALと同じ仕組みで決まると考えられます。エディタが開かないときの確認点は後半の節にあります。

Ctrl+Gは「システムに設定されたテキストエディタ」を開く

Ctrl+G(またはreadline由来の別名Ctrl+X Ctrl+E)は、Claude Codeのショートカット表で「Open in default text editor」と説明されています。環境変数名が出てくるのは、トランスクリプト画面のv(会話を一時ファイルに書き出して$VISUALまたは$EDITORで開く。フルスクリーン表示が前提)の行です。claude agentsの「v to open in editor」がデーモンの既定エディタを使っていた不具合も、シェルの$EDITOR/$VISUALに従うよう修正されています。v2.0.10でCtrl+Gが加わったときの説明は「your system's configured text editor」で、Ctrl+Gも$VISUAL/$EDITORと同じ仕組みで動くと考えられます。

$VISUALと$EDITORはUnix系シェルで古くから使われてきた環境変数です。画面全体を使うエディタを$VISUALに、行指向の軽いエディタを$EDITORに分ける慣習がありますが、今のターミナルエディタはほとんどが画面全体を使います。両方に同じ値を入れておけば混乱しません。今どちらが設定されているかはシェルで確認できます。

echo "$EDITOR"
echo "$VISUAL"

未設定なら、起動ファイルに1行足して恒久的に設定します。

export EDITOR="vim"
export VISUAL="vim"

GUIエディタは、保存してプロセスが終了するまで呼び出し元を待たせる起動オプション付きで登録するのが一般的な運用です(VS Codeならcode --wait)。v2.1.216では、/memory・/plan・/keybindings・Ctrl+GでGUIエディタを開いている間のマウス・フォーカスの乱れが修正されました。ターミナル系だけでなくGUIエディタも想定された機能です。

Ctrl+X Ctrl+Eという組み合わせ自体は目新しいものではありません。GNU readlineがedit-and-execute-commandという名前で割り当ててきたキーで、bashの行編集でも入力中のコマンドラインを外部エディタで書き直すのに使われています。Claude Codeはv2.1.83でこれをそのまま別名として追加しました。readlineに慣れた手は、キー割り当てを覚え直さずに済みます。

前回の返信を外部エディタに表示する設定(Show last response in external editor)

/configのShow last response in external editorをオンにすると、Ctrl+Gで開くエディタの先頭にClaudeの直前の返信が#コメントとして入ります。この設定はv2.1.110で追加されました。

# ─── Claude's last response (for reference; removed on save) ───
# I added the retry loop to fetchUser in src/api.ts and a test
# for the timeout case. Want me to wire the same retry into
# fetchOrders?
# ─── Write your reply below this line ──────────────────────────
 
Yes, and cap it at three attempts.

返信が長いときは、末尾の50行だけが入り、切り詰めた箇所は# … (earlier output truncated)で示されます。長い返信の冒頭を見返したい場面では、エディタ側ではなく画面のトランスクリプトを開くことになります。

設定キーはexternalEditorContextで、既定値はfalseです。~/.claude.jsonに直接書いても有効になります。

{
  "externalEditorContext": true
}

このキーは~/.claude.jsonの「Global config」のスコープで、settings.jsonに書いても無視されます。プロジェクトごとの.claude/settings.jsonでは切り替えられず、/configから切り替えればどのプロジェクトでも同じ挙動になります。

入力欄のスペルチェックとの関係

Claude Codeの入力欄には、入力中の単語に下線を引くスペルチェックがあります。チェック対象は入力ボックスの中のテキストだけで、シェルモード・Ctrl+Rの履歴検索・音声入力中は何もチェックしません。Ctrl+Gで外部エディタに移ったあとの本文は入力ボックスの外にあるので、校正はエディタ側の機能に任せることになります。この機能は既定でオフで、aspell・hunspell・ispellのいずれかがPATHに必要です。設定方法はClaude Code v2.1.235 — プロンプト入力のスペルチェック追加を含む19項目の更新にまとめています。

入力欄以外でもCtrl+Gは使える

Ctrl+Gが効くのはメインのChat入力欄だけではありません。場面によって対応に差があります。

AskUserQuestionの「その他」欄は、用意された選択肢のどれにも当てはまらないときに自由記述で答える入力欄です。公式ドキュメントはこれを「custom response」と呼び、Ctrl+Gの説明でも「プロンプトまたはcustom responseを編集する」と書いています。長い前提条件や複数行の反例を添えて答えたいときに、1行入力より書きやすくなります。

キー割り当ての変え方とつまずきやすい点

Ctrl+Gの実体はchat:externalEditorというアクション名で、~/.claude/keybindings.jsonから任意のキーに変更できます。次の例は、Ctrl+E(既定は行末へ移動)に割り当て直し、Ctrl+S(既定はchat:stash)を解除する設定です。

{
  "$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
      }
    }
  ]
}

既定ではCtrl+GとCtrl+X Ctrl+Eの両方がchat:externalEditorにバインドされています。片方だけ残して使い分けたい場合も、それぞれ個別にnullで解除します。設定ファイルへの変更はClaude Codeの再起動なしに自動で検知・反映されるため、保存してすぐに新しいキーで試せます。

つまずきやすい点は次の3つです。

• agent viewではCtrl+X Ctrl+Eが効かない: agent viewのキー入力は単一キーストロークが前提で、2打鍵の組み合わせは発火しません。バックグラウンドセッションの管理画面ではCtrl+Gだけを使います
• agent viewのリマップはChat側の設定に従う: dispatch入力の外部エディタ操作はAgentsコンテキストのアクションではありません。Chatコンテキストのchat:externalEditorに割り当てたキーが、そのままagent viewでも効きます
• Ctrl+Xから始まる組み合わせはプレフィックスを共有する: Ctrl+X Ctrl+Eのほかに、ChatコンテキストだけでもCtrl+X Ctrl+K(バックグラウンドサブエージェントの全停止)やCtrl+X Enterなどが同じCtrl+Xで始まります。Ctrl+Xを単独のキーとして別のアクションに使いたいときは、すべての組み合わせを解除する必要があります

Ctrl+Gまわりの追加と修正の経過

初出から現在までのあいだに、機能の追加と不具合修正が積み重なっています。

使っているエディタや端末で乱れが出たときは、まずClaude Codeのバージョンを見ると原因を切り分けやすくなります。

Ctrl+Gでエディタが開かないときの確認点

起動に失敗したときは、v2.1.6以降ならエラーが画面に出ます。出たメッセージとあわせて、次の順に見ていくと原因を絞れます。

1. $EDITORと$VISUALの値: Ctrl+Gのエディタは環境変数で決まると考えられるため、まず冒頭の節のコマンドで中身を確認します。空ならexportで設定します。設定したシェルとClaude Codeを起動したシェルが同じかも見ておきます
2. GUIエディタの起動オプション: code --waitのように、閉じるまで待つオプションを付けて登録しているかを確かめます
3. Claude Codeのバージョン: 上のタイムラインのとおり、claude agentsで/dev/ttyを開くエディタが失敗する不具合はv2.1.251、agent viewでのリマップ無視はv2.1.257で直っています。古い版なら更新で解消する可能性があります
4. キー割り当て: keybindings.jsonでCtrl+Gをnullにしていないか、別のアクションへ割り当て直していないかを確かめます

使い分けの目安

Ctrl+Gが生きるのは、数十行にわたる指示や複数のコードスニペットを組み合わせるとき、直前の返信を読み返しながら訂正を書くとき(externalEditorContextと組み合わせる)、AskUserQuestionの「その他」欄に選択肢で表せない条件を書くときです。一言二言の指示では、エディタの起動が遠回りになります。

Ctrl+Gと同じ入力まわりの操作には、過去のプロンプトを呼び戻すCtrl+Rがあります。使い方の違いはCtrl+R履歴検索でClaude Codeの過去プロンプトを再利用するにまとめてあります。keybindings.jsonのコンテキスト一覧や表記ルールを俯瞰したい場合は、Claude Codeショートカット一覧 — 既定操作とkeybindings.jsonでのカスタマイズが早見表になっています。