buildwithclaude:一个把 Claude Code 插件生态收拢进单一命令行的集市
一个单一的中心,用于查找 Claude 技能、代理、命令、挂钩、插件和市场集合,以扩展 Claude Code、Claude Desktop、Agent SDK 和 OpenClaw。
秒懂
- 它是什么?
- buildwithclaude 是一个面向 Claude Code 的插件市场与发现平台,聚合了代理、命令、钩子、技能和外部市场。它用一条 marketplace 命令打通安装流程,但内容的维护方式和社区插件的质量参差是需要先看清的边界。
- 适合谁用?
- 如果你正在用 Claude Code,并且厌倦了从 GitHub 散落仓库里手动复制 .md 文件到 ~/.claude 目录,buildwithclaude 值得试。它把 117 个代理、175 个命令、28 个钩子打包成可搜索、可一键安装的 marketplace,省去大量整理时间。
- 能商用吗?
- 可以。MIT 是宽松许可证:你可以使用、修改并销售基于它的软件,只需保留版权和许可证声明。
- 还在维护吗?
- 在维护。仓库最近一次提交在 2 天前。
- 用什么语言写的?
- 主要是 TypeScript(依据 GitHub 的语言统计)。
以上回答依据项目的 GitHub 数据(最近同步于 2026年9月14日)和我们的分析,不构成法律意见。
开源项目深度解析
它解决的是发现与安装的碎片化问题
Claude Code 的扩展机制分散在多个位置:代理文件放在 ~/.claude/agents,命令放在 ~/.claude/commands,钩子又是另一套目录。社区里每个作者各自维护仓库,格式不统一,发现成本很高。buildwithclaude 把这三类内容统一收进一个 marketplace,配合 Claude Code 自带的 /plugin 命令,把安装动作压缩成一条指令。它面向的是已经用上 Claude Code、但觉得手动复制文件太繁琐的工程师。对于只是偶尔用一下 CLI 的人,这个项目的价值有限,因为你要先理解插件机制本身。
目录结构就是它的数据模型
仓库的组织方式直接反映了插件的格式约定。代理放在 plugins/agents-*/agents/*.md,命令在 plugins/commands-*/commands/*.md,钩子在 plugins/hooks-*/hooks/*.md。每个文件头部有 YAML front matter,代理需要 name、description、category、tools 字段,命令需要 description、category、argument-hint,钩子需要 hooks 字段声明触发事件,比如 PreToolUse、PostToolUse。这个结构意味着,任何新插件只要遵循同样的 front matter 约定,就能被 marketplace 索引。README 里没有说明是否有 schema 校验,但 CONTRIBUTING.md 的存在暗示提交前有测试门槛。这种设计把扩展点建立在纯文本文件上,简单,但也就没有版本管理和依赖解析。
安装方式:一条 marketplace 命令,或手动复制
官方推荐的方式是把它当作 Claude Code 的插件市场来添加。在 Claude Code 会话里执行 /plugin marketplace add davepoon/buildwithclaude,然后就能用 /plugin search @buildwithclaude 浏览,用 /plugin install <plugin-name>@buildwithclaude 安装具体项。仓库还提供了批量安装入口,比如 /plugin install all-agents@buildwithclaude 会装下全部 117 个代理。另一种方式是手动克隆仓库,用 find 命令把 .md 文件复制到本地配置目录。比如 find plugins/agents-*/agents -name "*.md" -exec cp {} ~/.claude/agents/ \; 这条命令会把所有代理文件拷过去,然后重启 Claude Code。手动方式适合不想引入 marketplace 依赖的环境,但会丢失后续更新的便利。
内容规模与分类:数字背后是整理成本
README 列出的数字很具体:117 个代理、175 个命令、28 个钩子、26 个技能、51 个插件包,这些是仓库内维护的精选集合。分类也细,代理按语言、领域、质量安全、基础设施等分成 11 类,命令按版本控制、代码分析、文档等分成 22 类。社区发现部分则索引了 20k+ 外部插件、4,500+ MCP 服务器、1,100+ 市场。这个差距值得注意:仓库自带的精选内容有明确的目录和格式约束,而社区索引只是链接聚合,没有质量审核。对使用者来说,搜索结果是混在一起的,你需要自己分辨哪些是经过维护的,哪些只是被收录。
一个真实的局限:批量安装可能带来混乱
README 提供了 all-agents、all-commands、all-hooks 这样的批量安装选项。听起来方便,但想想后果:117 个代理文件一次性进入 ~/.claude/agents,你的会话上下文里会多出大量可能互相冲突的 agent 定义。代理的调用机制是根据描述自动触发,或者用 @agent-name 显式调用,装得太多,自动触发的准确性会下降。命令同理,175 个斜杠命令塞进命令面板,查找成本反而上升。这个项目没有提供依赖隔离或命名空间机制,安装粒度完全由用户自己控制。对于只想用几个精选命令的人,批量安装是反模式。
替代方案:直接维护自己的插件目录
不借助这个 marketplace,你依然可以手动管理 Claude Code 的扩展。做法是建立自己的目录,比如 ~/.claude/agents 和 ~/.claude/commands,然后从 GitHub 上挑选单个插件仓库,复制所需的 .md 文件。差别在于:buildwithclaude 提供搜索和统一安装入口,但内容来源混杂;手动方式完全可控,但需要你自己跟踪每个插件的更新。另一个相关项目是 Vexilo,README 里提到它提供了 31 个代理、99 个命令、123 个技能的交互式索引,按 5 步工作流组织。Vexilo 更偏向可视化浏览和教学,buildwithclaude 更偏向直接安装。两者互补,但如果你只需要少量插件,手动维护可能更干净。
维护成本与许可证
项目以 MIT 许可证发布,这意味着你可以自由使用、修改甚至重新分发,前提是保留版权声明。仓库最近一次推送是 2025 年 10 月,bwc-cli 发布了 1.2.4 版本,说明 CLI 工具在持续迭代。但注意,CLI 版本号只代表工具本身,不代表仓库内插件内容的更新频率。插件的维护依赖社区贡献,CONTRIBUTING.md 要求新插件遵循命名约定并运行 npm test,但没有迹象表明有持续的质量审查机制。这意味着,你安装的某个代理可能几个月没更新,而 Claude Code 的 API 可能已经变化。升级成本在于,你需要在每次 Claude Code 更新后验证已安装插件是否仍然工作,这个项目没有提供自动兼容性检查。
编辑结论
如果你正在用 Claude Code,并且厌倦了从 GitHub 散落仓库里手动复制 .md 文件到 ~/.claude 目录,buildwithclaude 值得试。它把 117 个代理、175 个命令、28 个钩子打包成可搜索、可一键安装的 marketplace,省去大量整理时间。但如果你需要的是经过严格审核、版本锁定、带维护承诺的插件源,这个项目不满足。它的社区插件索引达 20k 以上,但 README 没有给出任何质量筛选机制,安装前必须自己查看插件源码和文档。另外,MCP 服务器数量标注为 4,500+,但仓库本身不托管这些服务器,只是索引链接,实际可用性取决于外部源。首次使用前,建议在隔离环境里运行 /plugin marketplace add davepoon/buildwithclaude,然后逐个安装你需要的插件,而不是执行 /plugin install all-agents@buildwithclaude 一次装完。这个项目是生态的入口,不是生态的保证。
社区笔记