前言：这个站是干什么的

有一批内容没地方放：Claude Code 接入国内可用模型后端、上下文自动压缩的阈值、定时循环跑的 agent、24 小时长任务。它们具体到字段名和报错原文，塞进《验收先行》会撑破那本零基础教程，放在仓库内部文档里又没人读。这个站是给它们找的位置：用书的骨架，装博客式的内容。

这个站做一件事

给愿意碰命令行、能自己查文档的人，提供当下可复现的 AI 编程工具配置与 agent 工程细节。具体到字段名、命令、报错原文，以及「怎么确认它生效了」的验证方法。

几件事这里不做。不做零基础教学，不铺垫，默认读者会开终端、会查文档。不追求内容长期有效：工具变得快，每篇顶部标「最后核对日期」，过时的内容不删，在原位置加更新说明，让读者自己判断「什么时候变的」。不限定工具链：Claude Code、Codex、其他工具和模型，碰到什么写什么——目前写得最多的是 Claude Code，因为它的配置面最大、变得也最快。

每篇怎么写

结构固定为四段：结论先给，然后是完整的复现步骤（配置片段整段给出，不只给结论），再跟一段「怎么确认它生效了」，最后标核对日期和版本。允许从命令开始读，没有动机铺垫。

内容依据官方文档和本机实测，不依据记忆或转述。AI 参与检索、核对和整理，未经核实的内容不进正文，留在每篇末尾的「还没确认的点」里——这些条目在全站待核实清单有汇总，按「文档未覆盖 / 需要实测 / 版本差异」分类。

不用从头读到尾

每篇独立成立，分支之间没有依赖。搜报错进来的读者直接跳对应段落，或者去报错原文索引按原文查；按分支逛的读者从侧栏进，顺序随意。

没有想法的话，建议起点是CLAUDE.md 上下文工程——它解释了 agent 到底读到了什么，后面几篇都建立在这个基础上。