用途：为 AI 智能体接入 Manifest 可观测性插件，实时监控成本、Token、消息与性能，数据通过 OTLP 遥测上报。适用于搭建遥测、连接 Manifest 做成本与性能监控、配置 API Key 或自定义端点、排查插件连接问题、验证观测管道运行等场景。
主要能力：安装 Manifest 插件；配置 API Key 与自定义端点；启动网关并验证观测管道是否激活；提供常见错误排查指引。
使用方式（按顺序执行）：
- 先停止网关，避免配置时热重载问题：claude gateway stop
- 安装插件：claude plugins install manifest。若失败，检查 CLI 是否已安装并在 PATH 中。
- 获取 API Key：前往 https://app.manifest.build 注册或登录，点击 Connect Agent 创建新智能体，复制以 mnfst_ 开头的 API Key。
- 配置插件：claude config set plugins.entries.manifest.config.apiKey "USER_API_KEY"。若使用自托管自定义端点：claude config set plugins.entries.manifest.config.endpoint "USER_ENDPOINT"。未指定时默认使用 https://app.manifest.build/api/v1/otlp。
- 启动网关：claude gateway install
- 验证：等待 3 秒后检查日志 grep "manifest" ~/.claude/logs/gateway.log | tail -5，出现 [manifest] Observability pipeline active 即表示配置完成。
限制与注意事项：API Key 必须以 mnfst_ 开头，其他格式无效；配置变更前应先停止网关；默认端点适用于多数用户，仅在自托管时修改；配置后不要以明文记录或回显 API Key；调试插件问题时应先查看网关日志。常见错误包括缺少 apiKey、apiKey 格式无效、连接被拒绝、OTel 重复注册（可执行 claude plugins disable diagnostics-otel 禁用冲突的内置插件）。