8
3

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

iTerm2 × Claude Code を快適にする設定・Tips集

8
Last updated at Posted at 2026-03-04

Claude Codeを毎日使っていますが、ターミナルの設定はずっとデフォルトのままでした。

「まぁ動いてるしな」くらいの気持ちだったんですが、ちょっと設定を見直してみたら思った以上に快適になったので、自分がやった設定をまとめておきます。

対象読者: Claude Codeを普段使っていて、ターミナルはiTerm2の人

1. Unlimited Scrollback

Claude Codeの出力、めちゃくちゃ長いです。

コードの差分表示、ツール実行ログ、エージェントの思考過程——一度の応答で何百行も流れてくる。iTerm2のデフォルトだとスクロールバッファは1000行なので、ちょっと前の出力を見返そうとしたら消えてた、なんてことが普通に起きます。

設定は一箇所チェックを入れるだけです。

Settings > Profiles > Terminal > Scrollback Buffer で「Unlimited scrollback」にチェック。

ちなみに、Settingsは「Cmd+++ ,」で開けます。

Unlimited scrollback の設定画面

これで「さっきの出力どこいった?」から解放されます。

2. タブ名をPWD(作業ディレクトリ)に変更

Claude Codeで複数プロジェクトを並行して作業していると、タブがこうなりがち:

[Claude Code] [Claude Code] [Claude Code]

どれがどのプロジェクトかわからない。毎回切り替えて確認するのが地味にストレスでした。

タブ名を現在のディレクトリ名に変えると、こうなります:

[my-app] [api-server] [docs]

一目瞭然です。

Settings > Profiles > General > Title のドロップダウンで「PWD」系の表示を選択(「Job & PWD」や「PWD」など、好みで)。

Title > PWD の設定画面

3. 通知hooks(入力待ち・完了を音+バナーで通知)

個人的に、これが一番やってよかった設定。

Claude Codeにタスクを投げて、ブラウザで調べ物をしたり別の作業をしている間に、Claudeが「ここどうしますか?」と入力待ちになっていることがあります。気づかないまま数分放置——これが結構もったいない。

Claude Codeのhooks機能を使うと、特定のイベント発生時にシェルコマンドを実行できます。macOSの通知バナーを飛ばすようにしておけば、別の作業中でも見逃しません。

手順

1. terminal-notifier をインストール

brew install terminal-notifier

2. ~/.claude/settings.json にhooksを追加

{
  "hooks": {
    "Notification": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "terminal-notifier -title 'Claude Code' -message 'Input needed' -sound Glass"
          }
        ]
      }
    ],
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "terminal-notifier -title 'Claude Code' -message 'Task completed' -sound Hero"
          }
        ]
      }
    ]
  }
}

これで以下のタイミングで通知が飛びます:

イベント タイミング 通知音
Notification 権限確認やユーザー入力待ちが発生した時 Glass
Stop Claudeが応答を完了した時 Hero

Notification イベントは matcher でさらに絞り込めます:

matcher 発火タイミング
permission_prompt ツール実行の権限確認時
idle_prompt アイドル状態(ユーザー入力待ち)時

「権限確認の通知は要らない、入力待ちだけ知りたい」なら "matcher": "idle_prompt" にすればOK。

terminal-notifierの通知バナーが表示された画面

別作業中でも通知音+バナーで気づけるので、Claudeに投げて待ってる間のロスがほぼなくなりました。

4. 画像の直接貼り付け(Ctrl+V)

Claude Codeはマルチモーダル対応なので、スクリーンショットを貼り付けて「このUIのここを直して」みたいな指示ができます。

VS Codeのターミナルだと Cmd+V でクリップボードの画像を貼り付けられるので、iTerm2でも同じだろうと思っていたら、Cmd+V では画像が貼れませんでした。しばらく「iTerm2では画像貼り付けできないのか」と諦めていたんですが、実は Ctrl+V でできました。同じ勘違いをしている人がいるかもしれないので書いておきます。

  • Cmd+V → テキストとして貼り付けようとして失敗する(画像のMIMEタイプが無視される)
  • Ctrl+V → 画像として正しく貼り付けられる

macユーザーの本能で Cmd+V を押したくなりますが、画像は Ctrl+V です。

実際の流れ

  1. スクリーンショットを撮る(Cmd+Ctrl+Shift+4 で範囲選択→クリップボードにコピー)
  2. Claude Codeのプロンプトで Ctrl+V
  3. [Image #1] と表示されれば成功

エラー画面やデザインのフィードバックなど、言葉で説明するより見せたほうが早い場面は多いので、重宝しています。

補足: pngpaste を入れておくと、クリップボードの画像をファイルに保存するのも楽になります。

brew install pngpaste
pngpaste screenshot.png  # クリップボードの画像をファイルに保存

5. セッション管理(--resume / --continue)

Claude Codeにはセッションの再開機能があります。「昨日の続きから」「さっきのあのセッション」がコマンド一発でできます。

# 直近のセッションを再開
claude --continue
# または
claude -c

# セッション一覧から選んで再開
claude --resume
# または
claude -r

--resume を実行するとセッションピッカーが開きます。ここでの操作:

キー 動作
P セッション内容をプレビュー
R セッション名を変更
/ セッションを検索
B 現在のgitブランチでフィルタ

複数プロジェクトを行き来しているとセッションが溜まるので、名前をつけておくのがおすすめです。Claude Codeのプロンプトで:

> /rename auth-refactor

こうしておくと claude -r のピッカーで一発で見つかります。「bash-1」「bash-2」が並んでいる中から目的のセッションを探す苦行がなくなります。

おわりに

ターミナルの設定って後回しにしがちですが、毎日使う道具だからこそ手を入れる効果は大きいです

どれも数分で終わる設定なので、気になったものがあれば試してみてください。

8
3
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
8
3

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?