claude-code-system-prompts
Claude Code 系统提示词的完整开源文档库,200+ Markdown 文件拆解 AI 编程
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
Claude Code 系统提示词的完整开源文档库,200+ Markdown 文件拆解 AI 编程
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
图1:Piebald AI 组织头像
2025 年底,一位开发者试图理解为什么 Claude Code 在某些场景下表现异常——代码补全时偶尔"文不对题",Plan 模式下给出的建议不够精准。他翻遍了 Anthropic 的官方文档,却发现关于 Claude Code 内部运作机制的描述少之又少。
这不是他的个人困境。随着 Claude Code 从 v2.0.14 迭代到 v2.1.156(2026 年 5 月),累计发布 191 个版本,无数开发者在社区里追问同一个问题:Claude Code 到底是怎么"思考"的?
Piebald-AI/claude-code-system-prompts 正是为回答这个问题而生——它将 Claude Code 内部的系统提示词全部提取出来,以 Markdown 文件的形式公之于众,让每一个好奇的开发者都能窥见这个 AI 编程助手的"思维操作系统"。
项目由 Piebald AI 组织维护,这是一个专注于 AI 开发者体验的团队。他们独立于 Anthropic,通过脚本从 Claude Code npm 包的编译后 JavaScript 源码中提取系统提示词。
官方仓库地址于 2025 年 11 月 18 日创建,不到半年时间已积累超过 10,500 颗星 和 1,800 次 fork,成为 Claude Code 生态中最受关注的第三方资源之一。更新速度极快——每个新版本发布后数分钟内,仓库中的提示词文档就会同步更新,并生成对应的 CHANGELOG.md 变更记录。
这种近乎"实时同步"的维护方式,使得该项目成为研究 Claude Code 行为模式的权威资料来源。
Claude Code 绝非只有一个"系统提示词"。它实际上由 110+ 个独立的字符串片段组成,这些片段根据不同场景动态拼接。以下是项目整理出的完整分类体系:
这是 Claude Code 的核心行为准则层,包含多个文件:
system-prompt-autonomous-loop-check.md:自主循环执行检查逻辑system-prompt-coordinator-mode-orchestration.md:协调者模式的编排指令(约 14KB,是最大的单个文件之一)system-prompt-executing-actions-with-care.md:谨慎执行操作的行为准则system-prompt-learning-mode.md:学习模式的行为定义system-prompt-doing-tasks-software-engineering-focus.md:软件工程导向的任务执行原则Claude Code 内部运行多个专用子 Agent,每个 Agent 都有独立的提示词:
这是整个仓库中最精细的子模块,覆盖代码审查的不同力度:
这套设计展现了 Claude Code 对代码审查任务的深度理解——它不是一个简单的 diff 工具,而是一个经过精心设计的"AI 评审员",能够根据投入时间(审查力度)动态调整分析深度。
每个内置工具都有详细的提示词定义,确保 Claude Code 知道何时、如何调用该工具:
tool-description-write.md:文件写入工具tool-description-bash-*.md:Bash 执行相关(22+ 个子文件,涵盖沙箱、超时、权限等细节)tool-description-webfetch.md:网页抓取工具tool-description-skill.md:技能加载工具tool-description-workflow.md:工作流编排工具(约 19KB,最复杂的工作流定义)这些是 Claude Code 运行时注入上下文信息的模板:
data-claude-api-reference-python.md:Python API 参考(16KB+)data-claude-api-reference-typescript.md:TypeScript API 参考data-managed-agents-*.md:托管 Agent 生态的完整 API 文档(约 10+ 个文件,覆盖端点、事件、内存存储、多 Agent 会话等)data-tool-use-concepts.md:工具使用概念(17KB+)data-prompt-caching-design-optimization.md:提示词缓存设计优化指南data-claude-model-catalog.md:Claude 模型目录Claude Code 支持通过技能(Skills)扩展能力,项目中记录了关键技能的提示词:
skill-building-llm-powered-applications-with-claude.md(34KB):用 Claude 构建 LLM 应用的核心技能skill-model-migration-guide.md(83KB):模型迁移指南——这是整个仓库中最大的单个文件skill-init-claudemd-and-skill-setup-new-version.md:CLAUDE.md 和技能初始化skill-create-verifier-skills.md:验证技能创建skill-debugging.md:调试技能2026 年 1 月新增,约 40 个系统提醒,覆盖会话管理、上下文处理、安全限制等运行时细节。
如果说 Claude Code 是一个 AI 编程机器人,那么这个仓库就像它的出厂说明书——只不过不是一份文档,而是 200+ 份文件,详细描述了机器人的每一个零件、每一条行为规则。
一个具体场景:当你输入 /code-review 时,Claude Code 实际在做的是:
整个过程由 5-9 个独立提示词动态组合,构成了一个完整的多阶段 AI 代码审查流程。
这是一个文档仓库,不是可执行软件。 它包含 200+ 个 Markdown 文件,每个人都可以:
system-prompts/ 目录下按文件名查找对应提示词无需 Docker、无需 GPU、无需服务器——这可能是你在 PIFS 上见过的最低门槛的"AI 项目"。
虽然不是可部署软件,但仓库本身有一些值得注意的技术细节:
提取方式的灰色地带:Anthropic 并未官方支持这种提取方式,存在政策变化风险。2026 年 1 月新增 System Reminders 后,项目也进行了紧急适配。
不保证实时性:虽然更新速度极快,但仍可能存在极短暂的版本差。
法律地位未明确:系统提示词是否受版权保护,AI 社区尚无定论。Anthropic 官方未认可该项目,但截至目前未采取任何阻止措施。
仅供研究参考:修改本地提示词(通过 tweakcc)可能导致 Claude Code 行为异常,不建议生产环境使用。
这个项目的意义超越了技术本身。它代表了一种新兴趋势:当 AI 模型的"行为层"(系统提示词)变得越来越复杂、越来越重要时,开源社区开始尝试将其透明化、可审计化。
类似的趋势也出现在其他 AI 产品生态中——人们开始意识到,系统提示词是 AI 产品体验的核心竞争力之一,其设计质量直接影响最终用户的使用感受。Piebald-AI 的这个项目,为整个 AI 编程工具领域提供了一份珍贵的研究素材。
项目地址:https://github.com/Piebald-AI/claude-code-system-prompts
维护者:Piebald AI(独立于 Anthropic)
最新版本:Claude Code v2.1.156(2026-05-28)
Star 趋势:自 2025-11 创建以来,持续增长中