AI-Code-Tutorials

<div align="center"> <h1>🚀 AI Code Tutorials</h1> <h3><em>Claude Code 与 OpenAI Codex AI 辅助编程教程</em></h3> </div> <p align="center"> <strong>从零基础到高级应用，系统学习 Claude Code、OpenAI Codex 和现代 AI 辅助编程工作流。</strong> </p> <p align="center"> <a href="https://github.com/0xfnzero/AI-Code-Tutorials"> <img src="https://img.shields.io/github/stars/0xfnzero/AI-Code-Tutorials?style=social" alt="GitHub stars"> </a> <a href="https://github.com/0xfnzero/AI-Code-Tutorials/network"> <img src="https://img.shields.io/github/forks/0xfnzero/AI-Code-Tutorials?style=social" alt="GitHub forks"> </a> <a href="https://github.com/0xfnzero/AI-Code-Tutorials/blob/main/LICENSE"> <img src="https://img.shields.io/badge/license-MIT-blue.svg" alt="License"> </a> <a href="https://github.com/0xfnzero/AI-Code-Tutorials/issues"> <img src="https://img.shields.io/github/issues/0xfnzero/AI-Code-Tutorials" alt="GitHub issues"> </a> </p> <p align="center"> <img src="https://img.shields.io/badge/Claude-000000?style=for-the-badge&logo=anthropic&logoColor=white" alt="Claude"> <img src="https://img.shields.io/badge/Codex-111827?style=for-the-badge&logo=openai&logoColor=white" alt="Codex"> <img src="https://img.shields.io/badge/AI-FF6B6B?style=for-the-badge&logo=openai&logoColor=white" alt="AI"> <img src="https://img.shields.io/badge/Tutorial-4B8BBE?style=for-the-badge&logo=read-the-docs&logoColor=white" alt="Tutorial"> </p> <p align="center"> <a href="#-教程大纲">教程大纲</a> • <a href="#-学习路线建议">学习路线</a> • <a href="#-学习目标">学习目标</a> • <a href="#-扩展学习资源">资源</a> </p> <p align="center"> <a href="https://github.com/0xfnzero/AI-Code-Tutorials/blob/main/README.md">中文</a> | <a href="https://github.com/0xfnzero/AI-Code-Tutorials/blob/main/README_EN.md">English</a> | <a href="https://fnzero.dev/">Website</a> | <a href="https://t.me/fnzero_group">Telegram</a> | <a href="https://discord.gg/vuazbGkqQE">Discord</a> </p> --- ## 🔎 本教程覆盖什么 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 文档](https://docs.anthropic.com/en/docs/claude-code/overview) - [Claude Code Changelog](https://code.claude.com/docs/en/changelog) #### OpenAI Codex - [OpenAI Codex Overview](https://developers.openai.com/codex) - [OpenAI Codex Manual](https://developers.openai.com/codex/codex-manual.md) #### 通用协议与生态 - [Model Context Protocol](https://modelcontextprotocol.io/docs/getting-started/intro) - [Agent Skills](https://agentskills.io) ### 推荐文章 #### 1. Claude Code 优化指南 别再瞎写提示词了！这份 Claude Code 优化指南让你效率提升 10 倍 🔗 [查看文章](https://juejin.cn/post/7539544124669870115) #### 2. Claude Code AI 子代理集合 为 Claude Code 提供 83 个专业 AI 子代理的综合集合，涵盖软件开发、基础设施和业务运营领域的专业知识 🔗 [GitHub 仓库](https://github.com/wshobson/agents) #### 3. AI 工作流实战 耗时 1 年，终于拥有属于自己的 AI 工作流 🔗 [查看文章](https://aicoding.juejin.cn/post/7551359585900331060) #### 4. AI 编程出海实践 AI 编程出海不知道做什么？通过这个方法，有人月入 10 万 🔗 [查看文章](https://aicoding.juejin.cn/post/7553598949196021812) ## 🚀 开始学习 根据你使用的工具选择入口： - Claude Code 用户：[第一课：什么是 Claude Code？](./tutorials/01-基础概念.md) - OpenAI Codex 用户：[第十六课：OpenAI Codex 入门与实战](./tutorials/16-OpenAI-Codex入门与实战.md) ## 📞 获取帮助 - 💬 遇到问题？直接在项目中问你正在使用的 AI coding agent - 🐛 发现错误？提交 Issue - 💡 有建议？欢迎 Pull Request ## 📄 许可证 本教程遵循 MIT 许可证，欢迎自由使用和分享。 --- ⭐ 如果这个教程对你有帮助，请给个 Star 支持一下！