Claude Code 系统提示词全景解析：打开 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 行为模式的权威资料来源。

---

核心价值：110+ 个提示词文件，拆解 AI 编程助手的每个思维模块

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：软件工程导向的任务执行原则

内置子 Agent 提示词

Claude Code 内部运行多个专用子 Agent，每个 Agent 都有独立的提示词：

• Plan 模式（715 tokens）：深度规划子 Agent，支持多阶段执行
• Explore 模式（575 tokens）：代码探索子 Agent，帮助理解陌生代码库
• Task 模式：任务执行子 Agent
• Status Line Setup：状态栏配置子 Agent（约 2,433 tokens）
• Onboarding Guide Generator：新用户引导生成器（约 4,855 tokens）

代码审查专项 Agent（9 个文件）

这是整个仓库中最精细的子模块，覆盖代码审查的不同力度：

• Part 1：基础发现角度（Base Finder Angles）——逐行 diff 扫描、移除行为追踪、跨文件追溯
• Part 2-7：六种审查力度模式（Low/Medium/High/Extra-High/Maximum）
• Part 4：三态验证阶段（Confirmed / Plausible / Refuted）
• Part 8：GitHub PR 内联评论自动发布
• Part 9：修复建议自动应用

这套设计展现了 Claude Code 对代码审查任务的深度理解——它不是一个简单的 diff 工具，而是一个经过精心设计的"AI 评审员"，能够根据投入时间（审查力度）动态调整分析深度。

工具描述提示词（27 个内置工具）

每个内置工具都有详细的提示词定义，确保 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，最复杂的工作流定义）

数据注入型提示词（Data Templates）

这些是 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 模型目录

技能定义（Skills）

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：调试技能

系统提醒（System Reminders）

2026 年 1 月新增，约 40 个系统提醒，覆盖会话管理、上下文处理、安全限制等运行时细节。

---

类比解释：像一个精密的"提示词乐高"

如果说 Claude Code 是一个 AI 编程机器人，那么这个仓库就像它的出厂说明书——只不过不是一份文档，而是 200+ 份文件，详细描述了机器人的每一个零件、每一条行为规则。

一个具体场景：当你输入 /code-review 时，Claude Code 实际在做的是：

1. 加载 Part 1 基础发现角度提示词
2. 根据你指定的审查力度（Low/Medium/High/Maximum），加载对应模式提示词
3. 调用验证阶段提示词（Part 4 或 Part 5）
4. 如需，调用 Part 8 发布评论提示词
5. 如需，调用 Part 9 修复应用提示词

整个过程由 5-9 个独立提示词动态组合，构成了一个完整的多阶段 AI 代码审查流程。

---

部署分析：为什么它是"零门槛"的参考资源

这是一个文档仓库，不是可执行软件。 它包含 200+ 个 Markdown 文件，每个人都可以：

• 直接 GitHub 浏览：打开仓库，在 system-prompts/ 目录下按文件名查找对应提示词
• 本地 Clone：将仓库克隆到本地，用任意文本编辑器或 Markdown 阅读器查阅
• 集成到工具：如果你在开发类似 Claude Code 的 AI 编程工具，可以参考这些提示词来设计自己的 Agent 系统
• 用 tweakcc 定制：项目推荐了一个配套工具 tweakcc，可以将这些提示词补丁应用到本地 Claude Code 安装中

无需 Docker、无需 GPU、无需服务器——这可能是你在 PIFS 上见过的最低门槛的"AI 项目"。

---

技术栈与代码架构

虽然不是可部署软件，但仓库本身有一些值得注意的技术细节：

• 主要语言：JavaScript（updatePrompts.js 提取脚本）
• 提取机制：通过 npm 包内的编译后 JS 源码进行正则提取，保证与实际运行版本完全一致
• 文件组织：按提示词类型分目录（system-prompts/、tools/），每个文件含 YAML frontmatter（标注 Claude Code 版本和 token 数）
• 版本追踪：CHANGELOG.md 记录了 191 个版本的完整变更历史（约 238KB）
• 依赖：无外部依赖，纯静态文档

---

争议与局限

1. 提取方式的灰色地带：Anthropic 并未官方支持这种提取方式，存在政策变化风险。2026 年 1 月新增 System Reminders 后，项目也进行了紧急适配。

2. 不保证实时性：虽然更新速度极快，但仍可能存在极短暂的版本差。

3. 法律地位未明确：系统提示词是否受版权保护，AI 社区尚无定论。Anthropic 官方未认可该项目，但截至目前未采取任何阻止措施。

4. 仅供研究参考：修改本地提示词（通过 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 创建以来，持续增长中