Claude Code 社区手册现已成为协作型 wiki，已有 83 条实用技巧

如果你使用 Claude Code 超过几个小时，很可能已经碰到过瓶颈：上下文在约 30 万 token 处开始衰退，模型开始回答自己的问题，你的会话变成一次代价越来越高的缓慢螺旋。迄今为止，解决方案零散地分布在 Twitter 帖子和 YouTube 评论中。一个 GitHub 仓库正试图改变这一点。

开发者 Shan Raisshan 整理了事实上是首个 Claude Code 社区实战手册。截至 2026 年 4 月，该仓库已获得超过 200 个 GitHub 星标，记录了 14 个类别的 83 条技巧，以及来自更广泛生态系统的代理和技能合集。它吸取了 Anthropic 工程师、Claude Code 创建者 Boris Cherny 以及包括 Matt Pocock 和 Andrej Karpathy 在内的社区高级用户的经验。

这份资源的引人注目之处不在于技巧数量，而在于它们如何凝聚成一种类似专业准则的东西。该仓库明确将其内容定位为从 vibe coding（Andrej Karpathy 在 2025 年提出的术语，指让模型在没有太多理解的情况下自主驱动）向 agentic engineering（即开发者编排子代理、管理上下文预算、构建可复用工作流原语）的转变。

上下文预算管理成为核心技能

任何一个重度 Claude Code 用户首先会注意到，随着对话窗口填充，模型性能会下降。该仓库以异常精确的方式记录了阈值：在 100 万 token 的模型上，上下文衰退在大约 30 万到 40 万 token 时变得明显。一条来自化名 Thariq 的匿名 Anthropic 工程师的评论将大约 40% 上下文使用率定义为“愚蠢区”。新手被告知保持在 40% 以下；高级用户被告知不要超过 30%，且仅用于简单任务。

推荐的应对方案是一套分层会话管理系统。带有提示的 /compact 命令（例如 /compact focus on the auth refactor, drop the test debugging）优于让自动压缩触发，因为模型的自动触发发生在上下文已经影响性能时。/clear 命令加上简短的重提示让开发者完全控制哪些内容传递下去，代价是需要输入简短摘要。该仓库将两者标记为必需而非可选。

在错误尝试之前回退到之前的检查点，被认为优于尝试在原地纠正模型。按两次 Esc 或使用 /rewind 将对话重置到错误之前的位置，然后开发者根据所学内容重新提示。在对话中保留失败的尝试会浪费 token，模型之后还需绕开它们。

原语胜于提示

该仓库的组织论点是，Claude Code 高级用户不会写出更好的提示。他们会构建更好的抽象。三个核心原语是：代理、命令和技能。

代理是位于 .claude/agents/ 中的子代理定义，以 Markdown 文件形式存在。它们旨在处理特定角色（如 QA 代理、后端专家、PR 审查者），并在独立上下文窗口中运行。主会话只看到子代理的结论，而不是其中间工具调用。这种隔离正是关键所在：20 次文件读取、12 次 grep 搜索、3 次死胡同都留在子上下文中，最终只有最终报告返回。

命令是存储在 .claude/commands/ 中的斜杠触发工作流。该仓库建议为你每天多次执行的内环任务构建一个。一个 /techdebt 命令或 /context-dump 命令可以用一次按键替代重复的提示链。

技能是以 SKILL.md 为入口的文件夹，加上可选的脚本和示例子目录。技能的描述字段被视为触发器而非摘要：模型用它来决定何时触发。该仓库建议避免规定性的分步指令：给出目标和约束，而不是配方。每个技能中的“注意事项”部分被称为最有价值的内容，用于收集 Claude 长期运行中的失败模式。

一个值得注意的细节：技能可以通过 SKILL.md 中的 !command 嵌入 shell 命令。Claude 在调用时运行命令，模型只看到结果。这允许技能注入动态上下文，如当前分支、变更文件列表、上次 CI 运行状态，无需开发者将输出重定向到对话中。

反复出现的工作流模式

在社区收藏的十个精选工作流仓库中，一个结构模式反复出现：研究、计划、执行、审查、发布。仓库将其记录为一个包含子循环的循环。工作流表中的黄色标签（即子循环）是使模式适用于每个用例的关键。执行内部的每任务循环、计划内部的每故事循环、审查上的验证循环（直到条件满足才通过）。

跨模型工作流是较新的补充。存在三种不同机制：插件（另一个模型的 CLI 在 Claude Code 内以斜杠命令形式运行）、MCP 服务器（Claude Code 将另一个模型作为工具调用）以及路由器（Claude Code 的 API 端点被切换到不同提供商）。最值得注意的是 OpenAI Codex 插件：它在 Claude Code 内提供 /codex:review、/codex:adversarial-review 和 /codex:rescue 命令，有效让一个模型对另一个模型的输出进行质量审查。

83 条技巧，一个信号：这门学科正在成熟

技巧的数量是次要的，更重要的是它们所代表的意义。一年前，关于使用 AI 编程助手的建议不过是“在提示中要具体”和“将工作分解成小块”。Raisshan 的仓库展示了一个早已超越这一水平的社区。其中包含使用 git worktrees 进行代理团队并行开发的技巧；使用 ASCII 图表向模型传达架构的技巧；以及构建需要一周时间完善但能在后续每个冲刺中带来回报的产品验证技能的技巧。

该仓库本身承认这些笔记是动态发展的。截至 2026 年 4 月，技巧列表列出了 83 项，仓库说明也欢迎贡献。一个名为“未解问题”的章节列出了 14 个开放性问题，包括命令、代理和技能之间的平衡，以及以 Markdown 文件形式呈现的规格说明能否经受住代码生成速度的考验。这些未解问题可能是文档中最真诚的部分。

完整仓库可在 GitHub 上访问。社区技巧部分本身就值得一看，尤其是对于那些仍将 Claude Code 视为自动补全工具而非受管理工程资源的团队。