AI 编程工具中文教程到底去哪学？我做了 aiworkflowtutorials.com

⏱️ 预计阅读 18 分钟 ｜ 🎯 目标：让你 18 分钟内决定，要不要把 aiworkflowtutorials.com 加进自己的 AI 编程学习路径。

昨晚 11 点关电脑，今早 8 点醒来，发现群里又有人在问「Claude Code 中文教程到底去哪看」「Codex 怎么入门」「Cursor 还是 Claude Code 哪个适合我」。这种问题我已经回答过几十次了——答案不在某一篇博客里，是在一张完整的「中文 AI 编程工具地图」里。这张地图我自己用了一年多，最后干脆做成了一个公开站，叫 aiworkflowtutorials.com。

这篇文章不是站点新闻稿，是给你的使用说明书：站里装了什么、谁该读、读哪一栏、怎么和我的 AI 编程实操课配合。读完你应该能直接打开站、找到自己该看的第一篇，而不是又被一个新链接淹没。

30 秒答疑（先看这个）

不想读完整篇？看下面这张表，30 秒决定要不要继续读。

最容易踩的坑一句话警告：把这站当成「读一遍就完了」的教材——它其实是个字典，按工具按场景跳读，不要从首页一直滚到底。

一、为什么需要一个 AI 编程工具中文教程站：从我自己被卡住的几次说起

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

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

慢：官方今天发了个新功能（比如 Hooks 或者 Skill），中文圈一般要一周到两周才有像样的中文讲解出来。如果你刚好是新手，这两周里你看到的「Claude Code 教程」全是不带这个新功能的旧版——你按那篇做完之后，会发现自己学的是上个版本的工作流。

缺判断：这条最致命。中文圈大量教程把官方文档原样翻译过来，但不告诉你哪里重要、哪里可以跳过、哪个功能其实新手用不上。结果是你读完一篇 5000 字「Claude Code 全功能解析」，知道了 13 个功能，但不知道自己应该先用哪 3 个。

🔥 翔宇判断

中文 AI 编程教程的价值不在「翻译」，在「判断密度」。把官方文档照搬翻译成中文是机器就能干的活，AI 时代里没有任何溢价；真正有用的是「我用了一年这个工具，下面这 5 个功能你新手阶段先别学」这种判断。这站做的事情，是把判断密度补回来。

我自己第一次被卡住是去年——想给 Claude Code 写一份能在多个项目里复用的 CLAUDE.md 模板，搜遍了中文圈，没找到一篇讲清楚「项目级 CLAUDE.md 和用户级 CLAUDE.md 加载顺序」的文章。最后还是去翻官方仓库的 issue 列表，看到一条评论里 Anthropic 工程师顺嘴提了一句加载优先级，才搞明白。这种东西按理说应该是中文圈最常见的「踩坑文」，但当时确实没有。从那以后我就开始动手写自己的笔记，最后笔记积累得太多，干脆做成站。

二、aiworkflowtutorials.com 是什么：一分钟看懂

一句话定义：aiworkflowtutorials.com 是一个把 AI 编程工具的官方文档、源码、发布记录提炼成中文的教程站，配套我的 AI 编程实操课。

它不是博客。博客的内容是按发布时间排，最新的在最上面，过几个月就埋到第二页第三页找不着了。教程站是按工具和主题组织——你想学 Claude Code 就进 claude-code 栏目，里面所有内容是一个完整的体系，不会因为「过去两个月又发了几篇」就把核心教程顶到下面去。

它也不是论坛。论坛是众包，每个人写自己的视角，最后看到的是一堆不一致的说法。教程站是单作者控制——所有判断、所有取舍、所有「这玩意儿值得学，那玩意儿先别管」的立场，都是同一个人在同一个工作流下做出来的，读起来不会精神分裂。

💡 说人话

想象一下，你刚搬到一个陌生的城市，路上拦个人问「这条街最好的拉面店在哪」，对方告诉你三家不同店；再拦一个，又告诉你另外两家完全不重合的。你不知道信谁，最后只能自己挨家吃过去。教程站的意义就是有一本由本地人写的、明确告诉你「这条街我吃过 12 家拉面，前 3 名是哪 3 家、为什么」的小册子。

站点装了什么——目前已经覆盖主流 AI 编程工具的栏目，包括 Claude Code、OpenAI Codex、Cursor、Gemini CLI、GitHub Copilot、Windsurf、Antigravity 等几个 IDE/CLI 形态，以及一些实战编排框架的栏目。每个工具栏目内部固定有两个子目录——official（官方事实层，对照官方文档写）和 understanding（解读层，写「这玩意儿到底是什么、为什么这么设计、跟同类怎么比」）。

「这不是什么」三条澄清：

• 不是新闻站。AI 编程工具今天发了什么、明天发了什么，不是这站要追的。要追新闻看官方博客和 changelog 就够了。
• 不是 AI 生成内容站。每篇都有人读过原始官方资料、跑过示例、写过自己的判断段。
• 不是收费墙站。站本身公开免费，付费内容在 AI 编程实操课。

三、这站和官方英文文档、知乎、CSDN 是什么关系：不替代、互补、各干各的

经常有人问「我直接看官方英文文档不行吗」「知乎那么多回答还不够吗」「CSDN 的中文资料这么多干嘛重复造轮子」。这是好问题，我每次都正经回答一下。

和官方英文文档的关系——官方文档是第一手来源，永远是。教程站每篇都标 canonical（指向的官方原文链接），明确告诉你「这篇是我对官方文档的解读，权威版本在这里」。但官方文档解决不了三个问题：① 它是用专业术语写的，假设你已经懂前置概念；② 它是按功能模块写的，不告诉你「先学哪个再学哪个」；③ 它不会承认「这个功能新手用不上、那个功能很多人不知道但其实很重要」这种立场——官方不会自我贬低。中文教程站的位置就是补这三个缺口。

和知乎、CSDN 的关系——知乎和 CSDN 上有大量优质中文 AI 编程内容，我自己也读过很多。但内容分散：你想系统学 Claude Code，会发现一篇讲安装的文章、一篇讲 Hooks 的文章、一篇讲选模型的文章是三个不同作者写的，三人的工作流和判断完全不同，拼起来读会精神分裂。教程站的差异是单作者 + 体系化——读起来你能感受到「这十篇是同一个人按同一个工作流的判断写出来的」。

💡 说人话

官方文档像菜谱大全——每道菜的做法都最权威，但你翻完不知道今晚做什么。
知乎 CSDN 像美食公众号——每篇都好看，但十个号写十种风格，你做菜得先选信谁。
中文教程站像家里那本被翻烂的《家常菜》——一个人写的、按家庭场景组织、明确告诉你「这道菜适合周末做、那道菜别学了费力不讨好」。
三者不替代，做不同的事。

和翔宇官网（你现在在的这个站）的关系——这边是博客，写「我最近在 AI 编程上的观察、判断、踩坑」；教程站是字典，写「Claude Code 这个工具具体怎么用」。博客有时效性、有立场温度，字典追求长期可查。这篇你正在读的文章就是博客 → 字典的导流——把教程站介绍清楚之后，你自己决定要不要把那个站加进收藏夹。

四、4 类读者对号入座：你应该从哪一栏开始读

🔥 翔宇判断

AI 编程教程站的最大风险不是写错，是新手用错。一个新手如果第一次进站直接点开「Claude Code Hooks 高级配置」，他会被劝退，并且觉得「中文 AI 编程教程也不行」。所以下面这张对号入座表比任何具体教程都重要——选错入口比看错内容代价大得多。

下面这张表覆盖我观察到的 4 类典型读者画像，每类给一条具体的入栏路径。

flowchart TD
  A[你是谁？] --> B{用过任何 AI 编程工具？}
  B -- 没用过 --> C[完全新手路径]
  B -- 用过编辑器内嵌型 --> D[切 CLI 形态路径]
  B -- 用过多个工具 --> E[做选型 / 体系化路径]
  C --> C1[claude-code/understanding 起步篇]
  C1 --> C2[claude-code/official 安装与跑通]
  C2 --> C3[claude-code/understanding CLAUDE.md 篇]
  D --> D1[codex/understanding CLI 与 IDE 差异]
  D1 --> D2[同时安装 codex + claude-code 各跑一次]
  D2 --> D3[对比体感判断主力工具]
  E --> E1[每工具的 understanding 横向读]
  E1 --> E2[找 4 个栏目的判断段并列对照]
  E2 --> E3[做出选型决定 / 写出对比文]

这张图建议你看完后保存一下截图，进站时先想清楚自己在哪条路径上，再点对应栏目。最常见的错误是路径 ① 的新手直接跳到路径 ④ 的横向对比文章，结果读完更糊涂——因为对比文章假设读者已经懂每个工具的基础。

五、站点是怎么组织的：每个工具栏目固定两层

教程站的目录结构很简单，简单到我故意做成这样——每个工具栏目内部只有两个子目录，这是经过几次重构得到的最稳定形态。

{工具名}/
├── index.mdx              ← 栏目首页（这个工具是什么、谁该看）
├── official/              ← 官方事实层
│   ├── 安装与配置篇
│   ├── 第一次跑通篇
│   ├── 核心命令清单
│   └── ...（按官方文档结构对应）
└── understanding/         ← 解读层
    ├── 这工具到底是什么
    ├── 跟同类工具怎么比
    ├── 哪些功能新手别学
    └── ...（按读者最关心的判断问题组织）

official 子目录干什么——把官方文档里跟「能不能用起来」相关的部分翻译过来 + 重新组织。强调「保真」：官方说的就是怎么说的，每篇标 canonical 指回官方原文。这一层是给你查的——你想知道「这个命令的参数有哪些」「这个配置文件该放哪个目录」，进 official 就行。

understanding 子目录干什么——这是站点的灵魂。每篇回答一个判断类问题：「这工具到底是什么」「为什么要这么设计」「跟同类比强在哪、弱在哪」「哪些功能其实新手用不上」「我怎么决定要不要用它」。这一层是给你想清楚的——你不想被官方文档牵着走，想自己做判断，进 understanding。

💡 说人话

official 像产品说明书——告诉你按钮怎么按，不告诉你这台机器适不适合你。
understanding 像老用户在客厅里跟你聊半小时——告诉你这台机器哪个按钮好用、哪个按钮十年没人用过、买回来到底值不值。
两个一起看，比单独看任何一个都管用。

为什么不再细分子目录——做过几个版本之后我意识到，子目录越多，新手越迷路。每个工具栏目固定 official + understanding 两层，进任何一个工具都能马上知道「我要查事实就走 official，要看判断就走 understanding」，认知成本最低。

栏目首页（index.mdx）干什么——一句话：用最少的篇幅告诉你「这工具是什么、谁该看、从哪一篇开始」。如果某天你完全不知道从哪开始，直接进栏目首页，里面会把这个工具的入门路径标清楚。

六、覆盖了哪些 AI 编程工具：每栏一句话定位 + 适合谁先看

下面是目前站上的工具栏目清单，每条给一句话定位 + 一个具体的「适合谁先看」建议。

🔥 翔宇判断

没必要每个栏目都看。AI 编程的常见错误是「想学全」——结果哪个都不深。我的建议是按一个主力 + 一个对照 的方式选两个工具栏目深读，其他的栏目当字典随用随查。我自己的主力是 claude-code，对照是 codex；这个组合让我同时熟悉了 Anthropic 和 OpenAI 两边的工程取向，写文章和做选型时都有底气。

怎么选主力——三件事：① 看你已有的订阅（已经付了 ChatGPT 就先用 codex，已经付了 Claude 就先用 claude-code）；② 看你的工作模式（喜欢留在 IDE 的选 cursor，能接受跳进终端的选 CLI 系）；③ 看你的项目规模（小项目用什么都行、大项目优先选 CLAUDE.md / AGENTS.md 这类项目记忆功能成熟的工具）。

怎么选对照——主力是 CLI 就拿另一个 CLI 做对照；主力是编辑器型就拿另一个编辑器型做对照。同形态对照能让你看清「同样一件事的两种做法」，跨形态对照容易让你陷入「形态之争」反而忽略真正的差异。

七、三种使用路径：把这站从「教材」变成「字典」

教程站最大的反模式是从首页一篇一篇读到底——读完你会觉得「学了好多东西」，但什么都没真正用上。下面三条路径是我观察到的高效用法。

路径一：完全新手的「学一个工具」路径——这条路径目标是让你真的把一个 AI 编程工具用起来。具体动作：进站 → 选一个工具栏目 → 读栏目首页 → 读 understanding 入门篇（建概念）→ 读 official 安装篇（跟着装一遍）→ 读 official 第一次跑通篇（让 AI 改一个真 bug）。整条路径预计需要一到两周，每天读半小时 + 实操半小时。中间任何时候卡住，回头查 understanding 而不是网上随便搜。

路径二：选型者的「横向对比」路径——这条路径目标是让你做出明确的工具选择。具体动作：进站 → 选 3 个候选工具 → 每个工具只读两篇 understanding（「这工具是什么」+「跟同类比怎么样」）→ 看每篇的判断段 → 做选型决定 → 选定后再回来看 official。这条路径不要超过一个周末——拖太久反而会越想越糊涂。

路径三：实操课学员的「字典查阅」路径——这条路径目标是让你把课程里学到的东西落地。具体动作：在课程章节里遇到具体工具 → 跳到教程站对应栏目 → 直接 Ctrl+F 搜你要查的具体功能 → 读那一篇就够了，不要把整栏读完。这种用法让教程站成为你日常工作的字典，而不是要专门腾出时间「学习」的教材。

💡 说人话

一本字典的最大价值不在它有多厚，在你遇到不会的词时知道翻哪一页。教程站想做的就是这件事——你工作流里突然卡住「这功能怎么用」，三秒内能跳到对应栏目对应篇，看完就回去继续干活。

最容易跑偏的两条路径——一条是路径①的新手把所有栏目都通读了一遍，结果哪个工具都没真用过；另一条是路径②的选型者陷入「永远在调研」——读完 3 个工具又想看第 4 个、第 5 个，最后哪个都没选。两条路径都有时间盒，超出就强制收口。

八、内容怎么保鲜：verifiedAt 机制 + 怎么和 AI 编程实操课配合

保鲜机制——AI 编程工具更新非常快，教程过期是必然的。教程站的应对是把每篇文章的 frontmatter 里都标两个字段：

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

读到一篇文章你看不到这两个字段（它们在源码里），但站点会在每篇文末做一行可视化展示——告诉你「这篇上次核对是 X 个月前」。如果你看到核对时间已经过去比较久，最好顺手点 canonical 跳到官方原文核对一下，别全信教程。我自己每隔一段时间会做批量复检，发现官方变了的就回来改，但中间会有窗口期，这个老实告诉你。

❗ 翔宇失败坦白

我做这站的第一年就栽过一次。某个 AI 编程工具升级了一个核心配置文件的字段名，我没及时更新教程，那篇文章里教的旧字段名导致一波读者按教程跑不通。我收到反馈后熬了一晚把所有相关篇都重写了。从那次起 verifiedAt 字段才进入站点 schema——本质上 verifiedAt 不是为了好看，是为了让读者知道「这篇你最好自己再核对一下」。

和 AI 编程实操课的配合方式——教程站和实操课是「公开知识地图」+「付费实操路径」的组合：

具体怎么配合用：① 课程章节里每次提到一个工具，跳到教程站对应栏目快速查；② 课程外想自学一个新工具，先去教程站把那栏读一遍再回课程看怎么编排；③ 长期把教程站当字典放在浏览器固定标签页，把实操课当工作流的执行手册。

如果你还没买课，这篇你不需要现在做决定——先去教程站随便逛逛、找个工具栏目读两篇 understanding，体感对了再来看课程也来得及。课程入口在文末「相关阅读」里。

九、翔宇的真实路由：我自己每天怎么用这站

❗ 翔宇失败坦白

别照抄我的路由。下面写的是我作为站长 + 一人公司创业者的工作流，和你的工作流大概率不一样。看的是思路，不是动作。

我自己一天里跟这站的交互大概是这样的：

早上写文章 / 写 Skill 时——我的主力工具是 Claude Code，但写每篇文章前我会先打开教程站的 claude-code/understanding 标签页作为参考文档放在屏幕右侧。不是要查什么，是怕自己写的东西跟站上的判断不一致——这种自我对照能避免很多前后矛盾。

中午做技术选型 / 评估新工具时——我会横向打开站上 3-4 个工具栏目的 understanding 子目录，并列读判断段。这不是让我做决定的，是让我看清楚自己的判断有没有漂移——如果某个工具半年前我评价是 A，现在我倾向 B，那要么是工具变了，要么是我变了，两种情况都值得记下来。

下午做实操课更新时——课程章节涉及到的工具如果有更新，我会先去教程站把对应栏目改了，然后再来更新课程。这是我维护「公开知识地图」和「付费实操路径」一致性的固定动作。如果先改课程不改站，会出现学员从课程跳过来发现教程站还是旧的——那种体验最糟糕。

晚上做月度复盘时——我会把教程站当月新加的栏目和重大改动列一遍，看每条改动背后是什么变化驱动的（工具更新？读者反馈？我自己用法变了？）。这个动作让我对工具行业的节奏有体感——比读 changelog 直接，因为我筛过一层、判过一层。

周一早上做内容计划时——会看上周教程站的访问数据，哪一栏阅读多就把对应工具的相关内容优先排进当周翔宇官网的博客计划。这是教程站和这边博客之间的内容反馈环——读者用脚投票告诉我，下一篇博客最该写哪个工具。

十、5 个用站常踩的坑：我观察到的真实反模式

下面 5 条是我从读者反馈和站点使用数据里总结出来的高频错误，每条给一个反模式 + 一个正确做法。

坑一：把 understanding 当成 official 的「中文翻译」

反模式：用户进 understanding 子目录，期待看到的是「官方文档的中文版」，结果看到一堆「我觉得」「我认为」「这个功能新手别学」的判断段，反而觉得不专业。

正确做法：先搞清两层定位——official 是事实层（你查它），understanding 是判断层（你看它）。如果你只想查事实，进 official；如果你只想看立场，进 understanding；想完整学一个工具就两层都看。

坑二：跳读太狠，跳过了核心概念篇

反模式：完全新手第一次进站，直接点开「Claude Code Hooks 配置」或「Subagents 编排」这种深度功能页，读完一脸懵。

正确做法：每个工具栏目的 understanding 都有一篇「这工具是什么」的入门篇，强烈建议第一次进栏先读这篇 + 栏目首页（index）这两篇，再决定下一步看什么。这两篇加起来不到 20 分钟，能省你后面好几个小时的迷路时间。

坑三：不看 verifiedAt，全信教程内容

反模式：跟着一篇核对时间已经过去半年的教程做配置，发现命令跑不通，怀疑是自己环境问题，调试半天最后发现是工具版本变了教程没更新。

正确做法：每次按教程做实际配置前，看一眼 verifiedAt（站点会在文末展示），如果时间已经比较久，先点 canonical 链接到官方原文核对一下。教程站的角色是降低你的认知成本，不是替代官方权威。

坑四：用「读教材」的心态把整站读完

反模式：把站当成一本厚厚的教科书，从第一栏开始一篇一篇往下读，读了一周觉得「学了好多」，但实际工作中还是哪个工具都没真用过。

正确做法：把站当字典——选一个主力工具深读 + 实操，其他栏目当遇到时再查。AI 编程工具的核心能力靠用出来，不是靠读出来。读教程的目标是「能更快开始用」，不是「读完所有教程」。

坑五：用工具栏目数量来判断站点完整度

反模式：进站发现「咦怎么没有 X 工具」「Y 工具栏目怎么没更新」，得出结论「这站不够全」。

正确做法：教程站是按「我自己用过 + 用熟」的工具来扩展的——没有的栏目不是因为忘了，是因为我自己还没用熟，所以没法保证判断密度。这是单作者站的优势也是局限——宁缺毋滥。如果你想看的工具暂时没有栏目，最简单的做法是先用其他栏目熟悉「中文教程的读法」，等那个工具栏目上线再读。

十一、跑了 1-2 周之后的进阶路径：把教程站融进你的工作流

如果你按照前面的路径用了一两周，应该已经对站点的位置和价值有体感了。下面这张表给你「跑两周后的感受 → 下一步动作」的对应关系。

🔥 翔宇判断

AI 编程能力的分水岭不在「会用几个工具」，在「有没有把工具融进自己每天必跑的工作流」。会用五个工具但每个都不顺的人，远不如把一个工具用到日常每分钟都在用的人产出多。教程站和实操课加起来，就是想帮你完成「从知道 → 能用 → 每天用」这条路径。

十二、自检清单：进站前后的 8 个 check

读到这里你应该有动作了。下面 8 条 check 帮你确认自己用对了站。

• [ ] 我已经清楚教程站和翔宇官网博客的差别——一个是字典，一个是博客
• [ ] 我已经按 § 四对号入座，找到了自己应该走哪条路径
• [ ] 我已经选定了一个主力工具栏目 + 一个对照工具栏目
• [ ] 我已经把教程站设成浏览器收藏夹（最好固定标签页）
• [ ] 我已经知道遇到「事实查询」走 official、遇到「判断疑问」走 understanding
• [ ] 我已经看过至少一篇文章的 verifiedAt 字段，理解保鲜机制
• [ ] 我已经决定要不要把 AI 编程实操课加进自己的学习路径——可以现在不决定，但要知道课程的位置
• [ ] 我已经准备好如果发现教程站有错或过期，会反馈给翔宇

如果以上 8 条都打勾了，你比 95% 的读者用站姿势更对。

一句话收官

aiworkflowtutorials.com 是我把过去一年多的中文 AI 编程笔记强行标准化、按工具体系组织、按读者画像分层之后做出来的站——它不是给所有人的，是给那些「想认真用 AI 编程工具但中文资料一直没找到一份能信赖的」的人。别照抄我的路由，但可以从我的判断起步，把它揉进你自己的工作流。这就是这站存在的全部理由。

相关阅读

站内 AI 编程长文（继续深读）：

• Claude Code 完整学习指南：13 个核心知识点 + 新手到精通学习路径 — Claude Code 主力工具的完整学习地图
• Claude Code App、CLI、IDE 三入口怎么选 — 入口选择决策路径
• Claude Code CLAUDE.md 怎么写 — 项目记忆文件的实战写法

外部资源（按本文引用顺序）：

• aiworkflowtutorials.com — 本文介绍的中文教程站主入口
• aiworkflowtutorials.com/docs/claude-code — Claude Code 中文教程栏目
• aiworkflowtutorials.com/docs/codex — OpenAI Codex 中文教程栏目
• aiworkflowtutorials.com/docs/cursor — Cursor 中文教程栏目
• aiworkflowtutorials.com/docs/gemini-cli — Gemini CLI 中文教程栏目
• aiworkflowtutorials.com/docs/github-copilot — GitHub Copilot 中文教程栏目
• aiworkflowtutorials.com/docs/windsurf — Windsurf 中文教程栏目
• aiworkflowtutorials.com/docs/antigravity — Antigravity 中文教程栏目
• aiworkflowtutorials.com/docs/opencode — Opencode 中文教程栏目
• aiworkflowtutorials.com/docs/hermes — Hermes 编排实战栏目
• aiworkflowtutorials.com/docs/openclaw — OpenClaw 多 Agent 协作栏目
• AI 编程实操课（FlowUS） — 把教程站工具拼成可跑工作流的实操路径