AI Code Tutorials

🚀 AI Code Tutorials Claude Code 与 OpenAI Codex AI 辅助编程教程

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

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

中文 | English | Website | Telegram | Discord

---

🔎 本教程覆盖什么

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

| 模块 | 覆盖内容 | |------|----------| | 入门基础 | Claude Code 与 Codex 概念、安装配置、第一次对话、基础命令、Git 和文件操作 | | 项目实战 | Web 应用规划、前端页面、后端 API、用户认证、功能增强、部署上线 | | 进阶工作流 | 提示词工程、代码审查、调试技巧、设计模式、错误处理、安全实践 | | AI Agent | 子代理概念、开发/架构/测试/运维代理、协作模式、MCP 服务器配置 | | Codex 专题 | Codex CLI、App、IDE、Cloud、GitHub review、AGENTS.md、sandbox、skills、plugins | | 持续更新 | Claude Code、OpenAI Codex、MCP、Skills、Agent SDK、AI 编程趋势跟踪和教程维护流程 |

📖 快速开始

如果你主要使用 Claude Code，直接从 [第一课：什么是 Claude Code？](./tutorials/01-基础概念.md) 开始学习。 如果你主要使用 OpenAI Codex，可以先读 [第十六课：OpenAI Codex 入门与实战](./tutorials/16-OpenAI-Codex入门与实战.md)，再回到第 6、7、9、12、13 课补齐通用 AI 编程工作流。

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

🎯 教程大纲

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

📘 入门篇（零基础友好）

[第一课：什么是 Claude Code？](./tutorials/01-基础概念.md)

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

[第二课：安装和配置](./tutorials/02-安装和配置.md)

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

[第三课：第一次对话](./tutorials/03-第一次对话.md)

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

[第四课：基本命令和操作](./tutorials/04-基本命令和操作.md)

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

📗 进阶篇（提升技能）

[第五课：文件操作进阶](./tutorials/05-文件操作进阶.md)

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

[第六课：项目实战 - 完整 Web 应用](./tutorials/06-项目实战-Web应用.md)

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

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

[第七课：进阶技巧和最佳实践](./tutorials/07-进阶技巧.md)

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

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

📕 高级篇（专业开发）

[第八课：Claude Code 高级应用](./tutorials/08-高级应用.md)

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

[第九课：提示词优化技巧](./tutorials/09-提示词优化技巧.md) ⭐

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

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

[第十课：AI 子代理系统](./tutorials/10-AI子代理系统.md) ⭐

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

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

[第十一课：34条实用技巧集锦](./tutorials/11-实用技巧集锦.md)

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

[第十二课：最佳实践（Anthropic官方）](./tutorials/12-最佳实践.md) ⭐

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

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

[第十三课：MCP 服务器完整指南](./tutorials/13-MCP服务器指南.md) ⭐

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

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

[第十四课：完整使用指南](./tutorials/14-完整使用指南.md) ⭐

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

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

[第十五课：AI 编程发展跟踪与持续迭代手册](./tutorials/15-AI编程发展跟踪.md) ⭐

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

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

[第十六课：OpenAI Codex 入门与实战](./tutorials/16-OpenAI-Codex入门与实战.md) ⭐

补齐 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](./CHANGELOG.md)
• 具体检查清单见 [第十五课](./tutorials/15-AI编程发展跟踪.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？](./tutorials/01-基础概念.md)
• OpenAI Codex 用户：[第十六课：OpenAI Codex 入门与实战](./tutorials/16-OpenAI-Codex入门与实战.md)

📞 获取帮助

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

📄 许可证

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

---

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

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: 0xfnzero
• Source: 0xfnzero/AI-Code-Tutorials
• License: MIT
• Homepage: https://fnzero.dev

Install and usage instructions live in the source repository linked above.