揭秘Claude Code系统提示词：模块化设计、子代理协作与定制化实践

1. 项目概述与核心价值

如果你正在使用 Claude Code，或者对 AI 编程助手的内部运作机制感到好奇，那么你很可能已经意识到，真正决定其行为、能力和边界的，并非仅仅是那个强大的 Claude 模型本身，而是驱动它的“系统提示词”。这个名为Piebald-AI/claude-code-system-prompts的 GitHub 仓库，就像一本被公开的“魔法书”，里面详尽记录了 Claude Code 从 v2.0.14 到最新版本（截至 2026 年 4 月 8 日的 v2.1.97）所使用的全部系统提示词。这不仅仅是简单的文本集合，它揭示了 Anthropic 如何通过精心设计的指令，将一个通用大语言模型塑造成一个专业、高效且安全的 AI 开发者伙伴。

这个仓库的价值远超一个简单的文档备份。对于开发者而言，它是一扇观察顶级 AI 工程实践的窗口。你可以看到 Anthropic 的工程师们如何将一个复杂的“AI 代理”拆解成上百个模块化的指令片段，如何为不同的子任务（如探索代码库、制定计划、安全检查）设计专门的“子代理”提示词，以及如何通过一系列“工具描述”来精确控制 AI 对文件系统、终端、Git 等外部环境的操作权限和行为模式。对于想要深度定制 Claude Code 的用户，这更是一个宝藏。通过仓库配套的tweakcc工具，你可以直接修改这些底层的提示词文件，从而调整 Claude Code 的行为，使其更贴合你的个人工作流或团队规范，这相当于获得了对 AI 助手进行“微调”的能力，而无需重新训练模型。

简单来说，这个项目解决了几个核心痛点：透明度（让用户知道 AI 助手背后的“思考”框架是什么）、可定制性（允许高级用户进行精细化的行为调整）以及学习价值（为构建自己的 AI 代理提供了绝佳的范本）。无论你是想成为更高效的 Claude Code 使用者，还是希望借鉴其设计理念来构建自己的 AI 应用，这个仓库都是一个不可或缺的参考。

2. 核心架构与设计思路拆解

Claude Code 的系统提示词并非一个单一的、庞大的文本块，而是一个高度模块化、条件化组合的复杂系统。理解其设计思路，是有效利用这个仓库的关键。

2.1 模块化与条件化组合

Anthropic 没有采用“一刀切”的巨型提示词，而是将系统指令拆分为 110 多个独立的字符串。这种设计主要基于两个考量：

1. 性能与成本：大语言模型的上下文窗口是宝贵的资源。每次对话，系统提示词都会占用一部分 Token。通过模块化，Claude Code 可以根据当前会话的上下文（例如，是否启用了“学习模式”、是否在运行“安全审查”、当前激活了哪些工具）动态地组装最相关的提示词子集。这避免了将永远用不到的指令（比如 PowerShell 5.1 的特定说明）塞进每次对话，从而节省了上下文空间，降低了 API 调用成本，并可能提升响应速度。

2. 可维护性与清晰度：将功能隔离到独立的提示词文件中，使得 Anthropic 的工程师能够更清晰、更安全地进行迭代。例如，更新“安全审查”子代理的逻辑时，只需修改agent-prompt-security-review-slash-command.md文件，而无需担心会意外影响“代码探索”或“记忆合成”等其他功能。这种“高内聚、低耦合”的设计是软件工程的最佳实践在提示词工程领域的直接体现。

2.2 分层提示词体系

仓库中的提示词可以清晰地分为几个层次，共同构成了 Claude Code 的“人格”与“能力”：

• 核心行为准则层：位于system-prompt-doing-tasks-*.md系列文件。这些是塑造 Claude Code 基本工作哲学的“宪法”。例如，“不进行不必要的抽象”、“在修改前先阅读代码”、“避免添加未要求的功能”等。这些准则确保了 AI 的行为是务实、专注且符合软件工程最佳实践的，防止其过度设计或偏离用户指令。

• 工具与能力描述层：这是占比最大的一部分，包括对所有内置工具（如Write,Bash,TodoWrite）以及各种子代理（Explore,Plan,Verification Specialist等）的详细描述。每个工具描述都精确定义了其输入、输出、使用场景和边界条件。例如，Bash工具的描述会包含安全警告和命令执行规范，而WebFetch工具的描述则会指导 AI 如何高效地获取和总结网络信息。

• 数据与知识库层：以>