VS Code 拡張/デスクトップアプリから移行──tmux 中心の TUI 4 ツール構成による Claude Code 開発環境
tmux・fzf・git diff などを組み合わせたカスタム TUI 環境を構築し、Claude Code のコード生成とレビューを同一画面でライブ連携させる手法。
リリース: 2026-08-05 · 読了 5 分記事の要約
1. 核心(What)
- デスクトップアプリの代わりに tmux と 4 つの自作 TUI ツール(sessionizer, hunk, ctx, claude-history)を用いた Claude Code 運用環境を構築した。
- Alt+s で fzf を起動し、リポジトリと tmux セッションを 1 対 1 で即座に切り替えるワークフローを実現した。
- hunk コマンドによる差分ビューアをエージェントの起動と同時に別ペインで --watch 実行し、生成中の変更をリアルタイムで確認可能にした。
- SQLite データベースを活用したセッション履歴の横断検索 CLI(ctx および claude-history)により、人間とエージェント双方が過去のコンテキストを参照できる。
2. 影響(Why)
- レビューと指摘の統合: 差分表示と指摘入力が別画面になるデスクトップアプリとは異なり、TUI 側で置いたコメントをエージェントが自動で拾うため、チャット欄への文章入力を省略できる。
- コンテキスト喪失の防止: エージェントがセッションごとに記憶を失う課題に対し、SQLite 検索スキルを介して過去の決定事項を自律的に参照させることで、人間による再説明の手間をなくした。
3. 根拠・詳細(How)
- tmux セッション自動切り替え: find と pkgs.fzf を組み合わせたセッション管理スクリプトにより、存在しない場合は作成し、存在する場合は既存セッションにアタッチする動作を実装している。
- ライブ差分モニタリング: tmux split-window を用いて、エージェント起動時に作業ディレクトリのメインブランチに対する git diff を --watch オプション付きで別ペインに常時描画する。
- デュアル履歴検索システム: 人間向けには fzf 風 TUI の claude-history でセッション選択と resume を提供し、エージェント向けには SQLite インデックスを引く CLI(ctx)を skill として分離している。
4. 展望・課題(Next)
- 並列エージェント運用の可能性: 複数の worktree と issue 駆動スクリプトによる並列実行の土台はあるが、トークン消費コストを考慮し、現在はシングルセッションでの効率化を優先している。