Claude Code Mod 终极指南：从零安装到手搓，彻底玩转魔改！- 大数跨境

首页

Claude Code Mod 终极指南：从零安装到手搓，彻底玩转魔改！

AI信息Gap

2026-10-05

导读：GTA 6 还没出，Claude Code 先有 Mod 了！

Claude Code 正式支持 Mod（模组）功能。

通过 Mod，用户可自定义 Claude Code 的行为、界面及内置功能。例如，利用终端指令即可生成「额度状态栏」，实时显示用量、重置时间及上下文占用情况，并在用量超限时变色预警。

10 月 2 日，Anthropic 官宣该功能。目前，开发者已实现运行 Doom、超级马里奥等游戏。甚至官方内置的 /diff 面板也已转化为 Mod 形式，支持停用或替换。

Mod 的核心定义与差异

Mod 是挂载在 Claude Code 事件流上的 JavaScript 或 TypeScript 函数。与其他扩展机制相比，Mod 的最大优势在于它是原生组件，可直接修改界面。

	Mod	Hooks	Skill	MCP
本质	进程内运行的插件函数	配置文件中的外部脚本	供模型阅读的 Markdown 说明书	提供工具的外部程序或服务
能力范围	工具调用、提示词、命令、对话轮次、界面元素	拦截或修改工具调用及提示词参数	增强模型的知识与操作能力	扩展可用工具集
界面修改	支持	不支持	不支持	不支持
开发语言	JavaScript / TypeScript	任意脚本语言	Markdown	任意语言

左滑查看更多

注意：Mod 无法修改「权限确认框」的显示内容。版本需不低于 2.1.287。CLI 和桌面端支持完整界面修改；VS Code 扩展及云端会话中，逻辑正常但界面改动不显示。

官方推荐的三款 Mod

Token Weather：上下文晴雨表

在输入框上方显示上下文用量、Token 消耗及最近对话的趋势图。根据用量百分比显示不同天气图标（晴天、多云、雷雨等），并在接近限制时发出压缩提醒。

Blast Radius：爆炸半径防护

针对 rm -rf、git reset --hard 等高危命令进行拦截。执行前列出受影响文件列表及大小，需用户确认后方可继续，有效防止误删。

Replay Theater：变更回放

记录单轮对话中的所有文件修改。通过 r 键或 /replay 命令逐步回放改动，便于审查多文件批量修改的结果。

Mod 安装与配置指南

环境准备

1. 检查版本：终端运行 claude --version，确保版本号 ≥ 2.1.287。

2. 验证加载：在空文件夹运行 claude plugin test。若输出包含 no hooks module to load 则正常；若提示关闭，需检查本地设置或公司策略。

安装官方示例

1. 克隆仓库：

git clone https://github.com/anthropics/claude-code-playground.git
cd claude-code-playground/claude-code/mods

2. 代码体检（可选但推荐）：

claude plugin validate ./token-weather

3. 临时加载测试：

claude --plugin-dir ./token-weather

4. 永久安装：

claude plugin marketplace add ./
claude plugin install token-weather@claude-code-playground-mods --scope user

注意：本地插件市场依赖源文件夹，请勿删除。可通过 /plugin 菜单管理已安装的 Mod。

利用 AI 自动生成 Mod

无需精通代码，只需向 Claude Code 描述需求。系统将调用内置技能 plugin-authoring ，自动查询接口文档并生成代码。

提示词示例：

帮我做一个名为 quota-meter 的 Mod，在提示框上方显示额度状态栏。
需显示：5小时额度使用率及重置时间、周额度使用率及重置时间、当前上下文使用率。
颜色规则：<50%绿色，50%-80%黄色，>80%红色。
每轮对话后刷新，界面文字使用中文。

生成过程中，Claude 会自动处理主题适配（如颜色名称转换）并询问是否开启热重载。完成后，Mod 将保存至 ~/.claude/dev-mods/，建议复制至个人目录以便长期保留。

手动开发基础示例

Mod 由 plugin.json、hooks.json 及代码文件组成。以下是一个统计工具调用次数并显示在加载动画后的简易 Mod：

// 计数器初始化
let calls = 0

export function register(on) {
  // 监听工具调用事件
  on('tool.call', async ($, e, next) => {
    calls += 1
    $.ui.invalidate('ui.render') // 触发界面刷新
    return next(e)
  })

  // 监听 Spinner 渲染事件
  on('ui.render', { component: 'Spinner' }, async ($, e, next) => {
    return next({ ...e, props: { ...e.props, suffix: ' · tool calls: ' + calls + '…' } })
  })
}