--agents
CLI（コマンド・フラグ） ／ 実行フラグ ・ 最終確認 2026年7月11日
ひとことで：カスタムサブエージェントをJSONで動的に定義する。
書式
--agents <json>説明
設定ファイルを置かずに、その場でサブエージェント構成を渡したいときに。
用例
claude --agents '{"reviewer":{...}}'出典（公式ドキュメント）
- Claude Code 公式ドキュメント｜CLI reference（CLIコマンド・フラグ） ・ 確認 2026年7月11日
コマンド名・書式・キー割り当ては Claude Code のバージョンで変わることがあります。実行前に必ず上記の公式ページで最新の記載をご確認ください。当辞典の説明・用例は公式原文の逐語転載ではなく、日本語で要約し直したものです。
よくある質問
--agents とは何ですか？
カスタムサブエージェントをJSONで動的に定義する。
--agents はどう使いますか？
設定ファイルを置かずに、その場でサブエージェント構成を渡したいときに。 用例: claude --agents '{"reviewer":{...}}'
--agents の種別・カテゴリは？
種別は「CLI（コマンド・フラグ）」、カテゴリは「実行フラグ」です。
--agents の情報はどこで確認できますか？
Claude Code 公式ドキュメント（https://code.claude.com/docs/en/cli-reference）で 2026年7月11日 に確認しました。仕様は改定されることがあるため、実行前に公式ページで最新の記載をご確認ください。
同じカテゴリ（実行フラグ）の他の項目
- --model ・ 現在のセッションで使うモデルを指定する。
- --add-dir ・ Claudeが読み書きできる作業ディレクトリを追加する。
- --allowedTools ・ 権限プロンプトなしで実行できるツールを指定する。
- --disallowedTools ・ ツールを拒否するルールを指定する。
- --permission-mode ・ 起動時の権限モードを指定する。
- --dangerously-skip-permissions ・ 権限プロンプトをすべてスキップする（取り扱い注意）。
- --output-format ・ printモードの出力形式を指定する（text / json / stream-json）。
- --input-format ・ printモードの入力形式を指定する。
- --max-turns ・ エージェントの自律ターン数を制限する。
- --max-budget-usd ・ 停止までにAPIへ使う上限金額（ドル）を設定する。
- --verbose ・ 詳細ログを有効化し、ターンごとの動きを全部表示する。
- --mcp-config ・ JSONファイルまたは文字列からMCPサーバーを読み込む。