技术知识库 · 技术指南 · · 国科智飞 Gavin

AI Coding 学习路径:80 万字中文教程里该怎么挑

39 篇中文教程横跨 Claude Code、OpenClaw、Codex 三条线。别从头刷到尾,先按角色和目标挑一条线。

AI-Coding-Guide-Zh 是作者老金(KimYx0207)维护的中文 AI Coding 教程合集,MIT 协议,2026 年 2 月建仓后持续更新,目前在 GitHub 上有数千星标。它的特点是「三线合一」:Claude Code 13 篇、OpenClaw 12 篇、Codex 14 篇,另有 1 张速查卡,共 39 篇。仓库实测约 1.24MB、41,860 行,作者自称「80 万+ 内容量」,从体量看基本对得上。

对中文读者来说,它是把三个主流 AI Coding 工具讲成体系的最省事入口。但「省事」不等于「从头刷到尾」——80 万字全读一遍要好几天,正确的用法是把它当索引,按角色和目标挑。

覆盖范围

Claude Code 线(13 篇)走 CLI 深度。 安装(npm 与原生二进制两条路)、基础使用、Commands、MCP 集成、Hooks 系统、Subagent、Skills、Plugins、Agent SDK、综合实战、企业实战、远程控制、Channels 与计划任务。MCP、Hooks、Skills 三篇是重点,篇幅都在 60KB 以上。

OpenClaw 线(12 篇)走自托管私人助手。 从项目历史讲起——个人实验起步、后更名的这段来龙去脉也写在教程里——覆盖安装部署、模型配置、消息平台接入、技能系统、记忆系统、多 Agent 协作、Docker 部署、安全配置和 FAQ。支持的消息平台很全,WhatsApp、Telegram、Slack、Discord、Signal、iMessage、Teams、LINE、微信、QQ 等都在列;安全配置一篇重点讲 CVE 防护与权限管理。

Codex 线(14 篇)走桌面与云端工作流。 App 安装认证、桌面工作流、Commands、项目指令与权限、MCP、Skills、Plugins 与连接器、Subagents、Automations、Review 与 GitHub PR、Web/Cloud 辅助、CLI、安全企业,最后一篇是 Codex 与 Claude Code 的对比与共存策略。

工程化程度是它跟普通资源列表的区别。 每篇教程头部有统一元信息:作者、难度、阅读时间、前置知识、学习目标,还有「小白速通」提示哪些小节可以先跳过;README 提供分角色学习路径;CHANGELOG 记录版本基线,比如 v4.2 时同步到 Claude Code v2.1.158、OpenClaw v2026.5.27、Codex App 26.527,后续已迭代到 v4.3。作者另有几个配套开源仓库(多 CLI 编排、多智能体编排、Hook、记忆系统),教程与实战项目互相对应。

内容量与作者背景。 作者有十五年以上游戏研发与项目管理经验,教程之外还维护多 CLI 编排、多智能体编排等配套工具仓。篇幅最大的几篇集中在安装指南(约 100KB)、Hooks(约 80KB)、FAQ 与 Skills(各约 64KB),这些也正是踩坑最密集的地方,值得优先翻。

适合的学习路径

先选一条线,不要三条并行。选线标准很简单:你日常用哪个工具就学哪条;还没选定的,按目标选。

按角色挑章节也清楚:新手按每篇的「小白速通」提示走;开发者直奔 MCP、Hooks、Skills、Subagent;产品与管理者看综合实战、企业实战和安全章节;准备企业落地的人,Claude Code 的企业实战、OpenClaw 的安全配置、Codex 的安全企业三篇一起读。

使用建议

先核对版本,再读教程。 三个上游产品迭代都很快,教程头部的「适用版本」和「更新日期」是第一道检查;如果本机版本已经跨了好几个版本,把对应章节和官方文档对照着看。仓库的 CHANGELOG 是另一份地图,它记录了每轮更新同步到了哪个版本。

把仓库克隆下来全文搜索。 80 万字在网页上翻是折磨,克隆到本地后用编辑器搜索关键词,效率完全不一样。教程都是 Markdown,适合二次整理成自己的笔记或内部培训材料(MIT 协议允许,保留署名即可)。

按问题查,而不是按顺序读。 遇到 MCP 报错、Hook 不生效、消息平台接入失败,FAQ 和踩坑章节比重新通读更快。作者维护了 250+ 条 FAQ,不过这是自述数字,未逐条核对。

把「教程工程化」的做法学走。 每篇有难度、学时、前置知识、学习目标,CHANGELOG 管理版本,这种结构本身就值得借鉴——内部培训材料、交付文档都可以照这个格式组织。

给企业培训者的用法。 如果要拿它做内部培训,不建议整包转发:先按岗位裁剪章节,把「小白速通」段落抽成一小时入门课,再用综合实战做作业验收。教程的元信息已经标好了难度与学时,裁剪成本不高。

注意事项

版本漂移是最大的风险。 教程验证的是特定版本,上游一次 breaking change 就可能让某章失效。作者在 README 里也主动提示了这点。这不是教程质量问题,而是这类内容天然要面对的。

示例与 FAQ 数量是作者口径。 「1500+ 实操示例」「250+ FAQ 条目」来自 README 自述,没有第三方逐条计数;量级可信,但别当验收指标。

第三方兼容 API 要谨慎。 作者明确提醒,第三方兼容提供商的 API 行为可能不完全等同于官方;企业环境按官方渠道配置。

它是教材不是项目模板。 仓库里没有可运行的应用代码,照着读完不会自动得到一套系统;要练手就配合作者那几个配套仓库,或者直接拿自己的项目上手。

中文语境是优势也是边界。 对国内读者,它比官方英文文档好读得多;但遇到新特性、边界行为,官方文档仍是一手来源,教程代替不了。

更新频率不低,转载版本容易过时。 仓库从 v4.2 到 v4.3 只隔了十天左右,刷新速度跟得上上游;反过来说,收藏的版本很快会旧。看仓库当前内容为准,不要依赖任何转载或二手整理。

参考来源