Claude Code ターミナルセットアップガイド
iTerm2、WezTerm、Ghostty、Kitty などのターミナルでテーマを合わせ、Shift+Enter を有効にし、通知を設定し、長い貼り付けの切り詰めを修正し、vim モードをオンにする方法。
設定をやめて、構築を始めよう。
AIオーケストレーション付きSaaSビルダーテンプレート。
ターミナルの設定が、Claude Code で実際にどれだけ時間を節約できるかを左右します。デフォルト設定でも動作はします。ただし、多くの可能性が眠ったままになります。改行の処理が悪ければ、一行のプロンプト入力に縛られます。通知がなければ、Claude が待っている間に冷めたコーヒーを取りに行ってしまいます。200 行のスニペットを貼り付けて半分しか返ってこない経験があるなら、その問題はすでにご存知でしょう。
以下は手を入れる価値のあるすべての設定です。テーマの合わせ方、複数行入力、アラート、長い貼り付けの扱い方、vim モード、そして実際の開発者が使うターミナルごとの注意点を紹介します。
テーマの合わせ方
ターミナルは独自の色設定を持っています。Claude Code はそれを変更しませんし、変更しようともしません。できることは、ターミナルが使用しているカラースキームに合わせて内部パレットを調整することです。
Claude Code 内で /config を実行し、テーマオプションを選択します。シンタックスハイライト、ステータスマーカー、UI の装飾がライトまたはダークの背景に合わせてきれいに表示されます。
同じ /config の操作で、カスタムステータスラインも設定できます。このバーはターミナルの下部に表示され、手元に置いておきたいコンテキストを表示します。モデル、作業ディレクトリ、git ブランチなど。確認のための追加コマンドは不要です。
一つ注意点があります。日中にライトとダークを切り替える場合、切り替えるたびに /config を再実行してください。テーマの変更は自動では反映されません。
複数行入力の方法
一行のプロンプトでは制限があります。詳細のある内容、コード、複数ステップの質問は、複数行に分けた方が読みやすくなります。Claude Code 内で実現する方法が 4 つあります。
方法 1: バックスラッシュ + Enter (どこでも動作)
\ を入力してから Enter を押します。これで新しい行に移動します。すべてのオペレーティングシステムのすべてのターミナルでこれが機能するため、何も設定されていない場合のフォールバックとして使えます。
見た目はぎこちなく感じますが、確実に動作します。SSH でサーバーに接続している場合や、コントロールできないターミナルで作業している場合に頼りになります。
方法 2: Shift+Enter (ネイティブサポート)
4 つのターミナルは設定なしで Shift+Enter に対応しています。
- iTerm2
- WezTerm
- Ghostty
- Kitty
これらのいずれかを使っていれば、キーの組み合わせはすでに機能しています。有効にするものは何もありません。チャットウィンドウやテキストエディタでも同様の動作をするため、4 つの方法の中で最も自然に感じられます。
方法 3: /terminal-setup (自動設定)
ターミナルが Shift+Enter を認識しない場合、Claude Code が代わりに設定できます。Claude Code 内で /terminal-setup と入力すると、バインディングが自動的に設定されます。
このコマンドが対応するターミナル:
- VS Code 統合ターミナル
- Alacritty
- Zed
- Warp
知っておくべきこと: ネイティブサポートのあるターミナル (iTerm2、WezTerm、Ghostty、Kitty) を使用している場合、/terminal-setup コマンドはまったく表示されません。設定が必要なときだけ表示されます。
/terminal-setup が完了したらターミナルを再起動してください。バインディングは次回の起動時に有効になります。
方法 4: Option+Enter (Mac)
macOS では Option+Enter も改行キーとして使用できます。有効にするのは一度限りの調整ですが、どのメニューを変更するかは使用するターミナルによって異なります。
Mac の Terminal.app の場合:
- 設定を開き、プロファイル、キーボードの順に進む
- 「Option キーをメタキーとして使用」にチェックを入れる
iTerm2 と VS Code ターミナルの場合:
- 設定を開き、プロファイル、キーの順に進む
- 一般の下で、左右の Option キーを「Esc+」に設定する
Option+Enter は Option キーがすでにショートカットの癖に組み込まれている場合に最も効果的です。利点は Shift がテキスト選択のために解放されることです。
通知
Claude Code の重いタスクは数分かかることがあります。アラートがなければ、画面を見つめ続けるか、離れて戻り忘れるかのどちらかです。適切な通知はどちらの問題も解消します。
iTerm2 システム通知
iTerm2 は長時間実行タスク用の macOS ネイティブバナーを内蔵しています。
- iTerm2 の環境設定を開く
- プロファイル、ターミナルの順に進む
- 「ベルをミュート」を有効にする
- 「フィルターアラート」の下で「エスケープシーケンスで生成されたアラートを送信」を有効にする
- 希望の通知遅延を設定する
これを設定すると、Claude が遅いジョブを完了するたびに macOS のバナーが表示されます。iTerm2 が最小化されている場合や他のアプリに切り替えた場合でもアラートは発火します。
注意点: このパスは iTerm2 専用です。標準の macOS Terminal.app ではこの機能は利用できません。
カスタム通知フック
より高度なアラートロジックには、Claude Code のカスタム通知フックを使用します。特定のイベントで実行される独自のコードパスを記述できます。Slack への投稿、チャイムの鳴動、ウェブフックの発火などが可能です。
フックは Claude Code のより広いフックシステム内に存在します。タスクの完了時、エラー時、または任意の出力パターンで発火するように設定できます。
大きな入力の扱い方
長いコードブロックや巨大な仕様書を Claude Code に直接貼り付けると結果は良くありません。ほとんどのターミナルの貼り付けバッファには上限があり、それを超えるとテキストが切り詰められた状態になります。
重い入力のための 3 つのルール:
1. 直接貼り付けない。 100 行を超えたら、先にファイルに保存してください。そのファイルを Claude Code に指定して読み込むよう指示します。
2. VS Code のターミナルに注意。 VS Code 内の統合ターミナルは、ほとんどのターミナルよりも積極的に長い貼り付けを切り詰めます。VS Code が主な作業場所なら、ファイルルートは任意ではありません。短いプロンプト以上のものを通す唯一の方法です。
3. 質問を分割する。 仕様書全体を一度に渡す代わりに、チャンクに分けてください。Claude Code に一つずつ渡し、出力を確認してから次に進みます。
Vim モード
hjkl で動く指を持っているなら、Claude Code はそれに対応しています。入力エリア内で標準的な vim バインディングのサブセットを使える組み込みの vim モードがあります。
Vim モードをオンにする
2 つの方法で切り替えられます。
- Claude Code で
/vimと入力して即座に vim モードをオンにする /configを開いて設定で vim モードをオンにする (セッションをまたいで維持される)
オンにすると、NORMAL モードで開始します。入力エリアには通常のモードインジケーターが表示されるので、常にどのモードにいるかがわかります。
キーバインドリファレンス
モード切り替え:
| キー | アクション |
|---|---|
Esc | NORMAL モードに切り替え |
i | カーソルの前に挿入 |
I | 行頭に挿入 |
a | カーソルの後に挿入 |
A | 行末に挿入 |
o | 下に新しい行を開く |
O | 上に新しい行を開く |
ナビゲーション:
| キー | アクション |
|---|---|
h / j / k / l | 左 / 下 / 上 / 右 |
w | 次の単語の先頭にジャンプ |
e | 次の単語の末尾にジャンプ |
b | 前の単語の先頭にジャンプ |
0 | 行頭にジャンプ |
$ | 行末にジャンプ |
^ | 最初の非空白文字にジャンプ |
gg | 最初の行にジャンプ |
G | 最後の行にジャンプ |
f<char> | 行内の次の文字を検索 |
F<char> | 行内の前の文字を検索 |
t<char> | 次の文字の手前に移動 |
T<char> | 前の文字の後ろに移動 |
; | 最後の f/F/t/T を前方に繰り返す |
, | 最後の f/F/t/T を後方に繰り返す |
編集:
| キー | アクション |
|---|---|
x | カーソル下の文字を削除 |
dw | 次の単語まで削除 |
de | 単語の末尾まで削除 |
db | 単語の先頭まで削除 |
dd | 行全体を削除 |
D | 行末まで削除 |
cw | 次の単語まで変更 |
ce | 単語の末尾まで変更 |
cb | 単語の先頭まで変更 |
cc | 行全体を変更 |
C | 行末まで変更 |
. | 最後の編集コマンドを繰り返す |
ヤンクと貼り付け:
| キー | アクション |
|---|---|
yy / Y | 行全体をヤンク (コピー) |
yw | 次の単語までヤンク |
ye | 単語の末尾までヤンク |
yb | 単語の先頭までヤンク |
p | カーソルの後に貼り付け |
P | カーソルの前に貼り付け |
テキストオブジェクト (d、c、y と一緒に使用):
| キー | 選択範囲 |
|---|---|
iw / aw | 単語の内側 / 単語全体 |
iW / aW | WORD の内側 / WORD 全体 |
i" / a" | ダブルクォートの内側 / 全体 |
i' / a' | シングルクォートの内側 / 全体 |
i( / a( | 丸括弧の内側 / 全体 |
i[ / a[ | 角括弧の内側 / 全体 |
i{ / a{ | 波括弧の内側 / 全体 |
行操作:
| キー | アクション |
|---|---|
>> | 行をインデント |
<< | 行のインデントを解除 |
J | 現在の行と次の行を結合 |
Vim モードが効果を発揮する場面
Vim モードは長い複数行のプロンプトで真価を発揮します。ファイルパス、コードスニペット、複数ステップの要求を含む詳細な指示を Claude Code に渡すとき、vim スタイルのジャンプと編集で実際に数分を節約できます。
スキップすべき場面
vim ユーザーでない方はスキップしてください。Claude Code の入力ボックスだけのためにその学習曲線を登る価値はありません。
ターミナル別のヒント
VS Code 統合ターミナル
/terminal-setupを実行して複数行入力用の Shift+Enter を設定する- 長い入力の貼り付け切り詰めに注意。100 行を超えるものはファイルベースで
- ターミナルはエディタとリソースを共有する。アクティブな拡張機能が多いと Claude Code が遅く感じることがある
- ターミナル設定で Option キーを「Esc+」に設定することで Option+Enter が機能する
iTerm2
- Shift+Enter はネイティブで動作。設定不要
- プロファイル、ターミナル、「ベルをミュート」からシステムアラートをオンにして、タスク完了バナーを表示する
- プロファイル、キーの下で Option キーを「Esc+」に設定して Option+Enter を有効にする
- 組み込みの tmux 統合が並列 Claude Code セッションとうまく連携する
Warp
/terminal-setupを実行して Shift+Enter を設定する- Warp のブロックベースの入力が Claude Code のプロンプト検出に干渉することがある。問題が発生したらクラシック入力モードに切り替える
Alacritty
/terminal-setupを実行して Shift+Enter を設定する- GPU アクセラレーションされたレンダリングにより、Alacritty は Claude Code の出力表示に最速のターミナルの一つ
Ghostty
- Shift+Enter はネイティブで動作
- Ghostty はまだ若いが、Claude Code との相性は良好。macOS ネイティブのレンダリングと高速な起動が専用セッションに適した選択肢にする
Kitty
- Shift+Enter はネイティブで動作
- GPU レンダリングにより、長い Claude Code の出力でも Kitty はスムーズに動作
- 組み込みのマルチプレクサーで tmux なしで並列セッションを実行できる
まとめ
Claude Code のために適切に設定されたターミナルには 5 つの要素が揃っています。
- テーマの合わせ方
/configでハイライトが読みやすく表示される - 複数行入力 Shift+Enter または Option+Enter、好みの方でルーティングされている
- 通知 完了したタスクが注意を引くようにオンになっている
- 大きな入力の計画 短いプロンプト以上のものはファイルベースのワークフロー
- Vim モード すでに vim を使っているなら有効化
この 5 つを揃えてください。ターミナルが邪魔をやめ、本来あるべきコックピットとして機能し始めます。
設定をやめて、構築を始めよう。
AIオーケストレーション付きSaaSビルダーテンプレート。