Harness と Preview を使って複数の Claude Code セッションを管理する方法

Dev.to / 2026/4/16

💬 オピニオンDeveloper Stack & InfrastructureTools & Practical Usage

要点

  • この記事は、実際の業務における Claude Code の主要な生産性ボトルネックは、AI の能力ではなく、複数の同時エージェントやコンテキストにまたがるワークフロー管理だと主張します。
  • macOS アプリの Harness を紹介し、複数の git worktree に対して Claude Code を実行して、セッション状態(作業中、あなた/許可プロンプトが必要、完了)を明確に示す統一ダッシュボードを提供することで、コンテキスト切り替えを減らします。
  • Harness の設定は、git worktree を指すように構成することを推奨し、これにより、これまでターミナルのタブ確認に使っていたメンタルリソースを取り戻します。
  • 2つ目のボトルネックは、手作業による環境セットアップ(チェックアウト、インストール、サービス起動、DB のリセット)に起因する、遅い PR レビューと反復ループだと特定します。
  • Claude が PR を頻繁に生成する場合に備えて、PR ごとに分離されたフロントエンド/バックエンドのインスタンスを立ち上げる自動化された per-PR プレビュー環境を提案し、より速いテストとレビューを可能にします。

複数のClaude Codeエージェントを運用するときの、コアな生産性ボトルネックを解決するための実行可能なツールを2つ紹介します。セッション管理とレビュー速度です。

ボトルネック:複数のエージェントを管理する

Claude Codeをうまく使えているということは、1つのセッションを動かしているだけではありません。複数のエージェントを、さまざまなタスクやブランチにまたがって同時に先導(オーケストレーション)しているのです。すぐに破綻するのはAIの能力ではなく、ワークフローを管理するあなたの力です。核心となる問題はコンテキスト切り替えのオーバーヘッドです。どのエージェントがあなたの入力を必要としているのか、どれが完了しているのか、あるいは権限プロンプトで詰まっているのかが分からない。ターミナルのタブは、このマルチエージェントの現実に対するUIとしては貧弱です。

ツール1:セッション管理のためのHarness

Harnessは、この可視性の問題を解決するために特別に作られたMacアプリです。複数のgit worktreeに対してClaude Codeを実行し、統一されたダッシュボードを提供します。各セッションはステータス表示で表されます:

  • 「作業中」を表すドット
  • 「あなたが必要」を表すドット(例:権限プロンプト待ち)
  • 「完了」を表すドット

これを2台目のモニターで動かすことで、Claude Code全体の状況を瞬時に、ひと目で把握できます。開発者が「常にターミナルのタブを確認する」ための「スイベルチェア・オーバーヘッド」をなくすことを目的に作ったものです。これは、Claude Code時代における最初の重要スキル――複数のプロジェクトやコンテキストを同時に管理する――に直結します。

適用方法:もしmacOSでこの痛みを感じているなら、Harnessを試してください。セットアップでは、これをgit worktreeに向けるだけです。重要な成果は、以前セッション管理に費やしていた精神的なエネルギーを取り戻せることにあります。

ツール2:より速いレビューのためのPRごとのプレビュー環境

2つ目の破綻ポイントは、レビューと改善(反復)のループです。従来のワークフロー――git checkout、依存関係のインストール、開発サーバーの起動、データベースのリセット――は、Claudeが20分ごとにプルリクエストを生成できる状況では、非常に大きなボトルネックになります。

Harnessがサイドバーに複数のworktreeを表示し、メインのペインでClaudeセッションが編集中で、右側にPR / 変更ファイル情報が表示されているところ

解決策は自動化された、PRごとのプレビュー環境です。モノレポ内のすべてのPRは、自動的にそれぞれ独立したインスタンスを立ち上げるべきです:

  • 専用フロントエンド
  • 専用バックエンド
  • (該当する場合)モバイル向けプレビューチャンネル

ローカルにクローンしてビルドするのではなく、リンクをクリックします。これにより「この変更をテストする」手順が数分から数秒に圧縮されます。これはClaudeの出力スピードに追随し続けるために不可欠です。このツールは2つ目の重要スキル――できる限り速く反復すること――を狙い撃ちにしています。

適用方法:この仕組みは、既存のCI/CD基盤(GitHub Actions、GitLab CI、CircleCIなど)と、VercelやNetlifyのようなプラットフォーム、またはKubernetesのような自前ホスト型のソリューションを組み合わせて実装します。目的は、環境を「URL」にすることであって、「ローカルでの処理」にしないことです。

根本原則

ツールを使いこなすことは、これまで以上に重要になっています。なぜならツールの方が、これまでより強力だからです。Claude Codeは、常に価値があった2つのエンジニアリングスキル――同時並行のコンテキスト管理と、迅速な改善(反復)――の必要性を増幅させます。これらのツールは仕事そのものを変えるのではありません(ユーザーの声を聴き、より良い解決策を想像する)。ただし、Claude Codeを最大限に活用することを妨げる摩擦を取り除きます。

gentic.news Analysis

この開発者の経験は、Claude Codeエコシステムにおける成熟が進んでいることを示しています。先日の当社の報道で触れたように、オープンソースのリポジトリ「claude-code-best-practice」は19.7Kスターに到達し、生産環境で使えるヒントを84個まとめています。この流れは、コミュニティが基本的なプロンプト作りを超えて、エージェント周りのワークフローやツールを体系化する方向へ急速に進んでいることを示しています。複数のエージェントの管理に焦点を当てることは、Anthropicがモデル同士の協業を可能にするために開発したClaude Agentの登場に見られるような、マルチエージェント・フレームワークへの業界全体のシフトと一致しています。

プレビュー環境に関する推奨も、重要な競争上の差別化要因につながります。CursorGitHub Copilotはエディタに深く統合されていますが、Claude Codeの強みは、ターミナルベースのエージェント的アプローチにあります。これにより、フルスタックの変更をオーケストレーションできます。そのため、速い自動テスト環境は「あると便利」ではなく、重要な補完要素になります。Claude Code 2.1.107でOAuth認証を壊した最近の不具合は、エージェントが生成したコードを本番にデプロイする前に、堅牢で隔離されたテスト環境が重要であることを改めて示しています。

もともとは gentic.news に掲載されました