夜雨聆风
Claude Code完整指南:16个工具+AI编程助手背后的设计哲学》
Anthropic官方出品的AI编程助手，它的”系统提示词”到底写了什么？
最近，Claude Code的系统提示词被完整披露。作为Anthropic官方的AI编程助手，它的设计理念、工具体系和开发规范都值得我们深入学习。
今天这篇文章，带你全面了解Claude Code的16个核心工具，以及它背后的开发哲学。
一、16个核心工具全解析
Claude Code的工具体系可以分成5大类：
🔥高频核心工具（3个）
1. Read – 读取文件
主要功能：读取文件内容• 支持代码、图片、PDF、Jupyter notebooks• 默认最多2000行，带行号输出• 工作流：先读后改使用场景：查看代码、理解文件结构2. Edit – 精确替换
主要功能：精确替换文本• 字符串级别的精确替换• 必须先Read再Edit• 支持全局替换使用场景：修改现有代码、精确编辑3. Write – 写入文件
主要功能：写入新文件• 创建新文件或完全重写• 对现有文件必须先Read使用场景：创建新文件、完整重写💡核心流程：Read → Edit/Write → 验证
🔍搜索导航工具（3个）
4. Glob – 文件匹配
主要功能：文件匹配技术特点：支持glob模式匹配、递归搜索目录使用示例：• **/*.ts → 找到所有TypeScript文件• src/**/*.js → 找到src下所有JS文件5. Grep – 内容搜索
主要功能：内容搜索技术特点：• 基于ripgrep，支持正则表达式• 三种模式：content、files_with_matches、count使用场景：搜索函数定义、查找引用6. LS – 目录浏览
主要功能：目录浏览技术特点：列出文件和目录结构、支持忽略模式使用场景：浏览项目结构、查看目录内容💡搜索流程：Glob找文件 → Grep搜内容 → Read看详情
💻命令执行工具（3个）
7. Bash – 执行命令
主要功能：执行Shell命令特性说明：持久shell会话、支持后台运行、最多10分钟超时适用场景：运行构建、执行测试、安装依赖8. BashOutput – 获取输出
主要功能：获取命令输出特性说明：监控后台任务、支持正则过滤、实时获取结果适用场景：检查长时间运行的任务状态9. KillBash – 终止进程
主要功能：终止进程特性说明：清理后台任务、释放资源适用场景：停止卡死的进程、取消长时间任务📋任务管理工具（1个）
10. TodoWrite – 任务列表
主要功能：任务列表管理状态类型：pending（待处理）、in_progress（进行中）、completed（已完成）应用场景：跟踪复杂任务进度、管理待办事项🤖智能工具（2个）
11. Task – 启动子代理
主要功能：启动子代理核心优势：支持多种代理类型、可并发启动多个代理、并行处理复杂任务使用场景：研究任务、代码审查、架构设计12. MultiEdit – 批量编辑
主要功能：批量编辑核心优势：一次操作多处修改、原子操作（要么全成功，要么全失败）、提高编辑效率使用场景：重构代码、批量重命名、统一修改🌐网络工具（2个）
13. WebFetch – 获取网页
主要功能：获取网页内容技术特点：HTML自动转Markdown、15分钟缓存、提取核心内容应用场景：获取文档、抓取网页、阅读文章14. WebSearch – 网络搜索
主要功能：网络搜索技术特点：获取最新信息、支持域名过滤、实时搜索应用场景：查找技术文档、搜索问题解决方案📓专业工具（2个）
15. NotebookEdit – Jupyter编辑
主要功能：Jupyter编辑支持操作：单元格替换、单元格插入、单元格删除适用场景：编辑Jupyter notebooks、数据处理16. ExitPlanMode – 退出计划模式
主要功能：退出计划模式支持操作：完成规划、准备编码适用场景：完成架构设计、开始实现代码二、工作流编排：6大原则
1. 🔧 默认计划节点
3步以上任务或架构决策，必须先计划。
如果出现问题，立即停止重新计划——不要硬着头皮继续。
原则说明：• 计划优先 目的：确保方向正确 执行方式：使用planner代理制定详细计划• 及时调整 目的：避免无效工作 执行方式：遇到问题立即重新规划• 减少浪费 目的：提高效率 执行方式：计划确保方向正确再行动2. 🤝 子代理策略
策略说明：• 任务分派 目的：专注主流程 实施方法：研究任务分派给子代理• 保持整洁 目的：避免信息过载 实施方法：保持主上下文窗口整洁• 资源投入 目的：解决复杂问题 实施方法：复杂问题投入更多计算资源3. 🔄 自我改进循环
用户纠正后 → 更新<font style="color:rgb(51, 51, 51);">background-color:rgb(243, 244, 244);">lessons.md</font>→ 迭代直到错误率下降
这是Claude Code最聪明的设计：它会从错误中学习。
改进流程：阶段1：纠正 动作：用户指出错误 产出：问题识别阶段2：更新 动作：写入lessons.md 产出：知识沉淀阶段3：迭代 动作：后续任务应用 产出：持续改进4. ✅ 完成前验证
验证标准：• 功能有效性 标准：证明有效才能标记完成 方法：运行测试、检查日志• 代码质量 标准：高级工程师会批准吗？ 方法：代码审查、性能测试• 边界情况 标准：考虑边界和异常 方法：单元测试覆盖5. 🎨 追求优雅
修复前问：”有没有更优雅的方法？”
但不要过度设计——简单修复跳过这一步。
优雅原则：✅ 需要追求优雅的场景： • 复杂重构 - 长期维护，值得优化 • 核心功能 - 影响面大，需要优雅❌ 不需要追求优雅的场景： • 简单bug修复 - 快速修复更重要 • 临时方案 - 过度设计浪费时间6. 🔧 自主修复错误
接到错误报告 → 直接修复，不要问东问西。
用户不需要上下文切换。
修复流程：步骤1：接收错误报告 目的：了解问题步骤2：直接修复 目的：减少用户等待步骤3：验证修复 目的：确保问题解决步骤4：通知用户 目的：完成闭环三、编码风格：不可变性至上
❌错误：修改对象
function updateUser(user, name) { user.name = name // 修改！ return user}✅正确：创建新对象
function updateUser(user, name) { return { ...user, name }}编码原则：• 不可变性 原则：不修改现有对象，创建新对象 好处：避免副作用、易于追踪• 纯函数 原则：相同输入产生相同输出 好处：可预测、易测试• 副作用隔离 原则：副作用与纯逻辑分离 好处：代码更清晰、易维护文件组织原则
推荐实践：• 小文件 > 大文件 推荐值：200-400行 理由：易于理解、便于维护• 最大文件大小 推荐值：800行 理由：超过考虑拆分• 组织方式 推荐值：按功能，不按类型 理由：高内聚、低耦合代码质量检查清单
质量标准：• 函数长度 限制：<50行 目的：保持简单、单一职责• 文件长度 限制：<800行 目的：易于理解、便于维护• 嵌套层级 限制：<4层 目的：避免复杂、提高可读性• console.log 限制：无 目的：生产代码不应有调试输出• 硬编码值 限制：无 目的：使用常量或配置四、测试要求：80%覆盖率
TDD强制流程
阶段1：🔴 先写测试 目标：应该失败 目的：明确需求阶段2：🟢 写最小实现 目标：应该通过 目的：满足测试阶段3：🟡 重构优化 目标：改进质量 目的：提升代码质量阶段4：✅ 验证覆盖率 目标：达到80% 目的：确保测试完整三种测试必须
测试类型说明：1️⃣ 单元测试 测试范围：函数、组件 覆盖目标：覆盖所有分支 示例：测试单个函数逻辑2️⃣ 集成测试 测试范围：API、数据库 覆盖目标：覆盖关键流程 示例：测试数据库交互3️⃣ E2E测试 测试范围：用户流程 覆盖目标：覆盖核心场景 示例：测试完整用户旅程五、代理编排：9个专用代理
1️⃣ planner（规划者） 主要用途：实现规划 何时使用：复杂功能开发 核心能力：制定详细实现计划2️⃣ tdd-guide（TDD向导） 主要用途：TDD开发 何时使用：新功能开发 核心能力：引导测试驱动开发3️⃣ code-reviewer（代码审查员） 主要用途：代码审查 何时使用：写完代码后 核心能力：检查代码质量、提供改进建议4️⃣ security-reviewer（安全审查员） 主要用途：安全分析 何时使用：提交前 核心能力：识别安全漏洞、提供修复方案5️⃣ architect（架构师） 主要用途：系统设计 何时使用：架构决策 核心能力：设计系统架构、技术选型6️⃣ build-error-resolver（构建错误解决者） 主要用途：构建修复 何时使用：构建失败时 核心能力：诊断并修复构建错误7️⃣ e2e-runner（E2E运行器） 主要用途：E2E测试 何时使用：用户流程测试 核心能力：运行端到端测试、验证功能8️⃣ refactor-cleaner（重构清理器） 主要用途：代码清理 何时使用：维护时 核心能力：优化代码结构、提高可读性9️⃣ doc-updater（文档更新器） 主要用途：文档更新 何时使用：写文档时 核心能力：自动生成和更新文档代理选择指南
任务类型匹配：• 新功能开发 → planner + tdd-guide 理由：先规划再TDD开发• 代码提交前 → code-reviewer + security-reviewer 理由：确保代码质量和安全• 构建失败 → build-error-resolver 理由：专门处理构建问题• 架构决策 → architect 理由：专业架构设计• 代码维护 → refactor-cleaner 理由：优化现有代码并行执行原则
执行方式对比：✅ 好的：并行执行 效率：⭐⭐⭐⭐⭐ 适用场景：独立任务 示例：3个代理同时运行不同任务（如：代码审查 + 安全审查 + 测试）❌ 坏的：顺序执行 效率：⭐⭐ 适用场景：依赖任务 示例：必须按顺序完成的任务六、Hooks系统：自动化检查
PreToolUse（工具使用前检查）
1️⃣ tmux提醒 触发条件：执行长命令 检查内容：建议使用tmux保持会话 阻止执行：否（仅提醒）2️⃣ git push审查 触发条件：git push操作 检查内容：推送前打开编辑器审查 阻止执行：是（需要确认）3️⃣ 文档阻止器 触发条件：创建文档 检查内容：检查文档是否必要 阻止执行：是（阻止不必要文档）PostToolUse（工具使用后检查）
1️⃣ Prettier 触发条件：编辑代码文件 自动操作：自动格式化代码 目的：统一代码风格2️⃣ TypeScript检查 触发条件：编辑.ts文件 自动操作：运行tsc类型检查 目的：及早发现类型错误3️⃣ console.log警告 触发条件：代码中有console.log 自动操作：显示警告提醒 目的：清理调试代码Stop（会话结束时检查）
1️⃣ console.log审计 触发条件：会话结束前 检查内容：检查所有console.log 强制要求：是（必须清理）七、安全检查清单
提交前必查：
安全检查项：🔑 密钥管理（⚠️⚠️⚠️ 高风险） 检查内容：无硬编码密钥 检查方法：搜索硬编码的密钥、token✅ 输入验证（⚠️⚠️ 中风险） 检查内容：用户输入已验证 检查方法：检查所有输入点💉 SQL注入（⚠️⚠️⚠️ 高风险） 检查内容：使用参数化查询 检查方法：代码审查、安全扫描🎭 XSS预防（⚠️⚠️⚠️ 高风险） 检查内容：输出已转义 检查方法：检查输出点🛡️ CSRF保护（⚠️⚠️ 中风险） 检查内容：CSRF token已启用 检查方法：检查表单提交⏱️ 速率限制（⚠️⚠️ 中风险） 检查内容：API已限流 检查方法：检查API端点安全检查优先级：P0（最高优先级）：• 密钥管理• SQL注入• XSS预防原因：可能导致严重安全事故P1（高优先级）：• CSRF保护• 输入验证原因：常见攻击向量P2（中优先级）：• 速率限制原因：性能和安全平衡总结
Claude Code的设计体现了几个核心理念：
核心理念：🛠️ 工具化：16个工具覆盖开发全流程 价值：标准化操作流程📏 规范化：强制TDD、80%覆盖率 价值：保证代码质量🤖 自动化：Hooks系统自动检查 价值：减少人为错误🧠 智能化：子代理并行处理复杂任务 价值：提高开发效率🔒 安全化：多重安全检查机制 价值：保障代码安全这套体系不只是”能用”，更是”好用”——它把高级工程师的经验编码成了规则。
相关阅读
- Claude Code官方文档
- Anthropic系统提示词解读
本文基于Claude Code系统提示词整理，涵盖了工具使用、开发规范、代理编排等核心内容。