Anthropic发布Claude Code mods功能及入门教程

工具AI 评分 68/100Claude:Blog(网页) 等 2 家待复核
AI 聚合

本条为 AI 依据下方公开信源自动整理生成的摘要,不构成转载,可能存在偏差,请以原文为准。整理者:贝果科技 AI 资讯助手。

本条选题由第三方线索发现;线索方提供的摘要未被采用,本页内容依据下方信源整理。线索来源:AIHOT

Claude Code推出mods机制,允许通过JS/TS模块重写或替换其行为并绘制自定义UI。mods以hooks形式内置于插件,在会话内运行并捕获所有事件。官方教程演示了从零构建约80行的Token Weather插件,用于在提示词上方实时展示上下文窗口预测,并介绍了Blast Radius与Replay Theater两个大型mod。该功能在2.1.287及以上版本默认开启,API可能随版本变动,加载时会将类型声明写入插件目录作为版本依据。

全文梳理

AI 摘要依据下方信源原文自动整理,非原文转载

mods 是什么

mods 是运行在 Claude Code 会话内的小型 JavaScript 或 TypeScript 文件,可以观察会话中发生的事情、改变 Claude Code 的行为,或者绘制自己的界面,终端和桌面应用都支持。它不需要先学会 API 就能试用:运行 claude,然后描述想要的 mod,在提示时允许热重载,mod 会在本轮结束时出现。Claude Code 原本已经允许通过设置、权限规则、斜杠命令、技能和状态行来调整行为,mods 走得更远,可以重写或替换 Claude Code 的功能,并绘制自定义界面。底层上,mods 是随插件一起分发的钩子,每一个都能在会话事件发生时看到它们。这让 mods 成为把 Claude Code 适配到个人工作方式的手段:可以加一个经常查看的读数,在让人紧张的指令前放一道守卫,或者按自己喜欢的阅读方式构建变更审查视图。

从零写一个 mod

教程从空文件夹开始构建一个名为 Token Weather 的 mod,它是在提示符上方绘制的上下文窗口实时预报,大约 80 行代码。随后还介绍了两个更大的 mod,Blast Radius 和 Replay Theater,用来展示 API 还能做什么。三个 mod 的完整代码放在 anthropics/claude-code-playground 中。使用需要 Claude Code 2.1.287 或更高版本,mods 默认开启,无需额外打开。API 可能在不同版本之间变化,每次 Claude Code 加载 mod 时,会把构建所需的类型声明写入该 mod 的 .claude-plugin/types/ 文件夹,这些声明就是对应版本的权威依据。一个 mod 就是一个 Claude Code 插件,行为放在 JavaScript 或 TypeScript 模块里:文件夹是普通插件,带有 .claude-plugin/plugin.json 清单;hooks/hooks.json 在 modules 下指定一个模块;该模块导出 register(on, options),在其中用 on(event, matcher?, hook) 添加钩子,每个钩子形状相同。

事件与执行顺序

Claude Code 每次做一件事都会发出事件,例如调用工具、请求权限、绘制屏幕的一部分。mod 就是挂接到这些事件上的函数,可以在事件之前、之后运行,也可以代替事件运行,还能包裹事件,在前后都执行代码。借助一个函数,mod 可以:在提示词到达模型前重写它;阻止、重写或重试工具调用;批准或拒绝权限请求;在 Claude 读取工具输出前从中抹去机密信息。mod 也能改变看到的内容,可以编辑或替换 Claude Code 绘制的部分界面,比如工具结果或 Claude 提出的问题,还能添加按钮和输入框,其他 mod 可以在按下时作出响应。目前 mod 可以面向终端、桌面应用或两者。多个 mod 挂接同一事件时,按加载顺序运行,最先加载的 mod 最先看到事件、最后拿到结果,因此可以叠加不同作者写的 mod。也可以用 Claude Code 来给 Claude Code 做 mod:让 Claude 创建一个 mod,它可以编写 TypeScript、安装并在会话中热重载。部分内置功能现在也以 mod 形式分发。

为什么值得看

mods赋予开发者深度定制Claude Code行为与界面的能力,从底层扩展了其作为开发工具的适用场景。

AnthropicClaudeAPI

信源2 家

  1. [1]Claude:Blog(网页)线索来自 AIHOTClaude Code 推出 mods,可用 TypeScript 函数改写提示词、替换内置功能
  2. [2]Anthropic:Claude.dev 开发者博客(RSS)线索来自 AIHOTClaude Code mods 入门教程:从零构建 Token Weather 上下文窗口预报插件

关键事实

  • mods是Claude Code插件内的JS/TS模块,以hooks形式运行,可重写行为或绘制自定义UI[1]

  • 官方教程演示构建约80行的Token Weather插件,用于实时预报上下文窗口[1]

  • mods功能在Claude Code 2.1.287及后续版本默认开启[1]

  • mod加载时会在.claude-plugin/types/目录写入类型声明作为版本依据[1]

相关 · 工具

本页内容由 AI 自动聚合公开信源生成,仅供了解行业动态参考,不构成任何投资或决策建议。如需引用请以原文出处为准。