把 Claude Code 的系统提示词拆开看:Piebald-AI/claude-code-system-prompts 仓库能给你什么
Claude Code 系统提示的所有部分、27 个内置工具说明、子代理提示(计划/探索/任务)、实用程序提示(CLAUDE.md、compact、statusline、magic docs、WebFetch、Bash cmd、安全审查、代理创建)。针对每个克劳德代码版本进行了更新。
秒懂
- 它是什么?
- 这个仓库提取了 Claude Code 每个版本的全部系统提示词,共 515 个字符串,并附有跨 274 个版本的变更日志。它适合想理解、定制或审计 Claude Code 行为的开发者,但它的维护节奏和用途都有明确边界。
- 适合谁用?
- 如果你需要知道 Claude Code 在某个版本里到底怎么指示子代理、怎么压缩对话、怎么生成 CLAUDE.md,这个仓库是目前最直接的来源。它适合提示词工程师、安全审计者,以及想用 tweakcc 做本地定制的开发者。
- 能商用吗?
- 可以。MIT 是宽松许可证:你可以使用、修改并销售基于它的软件,只需保留版权和许可证声明。
- 还在维护吗?
- 在维护。仓库最近一次提交在 3 天前。
- 用什么语言写的?
- 主要是 JavaScript(依据 GitHub 的语言统计)。
以上回答依据项目的 GitHub 数据(最近同步于 2026年9月14日)和我们的分析,不构成法律意见。
开源项目深度解析
一个把黑盒提示词摊开的仓库
Claude Code 是一个闭源的命令行编程助手,它的行为由一整套系统提示词控制。但这些提示词藏在编译后的 JavaScript 文件里,普通用户看不到。Piebald-AI/claude-code-system-prompts 这个仓库做的事情很简单:用脚本从 npm 发布的 Claude Code 包中提取出所有系统提示词,按类别整理成 markdown 文件,并附上每个提示词的 token 数。截至 v2.1.251,它收录了 515 个提示词字符串。这个数字比之前的 350 个多了 165 个,说明覆盖范围在持续扩大。仓库的 README 明确说,这些提示词直接从编译源码中提取,因此保证与 Claude Code 实际使用的内容一致。对想了解 Claude Code 内部机制的人来说,这是一份难得的原始材料。
提示词不是一条,而是五百多条
仓库的核心观点是:Claude Code 并不只有一个系统提示词。它有一个庞大的主提示词,还有大量根据环境、配置、工具和子代理条件性添加的片段。比如 Explore 子代理的提示词有 862 个 token,Plan 模式的增强版有 1066 个 token,状态行设置代理的提示词高达 3646 个 token。这些数字差异很大,说明不同子代理承担的任务复杂度不同。仓库把提示词分成几类:子代理提示词、创建助手提示词、斜杠命令提示词,以及各种工具描述。例如 /code-review 命令被拆成了至少十个部分,每个部分对应一个阶段,从 base finder angles 到 ReportFindings 输出格式。这种拆分方式反映了 Claude Code 内部如何组织复杂的多阶段任务。
提取方式与 tweakcc 的关系
仓库的提取脚本从 npm 版本的 Claude Code 中抓取字符串,因此它反映的是官方发布的内容。README 提到,如果你想修改某个提示词,可以使用同一团队开发的 tweakcc 工具。tweakcc 允许你把提示词当作 markdown 文件来编辑,然后修补本地安装的 Claude Code,无论是 npm 版还是原生二进制版。它还提供 diff 和冲突管理,处理你与 Anthropic 对同一文件的不同修改。这意味着这个仓库不仅是展示,它还是 tweakcc 的工作基础。但要注意,仓库本身只提供静态文本,不提供任何修改功能。如果你只想改提示词,应该直接去看 tweakcc 仓库,而不是这里。
token 数只是近似值,别当精确度量
每个提示词文件都标注了 token 数,但 README 明确提醒:有些提示词包含插值部分,比如工具名称引用、可用子代理列表、上下文变量。这些变量在真实会话中会变化,所以实际 token 数会略有不同,但差异通常不超过 ±20 个 token。这个误差范围对大多数用途来说可以接受,但如果你在做严格的 token 预算分析,需要自行考虑这个浮动。另外,token 数本身不是质量指标。一个 105 token 的提示词可能比一个 3646 token 的提示词更关键,比如 /code-review 的 gap sweep 阶段只有 105 token,但它在整个审查流程中承担补漏任务。
变更日志的价值与局限
仓库附带一个 CHANGELOG.md,记录了从 v2.0.14 到 v2.1.251 共 274 个版本的提示词变化。这个日志是理解 Claude Code 如何演进的关键材料。比如你可以看到某个版本的 /code-review 提示词如何调整了发现缺陷的最低数量,或者 Plan 模式如何增强了推理步骤。但日志只覆盖仓库维护者记录的变化,不保证包含每个版本的全部细节。而且日志是文本形式的,如果你想对比两个版本的完整提示词差异,需要手动 diff 文件。仓库没有提供自动化的版本对比工具,这算是一个功能缺口。
谁该用,谁不该用
这个仓库适合三类人。第一类是提示词工程师,他们需要参考 Anthropic 如何编写子代理指令。第二类是安全审计者,他们想检查 Claude Code 是否在提示词中隐藏了不想要的行为。第三类是 tweakcc 用户,他们需要先了解原始提示词才能做定制。不适合的人也很明确:普通 Claude Code 用户,他们只需要使用 /init 或 /code-review 命令,不需要看底层文本。这个仓库对这类人没有直接帮助,反而可能造成信息过载。另外,如果你在寻找一个可以交互查询提示词的界面,这里也没有,只有静态 markdown 文件。
维护节奏与许可的实际情况
仓库的更新非常频繁,最近一次推送在 2026 年 8 月 28 日,同一天发布了 v2.1.251、v2.1.250 和 v2.1.248 三个版本。这意味着维护者几乎在 Claude Code 每次发布后都立即更新。这种节奏对依赖最新提示词的用户很友好,但也带来一个问题:你需要频繁拉取更新才能保持同步。仓库采用 MIT 许可,这意味着你可以自由使用、修改和分发提取的文本。但要注意,这些提示词本身是 Anthropic 的产品内容,MIT 许可只覆盖仓库的整理和提取工作,不改变 Anthropic 对原始内容的权利。如果你打算商用这些提示词,需要自行评估法律风险。
一个替代方案:自己从 npm 包提取
如果你不想依赖这个仓库,可以自己从 npm 包中提取提示词。Claude Code 的 npm 包是公开的,你可以下载特定版本,然后用字符串搜索或正则表达式在 minified JS 文件中找到提示词。这个方法的优点是你可以精确控制提取范围,只提取你关心的部分,而且不依赖第三方维护。缺点是工作量大,因为提示词被压缩和拆分,手动提取容易出错。相比之下,这个仓库已经帮你完成了提取和分类,而且有 token 数标注,节省了大量时间。另一个替代方案是使用 tweakcc,它不仅能提取,还能修改和打补丁,但它的主要用途是定制,不是查看。
编辑结论
如果你需要知道 Claude Code 在某个版本里到底怎么指示子代理、怎么压缩对话、怎么生成 CLAUDE.md,这个仓库是目前最直接的来源。它适合提示词工程师、安全审计者,以及想用 tweakcc 做本地定制的开发者。不适合只想用 Claude Code 写代码的人,因为这里没有使用教程,只有静态文本。采用前先确认三件事:你关注的版本是否在仓库覆盖范围内,仓库的更新频率是否跟得上你使用的 Claude Code 版本,以及你是否接受它由 Piebald 团队维护,而该团队同时推销自己的产品。仓库本身是 MIT 许可,但提取的提示词属于 Anthropic 的产品内容,商用前需要自行判断。最终判断:它是一份高保真的参考快照,不是运行时工具,它的价值在于让你看清 Claude Code 的提示词结构,而不是替代 Claude Code 本身。
社区笔记