hamzafer/claude-code-mods

解决的问题

Claude Code (Anthropic 的终端编码代理) 的内部运作通常是不可见的。本项目提供了一系列可选插件，让 Claude Code 的行为变得可视化：在提示符上方显示实时状态行、展示代理活动的面板、破坏性命令前的警告，甚至还有打发时间的小游戏。它解决了你无法了解上下文占用情况、子代理在做什么、审查何时完成，或者是否即将执行删除文件的危险命令等问题。

工作原理

这些插件基于 Claude Code 的函数钩子构建——这些钩子会在工具调用、提示发送和会话生命周期等事件触发时运行。每个“mod”都是一个可以单独安装的小插件。项目包含一个安装程序 (npx claude-code-mods@latest)，它会显示可用 mod 的清单，让你选择要启用的项目，并将其安装到你的 Claude Code 配置中。你还可以通过简单的界面对“bands”（提示符上方的实时行）进行排序。Mod 通过 Claude Code 的市场系统作为插件安装，部分 mod 需要额外的工具（例如用于图像渲染的 Chrome，或用于 GitHub 功能的 gh）。

适用人群

在终端使用 Claude Code 并希望对会话拥有更高透明度和控制权的开发者。它非常适合那些想要查看上下文使用情况、监控子代理、防范破坏性命令，甚至在等待时增加娱乐性的用户。该项目面向熟悉终端和 Claude Code 的用户，并包含由其他作者维护的社区 mod。

亮点

• 实时状态行 (例如 context-bar, token-weather, cache-clock) 在提示符上方显示上下文使用情况、token 缓存和会话成本。
• mission-control 提供了一个实时面板，映射子代理、工具调用及其操作的文件。
• blast-radius 会拦截诸如 rm -r 和强制推送等危险命令，在执行前显示将被删除的内容。
• switchboard 自动将子代理路由到更便宜的模型 (例如从 Claude Opus 到 Haiku)。
• 有趣的 mod，如 reels (YouTube Shorts)、snake 和 now-playing (Spotify)，在 Claude 工作时提供娱乐。
• 社区 mod 增加了图像预览、中文本地化以及拥有约 2,700 个 mod 的 mod 商店等功能。
• 安装程序允许你精确选择要启用的 mod，并提供 --dry-run 和 --pick 选项以实现自动化。