Basecamp Doctor 用于诊断 Basecamp CLI、认证状态及 agent 插件的健康情况。运行结构化诊断：basecamp doctor --json。检查结果按状态解读：pass 表示正常；warn 表示可用但建议跟进；skip 表示因未认证或不适用而跳过；fail 表示故障需处理。报告失败与警告时应带上 hint 字段，同时检查顶层 breadcrumbs 数组并保留其结构化的 cmd 后续步骤。
常见修复方式：Basecamp 认证使用 basecamp auth login，可用 --expect-identity <id> 防止浏览器以他人身份登录；机器人或 CI 配置改用 token：op read "op://<vault>/<item>/credential" | basecamp auth login --with-token -P <profile> --account <id> --expect-identity <id>。建议前须先用 basecamp auth status --json 查看 oauth_type；若为 agent，该配置是没有自然人主体的 Basecamp agent，需用其自有登录方式并传入 client secret：op read "op://<vault>/<item>/credential" | basecamp auth login --with-client-credentials --client-id <id> -P <profile> --account <id>，且优先采用 CLI 自带提示中的命令。
插件安装或版本修复：agent 插件用 basecamp setup agents；Codex 用 basecamp setup codex；Claude Code 用 basecamp setup claude；Grok 技能用 basecamp setup grok。上述修复均可无终端运行；裸 basecamp setup 是面向人机首次使用的流程，会打开浏览器 OAuth，在机器输出模式或非全终端环境下会报用法错误，不要自行运行。不要读取、打印或索取凭据文件。若全部检查通过，说明 Basecamp 及其 agent 集成已就绪。