如何充分利用 Claude Code 的每一项功能——Shrivu Shankar 的经验分享

摘要

本文是 Shrivu Shankar 关于 Claude Code 使用经验的深度分享。他从核心配置文件 CLAUDE.md 的编写原则出发，详细阐述了上下文管理策略、自定义命令的简化使用、钩子机制的质量控制作用、计划模式的协作价值，以及技能（Skills）与 MCP 的分工定位。文章还介绍了如何利用 Claude Code SDK 进行大规模脚本编写和原型开发，以及通过 GitHub Action 实现自动化工作流。核心理念是信任代理、动态调整、持续优化。

内容框架与概述

文章以 CLAUDE.md 为起点，将其定义为项目的"宪法"，强调应从约束而非手册的角度编写，保持简洁并推动团队简化内部工具。在上下文管理方面，作者建议避免使用自动压缩功能，转而采用 /clear + /catchup 的简单重启或"文档 & 清除"的复杂重启策略，以保持上下文的可控性。

在工具使用层面，作者认为自定义命令应作为个人快捷方式而非复杂系统，子代理虽理论强大但可能带来上下文隐藏问题。钩子的核心价值在于提交阶段的质量控制，而非写入阶段的阻断。计划模式则被视为大型功能开发的必备流程，帮助开发者与代理在实施前达成共识。

文章后半部分深入探讨了技能与 MCP 的关系演进。作者提出代理自主性的三阶段模型，认为技能代表了"脚本编写"层的产品化，而 MCP 的角色应转变为安全网关。最后，作者介绍了 Claude Code SDK 的三种典型用法和 GitHub Action 的自动化实践，形成了从配置到扩展的完整方法论。

核心概念及解读

CLAUDE.md：作为项目的核心配置文件，它不是详尽的使用手册，而是基于代理出错经验积累的约束集合。好的 CLAUDE.md 应当简洁，并通过这种简洁性倒逼团队优化内部工具和流程。

上下文管理策略：在 200k 令牌的限制下，作者反对使用不透明的自动压缩，推荐通过 /clear + /catchup 快速重启，或将计划进度外化到 .md 文件中实现"文档 & 清除"的复杂重启。

钩子（Hooks）：作为确定性的"必须执行"规则，钩子补充了 CLAUDE.md 中的"应该执行"建议。关键策略是在提交阶段而非写入阶段进行阻断，避免在计划过程中干扰代理思路。

技能与 MCP 的分工：技能代表代理自主性的"脚本编写"阶段，通过 SKILL.md 暴露 CLI 和脚本给代理。MCP 则从工具抽象层转变为身份验证和安全边界的管理者，提供少数高级工具作为环境入口。

Claude Code SDK：不仅是交互式 CLI，更是构建自定义代理的框架。典型用法包括大规模并行脚本编写、为非技术用户构建聊天工具，以及快速验证代理任务原型。

原文信息

此摘要卡片由 AI 自动生成