CC逆引きリファレンス

バックグラウンドエージェント化してターミナルを解放したい

1. 基本操作

コマンド / 機能

/background または claude --background / --bg

セッションを裏で走らせる

概要

/background コマンド、または起動時の --background / --bg フラグで、セッションをバックグラウンドエージェントとして切り離し、ターミナルを解放できます。バックグラウンドエージェントはコード作業が完了すると自動でコミット・pushし、ドラフトPRを開きます。claude agents / claude attach / claude logs / claude stop / claude rm / claude respawn で管理できます。

設定例

# 対話中のセッションをバックグラウンドに切り離す
/background

# 起動時からバックグラウンドで実行
claude --bg "テストを全部通して"

# 実行中のバックグラウンドセッションを一覧表示
claude agents
claude agents --json --all

# セッションに再アタッチ
claude attach <id>

# ログを見る
claude logs <id>

# 停止・削除・再起動
claude stop <id>    # kill でも可
claude rm <id>
claude respawn <id>
公式ドキュメントを見る

こんな時に使う

  • 長時間かかるタスクを裏で走らせてターミナルを他の作業に使いたい時
  • 複数のタスクを並行して進めたい時
  • 完了したらPRまで自動で作ってほしい時

使い方

  1. 1/background でセッション中に切り離す、または claude --background/--bg で最初からバックグラウンド起動
  2. 2claude agents で実行中のバックグラウンドセッション一覧を確認
  3. 3claude attach <id> で再アタッチして続きを操作
  4. 4claude logs / stop / rm / respawn <id> で管理

Tips

  • バックグラウンドエージェントはコード作業完了時に自動でコミット・pushし、ドラフトPRを開く
  • Notification フックが agent_needs_input(入力待ち)・agent_completed(完了)を受け取れる
  • claude daemon status でバックグラウンドセッションの監督プロセスの状態を確認できる

関連コマンド

/tasks