Skip to content
← リリースに戻る · 2.1.271
新機能 / v2.1.271

サブエージェント用omitClaudeMdオプション

CHANGELOG 原文（英語）

Added omitClaudeMd to agent frontmatter and --agents JSON, letting custom and plugin subagents run without user, project and local CLAUDE.md files; managed policy files still load
公式の変更履歴を開く ↗

日本語での補足

エージェントのfrontmatterと--agents JSONにomitClaudeMdを追加。カスタム・プラグインのサブエージェントが、ユーザー・プロジェクト・ローカルのCLAUDE.mdなしで実行できるように。managedポリシーファイルは引き続き読み込まれる。

ドキュメント

エージェント 全文を読む（英語原文） →

ドキュメントの抜粋（参考訳）

エージェント

プラグインは、Claude が必要に応じて自動的に呼び出せる、特定タスク向けの専用サブエージェントを提供できます。

配置場所: プラグインルート直下の agents/ ディレクトリ

ファイル形式: エージェントの能力を記述する Markdown ファイル

エージェントの構造:

---
name: agent-name
description: What this agent specializes in and when Claude should invoke it
model: sonnet
effort: medium
maxTurns: 20
disallowedTools: Write, Edit
---

Detailed system prompt for the agent describing its role, expertise, and behavior.

プラグインエージェントのフロントマター

プラグインのエージェントファイルは、サブエージェントファイルと同じフロントマターフィールドを使いますが、エージェントがプラグイン由来の場合、Claude Code はそのうち一部だけを反映します。

  • サポート対象: name、description、model、effort、maxTurns、tools、disallowedTools、skills、memory、background、omitClaudeMd、isolation、color、experimental。isolation に指定できる値は "worktree" のみです。
  • セキュリティ上の理由からサポート対象外: hooks、mcpServers、permissionMode。プラグインからエージェントを読み込む際、Claude Code はこれらを無視します。これらを使うには、エージェントファイルを .claude/agents/ または ~/.claude/agents/ にコピーしてください。
  • サポート対象外: initialPrompt。

プラグインのエージェントファイルは、agents/ のサブフォルダーに配置できます。Claude Code はそれらを再帰的に読み込み、プラグイン名、各サブフォルダー名、ファイル名をコロンで連結して、エージェントのスコープ付き名前を作ります。たとえば、my-plugin という名前のプラグインにある agents/review/security.md は my-plugin:review:security として読み込まれます。この名前は、次の 2 つの設定で変わります。

  • フロントマターの name: ファイル名の部分だけを置き換えます。そのため、agents/review/security.md に name: audit があると、my-plugin:review:audit として読み込まれます
  • マニフェストの agents フィールド: ここに列挙したファイルは、サブフォルダー名なしで読み込まれます。そのため "agents": "./custom/review/security.md" は my-plugin:security として読み込まれます

プラグインのエージェントは、フロントマターに name がない場合や、パースできない場合でも、Claude Code は読み込みます。

  • name がない場合: Claude Code はファイル名にちなんでエージェントに名前を付けます。そのため、my-plugin というプラグインの agents/reviewer.md は my-plugin:reviewer として読み込まれます
  • フロントマターがパースできない場合: Claude Code はファイル名にちなんで名前を付け、説明には Agent from my-plugin plugin を使い、ファイル内の他のフィールドはすべて無視します

一方、プロジェクト、ユーザー、管理対象のエージェントファイルについては、フロントマターに name がない場合やパースできない場合、Claude Code はそのファイルをスキップします。

プラグインの既定の agents/ ディレクトリ内で、フロントマターがパースできないファイルを見つけるには、claude plugin validate を実行してください。渡すパスは、そのプラグインにマニフェストがあるかどうかによって異なります。次のどちらの例も、プラグインディレクトリとして ./my-plugin を使っています。

  • マニフェストがあるプラグイン: claude plugin validate ./my-plugin
  • マニフェストがないプラグイン: claude plugin validate ./my-plugin/agents。Claude Code v2.1.233 以降が必要です。

プラグインを有効にすると、エージェントは @ メンションの入力補完に、my-plugin:code-reviewer のようなスコープ付き名前で表示されます。

詳細はサブエージェントを参照してください。

取得日 · 2026-09-23

変更の詳細