ai-coding-guide
「可能是全网最全的」📘 面向小白的 AI 编程 CLI 中文教程:Claude Code + Codex 92 篇精修
Links
README
From the repo.
Codex 中文教程与 AI 编程指南(含 Claude Code)
简体中文 | English
📘 92 篇 · 约 52 万字 精修中文教程,主力推荐 Codex 39 篇,同时保留 Claude Code 53 篇。适合 0 基础学习,从安装入门一直走到工程实战。
📖 在线阅读(暗色终端风、体验更佳)→ https://coding.stormzhang.ai
主力推荐:从 0 基础开始学习 Codex 中文教程与中文指南
同时提供:Claude Code 中文教程

这教程跟其他教程的差异
- 以官方文档为事实来源:所有功能 / 命令 / 默认行为对照 Codex 官方 和 Claude Code 官方 核实,不抄第三方猜测、不靠传言。
- 面向小白做大量易懂化改写:每个新概念三段式(场景引入 + 生活化类比 + 实际场景);不熟命令行也能跟上。
- 有真实经验印记:每篇 3+ 处第一人称踩坑/判断(带具体细节、真实数字),不写「我觉得」式空话。
- 可照跑、可自验:每个动手环节给完整命令 + 预期输出,让你边读边动手即时反馈。
- 暗色工程风原创配图:81 张 SVG/PNG 配图,统一暗色风格、不堆字、节点 ≤ 10。
目录
Claude Code 篇(53 篇)
从「是什么 / 安装」到代理循环、MCP、子代理、Skill、Hooks、Agent SDK、GitHub Actions,再到最佳实践 / 反模式 / FAQ / 术语表。
→ 从这里开始:coding.stormzhang.ai
完整 53 篇目录
- 01 · Claude Code 简介
- 02 · 安装与使用
- 03 · Claude Code 如何工作
- 04 · API 配置:订阅登录还是 API key,怎么选、怎么切
- 05 · 接入第三方 / 国产模型
- 06 · Coding Plan:订阅套餐与计费
- 07 · 第一次使用:跑通第一个例子
- 08 · VS Code 集成
- 09 · JetBrains 集成
- 10 · 桌面 app(Desktop)
- 11 · 网页版与云端:把 Claude Code 装进浏览器和手机
- 12 · 项目初始化:用 /init 一键生成 CLAUDE.md
- 13 · 项目结构:Claude Code 在你项目里都放了什么
- 14 · 交互界面与快捷键:把手放对地方
- 15 · 怎么提问和给指令:把话说到 Claude 心坎里
- 16 · 四个最常用的活儿:探索代码库、修 bug、重构、写测试
- 17 · 图片与多模态:贴张截图,它就懂了
- 18 · CLAUDE.md 使用指南:把项目规矩写进它的记忆
- 19 · 上下文管理:别让它「失忆」也别烧爆 token
- 20 · 权限配置:放多松、收多紧,你说了算
- 21 · 安全与风险边界:到底该不该信任 AI 碰你的代码
- 22 · MCP:给 Claude 接上外部世界
- 23 · 子代理(Subagents):把活儿外包出去,别什么都自己扛
- 24 · 插件(Plugins):把一堆零碎配置一键打包
- 25 · 记忆系统(memory):让它跨会话记住你
- 26 · Agent Skills:给 Claude 装一身随叫随到的专项本事
- 27 · Skills 使用实例:装一个、喊一声、看它干活
- 28 · skill-creator 使用:用一个 skill 造你自己的 skill
- 29 · Agent teams 智能体团队:多会话协作
- 30 · 功能怎么选:CLAUDE.md vs Skill vs Hook vs MCP vs Subagent
- 31 · settings.json:用户级 / 项目级配置
- 32 · 输出样式(Output Styles):换一档「节目」,不换主持人
- 33 · 钩子(Hooks):在固定时机自动扣扳机
- 34 · CLI 参考手册:命令与全部标志
- 35 · 控制与模式:开会话时手里那块「调音台」
- 36 · 斜杠命令(Slash Commands):一个
/调出 Claude 的所有快捷动作 - 37 · 检查点(Checkpoints):随时能倒带的安全网
- 38 · 插件参考手册:把自己那套配置,打成一个能发出去的包
- 39 · 实战入门:拿一个真需求,从开工到交付走一整趟
- 40 · Chrome:让它操作浏览器
- 41 · 并行任务:让几个 Claude 同时开工,而不是排队
- 42 · 环境变量:藏在背后那排「总开关」
- 43 · Git 工作流:让 Claude 当你的 git 副手
- 44 · GitHub Actions:在 PR 里 @ 一下,让 Claude 自己干活
- 45 · Agent SDK:把 Claude Code 的能力搬进你自己的程序
- 46 · 开发配置:把 Claude 干活的「工作环境」调顺
- 47 · Voice 语音模式:把提示词说出来,而不是打出来
- 48 · 综合实战:从零到上线,把所学串成一条线
- 49 · 最佳实践:把零散的好习惯,攒成一套能照着做的心法
- 50 · 反模式:常见的错误用法
- 51 · 常见问题排查(FAQ / Troubleshooting)
- 52 · 术语表(小白友好):把这一路的「黑话」一次性翻译成人话
- 53 · 制作视频(Remotion)〔选读〕
Codex 篇(39 篇)
四种入口、AGENTS.md、沙箱审批、config.toml、Chronicle 记忆、Worktrees、从 Claude Code 迁移等。
→ 从这里开始:coding.stormzhang.ai
完整 39 篇目录
- 01 · 认识 Codex 与四种入口
- 02 · Codex 核心概念速览
- 03 · 安装与登录(Mac / Windows / Linux)
- 04 · 订阅与计费
- 05 · 接入 DeepSeek 等国产模型
- 06 · 跑通第一个任务
- 07 · 桌面 App 全景
- 08 · 命令行 CLI 上手
- 09 · IDE 扩展(VS Code 等)
- 10 · 云端 Codex Cloud:把活丢上云,喝着咖啡等结果
- 11 · 项目说明书 AGENTS.md:把规矩焊进 Codex 的开工流程
- 12 · 斜杠命令与快捷键:会话里的「快捷操作面板」
- 13 · 提示词(Prompt)写法:把话说到 Codex 心坎里
- 14 · 四类日常工作流:探索、修 bug、重构、写测试
- 15 · 权限、沙箱与审批:放多松、收多紧,自己拧
- 16 · 安全与风险边界:到底该不该放手让它碰你的代码
- 17 · 电脑操控与浏览器(Computer Use):让 Codex 长出手
- 18 · config.toml 配置详解:一个文件管住所有旋钮
- 19 · 记忆系统(Memories 与 Chronicle):让 Codex 跨会话记住你
- 20 · 用 MCP 接外部工具:给 Codex 装上「外接口」
- 21 · 子代理(Subagents):把活儿拆出去并行跑,但只有「你开口」它才拆
- 22 · Agent Skills 技能:把一套活儿打包,教会 Codex 自己接
- 23 · 插件(Plugins):一键装一整套能力,别再一个个手配
- 24 · 规则与钩子(Rules & Hooks):给 Codex 装上「卡点」和「扳机」
- 25 · Worktrees 并行隔离:让几个 Codex 各干各的,互不打架
- 26 · Git 与 GitHub 集成:让 Codex 在你的 PR 里当审查员
- 27 · 自动化与 CI/CD:让 Codex 在你不在的时候自己干活
- 28 · 非交互模式 codex exec:把它塞进脚本和 CI 里跑
- 29 · Slack / Linear 与 SDK 集成:在别处召唤 Codex,把它嵌进你自己的产品
- 30 · 怎么选模型:同一句话,到底该派哪个模型去跑
- 31 · 进阶技巧与提速:拖慢你的不是模型,是你给的烂上下文
- 32 · 从 Claude Code 迁移:旧地图换个工具,照样能找到家
- 33 · Windows 使用要点:原生还是 WSL,到底怎么跑才省心
- 34 · 综合实战:从零给一个 TODO 小工具加功能、提交一次
- 35 · 命令与配置速查表
- 36 · 最佳实践:那些「正确的废话」之外,真正能落地的几条
- 37 · 常见问题排查:装不上、登不了、不肯改文件,挨个拆
- 38 · 术语表
- 39 · 企业管理与治理:一个人玩和一家公司用,是两件事
怎么读
- 挑一个工具(建议从 Codex 起步)。
- 按编号顺序往下读,每篇 3-10 分钟。
- 边读边动手 —— 每篇都有可照跑的命令 + 预期输出。
- 学完一个章节就把它集成进你每天的开发流程。
常见疑问
| Q | A |
|---|---|
| 要付费吗? | 教程本身 完全免费(MIT)。但 Claude Code / Codex 这两个工具本身需要订阅或 API 付费,各位按自己需求订阅就好 |
| 没用过命令行能学吗? | 能。第一组「基础入门」专门照顾新手,从命令行基础带起 |
| Claude Code 和 Codex 学哪个? | 两个工具理念接近、各有所长。新手建议从 Codex 起步——门槛更低、对国内用户更友好;Claude Code 账号风控更严、封号风险更高,等熟悉了再上手更稳。Codex 篇有「从 Claude Code 迁移」横向对比,两边可无缝切换 |
| 教程会更新吗? | 这两个工具迭代很快,重要变化会跟进。版本信息见 Commits |
贡献 / 反馈
- 发现错别字、过时信息、坏链接 → 直接提 Issue
- 想改进某句表述、补充踩坑案例 → 欢迎 PR
- 想加新主题、新工具 → 先开 Issue 讨论方向
状态
🟢 稳定:92 篇全部成稿,已完成四轮审核(事实核实 / 表达优化 / 16 子代理复核)。后续以增量小修小补为主,新工具上线时新增专篇。
如果这套教程帮你少踩坑、少绕弯,⭐ Star 一下让更多人看见。
License
MIT © 2026 stormzhang
Collected info
- ★ 1,863 stars
- ⎇ 470 forks
- Source updated: 9/22/2026
Config for your environment
Replace {MCP_ENDPOINT_URL} with this MCP’s endpoint URL (from its repo or docs above). No API key — you connect directly.
Tool
OS
Config file: ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"url": "{MCP_ENDPOINT_URL}"
}
}
}Paste into mcpServers in the config file. Restart Cursor after saving.
If this MCP is also published on mcpchannel.ai, you can subscribe from Browse and use the gateway config there instead.