# AI-Coding-Guide-Zh
**Repository Path**: merrick/AI-Coding-Guide-Zh
## Basic Information
- **Project Name**: AI-Coding-Guide-Zh
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-12
- **Last Updated**: 2026-05-12
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# Claude Code & OpenClaw & Codex 中文教程
**AI 三顶流 · 中文教程扛把子**
> 🎯 **Claude Code（官方编程神器）+ OpenClaw（开源 AI 助手框架）+ Codex（OpenAI 编程 Agent）= 最强 AI 工具三教程**
>
> Codex 主线以 **Codex App** 为核心；CLI / Web / SDK / GitHub Action 等只作为 App 生态补充。
> 📚 36个完整教程 | 180,000+字 | 90+代码示例 | 230+FAQ
> ⭐ 小白友好 | 从零到企业实战 | 三线学习路径
> 🔗 **GitHub仓库**：[https://github.com/KimYx0207/AI-Coding-Guide-Zh](https://github.com/KimYx0207/AI-Coding-Guide-Zh)
> 老金的开源知识库，实时更新群二维码：https://my.feishu.cn/wiki/OhQ8wqntFihcI1kWVDlcNdpznFf
---
## 📞 联系方式
### ☕ 请我喝杯咖啡
如果这个教程对你有帮助，欢迎打赏支持！
微信支付
|
支付宝
|
---
## 📖 项目简介
这是一套**系统化、小白友好、三顶流合璧**的 AI 工具中文教程，涵盖三大王者级产品：
| | Claude Code | OpenClaw | Codex |
|--|-------------|----------|-------|
| **是什么** | Anthropic 官方 AI 编程 CLI 工具 | 开源 AI 私人助手框架 | OpenAI 编程 Agent 平台 |
| **干什么** | 终端里写代码、调Bug、做架构 | 消息平台上管邮件、排日程、自动化一切 | App / CLI / Web / IDE / SDK 分层协作的编程 Agent |
| **谁出的** | Anthropic 官方 | Peter Steinberger（原名 Clawdbot，因 Claude 商标被迫改名） | OpenAI 官方（CLI 开源 Apache-2.0） |
| **教程数** | 13 篇 + 1 速查卡 | 12 篇完整教程 | 11 篇完整教程 |
### 🧬 为什么放在一起？
**因为它们是 AI Agent 时代的一体多面：**
1. **血脉相连** — OpenClaw 原名 **Clawdbot**（Claude + Bot），DNA 里流着 Claude 的血，被 Anthropic 强制改名后依然是 Claude API 最大的社区消费者
2. **互补工具链** — Claude Code 管**编程工作流**，OpenClaw 管**日常工作流**，Codex 管**快速 Agent 任务**，合在一起就是程序员的 AI 全家桶
3. **双强协作** — Codex 和 Claude Code 通过 MCP Server 共享工具链，双工具协作是 2026 年专业开发者的正确姿势
4. **中国用户刚需** — 三大顶流 AI 工具的中文教程，一站式搞定，不用东找西找
### ✨ 核心特色
- **🎓 三线学习路径**：Claude Code 编程线 + OpenClaw 助手线 + Codex Agent 线，各取所需
- **🚀 快速上手**：Claude Code 3 小时上手 / OpenClaw 5 分钟跑起来 / Codex 20 分钟上手
- **👶 小白友好**：90+术语解释、50+生活类比、230+FAQ
- **💻 实战导向**：90+个可运行代码示例，边学边练
- **📊 质量保证**：关键版本号与 CLI 行为优先对照 **官方 Release / 文档** 修订；细节仍可能随上游快速变化，请以你本机版本为准
- **🔄 持续更新**：适配最新版本（Claude Code v2.1.133 / OpenClaw 稳定版 v2026.3.28 / Codex CLI v0.129.0，实际以 GitHub Releases 和本机 `codex --version` 为准）
---
## 📚 教程目录
### 🤖 Part 1：Claude Code — Anthropic 官方编程神器
| 序号 | 教程名称 | 学时 | 难度 | 必学度 | 说明 |
|------|---------|------|------|--------|------|
| 01 | [Claude Code完整安装指南](docs/claude-code/01-Claude-Code完整安装指南.md) | 2-3h | ⭐ | ⭐⭐⭐ | 环境搭建、API配置、IDE集成 |
| 02 | [基础使用完整指南](docs/claude-code/02-基础使用完整指南.md) | 4-6h | ⭐ | ⭐⭐⭐ | 三种使用模式、30+命令详解 |
| 03 | [Commands系统完整指南](docs/claude-code/03-Commands系统完整指南.md) | 4-6h | ⭐⭐ | ⭐⭐ | Slash 命令、Skills 工作流与兼容层 |
| 04 | [MCP集成完整指南](docs/claude-code/04-MCP集成完整指南.md) | 4-6h | ⭐⭐ | ⭐⭐⭐ | 10+核心服务器、自定义开发 |
| 05 | [Hooks系统完整指南](docs/claude-code/05-Hooks系统完整指南.md) | 4-6h | ⭐⭐ | ⭐⭐⭐ | 多事件 Hook、4 类处理器、自动化工作流 |
| 06 | [Subagent子代理完整指南](docs/claude-code/06-Subagent子代理完整指南.md) | 1-2h | ⭐⭐ | ⭐⭐ | 官方 Subagents、Task 委派、Agent Teams（实验性） |
| 07 | [Skills定制完整指南](docs/claude-code/07-Skills定制完整指南.md) | 6-8h | ⭐⭐ | ⭐⭐ | 创建可复用功能包 |
| 08 | [Plugins生态完整指南](docs/claude-code/08-Plugins生态完整指南.md) | 4-6h | ⭐⭐ | ⭐ | `/plugin`、市场、作用域与本地开发 |
| 09 | [Agent-SDK完整指南](docs/claude-code/09-Agent-SDK完整指南.md) | 6-8h | ⭐⭐⭐ | ⭐⭐ | 编程开发AI Agent |
| 10 | [综合实战完整指南](docs/claude-code/10-综合实战完整指南.md) | 2-3h | ⭐⭐⭐ | ⭐⭐ | 团队协作、CI/CD集成 |
| 11 | [企业实战完整指南](docs/claude-code/11-企业实战完整指南.md) | 4-6h | ⭐⭐⭐ | ⭐ | 企业级最佳实践 |
| 12 | [Remote Control完整指南](docs/claude-code/12-Remote-Control完整指南.md) | 1-2h | ⭐⭐ | ⭐⭐ | 跨设备继续本地会话、`/remote-control`、`claude remote-control` |
| 13 | [Channels与计划任务完整指南](docs/claude-code/13-Channels与计划任务完整指南.md) | 2-3h | ⭐⭐⭐ | ⭐ | `--channels`、`/schedule`、`/loop`、`CronCreate` |
**速查**：[Claude Code 快速导航卡](docs/claude-code/快速导航卡.md)
### 🦞 Part 2：OpenClaw — 开源 AI 助手
| 序号 | 教程名称 | 难度 | 说明 |
|------|---------|------|------|
| OC-00 | [阅读指南](docs/openclaw/00-阅读指南.md) | 🟢 | 术语表、文档地图、4条阅读路线 |
| OC-01 | [项目介绍](docs/openclaw/01-OpenClaw项目介绍.md) | 🟢 | OpenClaw 是什么、发展历史、核心架构 |
| OC-02 | [安装部署](docs/openclaw/02-安装部署指南.md) | 🟢 | macOS / Linux / Windows 全平台安装 |
| OC-03 | [快速开始](docs/openclaw/03-快速开始指南.md) | 🟢 | 5 分钟跑起来第一个对话 |
| OC-04 | [AI 模型配置](docs/openclaw/04-模型配置指南.md) | 🟡 | 接入 OpenAI / Claude / Ollama 等模型 |
| OC-05 | [消息平台接入](docs/openclaw/05-消息平台接入指南.md) | 🟡 | 连接 WhatsApp / Telegram / Discord / 飞书等平台 |
| OC-06 | [技能系统](docs/openclaw/06-技能系统指南.md) | 🟡 | 技能生态与自定义技能开发 |
| OC-07 | [记忆系统](docs/openclaw/07-记忆系统指南.md) | 🟡 | AI 如何记住你的偏好和上下文 |
| OC-08 | [多 Agent 协作](docs/openclaw/08-多Agent协作指南.md) | 🔴 | 一个网关跑多个独立 AI 助手 |
| OC-09 | [Docker 部署](docs/openclaw/09-Docker部署指南.md) | 🔴 | 容器化部署与 VPS 远程访问 |
| OC-10 | [安全配置](docs/openclaw/10-安全配置指南.md) | 🔴 | 安全配置、CVE 防护、权限管理 |
| OC-11 | [常见问题](docs/openclaw/11-常见问题FAQ.md) | 🟢 | 踩坑指南与解决方案 |
### 🤖 Part 3：Codex — OpenAI 编程 Agent 平台
Codex 学习主线：**只有 Codex App 一条主线**。先看 CX-01 安装认证和 CX-02 App 桌面工作流；CX-03 到 CX-10 按功能拆开讲 Commands、项目指令、MCP、Skills、Plugins、Subagents、Automations、Review / GitHub；CX-11 和 CX-12 分别是 Web / Cloud、CLI 辅助；CX-13 安全企业；CX-14 为 Claude Code 对比附录。
| 序号 | 教程名称 | 学时 | 难度 | 说明 |
|------|---------|------|------|------|
| CX-01 | [Codex App 安装与认证](docs/codex/CX-01-Codex-App安装与认证完整指南.md) | 1-2h | ⭐ | Windows Microsoft Store / 防火墙，macOS 官方下载 / Gatekeeper，登录、本地项目和第一个线程 |
| CX-02 | [Codex App 桌面工作流](docs/codex/CX-02-Codex-App桌面工作流完整指南.md) | 3-4h | ⭐⭐⭐ | App 主控台：Thread、Local、Worktree、Review、Settings、功能全景 |
| CX-03 | [Commands 工作流入口](docs/codex/CX-03-Codex-Commands工作流入口完整指南.md) | 2-3h | ⭐⭐⭐ | App 里的 slash commands、/status、/plan-mode、/review、/mcp，以及 /goal、/loop 等实验入口的确认方法 |
| CX-04 | [项目指令、权限与配置](docs/codex/CX-04-Codex项目指令权限配置完整指南.md) | 2-3h | ⭐⭐⭐ | AGENTS.md、App Settings、权限、沙盒、Rules、Hooks |
| CX-05 | [MCP 外部工具连接](docs/codex/CX-05-Codex-MCP外部工具完整指南.md) | 2-3h | ⭐⭐⭐ | App 中接浏览器、数据库、文档源、内部 API 等外部工具 |
| CX-06 | [Skills 可复用工作流](docs/codex/CX-06-Codex-Skills可复用工作流完整指南.md) | 2-3h | ⭐⭐⭐ | 在 App 中点名、触发、编写和共享 Skills |
| CX-07 | [Plugins / Connectors](docs/codex/CX-07-Codex-Plugins连接器完整指南.md) | 2-3h | ⭐⭐⭐ | App 能力包、GitHub/Gmail/Drive/Slack 等账号连接 |
| CX-08 | [Subagents 多 Agent 协作](docs/codex/CX-08-Codex-Subagents多Agent协作完整指南.md) | 2-3h | ⭐⭐ | App 中的并行分析、分工实现、只读审查与 worktree 配合 |
| CX-09 | [Automations 后台任务](docs/codex/CX-09-Codex-Automations后台任务完整指南.md) | 2-3h | ⭐⭐ | App 里的周期检查、提醒、monitor、Skills + Automation |
| CX-10 | [Review / GitHub / PR](docs/codex/CX-10-Codex-Review-GitHub-PR完整指南.md) | 2-3h | ⭐⭐⭐ | 从 App diff 到 GitHub PR、CI 修复和 Cloud 接力 |
| CX-11 | [Web / Cloud 辅助路径](docs/codex/CX-11-Codex-Web-Cloud辅助指南.md) | 1-2h | ⭐⭐ | 远程仓库、云端 environment、PR 长任务；不是 App 主线 |
| CX-12 | [CLI 辅助指南](docs/codex/CX-12-Codex-CLI辅助完整指南.md) | 1-2h | ⭐⭐ | 终端排查、CI、codex review、MCP/plugin 管理；不是主线 |
| CX-13 | [安全与企业基线](docs/codex/CX-13-Codex安全企业完整指南.md) | 2-3h | ⭐⭐⭐ | 审批、沙盒、Rules、Hooks、MCP/Plugins/Automations 权限 |
| CX-14 | [Codex 与 Claude Code 对比](docs/codex/CX-14-Codex与Claude-Code对比指南.md) | 1-2h | ⭐⭐ | 从 App 主线出发做双工具选择和共存 |
---
## 📋 环境要求
### Claude Code
- **操作系统**：Windows 10+、macOS 10.15+、Linux
- **安装方式**：支持标准安装（`npm install -g @anthropic-ai/claude-code`，需 Node.js 18+）和原生二进制安装（beta / 改进安装路径）
- **认证方式**：可用 Claude 订阅登录，也可用 Anthropic Console / 第三方兼容提供商配置
- **IDE**：VS Code、Cursor、Windsurf 或其他支持的编辑器
> ⚠️ **2026年更新**：Claude Code 已提供原生二进制安装，但 **Node.js 18+ 的标准 npm 安装路径仍然受支持**。本仓库安装指南现同时覆盖两条路径，并明确各自适用场景。
### OpenClaw
- **Node.js**：24.x 推荐，22.14+ 兼容
- **AI 模型 API Key**：OpenAI / Anthropic / Google 等（或使用 Ollama 本地模型免 Key）
- **操作系统**：macOS / Linux / Windows（推荐 WSL2）
### Codex
- **Codex App**：macOS / Windows 桌面端（macOS 从官方 Codex App 入口安装；Windows 以 Microsoft Store / `winget -s msstore` 等官方安装入口为准；Linux 使用 CLI 或 Web）
- **Codex CLI**：Node.js 22+（`npm install -g @openai/codex`）；也可按官方 CLI 文档选择 Homebrew Cask 等路径
- **Codex Web / Cloud**：现代浏览器 + 支持 Codex 的 ChatGPT 账号或组织工作区
- **认证方式**：ChatGPT 账户登录 或 OpenAI API Key
---
## 🚀 快速开始
### 克隆仓库
```bash
git clone https://github.com/KimYx0207/AI-Coding-Guide-Zh.git
cd AI-Coding-Guide-Zh
```
### Claude Code 路线（3小时上手）
```
Step 1（60分钟）：01-安装指南 → 路径A快速上手
Step 2（30分钟）：04-MCP集成 → 第2部分快速开始
Step 3（30分钟）：05-Hooks系统 → 第2部分快速开始
完成 ✅ 能用Claude Code + 能用MCP + 能用Hook
```
### OpenClaw 路线（1小时上手）
```
Step 1（15分钟）：OC-01 项目介绍 → 了解全局
Step 2（20分钟）：OC-02 环境安装 → 装好环境
Step 3（10分钟）：OC-03 快速开始 → 跑起第一个对话
Step 4（15分钟）：OC-04 模型配置 → 接入 AI 模型
完成 ✅ 能用OpenClaw + 能和AI对话
```
### Codex 路线（20分钟上手）
```
Step 1（10分钟）：CX-01 安装与认证 → 装好 Codex + 配好认证
Step 2（10分钟）：CX-02 App 桌面工作流 → 跑起第一个 App 线程
完成 ✅ 能用Codex + 能让AI写代码
```
### 完整掌握路径
```
Week 1-2：Claude Code 安装 + 基础使用 + MCP
Week 3-4：Claude Code Hooks + Skills + Plugins
Week 5 ：Claude Code 模型配置 + Remote Control + Channels/计划任务
Week 6 ：Claude Code Agent-SDK + 综合实战
Week 7 ：OpenClaw 安装 + 快速开始 + 模型配置
Week 8 ：OpenClaw 消息平台 + 技能系统 + 记忆系统
Week 9 ：OpenClaw 多Agent + Docker部署 + 安全
Week 10 ：Codex App 安装 + App 桌面工作流 + Commands
Week 11 ：项目指令 + MCP + Skills + Plugins / Connectors + Subagents
Week 12 ：Automations + Review / GitHub / PR + Web/Cloud/CLI 辅助 + 安全
```
---
## 📊 项目统计
| 指标 | 数值 |
|------|------|
| **教程总数** | 39 篇完整教程（Claude Code 13 / OpenClaw 12 / Codex 14）+ 1 速查卡 |
| **总字数** | ~180,000 字 |
| **代码示例** | 90+个（全部可运行） |
| **FAQ数量** | 230+ 个 |
| **覆盖AI模型** | 29 个提供商（OpenClaw） |
| **覆盖消息平台** | 15+ 个（OpenClaw） |
| **Claude Code版本** | 2.1.133（2026-05-08 验证） |
| **OpenClaw版本** | 稳定版 **v2026.3.28**（2026-04-05 对照 [Releases](https://github.com/openclaw/openclaw/releases)）；列表含预发布时请自行取舍 |
| **Codex版本** | CLI v0.129.0（2026-05-08 GitHub Release）；本仓库按 2026-05 官方文档修订，实际以 `codex --version` 与 [GitHub](https://github.com/openai/codex) 为准 |
---
## 🔖 版本说明
> **版本校验方法**：本仓库教程中的版本号和 CLI 行为，优先对照 **官方 Release / 官方文档** 修订。上游产品迭代很快，部分细节可能在你阅读时已发生变化。
>
> **遇到版本不一致时**：以你本机 `claude --version`、`codex --version` 或 `npm list -g` 的输出为准，教程示例按官方最新文档调整。
| 产品 | 当前验证版本 | 验证日期 | 官方来源 |
|------|-------------|---------|---------|
| Claude Code | v2.1.133 | 2026-05-08 | [GitHub Releases](https://github.com/anthropics/claude-code/releases) |
| OpenClaw | 稳定版 v2026.3.28 | 2026-04-05 | [GitHub Releases](https://github.com/openclaw/openclaw/releases) |
| Codex CLI | v0.129.0 | 2026-05-08 | [GitHub Releases](https://github.com/openai/codex) |
> ⚠️ **版本号会随上游更新而失效**。教程中标注的版本号是编写/验证时的快照，不代表实时最新。遇到命令或参数不一致时，优先查官方 Release Notes 和 CLI 帮助（`--help`）。
---
## 🔌 第三方模型配置说明
三大工具均支持多种模型接入方式，具体配置见各教程：
| 产品 | 支持方式 | 配置入口 |
|------|---------|---------|
| **Claude Code** | Anthropic Console / Claude 订阅 / 第三方兼容提供商（`ANTHROPIC_BASE_URL`） | [01-安装指南：API中转站配置](docs/claude-code/01-Claude-Code完整安装指南.md) |
| **OpenClaw** | 29 个提供商（OpenAI / Claude / Gemini / Ollama / 本地模型等） | [04-模型配置指南](docs/openclaw/04-模型配置指南.md) |
| **Codex** | ChatGPT 账户登录 / OpenAI API Key | [CX-01 App 安装与认证](docs/codex/CX-01-Codex-App安装与认证完整指南.md) |
> ⚠️ **第三方模型注意事项**：
> - 第三方兼容提供商的 API 行为可能不完全等同于官方（速率限制、模型列表、功能支持可能有差异）
> - 本地模型（Ollama 等）能力取决于模型本身，复杂任务可能不如旗舰模型
> - 各提供商计费方式不同，使用前请确认价格策略
---
## 🎯 适用人群
- ✅ **零基础小白**：从未接触过 AI 编程工具，想系统学习
- ✅ **开发者**：想用 Claude Code 提升编程效率 + 用 OpenClaw 自动化日常工作
- ✅ **团队负责人**：为团队制定 AI 工具使用规范
- ✅ **企业用户**：企业级部署和最佳实践
- ✅ **AI 爱好者**：想搭建自己的 AI 私人助手
---
## 💡 学习建议
### 初学者（零基础）
**想学编程 AI** → 从 Claude Code Part 1 开始（01 → 04 → 05）
**想玩 AI 助手** → 从 OpenClaw Part 2 开始（OC-01 → OC-02 → OC-03）
**想试 Codex** → 从 Codex Part 3 开始（CX-01 → CX-02 或 CX-03）
**都想学** → 先 Claude Code 3 小时上手，再 Codex 20 分钟上手，最后 OpenClaw 1 小时上手
### 进阶者（有基础）
- Claude Code 重点：04-MCP、05-Hooks、06-Subagent、07-Skills
- OpenClaw 重点：06-技能系统、08-多Agent路由
- Codex 重点：CX-05 配置系统、CX-06 Skills、CX-07 MCP
### 高级者（深度定制）
- Claude Code：09-Agent-SDK、10-综合实战
- OpenClaw：08-多Agent、09-Docker部署、10-安全
- Codex：CX-09 沙箱安全、CX-10 综合实战、CX-11 双工具协作
- **双工具协作**：Codex + Claude Code 通过 MCP Server 共享工具链（详见 CX-11）
- 长期 Skill 治理：可参考 [SkillClaw](https://github.com/AMAP-ML/SkillClaw)（skill 演化、去重、合并、共享；论文 [arXiv:2604.08377](https://arxiv.org/abs/2604.08377)）
---
## 🤝 贡献指南
欢迎提交 Issue 和 Pull Request！
- 发现错误或过时信息，请提交 Issue
- 有改进建议，欢迎提交 PR
- 想分享使用经验，欢迎在 Discussions 讨论
---
## 📄 许可证
本项目采用 [MIT License](LICENSE) 开源协议。
---
## 🙏 致谢
感谢所有为 Claude Code 和 OpenClaw 生态做出贡献的开发者和社区成员！
---
## 📋 更新说明
完整更新记录统一维护在 [CHANGELOG.md](CHANGELOG.md)。README 只保留当前项目介绍、目录和使用入口，避免版本说明在多处漂移。
---
## ⚠️ 免责声明
- Claude Code 教程基于 **v2.1.133** 编写（[Release](https://github.com/anthropics/claude-code/releases/tag/v2.1.133)）；OpenClaw 教程以 **稳定版 v2026.3.28** 为修订参考；Codex 教程按 **2026-05 OpenAI 官方 Codex 文档** 修订，CLI/App 版本以本机和官方 Releases 为准
- **预发布与 `latest` 以各项目 [Releases](https://github.com/openclaw/openclaw/releases) 与本机版本为准**（持续更新中）
- 部分功能可能随版本更新而变化，请以官方文档为准
- 使用本教程产生的任何问题，作者不承担责任
---
⭐ 如果这个教程对你有帮助，欢迎 Star 支持！
📢 分享给更多需要的人，让 AI 工具学习更简单！
