CC逆引きリファレンス

エージェントをバックグラウンドで実行したい

9. エージェント

コマンド / 機能

background: true または Ctrl+B

バックグラウンド並列実行

概要

サブエージェントをバックグラウンドで実行すると、メインの会話を続けながら並列処理ができます。frontmatter で background: true を設定するか、実行中に Ctrl+B でバックグラウンドに移動できます。

設定例

# .claude/agents/background-agent.md
---
name: background-analyzer
description: バックグラウンドでコードを分析する
background: true
tools: Read, Grep, Glob
---

コードベースを継続的に分析して問題を報告してください。

# 対話中にバックグラウンドへ移行
# → Ctrl+B でバックグラウンドに移動
# → /tasks でバックグラウンドタスクを確認
公式ドキュメントを見る

こんな時に使う

  • 時間のかかる分析を並列で実行したい時
  • 作業を続けながらバックグラウンドで処理させたい時

使い方

  1. 1frontmatter に background: true を設定
  2. 2または Ctrl+B で実行中にバックグラウンドへ
  3. 3/tasks でバックグラウンドタスクの状態を確認

Tips

  • バックグラウンドエージェントは権限確認を事前に行い、実行中は自動拒否
  • 権限不足で失敗した場合はフォアグラウンドで再実行する
  • CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1 で無効化可能