用途：诊断 Open Claude Code（OCC）的启动失败、CLI 报错、提供商认证异常和技能无法发现等问题。使用前需记录失败命令、退出状态、Node 版本与 OCC 版本，并对凭据和提供商响应正文做脱敏。
环境要求：需 Node 20 或更高版本。在调用提供商前，先验证 npx --yes @ruvnet/open-claude-code@2.1.3 --version 与 --help。
认证排查：只检查所需环境变量是否存在，绝不打印其值。ANTHROPIC_API_KEY 对应 Anthropic，OPENAI_API_KEY 对应 OpenAI 兼容端点；路由取决于模型名，OpenAI 兼容路由使用 --model gpt-4.1-mini。检查 base URL 与模型选择时不得暴露凭据。
npm 发布问题：新发布版本出现 ETARGET 或 E404 时，用全新缓存并加 prefer-online 重试元数据或安装，最长五分钟。不要把认证、完整性或行为失败误判为传播延迟。
技能缺失：检查项目 .claude/skills/<name>/SKILL.md 和用户 ~/.claude/skills/<name>/SKILL.md。OCC 2.1.2 跟随目录符号链接，项目技能覆盖用户技能，损坏的符号链接会被忽略。
限制：Claude Code 插件与 OCC 自定义 PluginLoader 是不同契约；本仓库原生插件只为 Claude Code 提供技能，并不使 OCC 支持所有第三方 Claude 插件。应以最小允许工具集复现，保留脱敏证据，提出针对性修复；未经授权不得删除用户配置或轮换密钥。