← 返回列表

新工具 GitHub · YeonwooSung/my-claude-code-mods

用 Claude Code Mods 给会话加上环境体检命令（env-doctor）

下载 my-claude-code-mods，用 --plugin-dir 临时加载其中的 env-doctor，在一个有 package.json 的项目里运行 /env-doctor check，得到 Node 与包管理器版本是否满足项目要求的报告。

开始尝试

效果

本站验证时的实际输出（Windows 11）：“env-doctor: Env Doctor — presence only; no environment values retained / node: UNKNOWN (binary unavailable) / npm: 12.0.2 — MISMATCH 11.0.0”。其中 node 一项与本机实际不符。

这是什么

新在哪里：以前给 Claude Code 加功能主要靠 Skill、MCP 或钩子脚本；Claude Code 2.1.287 起默认开启 Mods，扩展可以直接给会话加面板、提示栏和命令。这个仓库在 2026-10-09 起公开了 17 个 Mod，env-doctor 是其中不调用模型、只读环境的一个。

怎么做到的：Mod 是一种 Claude Code 插件，带一个钩子模块（register.ts）。用 claude --plugin-dir <目录> 临时加载，不必安装到用户配置。env-doctor 读取 package.json 的 engines 与 packageManager，检查本机 node、npm 等版本，并只报告环境变量“有/无”，不保存取值。命令结果直接以文本返回，不消耗模型调用。

适合谁
常用 Claude Code、想试 Mods 扩展的开发者
能帮你
不耗模型额度的环境自检命令

评分 三项分开看，不合成总分；热度不等于好用

新颖性
老工具新用法 · 2026-10-09Claude Code 2.1.287 起默认开启 Mods；仓库 2026-10-09 创建
热度
未知
易上手
需要一些准备本站 2026-10-18 Windows 验证：node 检测与实际不符
怎么评的

三项都由本站记录的事实按固定规则算出，编辑不能直接改档位；规则改动会写进更新说明。

新颖性

  • ●●● 全新做法，且有来源依据的出现时间在最近 30 天内
  • ●●○ 老工具新用法或近期刚开放，且有来源依据的时间在最近 30 天内
  • ●○○ 出现时间超过 30 天、未核实到精确日期，或已不再是新做法
  • 其他 出现时间未核实、晚于今天，或新颖类型未核实时按最低一档处理，不靠猜测加分

热度

  • ●●● 最近一次每周人工确认为“热门”：最近 14 天里独立讨论、实际案例、持续时间、传播平台、相对关注五项门槛全部满足（规则 heat-v1）
  • ●●○ 最近一次人工确认为“观察中”：前三项至少一项达到，或讨论增长 ≥ 50%，且至少 2 个独立案例
  • ●○○ 最近一次人工确认为“未进入跟踪”
  • 其他 还没有人工确认过的热度记录时显示“未知”。热度只统计本站已接入的信源，不代表全网

易上手

  • ●●● 准备门槛低且难度入门：不需要新账号或付费，首次尝试不超过 30 分钟，公开可用，会复制粘贴即可
  • ●●○ 准备门槛中等，或门槛低但需要改少量代码或配置
  • ●○○ 准备门槛高：需要商业软件或付费服务、首次尝试超过 2 小时、特殊硬件或网络、排队或邀请且无替代方案，或需要专业知识
  • 其他 只有介绍、还没有站内步骤，或关键步骤已失效时显示“暂不可试”；门槛未核实时显示“未核实”

怎么尝试

  • 时间 首次约 10 分钟
  • 费用 免费：免费（Apache-2.0）；env-doctor 不调用模型，需要已安装的 Claude Code
  • 账号 需要 Claude 账号
  • 环境 Claude Code 2.1.287 或更高（本站用 2.1.301）、Git
  • 准备 Claude Code 2.1.287 或更高：Mods 默认开启的版本
  • 准备 Git：下载仓库
  • 准备 有 package.json 的项目：env-doctor 读取 engines 与 packageManager

按下面的步骤就能做出第一个结果。复制命令不会自动执行。

  1. 确认 Claude Code 版本

    Mods 从 2.1.287 起默认开启。

    PowerShell原始来源命令 
    claude --version

    预期结果：版本号 ≥ 2.1.287。

  2. 下载仓库

    下载到任意位置，记下其中 env-doctor 文件夹的路径。

    PowerShell原始来源命令 
    git clone https://github.com/YeonwooSung/my-claude-code-mods.git

    预期结果：出现 my-claude-code-mods\env-doctor 文件夹，里面有 .claude-plugin\plugin.json。

  3. 在一个有 package.json 的项目里加载 env-doctor 并检查

    进入你的项目（或新建一个只含 package.json 的文件夹），用 --plugin-dir 临时加载这个 Mod，不会装到你的用户配置里。把路径换成上一步的实际位置。

    PowerShell原始来源命令 
    claude --plugin-dir <my-claude-code-mods 的路径>\env-doctor

    替换：<my-claude-code-mods 的路径> 换成第 2 步下载的位置

    预期结果：Claude Code 正常启动，输入 / 时能看到 env-doctor 命令。

  4. 运行检查

    在 Claude Code 里输入下面的命令。这个命令不调用模型，结果直接返回。

    Claude Code原始来源命令 
    /env-doctor check

    预期结果：返回以 “env-doctor: Env Doctor — presence only” 开头的报告，逐行列出 node、npm 与 package.json 要求是否一致。
    判断完成的方法：判断完成：node 一行显示本机版本（例如 v24.x）并标明是否满足 engines.node。本站在 Windows 上这一行显示 UNKNOWN，未达到这个结果。

原始来源：GitHub 仓库 my-claude-code-mods（README 与 env-doctor） ↗