Addy Osmani 讲解 Claude Code Mods 上手方法

Addy Osmani 发布 Claude Code Mods 上手指南。mods 是几周前在 Claude Code 中推出的功能，本质是运行在会话内的小型 JavaScript 或 TypeScript 文件，可以响应事件、修改 Claude Code 行为，或在终端和桌面应用中渲染自定义界面。作者强调无需先学 API，直接在 claude 会话中描述想要的 mod，批准 Claude 写出的文件并开启热重载，回合结束后即可看到效果。 技术层面，mods 是打包在插件中的 hooks，能观察会话内的工具调用、提示提交、回合起止、会话起止、斜杠命令执行以及 UI 每次渲染。hooks 像中间件一样串联，事件先经过自定义 hook 再交给 Claude Code 默认处理。hook 有三种动作：观察事件并记录结果、改写事件供后续 hook 使用、直接接管事件使默认行为不执行。与设置里的 shell hook 不同，mod 只加载一次并维护自身状态和 UI，还能回调 Claude Code 打开面板、启动进程或注册斜杠命令与工具。Claude Code 自身的 AGENTS.md 支持和 /diff 面板就是用 mods 实现的。 指南给出三个示例。Token Weather 在提示框上方显示上下文窗口占用百分比、已用 token 数、最近几轮变化的小图表和新增 token 数，并用天气图标表示占用程度。Blast Radius 拦截 rm -rf、git reset --hard、git clean、force push、数据库迁移等潜在危险命令，通过 dry run 生成报告并弹出 Proceed 或 Cancel 按钮，作者称其为安全网而非防火墙，因为只读命令文本，$(…)、别名和脚本仍可绕过。Replay Theater 在回合运行时监听所有 Edit 和 Write 调用，回合结束后可通过 /replay 查看每次编辑的 diff 和步骤列表，不阻塞编辑。 发布与安装方面，mod 就是 Claude Code 插件，放入 GitHub 仓库并附带 marketplace 文件即可发布，安装使用 /plugin marketplace add、/plugin install 和 /reload-plugins 三条命令。安全上，mods 不在沙箱中运行，拥有用户权限，可读取文件和密钥、启动进程、发起网络请求、批准工具调用，作者建议阅读源码、只安装可信作者的 mod，并可用 claude plugin validate 检查其挂钩内容。文末还列举了 Stack viewer、cc-stretch、Mindful Claude、RemCTL 等社区 mod。