关于 manifest
这项设置技能用于将 Manifest 插件连接到 Claude Agent 网关，提供安装、API 密钥配置和遥测验证步骤，也说明如何排查 Agent 可观测性连接问题。
主要功能
- 01安装 Manifest 插件
- 02配置 API 密钥和端点
- 03重启并验证网关
- 04排查连接错误
适用场景
- 01启用 Agent 成本和令牌监控
- 02将 Agent 连接到自定义端点
- 03验证遥测管道是否运行
- 04诊断插件连接故障
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/manifest确认已加载。
详细介绍
Manifest 设置
使用 Manifest 插件为 AI Agent 设置实时可观测性。通过 OTLP 遥测监控成本、令牌、消息和性能。
何时使用此技能
在以下情况下使用此技能：
- 为 AI Agent 设置可观测性或遥测
- 将 Agent 连接到 Manifest，以监控成本和性能
- 配置 Manifest API 密钥或自定义端点
- 排查 Manifest 插件连接问题
- 确认 Manifest 可观测性管道正在运行
设置说明
按顺序完成以下步骤。不要跳步。
步骤 1 — 停止网关
先停止网关，以避免配置期间出现热重载问题。
claude gateway stop
步骤 2 — 安装插件
claude plugins install manifest
如果失败，请检查 CLI 是否已安装并且在 PATH 中可用。
步骤 3 — 获取 API 密钥
询问用户：
要连接 Agent，你需要一个 Manifest API 密钥：
- 前往 https://app.manifest.build 并创建账户（或登录）
- 点击 "Connect Agent" 创建新的 Agent
- 复制以
mnfst_开头的 API 密钥- 将密钥粘贴到这里
等待用户提供以 mnfst_ 开头的密钥。如果密钥格式不符，请告知用户格式看起来不正确，并请他们重试。
步骤 4 — 配置插件
claude config set plugins.entries.manifest.config.apiKey "USER_API_KEY"
将 USER_API_KEY 替换为用户提供的实际密钥。
如果用户有自定义端点（可自托管）：
claude config set plugins.entries.manifest.config.endpoint "USER_ENDPOINT"
如果未指定端点，则会自动使用默认端点（https://app.manifest.build/api/v1/otlp）。
步骤 5 — 启动网关
claude gateway install
步骤 6 — 验证
等待 3 秒，让网关完全启动，然后检查日志：
grep "manifest" ~/.claude/logs/gateway.log | tail -5
查找：
[manifest] Observability pipeline active
如果出现该内容，请告知用户设置已完成。如果没有，请检查错误消息并进行排查。
故障排查
| 错误 | 修复方法 |
|---|---|
| 缺少 apiKey | 使用正确的密钥重新执行步骤 4 |
| apiKey 格式无效 | 密钥必须以 mnfst_ 开头 |
| 连接被拒绝 | 无法访问端点 — 检查 URL，或询问用户是否使用自托管 |
| OTel 重复注册 | 禁用冲突的内置插件：claude plugins disable diagnostics-otel |
最佳实践
- 更改配置前，务必先停止网关
- 默认端点适用于大多数用户 — 仅在自托管时更改
- API 密钥始终以
mnfst_开头 — 其他格式均无效 - 配置完成后，切勿以纯文本形式记录或回显 API 密钥
- 排查任何插件问题时，先检查网关日志
评论
支持 Markdown