在AI编程圈子里待久了，总会遇到这样的场景：深夜或清晨，群里有人反复问“哪里能找到靠谱的Claude Code中文教程？”“Codex怎么上手？”“Cursor和Claude Code到底选哪个？”这些问题其实不难回答，但真正的答案从来不在某一篇孤立的文章里，而应该是一张完整的“中文AI编程工具地图”。过去一年多，我把自己在实践中积累的东西系统化，最终做了一个公开站点——aiworkflowtutorials.com。

这篇文章不是关于这个站点的新闻稿，而是一份实用的使用说明书。我会告诉你：站里覆盖了哪些内容，每类读者应该从哪里开始读，它怎么和我的AI编程实操课配合。读完你应该能直接打开站点，找到适合自己读的第一篇文章，而不是又被一个新链接淹没。

30秒答疑（先看这个）

如果不想读完整篇，先看下面这张表，30秒判断这篇文章是否适合你。

最容易踩的坑就是：把这个站当成一本“读一遍就完了”的教材。它本质上是一本字典，应该按工具按场景跳读，而不是从首页一直滚到底。

一、为什么需要一个AI编程工具中文教程站

中文圈的AI编程资料，长期存在三个老毛病——碎、慢、缺判断。

碎：想搞清楚Claude Code的CLAUDE.md文件到底怎么写，搜出来的中文资料一半是机翻的官方文档片段，一半是发布通稿，还有一半是“我用了三天感觉真香”的体感贴。把这些拼起来能拼出一个轮廓，但拼不出一份能照着写的完整指引。

慢：官方今天发了一个新功能，中文圈一般要一到两周才有像样的讲解。对于新手来说是很大的困扰，因为这两周里看到的教程全是旧版本的，学完之后才发现自己学的是上个版本的工作流。

缺判断：这一点最为关键。大量教程把官方文档原样翻译，却不告诉读者哪里重要、哪里可以跳过。结果是读完一篇几千字的全功能解析，知道了十几个功能，却不知道自己应该先用哪三个。

一个典型的案例来自去年：想给Claude Code写一份能在多个项目里复用的CLAUDE.md模板，搜遍中文圈，没找到一篇讲清楚“项目级CLAUDE.md和用户级CLAUDE.md加载顺序”的文章。最后还是去翻官方仓库的issue列表，看到一条评论里Anthropic的工程师顺嘴提了一句加载优先级才搞明白。这类内容在技术社区里本该是最常见的“踩坑文”，但当时确实没有。从那以后，就开始动手整理自己的笔记，最后积累成了这个站点。

二、aiworktutorials.com是什么

一句话概括：这是一个把AI编程工具的官方文档、源码、发布记录提炼成中文的教程站，并配套AI编程实操课。

它和博客不同。博客按时间排序，最新的在最上面，几个月后就被埋下去了。教程站是按工具和主题组织的——想学Claude Code就进claude-code栏目，里面所有内容是一个完整的体系。

它也不是论坛。论坛是众包，每个人写自己的视角，最后看到的是各种不一致的说法。教程站是单作者控制——所有判断、所有取舍都出自同一个工作流，读起来不会精神分裂。

目前站点已经覆盖了主流AI编程工具，包括Claude Code、OpenAI Codex、Cursor、Gemini CLI、GitHub Copilot、Windsurf、Antigra vity等IDE和CLI形态的工具，以及一些实战编排框架。每个工具栏目内部固定有两个子目录——`official`（官方事实层）和`understanding`（解读层）。

做三点澄清：这不是新闻站，不追即时发布；不是AI生成内容站，每篇文章都有人读过原始资料、跑过示例、写过自己的判断；不是收费墙站，站本身公开免费，付费内容在AI编程实操课中。

三、与官方文档、知乎、CSDN的关系

经常有人问：“直接看官方英文文档不行吗？”“知乎那么多回答还不够吗？”这是很好的问题。

与官方英文文档的关系：官方文档是第一手来源，永远是。教程站每篇文章都标有`canonical`指向官方原文链接，明确告知“这是对官方文档的解读，权威版本在那里”。但官方文档解决不了三个问题：它是用专业术语写的，假设读者已经懂前置概念；它是按功能模块写的，不告诉读者先学哪个再学哪个；它不会承认“这个功能新手用不上”这种立场。中文教程站的价值就是补这三个缺口。

与知乎、CSDN的关系：这些平台上有大量优质的中文内容。但内容分散——想系统学Claude Code，会发现不同作者写的文章风格和判断完全不同，拼起来读会精神分裂。教程站的差异化在于单作者加体系化，所有内容出自同一个人、同一个工作流。

与翔宇官网的关系：这边是博客，写最近在AI编程上的观察、判断和踩坑；教程站是字典，写工具具体怎么用。博客有时效性和立场温度，字典追求长期可查。这篇文章就是把这个关系讲清楚，然后由读者自己决定是否把教程站加进收藏夹。

四、四类读者对号入座

下面这张表覆盖了典型的四类读者画像，每类给一条具体的入栏路径。

建议把这个流程图保存下来，进站时先想清楚自己在哪条路径上，再点对应栏目。最常见的错误是路径①的新手直接跳到路径④的横向对比文章，结果读完之后更糊涂了。

五、站点组织方式：每个工具栏目固定两层

教程站的目录结构很简单——每个工具栏目内部只有两个子目录，这是经过多次重构之后确定的最稳定形态。

{工具名}/├── index.mdx（栏目首页：这个工具是什么、谁该看）├── official/（官方事实层：安装配置篇、第一次跑通篇、核心命令清单等）└── understanding/（解读层：这个工具到底是什么、跟同类怎么比、哪些功能新手别学等）

official子目录：把官方文档里跟“能不能用起来”相关的部分翻译并重新组织。强调保真，每篇标canonical指向官方原文。这一层是给读者查的。

understanding子目录：这是站点的灵魂。每篇回答一个判断类问题，比如“这个工具到底是什么”“为什么要这么设计”“跟同类比强在哪弱在哪”。这一层是给读者想清楚的。

为什么不再细分子目录？做过几个版本后发现，子目录越多，新手越容易迷路。两个层级，认知成本最低。栏目首页的作用是用最少的篇幅告诉读者这个工具是什么、从哪一篇开始。

六、覆盖的AI编程工具

怎么选主力工具？三件事：看你已有的订阅、看你的工作模式、看你的项目规模。怎么选对照？同形态对照比跨形态对照更有价值。

七、三种使用路径：把“教材”变成“字典”

教程站最大的反模式就是从首页一篇一篇读到底。下面三条路径是经过验证的高效用法。

路径一：完全新手的“学一个工具”路径——进站、选一个工具栏目、读栏目首页、读understanding入门篇、读official安装篇、读首次跑通篇。整条路径预计需要一到两周。

路径二：选型者的“横向对比”路径——进站、选3个候选工具、每个工具只读两篇understanding、看判断段、做选型决定、再回头读official。不要超过一个周末。

路径三：实操课学员的“字典查阅”路径——课程章节里遇到具体工具、跳到教程站对应栏目、直接搜具体功能、只读那一篇。让教程站成为日常工作的字典。

最容易跑偏的两条路径：一是新手把所有栏目通读了一遍；二是选型者陷入“永远在调研”。两条都需要有时间盒限制。

八、内容保鲜机制与配合方式

AI编程工具更新非常快，教程过期是必然的。教程站的做法是每篇文章的frontmatter里标两个字段：

• verifiedAt：上次亲自核对内容与官方现状一致的日期。
• canonical：对应官方原文链接。

站点会在每篇文末做可视化展示。如果核对时间较久，建议先点canonical核对官方原文。会定期做批量复检，但中间会有窗口期。

与AI编程实操课的配合方式：教程站是公开知识地图，实操课是付费实操路径。具体配合方式：课程章节里每次提到一个工具，跳到教程站对应栏目快速查；课程外想自学新工具，先去教程站读一遍再回课程；长期把教程站当字典放在浏览器固定标签页。

九、日常使用示例

早上写文章或写Skill时，主力工具是Claude Code，打开教程站的claude-code/understanding标签页作为参考文档。不是为了查什么，而是确保写的内容与站上的判断保持一致。

中午做技术选型或评估新工具时，横向打开站上几个工具栏目的understanding子目录，并列读判断段。这有助于检查自己的判断是否出现偏差。

下午做实操课更新时，课程涉及的工具如果有更新，先去教程站把对应栏目改了，再更新课程。这是维护公开知识地图和付费实操路径一致性的固定动作。

晚上做月度复盘时，列出教程站当月新加的栏目和重大改动，分析每条改动背后的驱动因素。

周一早上做内容计划时，看上周末教程站的访问数据，阅读量高的栏目优先排入当周的博客计划。

十、五个常见坑

坑一：把understanding当成official的“中文翻译”——正确的做法是先搞清两层定位。

坑二：跳读太狠，跳过了核心概念篇——每个工具栏目的understanding都有一篇入门篇，第一次进栏先读这篇和栏目首页。

坑三：不看verifiedAt，全信教程内容——每次按教程做配置前，先看一眼核对时间。教程站的角色是降低认知成本，不是替代官方权威。

坑四：用“读教材”的心态把整站读完——把站当字典，选一个主力工具深读加实操。

坑五：用工具栏目数量来判断站点完整度——教程站按“自己用过且用熟”的工具来扩展，没有的栏目不是因为忘了，而是因为还没用熟。

十一、一两周后的进阶路径

十二、自检清单

• 已经清楚教程站和翔宇官网博客的差别
• 已经对号入座找到自己的路径
• 已经选定一个主力工具栏目和一个对照工具栏目
• 已经把教程站设成浏览器收藏夹
• 已经知道事实查询走official，判断疑问走understanding
• 已经了解verifiedAt字段和保鲜机制
• 已经决定是否把实操课加入学习路径
• 已做好准备，发现错误或过期时会反馈

如果以上都做到了，使用姿势比多数读者都要到位了。

一句话收官

aiworkflowtutorials.com是把过去一年多积累的中文AI编程笔记系统化之后做出来的站点——它不是给所有人的，而是给那些“想认真用AI编程工具但中文资料一直没找到一份能信赖的”的人。不需要照抄任何人的使用路径，但可以从这些判断起步，把它融入自己的工作流。这就是这个站点存在的全部理由。