Claude Code & OpenClaw & Codex & WorkBuddy 中文教程

<div align="center"> <p> <a href="https://github.com/KimYx0207/AI-Coding-Guide-Zh/stargazers"><img alt="Stars" src="https://img.shields.io/github/stars/KimYx0207/AI-Coding-Guide-Zh?style=flat-square&amp;logo=github&amp;label=Stars"></a> <a href="https://github.com/KimYx0207/AI-Coding-Guide-Zh/forks"><img alt="Forks" src="https://img.shields.io/github/forks/KimYx0207/AI-Coding-Guide-Zh?style=flat-square&amp;logo=github&amp;label=Forks"></a> <a href="LICENSE"><img alt="License" src="https://img.shields.io/github/license/KimYx0207/AI-Coding-Guide-Zh?style=flat-square&amp;label=License"></a> <img alt="Tutorial Version" src="https://img.shields.io/badge/教程版本-v5.0-blueviolet.svg"> <img alt="Claude Code" src="https://img.shields.io/badge/Claude_Code-2.1.222-green.svg"> <img alt="OpenClaw" src="https://img.shields.io/badge/OpenClaw-v2026.7.1-blue.svg"> <img alt="Codex App" src="https://img.shields.io/badge/Codex_App-26.727-orange.svg"> <img alt="WorkBuddy" src="https://img.shields.io/badge/WorkBuddy-2026.08-purple.svg"> </p>

AI Coding / Agent 工作流中文实战教程

</div>

🎯 从个人上手到团队落地：Claude Code + OpenClaw + Codex + WorkBuddy

老金基于 15+ 年游戏研发、项目管理、多部门协同、里程碑制定与数据分析经验 整理本教程，面向 中小企业 AI 赋能、高校培训、开发团队 AI Coding 落地、国内办公场景。

Codex 主线以 Codex App 为核心；CLI / Web / SDK / GitHub Action 等只作为 App 生态补充。WorkBuddy 主线面向办公人和国内团队，跟另外三条开发者主线互补不冲突。

📚 50 篇完整教程 + 1 张速查卡 | 80万+ Markdown 内容量 | 1500+ 代码块 / 命令 / 配置示例 | 250+ 问答条目

⭐ 新手能入门 | 开发者能提效 | 团队负责人能建规范 | 企业和高校能做培训

🔗 GitHub 仓库：https://github.com/KimYx0207/AI-Coding-Guide-Zh

---

📖 项目简介

这是一套系统化、适合循序学习、也能进入团队落地的 AI Coding 与 Agent 工作流中文教程，覆盖三类代表性工具：

| | Claude Code | OpenClaw | Codex | WorkBuddy | |--|-------------|----------|-------|---------| | 是什么 | Anthropic 官方 AI 编程 CLI 工具 | 开源 AI 私人助手框架 | OpenAI 编程 Agent 平台 | 腾讯 AI 办公助手桌面 App | | 干什么 | 终端里写代码、调Bug、做架构 | 消息平台上管邮件、排日程、自动化一切 | App / CLI / Web / IDE / SDK 分层协作的编程 Agent | 专家/专家团/技能/自动化/腾讯生态，办公出活 | | 谁出的 | Anthropic 官方 | Peter Steinberger（原名 Clawdbot，因 Claude 商标被迫改名） | OpenAI 官方（CLI 开源 Apache-2.0） | 腾讯云（与 CodeBuddy 同根生） | | 教程数 | 13 篇 + 1 速查卡 | 12 篇完整教程 | 14 篇完整教程 | 11 篇完整教程 |

👤 作者定位

老金是合伙创业游戏研发公司出身，15 余年一线项目经验：从策划到整体项目负责人，长期处理多部门协同、团队管理、研发里程碑、版本节奏、数据分析和交付风险。

这套教程的目标不是堆命令，而是把 AI Coding / Agent 工具转成企业和高校都能理解、能训练、能验收的实战体系：先跑起来，再接入真实工作流，最后建立团队规范和安全边界。

🧬 为什么放在一起？

因为真实落地时，企业和个人不会只用一个工具：

1. 编程生产力 — Claude Code 适合深入本地项目、改代码、跑测试、做架构分析
2. 日常自动化 — OpenClaw 适合把 AI 接到消息平台、个人助理和企业流程里
3. 多入口协作 — Codex 适合 App / CLI / Web / Cloud / GitHub 等分层协作
4. 培训与管理 — 三者放在一起，才能讲清楚工具选择、权限边界、团队规范和落地路径

✨ 核心特色

• 🎓 三线学习路径：Claude Code 编程线 + OpenClaw 助手线 + Codex Agent 线，按目标选择
• 🧭 清晰路径：从安装、第一轮任务到团队规范，按主线逐步推进
• 📚 分层阅读：新手看路线图，开发者看实操，团队负责人看规范和安全
• 💻 实战导向：1500+ 个代码块、命令片段、配置模板和提示词示例，边学边练
• 📊 质量保证：关键版本号与 App / CLI 行为优先对照 官方 Release / 文档 修订；细节仍可能随上游快速变化，请以你本机版本为准
• 🔄 持续更新：适配最新稳定版（Claude Code v2.1.222 / OpenClaw v2026.7.1-2 / Codex App 26.727；Codex CLI 辅助基线 0.146.1，实际以 App 更新日志和本机 App 信息为准）

---

🎯 按身份选择路线

| 你是谁 | 先解决什么问题 | 推荐入口 | |--------|----------------|----------| | 刚入门的读者 | 看懂核心概念，完成第一个低风险任务 | README 快速开始 → Claude Code 01 / OpenClaw OC-03 / Codex CX-01 | | 开发者 | 把 AI 接进真实项目，提高写代码和排障效率 | Claude Code 02 / 04 / 05，Codex CX-02 / CX-04 / CX-05 | | 团队负责人 / PM | 建立协作规范、里程碑检查、Review 和安全边界 | Claude Code 10 / 11，Codex CX-10 / CX-13 / CX-14 | | 企业培训 / 高校课程 | 设计可讲、可练、可验收的课程路径 | 三线快速上手 + 企业安全章节 + FAQ / 检查清单 |

---

📚 教程目录

🤖 Part 1：Claude Code — Anthropic 官方编程 CLI

| 序号 | 教程名称 | 学时 | 难度 | 必学度 | 说明 | |------|---------|------|------|--------|------| | 01 | Claude Code完整安装指南 | 2-3h | ⭐ | ⭐⭐⭐ | 环境搭建、API配置、IDE集成 | | 02 | 基础使用完整指南 | 4-6h | ⭐ | ⭐⭐⭐ | 三种使用模式、30+命令详解 | | 03 | Commands系统完整指南 | 4-6h | ⭐⭐ | ⭐⭐ | Slash 命令、Skills 工作流与兼容层 | | 04 | MCP集成完整指南 | 4-6h | ⭐⭐ | ⭐⭐⭐ | 10+核心服务器、自定义开发 | | 05 | Hooks系统完整指南 | 4-6h | ⭐⭐ | ⭐⭐⭐ | 多事件 Hook、4 类处理器、自动化工作流 | | 06 | Subagent子代理完整指南 | 1-2h | ⭐⭐ | ⭐⭐ | 官方 Subagents、Task 委派、Agent Teams（实验性） | | 07 | Skills定制完整指南 | 6-8h | ⭐⭐ | ⭐⭐ | 创建可复用功能包 | | 08 | Plugins生态完整指南 | 4-6h | ⭐⭐ | ⭐ | /plugin、市场、作用域与本地开发 | | 09 | Agent-SDK完整指南 | 6-8h | ⭐⭐⭐ | ⭐⭐ | 编程开发AI Agent | | 10 | 综合实战完整指南 | 2-3h | ⭐⭐⭐ | ⭐⭐ | 团队协作、CI/CD集成 | | 11 | 企业实战完整指南 | 4-6h | ⭐⭐⭐ | ⭐ | 企业级最佳实践 | | 12 | Remote Control完整指南 | 1-2h | ⭐⭐ | ⭐⭐ | 跨设备继续本地会话、/remote-control、claude remote-control | | 13 | Channels与计划任务完整指南 | 2-3h | ⭐⭐⭐ | ⭐ | --channels、/schedule、/loop、CronCreate |

速查：Claude Code 快速导航卡

🦞 Part 2：OpenClaw — 开源 AI 助手

| 序号 | 教程名称 | 难度 | 说明 | |------|---------|------|------| | OC-00 | 阅读指南 | 🟢 | 术语表、文档地图、4条阅读路线 | | OC-01 | 项目介绍 | 🟢 | OpenClaw 是什么、发展历史、核心架构 | | OC-02 | 安装部署 | 🟢 | macOS / Linux / Windows 全平台安装 | | OC-03 | 快速开始 | 🟢 | 完成第一个本地对话和基础检查 | | OC-04 | AI 模型配置 | 🟡 | 接入 OpenAI / Claude / Ollama 等模型 | | OC-05 | 消息平台接入 | 🟡 | 连接 WhatsApp / Telegram / Discord / 飞书等平台 | | OC-06 | 技能系统 | 🟡 | 技能生态与自定义技能开发 | | OC-07 | 记忆系统 | 🟡 | AI 如何记住你的偏好和上下文 | | OC-08 | 多 Agent 协作 | 🔴 | 一个网关跑多个独立 AI 助手 | | OC-09 | Docker 部署 | 🔴 | 容器化部署与 VPS 远程访问 | | OC-10 | 安全配置 | 🔴 | 安全配置、CVE 防护、权限管理 | | OC-11 | 常见问题 | 🟢 | 踩坑指南与解决方案 |

🤖 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 安装与认证 | 1-2h | ⭐ | Windows Microsoft Store / 防火墙，macOS 官方下载 / Gatekeeper，登录、本地项目和第一个线程 | | CX-02 | Codex App 桌面工作流 | 3-4h | ⭐⭐⭐ | App 主控台：Thread、Local、Worktree、Review、Settings、功能全景 | | CX-03 | Commands 工作流入口 | 2-3h | ⭐⭐⭐ | App 里的 slash commands、/status、/plan、/review、/mcp，以及 /goal 等长目标入口的确认方法 | | CX-04 | 项目指令、权限与配置 | 2-3h | ⭐⭐⭐ | AGENTS.md、App Settings、权限、沙盒、Rules、Hooks | | CX-05 | MCP 外部工具连接 | 2-3h | ⭐⭐⭐ | App 中接浏览器、数据库、文档源、内部 API 等外部工具 | | CX-06 | Skills 可复用工作流 | 2-3h | ⭐⭐⭐ | 在 App 中点名、触发、编写和共享 Skills | | CX-07 | Plugins / Connectors | 2-3h | ⭐⭐⭐ | App 能力包、GitHub/Gmail/Drive/Slack 等账号连接 | | CX-08 | Subagents 多 Agent 协作 | 2-3h | ⭐⭐ | App 中的并行分析、分工实现、只读审查与 worktree 配合 | | CX-09 | Automations 后台任务 | 2-3h | ⭐⭐ | App 里的周期检查、提醒、monitor、Skills + Automation | | CX-10 | Review / GitHub / PR | 2-3h | ⭐⭐⭐ | 从 App diff 到 GitHub PR、CI 修复和 Cloud 接力 | | CX-11 | Web / Cloud 辅助路径 | 1-2h | ⭐⭐ | 远程仓库、云端 environment、PR 长任务；不是 App 主线 | | CX-12 | CLI 辅助指南 | 1-2h | ⭐⭐ | 终端排查、CI、codex review、MCP/plugin 管理；不是主线 | | CX-13 | 安全与企业基线 | 2-3h | ⭐⭐⭐ | 审批、沙盒、Rules、Hooks、MCP/Plugins/Automations 权限 | | CX-14 | Codex 与 Claude Code 对比 | 1-2h | ⭐⭐ | 从 App 主线出发做双工具选择和共存 |

🐧 Part 4：WorkBuddy — 腾讯 AI 办公助手

WorkBuddy 主线面向办公人和国内团队：会用电脑但不会命令行的人、用企业微信/腾讯文档的团队、想给非技术同事一个 AI 工具的人。跟另外三条开发者主线互补，不冲突。先看 WB-00 阅读指南找到学习路径，再按需学 WB-01~WB-10。

| 序号 | 教程名称 | 学时 | 难度 | 说明 | |------|---------|------|------|------| | WB-00 | 阅读指南 | 5 分钟 | 🟢 | 五大核心概念、文档地图、阅读路线 | | WB-01 | 项目介绍 | 30-60 分钟 | ⭐ | 30 分钟召唤第一个专家，搞清 WorkBuddy 是什么 | | WB-02 | 安装与登录 | 20-40 分钟 | ⭐ | Win/Mac 双平台安装、微信扫码、跑通第一个任务 | | WB-03 | 专家与专家团 | 1-2h | ⭐⭐ | 召唤单专家、组专家团、自建专属专家团 | | WB-04 | 技能与技能市场 | 1-2h | ⭐⭐ | 一键装技能、发邮件查股价读写文件 | | WB-05 | 连接器与腾讯生态 | 1-2h | ⭐⭐ | 接 QQ 邮箱/腾讯文档/腾讯会议/企业微信 | | WB-06 | 知识库 | 1-2h | ⭐⭐ | 把资料喂给 AI，回答有依据不瞎编 | | WB-07 | 自动化与计划任务 | 1-2h | ⭐⭐ | 定时跑、远程触发、跨应用流转、7×24h | | WB-08 | 多端协同 | 1h | ⭐⭐ | 桌面/微信/小程序/企业微信无缝接力 | | WB-09 | Coding Mode 编程模式 | 1-2h | ⭐⭐ | 办公人偶尔写代码（开发者请用 Claude Code/Codex） | | WB-10 | 企业账号、安全与对比 | 1-2h | ⭐⭐⭐ | 账号积分、私有云、安全边界、四工具横向对比 |

---

📋 环境要求

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.19+ 兼容
• AI 模型 API Key：OpenAI / Anthropic / Google 等（或使用 Ollama 本地模型免 Key）
• 操作系统：macOS / Linux / Windows（推荐 WSL2）

Codex

• Codex App：当前主线按 App 26.727（2026-07-30 官方 changelog）复核；Codex 已并入 ChatGPT 桌面 App（26.707 起），macOS 从官方入口安装，Windows 以 Microsoft Store / winget -s msstore 等官方安装入口为准
• CLI / Web / Cloud 辅助：CLI 仅用于终端排查、CI、MCP / plugin 管理等辅助场景；Web / Cloud 用于远程仓库和长任务接力，版本以官方文档和当前账号能力为准
• 认证方式：ChatGPT 账户登录 或 OpenAI API Key

WorkBuddy

• WorkBuddy 桌面 App：腾讯云出品，与 CodeBuddy 同账号同团队、积分共享；Windows 10/11、macOS（Apple Silicon / Intel）都支持
• 多端：桌面 App + 微信公众号/小程序 + 企业微信，同一微信账号打通
• 认证方式：微信扫码（推荐）、QQ 扫码、手机号验证码、腾讯云账号密码
• 网络：国内服务器直连，正常办公网络不用代理

---

🚀 快速开始

克隆仓库

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写代码

WorkBuddy 路线（30 分钟上手）

Step 1（10 分钟）：WB-02 安装登录 → 装好 WorkBuddy、微信扫码
Step 2（20 分钟）：WB-01 项目介绍 → 召唤第一个专家、跑通周报任务
完成 ✅ 能用 WorkBuddy + 能让 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/