最近、Claude Code を日常的に利用するようになりました。

私は普段 Vim を使用しており、画面を「左半分：ブラウザ」「右半分：ターミナル」に分割しています。
さらにターミナル側は、上 2/3 を Vim、残りの 1/3 を左右に分割してビルドやテストの実行に使用しています。

このレイアウトだと、Claude Code を常時表示させておくスペースがありません。そこで、tmux display-popup を活用して、必要なときだけ呼び出す運用にすることにしました。

要件

快適に使うために、以下の挙動を目指しました。

ディレクトリごとの管理: 複数のプロジェクト（ディレクトリ）を別々のウィンドウで開いているため、Claude Code のセッションもウィンドウ（ディレクトリ）ごとに独立させたい。
高速な切り替え: キー操作一発で表示・非表示を行いたい。

やったこと

config.fish の設定

私はシェルに fish を使用しているため、config.fish に以下の関数を設定しました。

この関数のポイントは以下の通りです。

カレントディレクトリ名をプレフィックスにしたセッション名（例: popup_projectA）を作成
すでに該当のセッションが存在する場合は、それを呼び出す（アタッチする）
すでに popup 内にいる状態で実行された場合は、popup を閉じる（デタッチする）

function tmuxpopup -d "toggle tmux popup window"
  set width '80%'
  set height '80%'
  
  # 現在のセッション名とカレントディレクトリを取得
  set session (tmux display-message -p -F "#{session_name}")
  set current_dir (basename (tmux display-message -p -F "#{pane_current_path}"))
  set popup_session "popup_$current_dir"
  
  # すでに popup セッション内にいる場合はデタッチ（閉じる）
  if string match -q "popup_*" $session
    tmux detach-client
  else
    # popup を表示。セッションがなければ新規作成、あればアタッチ
    tmux display-popup -d '#{pane_current_path}' -xC -yC -w$width -h$height -E "tmux attach -t $popup_session || tmux new -s $popup_session"
  end
end

.tmux.conf

tmux のキーバインド設定で、上記で作成した fish 関数を呼び出すようにします。ここでは Ctrl + q に割り当てています。

# display-popup の設定
bind -n C-q run-shell "fish -c \"tmuxpopup\""

これにより、どのペインにいても Ctrl + q を押すだけで、そのディレクトリ専用の Claude Code 画面がポップアップし、もう一度押すと裏に隠れるようになります。

デモ

実際の挙動は以下の通りです。

おまけ

今回はターミナル全体（tmux）の機能を使いたかったため display-popup を採用しましたが、Vim ユーザーであればプラグインの akinsho/toggleterm.nvim を使用する方法もあります。

tmux のセッションマネージャーを利用していなかったり、Zellij などの他のターミナルマルチプレクサを使用している場合は、Vim プラグイン側で解決するのも良い選択肢だと思います。

参考