Claude Code Agent 路由：插件治理与 OTEL 审计追踪

5 月 29 日发布的 Claude Code v2.1.157 是近几个月来运营意义最重大的更新之一——不是因为有什么重磅模型升级，而是因为它交付了三项改变多 agent 编程流水线治理、路由与可观测性方式的控制能力。如果你在团队规模下运行 Claude Code，这些变化今天就会影响你的部署模型。

发生了什么

v2.1.157 更新日志中有三项值得重点关注的功能：

1. 插件从 .claude/skills 目录自动加载——无需 marketplace

此前，向团队分发 Claude Code 插件需要经过 marketplace 审批或手动安装步骤。现在，放置在 .claude/skills 目录中的任何插件都会在 Claude Code 启动时自动加载。新增的 claude plugin init <name> 命令可以在该目录下快速搭建插件结构。

这是一次治理模式的转变：团队现在可以通过自己的代码仓库或共享文件系统分发内部插件——自定义工具、公司专属工作流、私有集成——而无需依赖 Anthropic 的 marketplace 基础设施。

2. settings.json 中的 agent 字段现在对派发会话生效

当 Claude Code 通过 claude agents 派发后台 agent 会话时，现在会读取 settings.json 中的 agent 字段来决定使用哪个 agent profile。可以通过 --agent <name> 在每次调用时覆盖。

这是一个路由决策点：operator 现在可以在配置层面声明派发会话使用哪个 agent 身份，而不是依赖运行时参数或寄希望于默认值正确。对于运行多个 agent profile 的团队（例如严格的代码审查 agent 与宽松的探索 agent），这意味着派发路由现在是声明式且可审计的。

3. 设置 OTEL_LOG_TOOL_DETAILS=1 后，tool_decision 遥测事件包含工具参数

Claude Code 此前已经为工具决策发出 OTEL 遥测。此次更新后，设置 OTEL_LOG_TOOL_DETAILS=1 会让这些事件包含实际的工具参数——执行的 bash 命令、调用的 MCP 工具名称、使用的 skill 名称。

这填补了一个重要的可观测性空白。此前你只能看到某个工具被调用了；现在你能看到它被用什么参数调用。对于通过 API gateway 路由 Claude Code 或在 CI/CD 流水线中运行它的团队，这意味着你终于可以在工具调用层面构建有意义的审计追踪和成本归因。

为什么这对 AI 工程团队很重要

这三项变化分别针对 operator 技术栈的不同层次：

插件治理移除了内部工具对外部基础设施的依赖。那些因为分发需要 marketplace 审批或手动步骤而对构建私有 Claude Code 扩展持观望态度的团队，现在有了清晰的路径：将插件提交到共享仓库，挂载 .claude/skills 目录，完成。这对有隔离网络或受限环境的企业尤为重要。

Agent 路由配置让多 agent 派发变得可审计。settings.json 中的 agent 字段意味着你的 CI/CD 流水线、团队共享配置或 operator 管理的部署可以声明运行哪个 agent profile——而这个声明是版本控制的。这是"我们认为正确的 agent 运行了"与"我们能证明正确的 agent 运行了"之间的区别。

OTEL 工具遥测实现了真正的成本归因和安全审计。如果你在规模化运行 Claude Code——数十名开发者、每天数百个 agent 会话——知道执行了哪些 bash 命令、调用了哪些 MCP 工具不是可选项，而是计费对账、异常检测和合规报告的基础。

Router/Operator 视角

settings.json 中的 agent 字段是这次更新中最容易被低估的变化。它在 Claude Code 自身的派发机制内引入了一个路由层：operator 声明 agent 身份，运行时遵从它。这类似于路由 gateway 让你按请求固定模型或 provider——只不过这里固定的是 agent profile，而不是模型。

对于通过 TheRouter 等 API gateway 使用 Claude Code 的团队，agent 路由配置与 OTEL 工具遥测的组合构建了更完整的可观测性视图：

• Gateway 在 API 层面看到模型、token 数量和延迟。
• OTEL 工具遥测（设置 OTEL_LOG_TOOL_DETAILS=1）增加了工具调用层：运行了哪些命令、调用了哪些 MCP 工具、使用了哪些 skill。
• settings.json 中的 agent 字段增加了身份层：哪个 agent profile 负责了这次会话。

三层数据合在一起，让你能够回答"这个 agent 会话实际做了什么，谁授权了它？"

Operator 插件治理检查清单：

• 审计你的 .claude/skills 目录——其中的任何内容现在都会自动加载。把它当作 PATH 条目来对待。
• 如果你在分发内部插件，将它们移到共享配置仓库的 .claude/skills 目录中。
• 如果需要工具级审计追踪，在 CI/CD 环境中设置 OTEL_LOG_TOOL_DETAILS=1。
• 在团队的 settings.json 中添加 agent 字段，为派发会话固定 agent profile。
• 在部署自定义工具之前，通过 claude plugin init 脚手架了解有效的插件结构。

TheRouter 用户应关注什么

如果你通过 TheRouter 路由 Claude Code，OTEL 工具遥测变化与你的可观测性配置直接相关。Gateway 层数据（模型、token、延迟）和工具层数据（bash 命令、MCP 调用）现在来自不同层次——但如果你正确配置，两者都可以获取。

关注 Anthropic 在未来版本中如何扩展 agent 字段的语义。如果 agent profile 获得模型固定或 provider 路由能力，这个配置字段将成为 operator 希望集中管理的一级路由控制。

插件自动加载变化也值得从安全角度关注：任何在作用域内的 .claude/skills 目录现在都是一个执行面。团队应该以与依赖管理同等的严格程度对待插件治理。