iterm2

Iterm2

macOS 向けのターミナルエミュレーター iTerm2 と、ターミナルマルチプレクサ tmux の完全なリファレンスです。キーボードショートカット、設定、tmux との統合、生産性を高めるワークフローについて説明します。

ワークフローのルーティング

ワークフローを実行する際は、次の両方を行ってください。

1. 通知スクリプトを呼び出す（可観測性の追跡のため）：

   ~/.claude/Tools/SkillWorkflowNotification WORKFLOWNAME Iterm2
   

2. テキスト通知を出力する（ユーザーに表示するため）：

   Running the **WorkflowName** workflow from the **Iterm2** skill...
   

ワークフロー	トリガー	ファイル
SetupTmux	「setup tmux」、「configure tmux」	workflows/SetupTmux.md
TmuxSession	「tmux session」、「attach session」、「detach」	workflows/TmuxSession.md
TroubleshootTmux	「tmux not working」、「fix tmux」	workflows/TroubleshootTmux.md

使用例

例 1：ターミナルを複数のペインに分割する

User: "How do I split my terminal in iTerm2?"
→ References Shortcuts.md
→ Explains Cmd+D (vertical) and Cmd+Shift+D (horizontal)
→ Shows navigation with Cmd+Option+Arrow

例 2：iTerm2 との統合を設定して tmux をセットアップする

User: "How do I use tmux with iTerm2?"
→ Invokes SetupTmux workflow
→ Explains tmux -CC control mode
→ Shows native window integration benefits

例 3：SSH 経由で永続的なセッションを管理する

User: "Keep my terminal running after disconnect"
→ Invokes TmuxSession workflow
→ Creates named session with tmux new -s
→ Shows how to reattach after disconnect

クイックリファレンス

iTerm2 の基本操作

操作	ショートカット
垂直分割	Cmd+D
水平分割	Cmd+Shift+D
ペイン間を移動	Cmd+Option+Arrow
ペインを最大化	Cmd+Shift+Enter
次／前のタブ	Cmd+{ / Cmd+}
検索	Cmd+F
オートコンプリート	Cmd+;
ペースト履歴	Cmd+Shift+H
インスタントリプレイ	Cmd+Option+B
カーソルを検索	Cmd+/

tmux の基本操作

デフォルトのプレフィックス：Ctrl+b

操作	ショートカット
セッションを新規作成	tmux new -s name
セッション一覧を表示	tmux ls or Ctrl+b s
セッションにアタッチ	tmux attach -t name
デタッチ	Ctrl+b d
ウィンドウを新規作成	Ctrl+b c
垂直分割	Ctrl+b %
水平分割	Ctrl+b "
ペイン間を移動	Ctrl+b Arrow
ペインをズーム	Ctrl+b z
ペインを閉じる	Ctrl+b x
コピーモード	Ctrl+b [

iTerm2 と tmux の統合

ネイティブの iTerm2 統合を利用するには、tmux -CC を実行します。

• tmux のウィンドウがネイティブの iTerm2 ウィンドウとして表示されます
• tmux のプレフィックスではなく、iTerm2 のショートカットを使用します
• セッションは切断後も維持されます
• Shell > tmux > Dashboard からダッシュボードを利用できます

ドキュメント一覧

ドキュメント	用途
Shortcuts.md	キーボードショートカットの完全なリファレンス
TmuxConfig.md	tmux 設定（.tmux.conf）ガイド
TmuxCommands.md	tmux コマンドの完全なリファレンス

---

注意点

• 「前のセッションのディレクトリを再利用」はプロファイルとコンテキストごとに設定されます： Cmd-N で開いた新しいウィンドウではプロファイルのウィンドウ設定が使われ、Cmd-T で開いた新しいタブではタブ設定が使われます。両者は異なるため、プロンプトが予期しないディレクトリで開くと混乱の原因になります。
• tmux -CC の実行には、tmux サーバーがインストールされ、起動している必要があります： tmux がリモートホストにあり、iTerm2 がローカルにある場合、tmux -CC attach が SSH 経由で機能するのは、SSH を iTerm2 自体から起動した場合のみです。サブシェルを起動するスクリプトからでは機能しません。
• Cmd-D による分割では、ウィンドウのデフォルトではなく、現在のペインのプロファイルが使われます： シェル統合によってセッション中にプロファイルが変更されると、新しい分割ペインには変更後のプロファイルが引き継がれ、不要な env や PATH が持ち込まれることがあります。
• Ctrl+b プレフィックスは readline の transpose-words と競合します： vi モードのユーザーがこれを再割り当てする場合（set -g prefix C-a）、Ctrl+a は screen やシェルの行頭移動とも競合することに注意してください。C-Space など、空いている組み合わせを選んでください。
• シェル統合は OSC 1337 エスケープコードを挿入します： ターミナル出力を取得するパイプライン（script、asciinema）では、Edit Session > Disable Shell Integration からペインごとに統合を無効にしない限り、制御シーケンスが文字化けします。
• ステータスバーの更新はメインスレッドで実行されます： 負荷の高いカスタムステータスバースクリプト（時間のかかる git status や遅いクラウド CLI）はターミナル全体をフリーズさせるため、ステータスのコールバックは 100ms 未満に保つか、非同期で実行してください。