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 · 企业管理与治理：一个人玩和一家公司用，是两件事

怎么读

1. 挑一个工具（建议从 Codex 起步）。
2. 按编号顺序往下读，每篇 3-10 分钟。
3. 边读边动手 —— 每篇都有可照跑的命令 + 预期输出。
4. 学完一个章节就把它集成进你每天的开发流程。

常见疑问

贡献 / 反馈

• 发现错别字、过时信息、坏链接 → 直接提 Issue
• 想改进某句表述、补充踩坑案例 → 欢迎 PR
• 想加新主题、新工具 → 先开 Issue 讨论方向

状态

🟢 稳定：92 篇全部成稿，已完成四轮审核（事实核实 / 表达优化 / 16 子代理复核）。后续以增量小修小补为主，新工具上线时新增专篇。

---

如果这套教程帮你少踩坑、少绕弯，⭐ Star 一下让更多人看见。

License

MIT © 2026 stormzhang