Claude Code のバックグラウンドエージェント

問題: サブエージェントはかつてセッションをフリーズさせていました。メインエージェントがリサーチや重い分析処理のためにサブエージェントを生成すると、戻ってくるまでただ待つしかありませんでした。

すぐに使えるヒント: サブエージェントが起動した瞬間に Ctrl+B を押すと、バックグラウンドに落ちます。

You: Research authentication best practices for our Next.js app
Claude: I'll spawn a sub-agent to research this...
[Sub-agent starts]
You: [Press Ctrl+B]
You: While that runs, let's work on the database schema...

あなたはチャットに留まります。サブエージェントは単独で作業を続けます。完了すると、結果が戻ってきます。

真の並列実行

非同期サブエージェントはファーストクラスの機能になりました。メインエージェントがサブエージェントを生成するたびに、バックグラウンドに送り出して Claude との別の作業スレッドを続けられます。

フロー:

リクエスト: サブエージェントに適したタスクを Claude に渡す
Claude が生成: メインエージェントがサブエージェントを作成して実行する
バックグラウンドへ: サブエージェントが作業中に Ctrl+B を押す
作業継続: メインエージェントに別の話題について話しかける
自動再開: 完了時にサブエージェントがメインエージェントを起こし、結果を渡す

実行中のものを確認したいですか? /tasks と入力します。

/tasks

バックグラウンドの各エージェントがステータス、トークン数、進捗インジケーターと共に表示されます。クリックすると詳細を確認できます。

エージェントをバックグラウンドにする場面

バックグラウンド向きの処理:

ウェブ検索が必要なリサーチ
大規模なコードベースの分析
ドキュメントの生成
セキュリティ監査や脆弱性スキャン
パフォーマンスプロファイリングレポート

フロントに置くべき処理:

次にあなたの回答が必要なもの
完了前に確認したいファイル編集
今取り組んでいる作業に依存する処理

シェルコマンドも同様

同じ操作で遅いシェルコマンドもバックグラウンドに送れます。Claude が npm install、docker build、ffmpeg ジョブを開始したら、バックグラウンドに送りましょう。

Claude: Running npm install...
[Command starts]
You: [Press Ctrl+B]
You: While that installs, can you review the API routes?

エージェントと同様に /tasks で確認できます。

`--agent` フラグ

新しい CLI フラグで Claude Code をサブエージェントのコンフィグ済みの状態で起動できます。

claude --agent plan

この行を実行すると、プランニングエージェントのコンフィグがロードされた状態で Claude が起動します。プロンプトを与えたり、動作を試したり、実際のワークフローに組み込む前にエッジケースの処理方法を確認したりできます。

役立つ場面:

依存する前にカスタムサブエージェントをデバッグする
エージェントの指示とツールアクセスを確認する
1回限りの作業に専門エージェントを直接実行する
組み込みエージェントが実際に何をするかを学ぶ

組み込みエージェント (plan、explore など) も、.claude/agents/ で定義したものも使えます。

同時リリースされた機能

Anthropic は同じリリースでいくつかの改善をまとめて提供しました。

即時コンパクション: /compact が待ち時間なしで動きます。Claude がバックグラウンドでライブセッションサマリーを常時保持しているため、コマンドを実行するとそのサマリーをクリーンなコンテキストに読み込むだけです。

セッションメモリアーキテクチャ: すべてのセッションが構造化されたサマリーを持ちます。ステータス、完了した作業、ディスカッションスレッド、作業ログを追跡します。

統計ダッシュボード: /stats で使用パターン、よく使うモデル、トークン合計、ストリークを確認できます。Ctrl+S で出力をコピーして共有できます。

セッション命名: /rename でセッションにラベルを付け、claude --resume session-name で名前から再開できます。/resume 画面ではフォークされたセッションがグループ化され、キーボードショートカットも追加されました (P でプレビュー、R でリネーム、B でフォーク一覧を表示)。

MCPクイックトグル: 設定ファイルを触らずにMCPサーバーをオン/オフできます。

Slack連携: Slack チャンネルから Claude Code にタスクを渡せます。バグや機能リクエストに @Claude をメンションすると、チームワークフローが拾い上げます。

よくある問題

エージェントがバックグラウンドに行かない: Ctrl+B はエージェントが実際に動作中の場合にのみ機能します。完了後ではなく、作業中に押してください。

エージェントの追跡を見失った: /tasks を実行します。IDと共にすべてのバックグラウンドプロセスが一覧表示されます。

エージェントが完了したが何も出てこない: 結果は通常 AgentOutputTool を通じて自動的に戻ってきます。見逃した場合は /tasks で見つけて出力を確認してください。

次のステップ

実行パターン: 並列、シーケンシャル、バックグラウンド。ジョブに合ったものを選ぶ
基礎: より大きなものを作る前にエージェントの基本を読む
設計パターン: サブエージェントの設計でクリーンな作業分割を学ぶ
配布: タスク配布でマルチエージェントオーケストレーションを扱う
カスタムエージェント: カスタムエージェントパターンで独自のスペシャリストを作る

バックグラウンド実行により、Claude Code はターン制チャットではなく、並列ワークステーションに近いものになります。リサーチを開始して、コードを書き続けて、準備ができたら結果を拾い上げる。