从零基础到高级应用，系统学习 Claude Code、OpenAI Codex 和现代 AI 辅助编程工作流。

教程大纲 • 学习路线 • 学习目标 • 资源

中文 | English | Website | Telegram | Discord

🔎 本教程覆盖什么

AI-Code-Tutorials 是一套中英双语 AI 辅助编程教程，面向零基础用户、独立开发者和专业工程师。当前内容覆盖 Claude Code 与 OpenAI Codex，从安装配置、第一次对话、CLI 命令、文件操作开始，逐步进入 Web 项目实战、提示词优化、代码审查、调试、安全最佳实践、MCP 服务器、AI 子代理和 Codex 多端工作流。

📖 快速开始

如果你主要使用 Claude Code，直接从 第一课：什么是 Claude Code？ 开始学习。
如果你主要使用 OpenAI Codex，可以先读 第十六课：OpenAI Codex 入门与实战，再回到第 6、7、9、12、13 课补齐通用 AI 编程工作流。

📌 维护状态：本仓库从 2026-06-20 起加入持续更新机制。版本相关内容请优先参考 第十五课：AI 编程发展跟踪与持续迭代手册 和 更新日志。

🎯 教程大纲

本教程采用循序渐进的方式，分为三个阶段：入门、进阶和高级。即使你完全没有编程基础，也能跟着学习！

📘 入门篇（零基础友好）

第一课：什么是 Claude Code？

• Claude Code 简介
• 和 ChatGPT 的区别
• 能做什么？适合谁用？
• 安全性说明

第二课：安装和配置

• 安装 Node.js
• 安装 Claude Code
• 获取和配置 API 密钥
• 第一次运行
• 常见问题解决

第三课：第一次对话

• 如何有效沟通
• 创建第一个项目（个人名片网页）
• 理解 Claude Code 的工作流程
• 常见交互场景
• 实用对话模板

第四课：基本命令和操作

• 内置命令详解
• 文件操作技巧
• 项目管理方法
• 代码搜索和导航
• Git 基础操作

📗 进阶篇（提升技能）

第五课：文件操作进阶

• 复杂项目结构管理
• 跨文件搜索和替换
• 代码重构技巧
• 批量文件操作
• 配置文件管理
• 项目文档自动化

第六课：项目实战 - 完整 Web 应用

从零构建任务管理应用，包含 8 个详细模块：

• 1.1 项目规划 - 需求分析、技术栈选择
• 1.2 项目结构搭建 - 目录结构、版本控制
• 1.3 静态页面设计 - HTML/CSS、响应式布局
• 1.4 前端功能实现 - CRUD操作、本地存储
• 1.5 后端服务器搭建 - Express、SQLite、API
• 1.6 用户认证系统 - 注册登录、JWT、密码加密
• 1.7 功能增强 - 搜索筛选、拖拽排序
• 1.8 部署上线 - Heroku部署、环境配置

第七课：进阶技巧和最佳实践

掌握高级开发技巧，包含 6 个专题模块：

• 1.1 提示词基础 - 精确描述、上下文、示例引用
• 1.2 代码审查 - 性能优化、重构建议
• 1.3 调试技巧 - 系统化调试、断点、日志
• 1.4 设计模式 - 单例、观察者、工厂模式
• 1.5 错误处理 - 统一处理、友好提示
• 1.6 安全最佳实践 - 输入验证、XSS/CSRF防护

📕 高级篇（专业开发）

第八课：Claude Code 高级应用

• AI Pair Programming（结对编程）
• 复杂项目架构设计
• 微前端架构
• 插件系统设计
• 自动化测试（单元测试、E2E测试）
• CI/CD 集成
• 多语言项目开发

第九课：提示词优化技巧 ⭐

效率提升 10 倍的秘诀，包含 6 个核心模块：

• 1.1 六大黄金原则 - 具体明确、结构化、上下文丰富
• 1.2 高级技巧 - 角色设定、思维链、约束性提示
• 1.3 模板库 - 功能开发、代码审查、Bug修复
• 1.4 最佳实践 - Dos/Don'ts、常见陷阱
• 1.5 案例研究 - 真实项目、前后对比
• 1.6 练习项目 - 提示词重写、实战演练

第十课：AI 子代理系统 ⭐

打造你的专家团队，包含 7 个专业模块：

• 1.1 核心概念 - 什么是子代理、优势、分类
• 1.2 开发类代理 - 前端、后端、全栈专家
• 1.3 架构类代理 - 系统、数据、基础设施架构师
• 1.4 测试类代理 - 测试工程师、QA、性能测试
• 1.5 运维类代理 - CI/CD、容器、监控专家
• 1.6 协作模式 - 单代理、串行、并行、审查
• 1.7 实战项目 - 完整项目开发案例

第十一课：34条实用技巧集锦

• 命令行（CLI）技巧（7条）
• 图像处理技巧（6条）
• 集成与外部数据技巧（5条）
• claude.md 配置文件技巧（7条）
• 定义斜杠命令技巧（6条）
• UI 与工作流技巧（3条）

第十二课：最佳实践（Anthropic官方） ⭐

Anthropic 官方推荐的最佳实践，包含 6 个核心主题：

• 自定义你的设置（CLAUDE.md、工具权限、gh CLI）
• 给 Claude 更多工具（bash、MCP、斜杠命令）
• 尝试常见工作流（探索-规划-编码-提交、TDD、视觉反馈）
• 优化你的工作流（具体指令、图片、URL、及时纠正）
• 用无头模式自动化基础设施（issue 分拣、linter）
• 多 Claude 协作提升效率（代码审查、多仓库、worktree）

第十三课：MCP 服务器完整指南 ⭐

从入门到精通的 MCP 服务器配置指南，包含完整教程：

• MCP 核心概念和架构
• 三种添加方法（命令行、配置文件、项目级）
• 作用域详解（Local/User/Project）
• 10 个最实用的 MCP 服务器推荐
• 常见错误及解决方案
• 调试技巧和最佳实践
• 中文用户特别注意事项

第十四课：完整使用指南 ⭐

Claude Code 百科全书和日常参考手册，包含全面内容：

• 安装配置与系统要求
• CLI 命令完整详解
• 配置文件管理（全局/项目/环境）
• MCP 服务器深度集成
• 提示词工程与模板库
• 文件操作与代码重构
• Git 工作流与团队协作
• 项目管理与文档管理
• 性能优化技巧
• 安全最佳实践
• 故障排查与调试
• 生产环境实践（CI/CD、Docker、监控）

第十五课：AI 编程发展跟踪与持续迭代手册 ⭐

让教程持续跟进 AI 发展，建立可重复的维护机制：

• Claude Code 版本、变更日志和 CLI 命令复核
• MCP 规范、鉴权、安全和生产实践追踪
• Skills、Plugins、Agent SDK 与多 agent 工作流跟进
• 内容更新检查清单、Roadmap 和更新日志规范

第十六课：OpenAI Codex 入门与实战 ⭐

补齐 OpenAI Codex 工作流，覆盖 Codex 的主要入口和团队实践：

• Codex CLI、IDE 扩展、Codex app、Codex cloud 与 GitHub review
• AGENTS.md、config.toml、sandbox、approval policy 与 rules
• MCP、skills、plugins 与项目级可复用工作流
• Codex 与 Claude Code 的差异、组合和后续学习路线

🎓 学习路线建议

零基础用户

第一课 → 第二课 → 第三课 → 第四课 → 第六课（实战）
预计学习时间：2-3 周

有编程基础用户

第一课（快速浏览）→ 第二课 → 第四课 → 第五课 → 第六课 → 第七课 → 第九课 → 第十课 → 第十六课
预计学习时间：1-2 周

专业开发者

第二课（安装）→ 第五课 → 第七课 → 第九课（必学）→ 第十课（必学）→ 第十三课（MCP）→ 第十五课（持续跟进）→ 第十六课（Codex）
预计学习时间：3-5 天

Codex 用户

第十六课（Codex）→ 第十三课（MCP）→ 第十五课（持续跟进）→ 第七课（进阶技巧）→ 第九课（提示词优化）→ 第十课（AI Agent）
预计学习时间：3-5 天

💡 学习建议

1. 按顺序学习 - 后面的课程会用到前面的知识
2. 动手实践 - 每课都有练习任务，一定要自己做
3. 不要跳过 - 即使觉得简单，也要过一遍
4. 多提问 - 遇到不懂的，直接问 Claude Code
5. 做笔记 - 记录常用命令和技巧
6. 创建项目 - 学完每个阶段，做一个小项目巩固

🎯 学习目标

完成本教程后，你将能够：

• ✅ 熟练使用 Claude Code 进行日常开发
• ✅ 熟悉 OpenAI Codex 的 CLI、App、IDE、Cloud 和 GitHub review 工作流
• ✅ 独立完成前端和后端项目
• ✅ 运用最佳实践编写高质量代码
• ✅ 设计和实现复杂的应用架构
• ✅ 建立完整的开发工作流
• ✅ 跟进 AI 编程工具变化并定期更新团队实践
• ✅ 使用 AI 提升 10 倍开发效率

🔄 持续更新机制

AI 编程工具更新很快，本仓库后续按“官方来源核对 + 中英文同步 + 更新日志记录”的方式维护：

• 每月检查 Claude Code、OpenAI Codex、MCP、Skills、Agent SDK 的官方文档和版本变化
• 每季度复核教程中的命令、配置、模型名、部署平台和安全建议
• 所有版本相关更新记录到 CHANGELOG.md
• 具体检查清单见 第十五课

📚 扩展学习资源

官方文档

Claude Code

• Claude Code 文档
• Claude Code Changelog

OpenAI Codex

• OpenAI Codex Overview
• OpenAI Codex Manual

通用协议与生态

• Model Context Protocol
• Agent Skills

推荐文章

1. Claude Code 优化指南

别再瞎写提示词了！这份 Claude Code 优化指南让你效率提升 10 倍

🔗 查看文章

2. Claude Code AI 子代理集合

为 Claude Code 提供 83 个专业 AI 子代理的综合集合，涵盖软件开发、基础设施和业务运营领域的专业知识

🔗 GitHub 仓库

3. AI 工作流实战

耗时 1 年，终于拥有属于自己的 AI 工作流

🔗 查看文章

4. AI 编程出海实践

AI 编程出海不知道做什么？通过这个方法，有人月入 10 万

🔗 查看文章

🚀 开始学习

根据你使用的工具选择入口：

• Claude Code 用户：第一课：什么是 Claude Code？
• OpenAI Codex 用户：第十六课：OpenAI Codex 入门与实战

📞 获取帮助

• 💬 遇到问题？直接在项目中问你正在使用的 AI coding agent
• 🐛 发现错误？提交 Issue
• 💡 有建议？欢迎 Pull Request

📄 许可证

本教程遵循 MIT 许可证，欢迎自由使用和分享。

⭐ 如果这个教程对你有帮助，请给个 Star 支持一下！