AI-Code-Tutorials

KO | EN

gitlite — search

#javascript #php #ruby #python #java #hacktoberfest #puppet #c-sharp #erlang #jquery #library #logic-programming

AI-Code-Tutorials

★ 77 Open GitHub ↗

Bilingual AI coding tutorials for Claude Code and OpenAI Codex: setup, CLI, Codex workflows, MCP, agents, code review, prompt engineering, and web projects.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<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/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 支持一下！

AI-Code-Tutorials

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README