本专题共 137 篇。内容依据 官方文档 的公开内容整理。凡官方文档没有写明的地方，文中一律照实写 「官方文档没有说明这一点」，不做推断； 遇到文档前后口径不一致的地方，只陈述差异、不猜原因。

上手与日常用法

装完之后真正要弄明白的几件事：CLAUDE.md 怎么写才有用、上下文什么时候该压、Plan 模式省下的是哪一部分、斜杠命令怎么固化重复动作、多开 worktree 并行怎么不打架、团队一起用要立哪些规矩。

把它改造成你的样子：hooks、Skills、子代理与插件

四套扩展机制解决的是不同问题——hooks 在动作前后插钩子、Skills 是装进来的能力包、子代理把任务分出去且各带各的上下文、插件负责分发。这一组还包括几个「配了却不生效」的高频坑：插件卡在依赖还是相关性、托管 MCP 与自配 MCP 谁覆盖谁、记忆文件为什么没被读到。

Claude Agent SDK：把 Agent 能力接进自己的程序

这一组是本专题最成体系的部分，也是中文资料最少的部分。从跑通第一个 Agent、写自定义工具、要结构化输出，到会话怎么存怎么续、权限回调开在哪、部署成服务要满足什么前置；再往下是机制层——agent loop 每一轮发生了什么、工具太多时 tool search 怎么救、流式与单次为什么不可兼得、todo 不只是给人看的、系统提示能改到什么程度。

企业部署：自托管、网关与 CI

公司里落地绕不开的一条线。自托管环境的部署顺序不能颠倒、身份接入怎么验、自建 LLM 网关分两阶段接、走 Bedrock 与 Vertex/Foundry 各自要配什么、进 GitHub Actions 与 GitLab CI 的写法不通用、devcontainer 里权限与网络有额外前置。网络那篇只照文档写需放行的范围，不自行扩充域名清单。

机制解读：它到底怎么工作

主循环各阶段与工具调用的介入点、上下文是被什么填满的、提示缓存在哪一段失效、沙箱究竟隔离了什么（这篇特意不写「有沙箱所以安全」，只写官方明说不覆盖的部分）、三份安全文档各管一层、ZDR 开了之后还剩什么、权限模式各档放开的动作范围。

多代理协作：teams、channels 与跨会话

站内此前几乎没有中文资料的一块。agent teams 的成员与分派前置、channels 的字段语义、跨会话消息能不能发出去、远程控制与 deep links 是两条链路。这些机制在官方文档里标注的可用版本各不相同，正文都照实标了版本门槛。

报错与排查

按现象分流：配置改了不生效先看优先级链、沙箱拦的与权限拒的现象不一样、检查点回滚不回来是因为它本来就不存某些东西、大仓库变慢有官方给的策略。后面接的是站内既有的单条报错专篇（401、529、输出上限、上下文过长、压缩报错、流式中断、SSL、启动崩溃等），一条一篇，不重复。

额度与计费

这一组是站内既有内容。★注意：额度与限流的具体数值变动频繁，这些文章记录的是当时的实测与官方口径，**以官方最新说明为准**；本批新增的文章一律不写额度数值，只写机制。

与其它工具对照

与 Cursor 的对照按机制维度逐个展开：权限与运行模式、规则文件加载、Skills、子代理、hooks、MCP、云端代理、无头形态、插件体系、企业治理、两边 SDK。另有与 OpenRouter Agent SDK 的分层对照，以及站内既有的 Codex/Copilot 横评。**这些对照篇只比双方文档都白纸黑字写明的机制，不做优劣排名。**

其它

尚未归入上面几组的篇目。