サブエージェント・チーム
カスタムサブエージェントを定義してClaudeの役割・ツール制限・システムプロンプトを特化させる。エージェントチーム機能で複数のClaudeインスタンスが協調して大規模タスクを並列処理できる。
コマンド・設定オプション26件
この機能に関連するスラッシュコマンド・CLIオプション・設定項目の一覧です。
スラッシュコマンド
Claude Code のインタラクティブセッション内で / から始めて入力するコマンド。
自動化・CI/CD
/agents
サブエージェント管理UIを開く。ビルトイン・ユーザー・プロジェクト・プラグインのエージェントを一覧表示し、新規作成・編集・削除・有効化を操作できる。
/agents/background
現在のセッションをバックグラウンドエージェントに切り替え、このターミナルを解放する。引数でもう1つ指示を渡してからデタッチできる。`claude agents` で監視可能。エイリアス: `/bg`。
/background フロントエンドのテストを修正して/stop
アタッチ中のバックグラウンドセッションを停止する。トランスクリプトとworktreeは保持される。停止せずデタッチするには `/exit` または `←` キーを使う。
/stop/tasks
バックグラウンドタスクを一覧表示・管理する。`/bashes` でも起動可能。
/tasksCLIオプション
`claude` コマンドをターミナルから起動する際に渡すオプション。
自動化・CI/CD
claude agents
バックグラウンドセッションを一元管理するエージェントビューを開く。実行中・入力待ち・完了したすべてのセッションを一覧表示。`--cwd <path>` でディレクトリ絞り込み、`--json` でJSON出力できる。`--permission-mode`・`--model`・`--effort` でデフォルト設定も指定可能。
claude agents --jsonclaude attach
バックグラウンドセッションにこのターミナルでアタッチする。セッションIDを指定する。アタッチ後は `←` キーでエージェントビューに戻れる。
claude attach 7c5dcf5dclaude daemon status
バックグラウンドセッションを管理するスーパーバイザープロセスの状態・バージョン・ソケットディレクトリ・ワーカー数を表示する。スーパーバイザーが起動していない場合は終了コード1を返す。
claude daemon statusclaude logs
バックグラウンドセッションの直近出力を表示する。セッションIDを指定する。アタッチせずに進捗確認したい場合に使用する。
claude logs 7c5dcf5dclaude respawn
実行中または停止中のバックグラウンドセッションを会話履歴を保持したまま再起動する。`--all` ですべての実行中セッションを再起動できる（バイナリ更新後などに有用）。
claude respawn 7c5dcf5dclaude rm
バックグラウンドセッションをリストから削除する。会話トランスクリプトはローカルに残り `claude --resume` で再開できる。
claude rm 7c5dcf5dclaude stop
バックグラウンドセッションを停止する。`claude kill` でも同様の操作が可能。
claude stop 7c5dcf5d--agent
現在のセッションで使用するサブエージェントを指定する。`agent` 設定を上書きする。
claude --agent my-custom-agent--agents
カスタムサブエージェントをJSON形式で動的に定義する。サブエージェントのフロントマターと同じフィールド名と `prompt` フィールドを使用する。
claude --agents '{"reviewer":{"description":"コードレビュアー","prompt":"あなたはコードレビュアーです"}}'--bg
セッションをバックグラウンドエージェントとして開始してすぐに制御を返す。セッションIDと管理コマンドを出力する。`--agent` と組み合わせて特定のサブエージェントをバックグラウンドで実行できる。
claude --bg "flaky testを調査して"--teammate-mode
エージェントチームのチームメイト表示方法を設定する。`auto`（デフォルト）・`in-process`・`tmux` から選択。
claude --teammate-mode in-process--exec
Claudeセッションを開始せず、シェルコマンドをPTYバックドのバックグラウンドジョブとして実行する。`--bg` と組み合わせてシェルから起動する。`claude agents` でアタッチ・デタッチできる。
claude --bg --exec 'pytest -x'claude daemon stop
バックグラウンドセッションのスーパーバイザーと管理中のセッションを停止する。`--any` でオンデマンドスーパーバイザーの停止を確認、`--keep-workers` でバックグラウンドセッションを残したまま停止できる。応答しないスーパーバイザーの回復に使用する。
claude daemon stop --any --keep-workers設定オプション
`claude config set <key> <value>` または `~/.claude/settings.json` で設定する項目。
自動化・CI/CD
teammateMode
エージェントチームのチームメイトの表示方法を設定する。`auto`（デフォルト、tmux/iTerm2ではスプリットペイン）・`in-process`・`tmux` から選択。
~/.claude/settings.json: {"teammateMode": "in-process"}agent
メインスレッドをnamed subagentとして実行する。そのサブエージェントのシステムプロンプト・ツール制限・モデルが適用される。
~/.claude/settings.json: {"agent": "code-reviewer"}CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS
（実験的）エージェントチーム機能を有効化する。`settings.json` の `env` オブジェクトまたはシェル環境変数として `1` に設定する。複数のClaude Codeインスタンスがチームとして協調して作業できるようになる。
~/.claude/settings.json: {"env": {"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"}}CLAUDE_CODE_DISABLE_BACKGROUND_TASKS
バックグラウンドタスク機能をすべて無効化する。環境変数として `1` に設定する。サブエージェントのバックグラウンド実行を完全に無効にしたい場合に使用する。
export CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1CLAUDE_CODE_FORK_SUBAGENT
フォークサブエージェントを有効化する。`1` に設定すると `/fork` コマンドが会話ブランチの代わりにフォークサブエージェントを起動するようになる。
export CLAUDE_CODE_FORK_SUBAGENT=1disableAgentView
バックグラウンドエージェント機能（エージェントビュー）を無効化する。`true` に設定するとバックグラウンドセッションの管理機能が使えなくなる。
~/.claude/settings.json: {"disableAgentView": true}agentPushNotifEnabled
バックグラウンドエージェントからのプロアクティブなプッシュ通知を許可する（v2.1.119以降）。エージェントが重要な状態変化を通知する場合に使用する。
~/.claude/settings.json: {"agentPushNotifEnabled": true}inputNeededNotifEnabled
バックグラウンドエージェントがユーザー入力待ち状態になった際にプッシュ通知を送る（v2.1.119以降）。バックグラウンドで実行中のセッションが承認を求めるときに通知を受け取れる。
~/.claude/settings.json: {"inputNeededNotifEnabled": true}CLAUDE_CODE_DISABLE_AGENT_VIEW
バックグラウンドエージェント（エージェントビュー）機能を環境変数で無効化する。`1` に設定すると `disableAgentView: true` 設定と同等の効果。
export CLAUDE_CODE_DISABLE_AGENT_VIEW=1関連記事
取得中...