Claude Code 插件的项目级配置，终于有标准答案了

Claude Code 的插件系统有一个很微妙的设计问题：当你给团队配置了一组共享的插件规则之后，怎么让每个项目能有不同的配置？比如安全扫描插件，你可能希望 A 项目严格模式、B 项目宽松模式，但插件本身并不知道项目之间的差异。

Claude Code 官方出了一个很轻量的 Skill，专门来解决这个问题——configured-agent，教你怎么用文件来管理插件的项目级配置。

核心思路

这个 Skill 只做一件事：用 .claude/plugin-name.local.md 文件存储每个项目的插件配置。

文件格式是 YAML frontmatter 加 Markdown body，比如：

---
enabled: true
strict_mode: false
max_retries: 3
notification_level: info
---
# Plugin Configuration
This plugin is configured for standard validation mode.

YAML 部分放结构化配置，Markdown body 可以写额外的上下文或说明。文件放在项目根目录下的 .claude/ 目录里，并且需要加入 .gitignore——因为这是每个开发者自己项目级别的配置，不应该被 git 追踪。

它怎么工作

当你写了一个插件的 hook 或者 agent 之后，可以让它去读这个 .local.md 文件，根据配置内容决定行为。

比如一个安全扫描插件，可以在 hook 里写：

STATE_FILE=".claude/security-scan.local.md"
if [[ ! -f "$STATE_FILE" ]]; then exit 0; fi
# 解析 YAML frontmatter
FRONTMATTER=$(sed -n '/^---$/,/^---$/{ /^---$/d; p; }' "$STATE_FILE")
ENABLED=$(echo "$FRONTMATTER" | grep '^enabled:' | sed 's/enabled: *//')
if [[ "$ENABLED" != "true" ]]; then exit 0; fi

这样，不同项目只需要维护不同的 .local.md 文件，插件逻辑本身不用改。

典型使用场景

按项目开关插件。团队有一套共享的插件，但某个内部项目不需要某个插件？不需要改插件代码，在那个项目的 .local.md 里把 enabled 设为 false 就行。

多 agent 协作时的状态共享。当你的 Claude Code 配置了多个 agent 互相协作，可以用 .local.md 存储”当前谁在负责什么任务”这样的协调信息。

不同项目不同行为。比如代码格式化插件，A 项目用 2 空格、B 项目用 4 空格，把格式配置写在各自项目的 .local.md 里。

这个 Skill 本身是什么

严格来说这不是一个”功能型”Skill——它不直接给你增加什么能力，而是教 Claude Code 开发者一个标准化的配置管理模式。如果你正在写 Claude Code 插件，或者用插件做团队协作，这个模式值得直接用起来。

安装方式：

npx skills add https://github.com/anthropics/claude-code --skill configured-agent

来自 Anthropic 官方 claude-code 仓库，45K+ stars，质量有保证。

GitHub 仓库：https://github.com/anthropics/claude-code

沈星河｜AI 行业观察，关注我，带你看见 AI 领域的真实变化。

GitHub: https://github.com/anthropics/claude-code