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> <a href="https://github.com/KimYx0207/AI-Coding-Guide-Zh"><img alt="Tutorial Version" src="https://img.shields.io/badge/教程版本-v5.2-blueviolet.svg"></a> <a href="https://github.com/KimYx0207/AI-Coding-Guide-Zh"><img alt="Claude Code" src="https://img.shields.io/badge/Claude_Code-2.1.270-green.svg"></a> <a href="https://github.com/KimYx0207/AI-Coding-Guide-Zh"><img alt="OpenClaw" src="https://img.shields.io/badge/OpenClaw-v2026.9.4-blue.svg"></a> <a href="https://github.com/KimYx0207/AI-Coding-Guide-Zh"><img alt="Codex App" src="https://img.shields.io/badge/Codex_App-26.908-orange.svg"></a> <a href="https://github.com/KimYx0207/AI-Coding-Guide-Zh"><img alt="WorkBuddy" src="https://img.shields.io/badge/WorkBuddy-5.5.6-purple.svg"></a> </p>

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

</div>

先做出一个能检查的成果，再把方法用到自己的工作里。

老金基于游戏研发、项目管理和数据分析经验，把四款工具放进日常任务里讲：修代码、写周报、处理表格、查资料、整理待办。每条入门路线都有材料和结果对照，做完再按需要深入。

今天先完成哪件事

第一次只选一行。已安装并登录，可以直接进入练习；尚未准备环境，先完成同一行的安装说明。练习时长是阅读与操作的参考，安装、网络和登录耗时另计。

| 你的任务 | 跟着做 | 做完能拿到什么 | |---|---|---| | 在终端里修一处代码错误 | Claude Code 安装 → 空列表进度练习 | 复现 NaN，修复后通过检查，再独立补一道变式题 | | 用桌面 App 完成一次小改动 | Codex App 安装 → App 修错练习 | 一份能在 Review 中看懂、能用运行结果检查的改动 | | 把散乱记录整理成周报 | WorkBuddy 安装 → 第一份周报 | 保留未完成事项和改期信息的短周报、Word 草稿 | | 让助手整理今天的待办 | OpenClaw 安装 → 待办简报 | 去重、排除已完成、保留未知时间的行动列表 |

打开配套练习材料：代码、工作记录、7 行订单和三份新旧说明都已备好，使用虚构数据。先照着做一轮，再修改一个条件，看看自己能否判断结果。

四条线保持各自重点：Claude Code 编程、Codex App 工作流、OpenClaw 助手、WorkBuddy 办公。CLI / Web / SDK / GitHub Action 在 Codex 系列中作为 App 生态补充。

🔗 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 | | 干什么 | 终端里理解项目、改代码、排查错误 | 整理待办、查询资料，按需接入消息平台和定时任务 | 在 App 中安排任务、审阅改动，配合其他入口协作 | 整理文档和表格，用专家、资料库与连接器处理办公任务 | | 谁出的 | Anthropic 官方 | Peter Steinberger（原名 Clawdbot，因 Claude 商标被迫改名） | OpenAI 官方（CLI 开源 Apache-2.0） | 腾讯云（与 CodeBuddy 同根生） | | 教程数 | 13 篇 + 1 速查卡 | 12 篇完整教程 | 14 篇完整教程 | 11 篇完整教程 |

👤 作者定位

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

这套教程从项目里常见的小问题开始：进度怎么算、周报该写哪些事实、旧资料还能不能引用。读者先完成一个任务，学会检查和修正结果，再接入自己的工作流与团队规范。

🧬 为什么放在一起？

按任务选择工具，学到需要协作时再看其他主线：

1. 编程生产力 — Claude Code 适合深入本地项目、改代码、跑测试、做架构分析
2. 日常自动化 — OpenClaw 适合把 AI 接到消息平台、个人助理和企业流程里
3. 多入口协作 — Codex 适合 App / CLI / Web / Cloud / GitHub 等分层协作
4. 办公出活 — WorkBuddy 适合不写代码的同事，把周报、调研、文档和腾讯生态里的杂活交给 AI
5. 培训与管理 — 用同类任务比较工具选择、权限边界和团队协作方式

✨ 核心特色

• 🎓 四线学习路径：Claude Code 编程线 + OpenClaw 助手线 + Codex Agent 线 + WorkBuddy 办公线，按目标选择
• 🧭 清晰路径：从安装、第一轮任务到团队规范，按主线逐步推进
• 📚 分层阅读：新手看路线图，开发者看实操，团队负责人看规范和安全
• 💻 有材料、有结果：入门任务给出可复制素材、结果对照和常见错误，做完再换条件练一次
• 📊 事实核对：关键版本号与 App / CLI 行为优先对照 官方 Release / 文档 修订；细节仍可能随上游快速变化，请以你本机版本为准
• 🔄 持续更新：教程基线为 Claude Code v2.1.270 / OpenClaw v2026.9.4 / Codex App 26.908 / WorkBuddy 5.5.6；Codex CLI 辅助基线为 0.154.0（核查日：2026-09-14，使用时对照官方 changelog 和本机版本）。

---

按高频任务找教程

先找与你手头工作最接近的一行。前四条入门路线已给出完整素材；深入章节会逐步用到你自己的项目或已授权资料。

| 手头的问题 | 从哪里开始 | 重点学会什么 | |---|---|---| | 刚接手一个仓库，不知道从哪看 | Claude Code：只读分析项目 | 找入口、运行方式和约束，再决定怎么改 | | 一个 Bug 反复改不对 | Claude Code 小 Bug / Codex App 小 Bug | 先复现，限定改动，再用同一检查确认 | | AI 改了一堆代码，看不懂是否可靠 | Codex：Review 四层阅读法 | 从文件范围、行为变化、检查结果看改动 | | 周报写得漂亮，却漏了风险 | WorkBuddy：周报练习 | 区分完成、未完成、改期和待确认 | | 表格里有重复、空值和退款 | WorkBuddy：7 行订单练习 | 先定口径，再清洗、汇总和画图 | | 要把材料整理成 Word 或汇报演示 | WorkBuddy：专家与专家团 | 给清受众、素材和结构，检查成稿再继续修改 | | 新旧资料冲突，答案没有出处 | WorkBuddy：三份资料问答 | 看生效日期和适用范围，缺信息时保留待确认 | | 会开完了，还不知道谁该做什么 | WorkBuddy：提取下一步 | 整理行动、负责人、时间和原文依据 | | 待办重复，做完的还在催 | OpenClaw：待办简报 | 去重、筛选、更新状态，不补造时间 | | 每次都要重新交代偏好 | OpenClaw：用户画像和偏好记忆 | 区分长期偏好与临时任务，核对记忆内容 | | 文件太多，需要批量整理或写小脚本 | WorkBuddy：编程任务 | 先看处理清单，用副本试运行，再处理自己的文件 | | 同一份检查、简报每天重复做 | WorkBuddy 定时任务 / Codex Automations | 先把手动流程跑顺，再设置触发、范围和失败处理 |

团队负责人可从 Claude Code 企业实战 和 Codex 安全与企业基线 补协作约定。带课时先选一条入门路线，让学员交出成果并解释一处改动，再安排后续章节。

---

📚 教程目录

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

| 序号 | 教程名称 | 学时 | 难度 | 必学度 | 说明 | |------|---------|------|------|--------|------| | 01 | Claude Code完整安装指南 | 2-3h | ⭐ | ⭐⭐⭐ | 环境搭建、API配置、IDE集成 | | 02 | 基础使用完整指南 | 4-6h | ⭐ | ⭐⭐⭐ | 从小 Bug 跟练开始，继续学项目规则、使用模式与命令 | | 03 | Commands系统完整指南 | 4-6h | ⭐⭐ | ⭐⭐ | Slash 命令、Skills 工作流与兼容层 | | 04 | MCP集成完整指南 | 4-6h | ⭐⭐ | ⭐⭐⭐ | 10+核心服务器、自定义开发 | | 05 | Hooks系统完整指南 | 4-6h | ⭐⭐ | ⭐⭐⭐ | 多事件 Hook、4 类处理器、自动化工作流 | | 06 | Subagent子代理完整指南 | 1-2h | ⭐⭐ | ⭐⭐ | 官方 Subagents、Agent 委派、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 | ⭐⭐⭐ | 先修一处代码并 Review，再深入 Thread、Local、Worktree、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 分钟 | ⭐ | 用 5 条工作记录完成周报，检查事实，再保存 Word 草稿 | | WB-02 | 安装与登录 | 20-40 分钟 | ⭐ | Win/Mac 双平台安装、微信扫码、跑通第一个任务 | | WB-03 | 专家与专家团 | 1-2h | ⭐⭐ | 7 行订单清洗、专家团与行业 Buddy 跟练 | | WB-04 | 技能与技能市场 | 1-2h | ⭐⭐ | 一键装技能、发邮件查股价读写文件 | | WB-05 | 连接器与腾讯生态 | 1-2h | ⭐⭐ | 接 QQ 邮箱/腾讯文档/腾讯会议/企业微信 | | WB-06 | 资料库与知识问答 | 入门 15–20 分钟 | ⭐⭐ | 三份新旧资料练引用、版本判断和纠错，管理与组合用法按需学 | | WB-07 | 定时任务与远程执行 | 1-2h | ⭐⭐ | 手动跑通后再定时执行，检查在线前提、记录和失败处理 | | WB-08 | 多端协同 | 1h | ⭐⭐ | 桌面/微信/小程序/企业微信无缝接力 | | WB-09 | 编程任务与 Worktree | 1-2h | ⭐⭐ | 小脚本、执行模式、Worktree 并行修改与本地合并 | | WB-