一句话判断："这个工具的输出，我后续还需要原始数据，还是只需要结论？"

一个有趣的事实：Claude Code 团队曾经尝试过向量数据库和 RAG 方案，Zui终放弃了。

原因hen简单：失败的尝试会留在上下文里持续污染后续的判断。回退到干净的状态重来比在脏上下文里修补geng高效。

CLAUDE.md：你的“记忆核心”

CLAUDE.md 是 Claude Code 的记忆核心——每次启动时自动加载的指令文件。但大多数人要么不写，要么写成了一坨无用的长文档。

他们发现 agentic search效果geng好。

描述的作用是让 Claude 判断"什么时候该激活我"，所以要用触发场景来写。

创始人工作流的核心：永远从 Plan Mode 开始

Claude Code 创始人的工作流核心：永远从 Plan Mode 开始。

GitHub 仓库地址：shanraisshan/claude-code-best-practice，持续geng新中，建议 Star 收藏。

权限管理：不是全跳过也不是全开放

基于模型的安全分类器，自动判断操作是否安全。比全跳过安全得多，比手动确认方便得多。

原因是模型Ke以根据搜索结果动态调整下一步搜索策略，而 RAG 的一次性检索往往不够精确。

v2.1.74:从 Neng用 走向 好用 的关键一步。Claude Code 正在从 Neng用 向 顺手、好用 迈进。

所有 API 路由必须包含 rate limiting 中间件

条件触发式的指令比全局的"你必须Zuo X"geng容易被遵守。

子代理：Claude 的“分身术”

启动一个子代理，角色设定为"资深工程师"，让它审查主会话中 Claude 的实现计划。两个独立的上下文互相检查，Neng抓到hen多单一视角kan不到的问题。

Claude Code 现在支持 万 token 的上下文窗口，听起来hen大，但实际上——

在 5000 - 8000 token 时模型表现就开始退化了。

技Neng模块：不只是“脚本”那么简单

这类技Neng的投资回报极高。写一次每次改动后自动验证，省掉大量手动测试时间。

.claude/skills/deploy-checker/
├── SKILL.md           # 技Neng定义和触发条件
├── references/        # 参考文档
├── scripts/           # 可执行脚本
└── examples/          # 示例

关键经验

技Neng描述是"触发器"，不是"摘要"

错误写法：这个技Neng用于部署检查

正确写法：当用户要求部署、发布、上线、推送到生产环境时使用此技Neng

Boris 特别强调的一个方向：为你的产品构建专门的验证技Neng。

Hooks：自动化流程的“隐形推手”

Hooks 是在 Claude 的 agentic 循环之外运行的事件处理器，支持多种事件。

设置 PostToolUse Hook，在 Claude 每次写完文件后自动运行 prettier 或 eslint --fix。Claude 不需要记住格式化规则，Hook 自动处理。

Zui酷的用法：Stop Hook

在 Claude 准备结束一轮对话时触发，Ke以让它：

自动压缩上下文

生成报告

清理临时文件

上下文腐烂：你不知道的“隐形杀手”

这是 claude-code-best-practice 仓库里提到的一个核心概念：Context Rot。模型并不会在塞满 10 万 token 之后才变差，而是远远提前就开始丢精度、忘指令、漏细节。

系统自动压缩触发时上下文Yi经在退化区间了。正确Zuo法是在 70% 左右就手动执行 /compact。

比如输入 /compact 保留 auth 重构的上下文，丢掉之前调试测试的部分。

geng好的Zuo法：带提示词压缩。

权限控制：别再乱开 --dangerously-skip-permissions

hen多人为了省事，开启 --dangerously-skip-permissions。这是个坏主意。

只放行你信任的命令模式，而不是全部跳过。

{
  "permissions": {
    "allow": 
  }
}

踩坑记录：别让 Claude 重复犯错

在每个 SKILL.md 里加一个 Gotchas 部分，记录Yi知的坑。比如：

不要在技Neng里写"第一步Zuo X，第二步Zuo Y"

Claude 不需要被手把手教

写清楚目标是什么、边界在哪里就够了

把 Claude 当成一个需要好环境的工程师

给它清晰的上下文，合理的分工，可复用的知识，自动化的流程，以及安全的边界。

这是 Claude Code Zui被低估的功Neng之一。

当 Claude 的一次操作出了问题，hen多人的本Neng反应是在对话里纠正它。但geng好的Zuo法是：按两次 Esc 回退到出错之前的节点，然后重新给指令。

你在用 Claude Code 时踩过什么坑？或者有什么独家技巧？欢迎在评论区分享。

---