機能解説

Claude Codeのバックグラウンドエージェント
（claude agents）完全ガイド

複数タスクを投げっぱなしにして、完了したものから下書きPRとして受け取る。新しい並行作業スタイルを解説します。

Claude Codeには、claude agentsコマンドで開くAgent View（バックグラウンドエージェント管理画面）という機能があります。複数の独立したタスクを一つの画面から一括ディスパッチ・監視でき、v2.1.198からは作業完了時に下書きPRを自動作成するようになりました。「投げて、放置して、緑になったPRだけ見る」という働き方ができます。

研究プレビュー機能です

Agent Viewはリサーチプレビュー段階の機能で、Claude Code v2.1.139以降が必要です。インターフェースやキーボードショートカットは今後変更される可能性があります。

サブエージェントとの違い

「サブエージェント」と混同しやすいですが、別の概念です。

	サブエージェント	バックグラウンドエージェント（Agent View）
実行単位	1つのセッション内の作業委任	独立した複数のフルセッション
表示	メイン会話のパネルに一覧	専用の管理画面（`claude agents`）に一覧
会話履歴	メインセッションに紐づく	それぞれ独立した会話

基本の使い方

STEP 1：Agent Viewを開く

claude agents

下部に入力欄、上部にセッション一覧が表示されます。Escでいつでもシェルに戻れます。

STEP 2：タスクをディスパッチする

入力欄にプロンプトを書いてEnterを押すと、新しいバックグラウンドセッションが起動し、1行としてリストに追加されます。続けて別のプロンプトを入力すれば、2つ目のセッションが並行して起動します。

STEP 3：状況を確認する

矢印キーで行を選び、Spaceで「覗き見パネル」を開くと、フルの会話履歴を開かずに最新の状況（作業中の内容、待っている質問）を確認できます。返信もそのまま送信可能です。

STEP 4：必要な時だけ入り込む

Enterまたは→でセッションにアタッチすると、フルの対話セッションとして操作できます。空の入力欄で←を押せば、いつでもAgent Viewの一覧画面に戻れます（デタッチしてもセッションは止まりません）。

セッションの状態

状態	意味
Working	Claudeが作業中（ツール実行・応答生成）
Needs input	質問または権限確認の返答待ち
Idle	次の指示待ちで、特にやることがない状態
Completed	タスクが正常に完了
Failed	エラーで終了
Stopped	`Ctrl+X`や`claude stop`で停止された

目玉機能：作業完了時の自動PR作成

v2.1.198以降、コード変更をワークツリーで隔離したバックグラウンドセッションは、作業完了時に自動でコミット・ブランチのプッシュ・下書きPRの作成まで行い、確認を求めることなく実行します。PRが開かれると、行の右端に#1234のようなラベルが表示されます。

安全のための制約

この自動化には明確な歯止めがあります。mainやmasterに直接プッシュすることは一切なく、force pushやマージも行いません。「PRを開かないで」と伝えていた場合や、リポジトリにリモートが設定されていない場合はPR作成自体がスキップされます。

PRラベルの色分け

色	意味
黄色	チェック待ち・レビュー待ち、またはチェック失敗
緑	チェック通過、レビューのブロックなし
紫	マージ済み
灰色	下書きまたはクローズ済み

多くのタスクでは、このPR番号が緑になったタイミングでレビュー・マージすればいいという運用になります。

ファイル編集はワークツリーで自動隔離

バックグラウンドセッションがファイルを編集する前、Claude Codeは自動的に.claude/worktrees/配下の独立したgitワークツリーへ移動します。これにより、並行して動く複数のセッションが同じチェックアウトを読みつつ、それぞれ別の場所に書き込めるようになっています。

この隔離を無効にしたい場合は、プロジェクト設定で明示的にオフにできます。

.claude/settings.json

{
  "worktree": {
    "bgIsolation": "none"
  }
}

シェルからの操作

Agent Viewを開かなくても、シェルから個別セッションを管理できます。

コマンド	用途
`claude --bg "<prompt>"`	バックグラウンドで即座に開始
`claude attach <id>`	そのターミナルでセッションにアタッチ
`claude logs <id>`	最近の出力を表示
`claude stop <id>`	セッションを停止
`claude respawn <id>`	会話を保持したまま再起動
`claude rm <id>`	一覧からセッションを削除

既存セッションをバックグラウンドに送る

/background
# エイリアス: /bg
# 追加の指示を渡すことも可能
/bg run the test suite and fix any failures

コストへの影響

それぞれのセッションは独立してサブスクリプションの利用枠を消費します。複数タスクを同時にディスパッチする際は、この点を踏まえて数をコントロールしてください。完了後、アタッチされないまま約1時間放置されたセッションのプロセスは自動的に停止し、リソースが解放されます（会話自体は保持され、次にアクセスした時に再開します）。