terminal-setupでShift+Enterが改行にならないときの対処
Claude Codeで改行できない、Shift+Enterが送信になるときの原因と直し方です。Ctrl+J、terminal-setup、tmux、Windows Terminalの違いを扱います。
Shift+Enterが送信になるときは、使っているターミナルで手が変わる
Claude CodeではEnterを押すとメッセージが送信されます。改行したいときはCtrl+J、または \ を入力してからEnterを押します。この2つはどのターミナルでも設定なしで動きます。macOSで別の手を探すなら、OptionキーをMetaキーとして扱う設定をしたうえでOption+Enterも使えます。
Shift+Enterによる改行は追加の選択肢で、効くかどうかはターミナルごとに分かれます。まずClaude Codeのバージョンを確かめます。表の「kitty keyboardプロトコル対応」の行は、v2.1.269以降が条件だからです。
claude --version出力は 2.1.287 (Claude Code) の形で、先頭の数字がバージョンです。
Shift+Enterが効かないときの確認順
- 1
バージョンを確かめる
claude --versionの数字が2.1.269より前なら、kitty keyboardプロトコル対応端末でも設定が要ります。更新してから次へ進みます。 - 2
tmuxの中で動かしていないか見る
tmuxの中では、外側のターミナルが対応していてもShift+Enterは送信になります。
~/.tmux.confの追記が必要です(後述)。 - 3
下の表で自分のターミナルの行を引く
「設定不要」ならそのまま使えます。「
/terminal-setupが必要」の行なら、次のステップへ進みます。 - 4
ホストターミナルで /terminal-setup を実行する
tmuxやscreenの外で直接実行します。「対応なし」の行ならこの手順は使えないため、Ctrl+Jか
\+Enterで改行します。
ターミナルごとの対応状況
Windows Terminal、iTerm2、Ghosttyなどは設定なしで動き、VS CodeやCursorは一度 /terminal-setup が要ります。一覧は次のとおりです。
対応状況は4つのグループに分かれます。
| グループ | 該当ターミナル | 対応方法 |
|---|---|---|
| 設定不要で動く | 該当ターミナルGhostty、Kitty、iTerm2、WezTerm、Warp、Apple Terminal、Windows Terminal | 対応方法そのまま使える |
| kitty keyboardプロトコル対応 | 該当ターミナルfootやAlacritty 0.16以降 | 対応方法v2.1.269以降なら設定不要 |
/terminal-setupが必要 | 該当ターミナルVS Code、Cursor、Devin Desktop、0.16より前のAlacritty、Zed | 対応方法一度コマンドを実行する |
| 対応なし | 該当ターミナルgnome-terminal、PyCharmやAndroid StudioなどのJetBrains系IDE | 対応方法Ctrl+Jか\+Enterを使う |
Windows Terminalは設定不要の側です。それでも送信になるときは、claude --version で2.1.89以降か確かめます。v2.1.89より前のWindows Terminal Preview 1.25では、Shift+Enterが送信される不具合がありました。
WezTermでは /terminal-setup とは別に、kitty keyboardプロトコル起因で記号やShift付き英字の入力が崩れる不具合が報告されています。詳しくはClaude CodeでWezTermの記号が入力できないときの対処法にまとめています。Alacrittyで設定ファイルの場所が食い違うときはClaude CodeのAlacritty設定がterminal-setupで食い違うときの直し方が参考になります。
実行手順と確認メッセージ
/terminal-setupこのコマンドがShift+Enterのキーバインドを、使っているターミナルまたはエディタの設定ファイルへ書き込みます。初回実行時は Installed VSCode terminal Shift+Enter key binding のような確認メッセージが表示されます。すでに設定済みの場合は VSCode terminal Shift+Enter key binding already configured と出て、既存の設定は上書きされません。
注意点が1つあります。tmuxやscreenの中ではなく、ホストターミナルで直接実行する必要があります。
VS Code系エディタで一緒に変わる2つの設定
VS Code、Cursor、Devin Desktopで /terminal-setup を実行すると、キーバインドのほかにエディタ設定も2つ変わります。
terminal.integrated.gpuAccelerationを"off"に設定(統合ターミナルの文字化け対策)terminal.integrated.mouseWheelScrollSensitivityを調整(フルスクリーン表示時のスクロールを滑らかにする)
この2つは /terminal-setup の機能として後から加わったもので、スクロール感度はv2.1.116、GPUアクセラレーションはv2.1.157からです。claude --version がそれより古いと、キーバインド以外は変わりません。
GPUアクセラレーションの変更を元に戻したい場合は、設定を "auto" に戻してからウィンドウを再読み込みします。
Zedではkeymap.jsonを書き換える
Zedでの /terminal-setup は、keymap.json にShift+Enterのバインドを書き足します。ファイルを丸ごと上書きする動きではありません。v2.1.247より前には、keymap全体を上書きしてしまう不具合がありました。
Zedで /terminal-setup を実行したときの2つの結果
書き足せた場合
keymapに既にバインドがあり、その中にTerminalの shift-enter が無い場合です。元のファイルと同じ場所に keymap.json.1a2b3c4d.bak のような名前でバックアップを作ります。そのうえで、ほかのキーバインドとコメントを残したままShift+Enterのバインドを統合します。
書き足せなかった場合
読み込み・構文解析・バックアップ・統合結果の検証のいずれかに失敗すると、ファイルには触れません。代わりにkeymapのパスと、追記するブロックを画面に表示します。
追記を求められたときのブロックは次の形です。パスは画面に出たkeymap.jsonのものに合わせます。
{ "context": "Terminal", "bindings": { "shift-enter": ["terminal::SendText", "\u001b\r"] } }このブロックは、keymapの一番外側の配列に加えます。メッセージの1行目が原因を示します。
| メッセージ | 原因 |
|---|---|
Couldn't read your Zed keymap | 原因ファイルの権限などで読み込めない |
Your Zed keymap isn't a readable list of keybindings | 原因配列として解釈できない(// コメントと末尾カンマは許容) |
Couldn't back up your Zed keymap; not modifying it. | 原因.bak のバックアップを作れなかったため、何も変更していない |
Couldn't update your Zed keymap | 原因統合結果が有効なkeymapとして検証できなかった。キーの重複が原因になりうる |
Your Zed keymap isn't a readable list of keybindings が出たときは、構文エラーを直すか最上位を配列にします。そのあと、もう一度 /terminal-setup を実行します。
tmuxでShift+Enterが改行にならないときの設定
tmuxの中でClaude Codeを動かしている場合、外側のターミナルがShift+Enterに対応していても、既定ではShift+Enterが送信になります。通知やプログレスバーも外側のターミナルまで届きません。~/.tmux.conf に以下を追記し、tmux source-file ~/.tmux.conf で動作中のサーバーに反映します。
set -g allow-passthrough on
set -s extended-keys on
set -as terminal-features 'xterm*:extkeys'extended-keys の2行が、Shift+Enterと通常のEnterをtmuxが区別するための設定です。allow-passthrough は通知とプログレスバーを外側へ通す設定で、Shift+Enterとは別の問題を解きます。
tmuxやsshのセッションへ再接続したあとにShift+Enterが効かなくなる不具合は、エージェントビューの中ではv2.1.267で直っています。
Apple TerminalとiTerm2の自動設定
macOSのApple Terminalでは、意識しないところで /terminal-setup が動いていることがあります。Claude Code初回起動時のセットアッププロンプトを承諾すると、このコマンドが実行されます。
実行で変わるのは2つです。1つはOptionキーをMetaキーとして扱う設定で、Option+Enterでの改行やOption+Pでのモデル切り替えに必要です。もう1つは、ターミナルの可聴ベルを無音にする設定です。
スクリーンリーダーモードでは、ベルの設定は変更されません。v2.1.211より前は、このモードでもベルが無音になりました。過去にベルが鳴らなくなった心当たりがあれば、Settings → Profiles → Advancedの「Audible bell」から戻せます。
iTerm2では、クリップボードへのアクセスを許可する設定を有効にします。設定箇所はSettings → General → Selectionの「Applications in terminal may access clipboard」です。これで /copy がシステムのクリップボードに書き込めるようになります。
iTerm2の検出はtmuxの中から実行しても働きますが、反映にはiTerm2の再起動が必要です。Optionキー側の設定(Esc+への切り替え)や通知センターへの転送まで含めた手順はClaude CodeでiTerm2のOption keyとクリップボードを有効化するにまとめています。
gnome-terminalではShift+Enterを使えない
UbuntuやFedoraの標準ターミナルであるgnome-terminalは、ターミナルごとの対応表で「対応なし」の行に入っています。/terminal-setupが書き込める設定ファイルの対象にも入っていないため、Shift+Enterは改行になりません。表の行をたどって設定を探しても、設定の手段そのものがありません。
使える手は、どのターミナルでも設定なしで動く2つです。
- Ctrl+Jを押す
\を入力してからEnterを押す
gnome-terminalを対象に加えてほしいという要望は、issue #8034に出ています。issueによると、gnome-terminalで/terminal-setupを実行すると「Terminal setup cannot be run from gnome-terminal.」と表示されて止まります。UbuntuやFedoraのGNOME環境の利用者から反応が続いていて、issueはopenのままです。Enterを改行に割り当て直す方法は、次の節で触れます。
それでも直らないときの代替策
/terminal-setup を実行しても改善しない場合に試せる手があります。
- Ctrl+Jか
\+Enterで代用する: 冒頭のとおり、ターミナルを選びません - EnterとShift+Enterの役割を入れ替える:
chat:newlineとchat:submitをkeybindingsファイルで割り当て直します。Enterで改行、Shift+Enterで送信にもできます - Vimモードを使っている場合: INSERTモードのEnterは標準のVimと違って送信のままです。NORMALモードで
oかOを使うか、Ctrl+Jで改行します。v2.1.283では、Vimモードの.がShift+Enterで入れた改行を落とす不具合も直りました
Shift+Enter対応が広がってきた経緯
/terminal-setup と周辺の対応は、次のように段階的に広がってきました。
Shift+Enter関連の主な変更
- v2.0.74Kitty・Alacritty・Zed・Warpに対応
/terminal-setupの対象ターミナルが増えました。 - v2.1.0iTerm2・WezTerm・Ghostty・Kittyは設定不要に
ターミナル側の設定ファイルを変更しなくても、Shift+Enterが動くようになりました。
- v2.1.47Warpの誤った設定案内を修正
WarpはShift+Enterをネイティブに扱えるのに、設定を促されてしまう不具合が直りました。
- v2.1.89Windows Terminal Preview 1.25の送信問題を修正
このプレビュー版でShift+Enterが改行にならず送信されていた不具合が直りました。
- v2.1.116VS Code系のスクロール感度を設定
Cursor・Windsurfを含む統合ターミナルで、フルスクリーン表示のスクロールを滑らかにするため、
/terminal-setupがスクロール感度を調整するようになりました。 - v2.1.121iTerm2のクリップボード許可を自動化
/copyが使えるように、設定を有効にする処理が入りました。 - v2.1.132Windows Terminalの誤案内を修正
ネイティブ対応済みなのに、矛盾したエラーが表示される不具合が直りました。
- v2.1.157VS Code系でGPUアクセラレーションを無効化
/terminal-setupが統合ターミナルのGPUアクセラレーションを切り、文字化けを防ぐ設定が加わりました。 - v2.1.162WindsurfがDevin Desktopに表記変更
/ideメニューや/terminal-setup、/scroll-speedの表記が、エディタの改称に合わせて変わりました。 - v2.1.247Zedのkeymapを上書きする不具合を修正
keymap全体ではなく、Shift+Enterのバインドだけを統合する動きになりました。
- v2.1.269kitty keyboardプロトコル対応端末で設定不要に
footやAlacritty 0.16以降がShift+Enterをそのまま使えるようになりました。
エディタやマシンを替えたときの再設定
設定はそのエディタの設定ファイルに書かれるので、別のエディタや別のマシンでShift+Enterを使うときは、その環境でも /terminal-setup を実行します。
まとめ
Shift+Enterが効かない原因は、ターミナルの種類、Claude Codeのバージョン、tmuxの3つに絞れます。手元の環境がどれに当たるか分からないうちは、Ctrl+Jで改行しながら表の行を引くのが手早い進め方です。
キーボード操作全般をカスタマイズしたい場合はClaude Codeショートカット一覧を参考にしてください。通知音や完了アラートを整えたい場合はClaude Code Hooks完全ガイドが役立ちます。VS Code拡張全体の使い方はClaude Code VS Code拡張機能の使い方にまとめています。
参照した一次ソース
この記事の記述は、次の一次ソースと照合しています。更新時に参照先が変わった場合は一覧も更新します。