YeonwooSung/my-claude-code-mods
Custom Claude Code Mods that I need
My Claude Code Mods – 简介
这是一系列用于 Anthropic 代码助手环境 Claude Code 的插件（称为“mods”）。每个插件都增加了一个小型 UI 或诊断功能，帮助开发者在编码会话期间理解并控制 Claude 的行为。
各个插件
| 插件 | 功能（通俗解释） |
|---|---|
| agent‑profiler | 显示会话时间消耗在何处——等待模型、运行工具、调用子代理或重新读取代码。它还可以导出 OpenTelemetry 追踪数据，供你在 Jaeger 或 Tempo 中查看。 |
| context‑inspector | 分析 Claude 如何使用提示词窗口：窗口中填充了什么文本、重新读取的频率、是否产生近乎重复的输出以及哪些部分被压缩。它随后会给出减少上下文浪费的建议。 |
| time‑machine | 在分支时间轴上记录每次工具调用，并在每一步后对文件系统进行“shadow‑git”快照。你可以回退到任何步骤、查看哪个编辑破坏了测试、恢复文件、创建分支、比较运行结果或重放步骤。 |
| loop‑detective | 监视重复的 Bash 失败和编辑重试循环。当发现循环时，它会提供证据、提示进行调查，并显示带有边界历史记录的实时案例面板。 |
| pin‑memo | 允许你在输入框上方固定笔记和可点击的 TODO。当你重新打开同一个文件夹或会话时，笔记会自动恢复。 |
| model‑effort‑band | 在提示词上方绘制一个彩色带，指示当前选定的模型以及模型正在使用的主线程工作量，提供工作负载的快速视觉提示。 |
如何获取
- 添加 Claude Code Mods 市场（参见 README 中链接的官方文档）。
- 通过市场安装你需要的任何插件——每个插件的 README 都包含确切的命令。
- 运行 Claude Code 时，使用
--plugin-dir加载插件（或通过 UI 启用）。可以禁用其他已安装的插件以进行纯净的基准测试。
开发与测试
- Node 版本 – 需要 Node 22.19.0 或更高版本。
- 依赖项 – 锁定在
package-lock.json中。 - 测试命令：
npm ci --ignore-scripts– 安装确切的依赖。npm test– 运行不需要 Claude 安装的核心逻辑测试。CLAUDE_BIN=/path/to/claude npm run test:adapters– 运行完整的引擎套件，包括与 Claude 通信的适配器。npm run typecheck– 根据本地生成的引擎声明检查 TypeScript 类型。
- README 中的兼容性矩阵显示了每个插件已验证的 Claude Code 版本（主要是 2.1.292，包含一些早期访问说明）。
- UI 相关测试与核心单元测试套件分离；它们需要交互式运行。
性能基准测试（如所述）
README 建议进行受控实验：
- 选择一个固定提交的大型仓库。
- 在四种配置下运行相同的工作负载：无插件、仅分析器、仅时间机器和全部三个。
- 使用
--plugin-dir显式加载插件并禁用其他插件。 - 预热后，每种配置至少执行五次测量运行，交替顺序。
- 记录挂钟时间、工具调用次数、模型 Token 使用量和平均快照成本。
- 报告中位数和 95% 分位数值，将纯模型延迟与快照/钩子的开销分开。
适用人群
- 依赖 Claude Code 进行代码生成，并希望了解模型延迟、上下文使用或工具调用历史的开发者。
- 需要可重现性（time‑machine）或希望捕获 Bash 脚本中无限循环错误的团队（loop‑detective）。
- 喜欢在编码会话中保留快速笔记的人（pin‑memo）。
总结
My Claude Code Mods 是一个小型、专注的工具箱，通过诊断、历史记录跟踪和 UI 辅助功能扩展了 Claude Code。该仓库提供了源代码、基于 Node 的测试工具以及通过官方 Claude Code 市场安装每个插件的清晰说明。这是一个旨在改善使用大语言模型编码助手时开发者体验的真实 AI 相关软件项目。
相关
- 项目
- 项目
- 项目
- 项目