AI Coding Guide
AI 编程（Claude Code + Codex）指南
简体中文 | English
简体中文 | English
📘 92 篇 · 约 52 万字 精修中文教程，带你从装好到熟练 —— Claude Code 53 篇 + Codex 39 篇，把命令行变成你最快的那只手。
📖 在线阅读（暗色终端风、体验更佳）→ /docs/ai-coding-guide
这教程跟其他教程的差异
- 以官方文档为事实来源：所有功能 / 命令 / 默认行为对照 Claude Code 官方 和 Codex 官方 核实，不抄第三方猜测、不靠传言。
- 面向小白做大量易懂化改写：每个新概念三段式（场景引入 + 生活化类比 + 实际场景）；不熟命令行也能跟上。
- 有真实经验印记：每篇 3+ 处第一人称踩坑/判断（带具体细节、真实数字），不写「我觉得」式空话。
- 可照跑、可自验：每个动手环节给完整命令 + 预期输出，让你边读边动手即时反馈。
- 暗色工程风原创配图：81 张 SVG/PNG 配图，统一暗色风格、不堆字、节点 ≤ 10。
目录
Claude Code 篇（53 篇）
从「是什么 / 安装」到代理循环、MCP、子代理、Skill、Hooks、Agent SDK、GitHub Actions，再到最佳实践 / 反模式 / FAQ / 术语表。
→ 从这里开始：ai学习教程
- 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
- 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 · 企业管理与治理：一个人玩和一家公司用，是两件事
怎么读
- 挑一个工具（建议从 Claude Code 起步）。
- 按编号顺序往下读，每篇 3-10 分钟。
- 边读边动手 —— 每篇都有可照跑的命令 + 预期输出。
- 学完一个章节就把它集成进你每天的开发流程。