react-doctor 官方入口：Codex/Claude Code React 审查工具安装指南

刚打开 React Doctor，最容易冒出的疑问是：我要装的是 React 扫描器，还是给 Codex、Claude Code 用的技能？答案是两层都要分清——扫描器负责找问题，代理技能负责提醒编码代理在改动前后调用扫描器。

先确认你拿到的是官方项目

官网域名是 react.doctor，npm 包名是 react-doctor，GitHub 仓库是 millionco/react-doctor。我会先在 React 项目根目录执行 npx react-doctor@latest --verbose --scope changed，确认终端能识别项目并返回诊断，再碰代理安装。这样即使后续技能没有被代理读取，也能判断扫描器本身是否正常。

Codex 与 Claude Code 走同一条主线

官方安装器会探测本机支持的编码代理，再询问把技能装到哪里。Codex 和 Claude Code 都从同一条命令开始：

npx react-doctor@latest install

我会在真正写入前先看终端列出的代理与目标位置，不凭经验手动复制目录。若电脑同时装着多个代理，就只勾选准备使用的目标；--yes 会给所有检测到的代理安装，适合明确知道机器环境时使用。

我会先预演，再真正写入

担心安装器改动不透明，可以先运行 npx react-doctor@latest install --dry-run。预演只展示计划，不写文件；核对后再去掉 --dry-run。这一过程没有要求配置 API Key。安装成功后，代理拿到的是“何时运行 React Doctor、怎样复查改动”的工作说明，不是另起一个云端账号。

钩子不是所有代理都有

--agent-hooks 需要单独理解：官方当前只把原生代理钩子列给 Claude Code 与 Cursor，它能在代理编辑文件后回送诊断。Codex 支持编码代理技能，但不要把它写成已支持同一种原生钩子。我会让 Codex 按技能在任务末尾主动执行 changed 扫描；给 Claude Code 开钩子前，则先评估额外上下文与运行频率。

装完别急着关终端

我会给代理一个很小的 React 改动，让它完成后运行 npx react-doctor@latest --verbose --scope changed，并要求返回规则名、文件位置与复查结果。只看到“安装完成”不算验证；代理能在改动后主动体检，修复后同一条诊断消失，才说明技能进入了实际工作流。若没有触发，先重新运行安装器核对检测目标，再检查代理当前会话是否读取了新技能。