AI-Coding-Guide-Zh — 用中文实操教程，带零基础者上手四类 AI 编程与 Agent 工具 · Shelfry
首页 / AI 与智能 / AI-Coding-Guide-Zh
shelfry.app/p/ai-coding-guide-zh
AI-Coding-Guide-Zh 这是一套面向中文读者的 AI 编程与 Agent 工作流教程仓库，围绕 Claude Code、Codex、OpenClaw 和 WorkBuddy 四条主线展开。内容包含 50 篇教程与一张速查卡，从安装配置、第一个小任务到团队协作与安全规范逐步推进。每篇入门练习配有虚构素材、结果对照和常见错误，强调先做出可检查的成果，再迁移到自己的工作场景。
今天先完成哪件事
零基础怎么开始学 AI 编程？ 先选一种工具、完成一个小任务，再学后续功能。喜欢在终端操作，走下面的 Claude Code 路线；想在桌面 App 里查看改动，走 Codex 路线。暂时只想处理周报、表格或待办，也有对应的办公与助手练习。
第一次只选一行。已安装并登录，可以直接进入练习；尚未准备环境，先完成同一行的安装说明。练习时长是阅读与操作的参考，安装、网络和登录耗时另计。
打开配套练习材料 ：代码、工作记录、7 行订单和三份新旧说明都已备好，使用虚构数据。先照着做一轮，再修改一个条件，看看自己能否判断结果。
AI 写完代码，怎么检查结果？ 以进度计算练习 为例：先运行原始测试，确认空列表会得到 NaN；让助手只修改指定源码，保留测试；再运行同一条测试，确认空列表为 0、正常比例和四舍五入仍正确。最后自己补一道“完成 3 项、共 8 项，百分比四舍五入应得到 38”的变式题。用 Codex App 跟练时，再按 Review 四层阅读法 核对文件范围、行为变化与检查结果。
这套教程与样例可免费阅读，采用 MIT 许可 。工具账号、模型用量及你自己的部署费用按所选服务计算。这里的练习是教学样例，不是学员商业成绩。
四条线保持各自重点：Claude Code 编程、Codex App 工作流、OpenClaw 助手、WorkBuddy 办公 。CLI / Web / SDK / GitHub Action 在 Codex 系列中作为 App 生态补充。
📖 项目简介 这是一套可以循序学习，也能用于团队培训和项目实践的 AI Coding 与 Agent 工作流中文教程 ，覆盖四类代表性工具：
Claude Code OpenClaw Codex WorkBuddy 是什么 Anthropic 官方 AI 编程工具，提供 CLI、IDE、桌面和 Web 入口 开源 AI 私人助手框架 OpenAI 编程 Agent 平台 腾讯 AI 办公助手桌面 App 干什么 终端里理解项目、改代码、排查错误 整理待办、查询资料，按需接入消息平台和定时任务 在 App 中安排任务、审阅改动，配合其他入口协作 整理文档和表格，用专家、资料库与连接器处理办公任务 谁出的 Anthropic 官方 Peter Steinberger（原名 Clawdbot，因 Claude 商标被迫改名） OpenAI 官方（CLI 开源 Apache-2.0） 腾讯云（与 CodeBuddy 同根生） 教程数 13 篇 + 1 速查卡 12 篇完整教程 14 篇完整教程 11 篇完整教程
👤 作者定位 老金有合伙创办游戏研发公司的经历，也有 15 余年一线项目经验：从策划到整体项目负责人，长期处理多部门协同、团队管理、研发里程碑、版本节奏、数据分析和交付风险。
这套教程从项目里常见的小问题开始：进度怎么算、周报该写哪些事实、旧资料还能不能引用。读者先完成一个任务，学会检查和修正结果，再接入自己的工作流与团队规范。
🧬 为什么放在一起？
编程生产力 — Claude Code 适合深入本地项目、改代码、跑测试、做架构分析日常自动化 — OpenClaw 适合把 AI 接到消息平台、个人助理和企业流程里多入口协作 — Codex 适合 App / CLI / Web / Cloud / GitHub 等分层协作办公出活 — WorkBuddy 适合不写代码的同事，把周报、调研、文档和腾讯生态里的杂活交给 AI培训与管理 — 用同类任务比较工具选择、权限边界和团队协作方式
✨ 核心特色
🎓 四线学习路径 ：Claude Code 编程线 + OpenClaw 助手线 + Codex Agent 线 + WorkBuddy 办公线，按目标选择🧭 清晰路径 ：从安装、第一轮任务到团队规范，按主线逐步推进📚 分层阅读 ：新手看路线图，开发者看实操，团队负责人看规范和安全💻 有材料、有结果 ：入门任务给出可复制素材、结果对照和常见错误，做完再换条件练一次📊 事实核对 ：关键版本号与 App / CLI 行为优先对照 官方 Release / 文档 修订；细节仍可能随上游快速变化，请以你本机版本为准🔄 持续更新 ：2026-10-03 全量检查了 50 篇教程和速查卡，修正影响安装、配置和跟练的变化；教程参考版本、上游发布记录与本机测试范围分别说明，见逐章核查清单 。
按高频任务找教程 先找与你手头工作最接近的一行。前四条入门路线已给出完整素材；深入章节会逐步用到你自己的项目或已授权资料。
📚 教程目录
🤖 Part 1：Claude Code — Anthropic 官方编程 CLI
🦞 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 对比附录。
🐧 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-10 企业账号、安全与对比 1-2h ⭐⭐⭐ 账号积分、私有云、安全边界、四工具横向对比
📋 环境要求
Claude Code
操作系统 ：Windows 10 1809+ / Server 2019+、macOS 13+，Linux 按官方支持的发行版与依赖选择，详见安装指南安装方式 ：支持标准安装（npm install -g @anthropic-ai/claude-code，需 Node.js 22+）和原生二进制安装；两种方式安装同一原生二进制认证方式 ：可用 Claude 订阅登录，也可用 Anthropic Console / 第三方兼容提供商配置IDE ：VS Code、Cursor、Windsurf 或其他支持的编辑器
⚠️ 2026年更新 ：Claude Code 已提供原生二进制安装，但 Node.js 22+ 的标准 npm 安装路径仍然受支持 。本仓库安装指南现同时覆盖两条路径，并明确各自适用场景。
OpenClaw
Node.js ：OpenClaw v2026.9.4 推荐 26.x（至少 26.1.0）；兼容 24.x 时至少 24.16.0。25.x 和 26.0.x 不在支持范围内，详见 安装要求 AI 模型 API Key ：OpenAI / Anthropic / Google 等（或使用 Ollama 本地模型免 Key）操作系统 ：macOS / Linux / Windows（推荐 WSL2）
Codex
Codex App ：App 26.908（2026-09-11）保留为功能快照；安装与安全更新按当前官方入口核对；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 ：腾讯云出品，账号与积分关系见当前套餐说明；Windows 使用官方支持的 x64 版本，macOS 按官网下载页提供的系统与芯片安装包选择。官方更新日志已列到 5.6.2（2026-09-21），安装从官网首页开始多端 ：桌面与手机先核对同一账号和任务，微信/企业微信助理按官方流程绑定；各端可用材料和功能分别检查认证方式 ：客户端打开官网登录页，可用微信、手机号、邮箱等方式；企业 SSO 按公司配置及当前页面使用网络 ：按当前客户端与服务的可访问性核对；企业代理、VPN 和防火墙按团队配置
🚀 快速开始
取得练习材料 可在 examples 打开并保存单个文件；对应课程也附有完整文本。已经会用 Git 的读者可以克隆仓库：
git clone https://github.com/KimYx0207/AI-Coding-Guide-Zh.git
cd AI-Coding-Guide-Zh
Claude Code：从一次修错开始 Step 1：01 安装指南 → 选择适合本机的安装路径，完成登录
Step 2：02 基础使用 → 用练习材料复现、修复空列表 Bug，重跑测试
Step 3：02 基础使用 → 把真实项目的运行方式和约束写入 CLAUDE.md
接下来：需要外部工具时学 MCP，需要重复动作时学 Hooks / Skills
OpenClaw：从今天的简报开始 Step 1：OC-02 安装 → 版本检查、初始化；模型未就绪时对照 OC-04
Step 2：OC-03 快速开始 → 确认模型能回复，再整理示例待办
Step 3：更新一条完成状态 → 对照新的简报，检查是否仍在催已完成事项
接下来：按需求学 OC-07 记忆或 OC-05 消息平台
Codex：在 App 中改一次、看一次 Step 1：CX-01 安装与认证 → 装好 App，打开本地练习目录
Step 2：CX-02 小 Bug 练习 → 先复现，再修改，在 Review 中对照
Step 3：自己补 3/8 的检查 → 运行后解释为什么应得到 38
接下来：CX-04 项目指令；需要协作审查时学 CX-10
WorkBuddy：把一周记录整理清楚 Step 1：WB-02 安装与登录 → 完成登录，找到任务入口
Step 2：WB-01 周报练习 → 输入 N1–N5，检查未完成和改期，再保存草稿
Step 3：自己改变一条事实 → 让它只修订相关段落，并核对结果
接下来：处理表格去 WB-03，查询资料去 WB-06
需要系统学习时 下面是分阶段阅读参考，可只选择一条主线。时间取决于已有经验和练习结果，不代表按周读完就能掌握所有功能。
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 辅助 + 安全
Week 13：WorkBuddy 安装 + 项目介绍 + 专家与专家团
Week 14：WorkBuddy 技能 + 连接器 + 知识库 + 自动化 + 多端 + 企业安全
🧰 配套开源项目（老金出品） Meta_Kim 的介绍与开始入口放在首页前面。学习 Hook 与 Skill 时，还可以按需看 Kim_Service ：各子项目提供自己的 README 或 SKILL.md，选择当前需要的方法，再按说明安装和验证。不要为了跟练一次装完整个合集。
📊 项目统计 指标 数值 教程总数 50 篇完整教程（Claude Code 13 / OpenClaw 12 / Codex 14 / WorkBuddy 11）+ 1 速查卡 内容体量 120万+ Markdown 字符（含正文、命令、代码、配置、提示词和 FAQ） 中文核心内容 36万+ 中文字 代码 / 命令 / 配置示例 3100+ 个代码块与实操片段（核心示例按当前版本持续校验） FAQ / 问答条目 500+ 个 覆盖AI模型 OpenClaw 支持多个主流模型提供商，具体目录以当前安装版本和官方 Models / Onboarding 为准 覆盖消息平台 WhatsApp、Telegram、Slack、Discord、Signal、Google Chat、iMessage、Microsoft Teams、Matrix、飞书、LINE、Mattermost、Nextcloud Talk、Nostr、Synology Chat、Twitch、Zalo、WeChat、QQ 等 参考版本与测试范围 各章保留适用版本和功能引入日期；最新发布记录与本机核查范围见下表及核查清单
统计范围是四个教程目录内的 50 篇教程和 1 张速查卡。字符数包含正文与示例，中文数量按汉字计，代码块按 Markdown 围栏计；FAQ 同时统计标题和粗体编号问答，按显示条目计数，跨章重复问题未去重。
🔖 版本说明
版本校验方法 ：本仓库教程中的版本号和 App / CLI 行为，优先对照 官方 Release / 官方文档 修订。上游产品迭代很快，部分细节可能在你阅读时已发生变化。
遇到版本不一致时 ：以你本机 App About / Settings、系统应用信息、claude --version、CLI codex --version 或 npm list -g 的输出为准，教程示例按官方最新文档调整。
产品 教程参考与本次核查范围 官方发布记录（2026-10-03 查询） 官方来源 Claude Code 保留 2.1.270 的历史功能说明；按现行文档修正安装、权限、SDK 等。原 CLI 2.1.236 只读核查；隔离的官方 2.1.288 用于 Mods 离线检查 changelog 最新条目 2.1.288；未改全局客户端或执行模型请求 Claude Code changelog OpenClaw 配置与 Docker 示例按 v2026.9.4 源码复核；本机 2026.7.1-2 只核 help，不验证新版服务行为 最新 Release v2026.9.8；不能由版本号推断旧状态可以直接降级 GitHub Releases ChatGPT / Codex 桌面 App 26.908 为原功能快照，安装走当前 ChatGPT 桌面入口 macOS 26.924.20706 修复 9 月 25 日公告的安全问题；安装取官网更新版本 ChatGPT & Codex changelog Codex CLI 本机 0.157.1 的 help 与已装入口，以及官方 0.160.0 源码、schema rust-v0.160.0，10 月 1 日发布；没有升级本机 GitHub Release WorkBuddy 现行可访问的官方文档；账号界面与真实授权未实跑 更新日志 5.6.2；原价格表保留 9 月 14 日快照，未取得现价正文 WorkBuddy 更新日志
这次具体修了什么 这次先修正安装、认证和配套练习，再重新核对四条主线的正文、重复 FAQ 与当前功能。原来有明确日期的历史说明继续保留；新入口放回对应章节，读者不用只看更新日志猜该怎么操作。
Claude Code 把安装、认证和排障中的重复旧说明一起修正，区分订阅、Console 和 API Key；修正不存在的 CLI 参数、MCP 配置、插件安装与 SDK 工具限制；Hooks 通知保留可选标题，格式化与 Git 检查正确处理文件名和检查失败。Skills 的跨平台示例保留完整文件头，脚本输出和教材相符，创建时会检查路径和已有文件。AGENTS.md、指令审计、新增 Hook、Mods、账号资源同步和当前治理字段也接回了正文。
Codex 的 Rules 示例改成真正注册规则，并用离线匹配确认效果；CLI 区分 JSONL 事件和最终回答，结构化练习补齐 schema。App 工作树、手机接续、Browser、Computer Use、录制技能、Memories、Computer History、当前 PR 插件、安全审查、事件任务和新 Cloud 的准备、发布与凭据入口，都说明了具体操作和适用条件。
OpenClaw 保留 9.4 的固定部署参考，同时讲清 9.8 的 Windows 状态迁移和会话返回变化；修正后台服务重复启动、消息平台命令、技能与记忆入口，以及 Docker 初始化、更新和恢复中的矛盾。WorkBuddy 补当前技能、积分、注销、定时通知与项目配置步骤，定时摘要使用明确日期的虚构日志；真实报价仍保留待核，不把旧价改成最新价。
近期发布复核又补了一批实际操作：Claude Code 的 Mods 有从三个文件到加载、热重载、离线测试和停用的完整工坊，权限、插件和云任务说明也补了适用条件；Codex 补任务管理、工作树与 MCP 排障，并区分 ChatGPT 插件界面、MCP Events 和 Security Cloud；OpenClaw 讲清技能搜索与自学习、只读配置、媒体迁移和升级回滚；WorkBuddy 补原生手机 App、文件浏览器、专家和连接器的步骤。Mods 已通过隔离官方 2.1.288 客户端的离线检查，登录后的界面与手机流程仍未实跑。
详细记录统一放在 CHANGELOG.md 。逐章核查清单 列出了全部章节的修改与保留情况，并纠正了第二轮把功能简介当成完整覆盖的判断。精选功能记录不是产品全部发布项的覆盖率；参考答案用于对照事实，离线检查也不表示当天已经在 AI 客户端跑过所有流程。
🔌 第三方模型配置说明 下面三条开发者主线都支持多种模型接入方式，具体配置见各教程：
产品 支持方式 配置入口 Claude Code Anthropic Console / Claude 订阅 / 第三方兼容提供商（ANTHROPIC_BASE_URL） 01-安装指南：API中转站配置 OpenClaw 多个主流提供商（OpenAI / Claude / Gemini / Ollama / 本地模型等，实际以当前模型目录为准） 04-模型配置指南 Codex ChatGPT 账户登录 / OpenAI API Key CX-01 App 安装与认证
⚠️ 第三方模型注意事项 ：
第三方兼容提供商的 API 行为可能不完全等同于官方（速率限制、模型列表、功能支持可能有差异）
本地模型（Ollama 等）能力取决于模型本身，复杂任务可能不如旗舰模型
各提供商计费方式不同，使用前请确认价格策略
🎯 适用人群
✅ 刚入门的读者 ：从未接触过 AI 编程工具，想系统学习
✅ 办公人 / 业务用户 / 国内团队 ：想用 AI 出周报、调研、PPT，被英文 CLI 劝退过，WorkBuddy 主线为你准备
✅ 开发者 ：想用 Claude Code 提升编程效率 + 用 OpenClaw 自动化日常工作
✅ 团队负责人 / PM ：为团队制定 AI 工具使用规范、评审流程和里程碑验收方式
✅ 企业用户 ：企业级部署、安全边界、权限管理和最佳实践
✅ 高校 / 培训机构 ：设计 AI Coding、Agent 工作流和企业实践课程
✅ AI 爱好者 ：想搭建自己的 AI 私人助手
💡 学习建议
初学者 想学编程 AI → 从 Claude Code Part 1 开始（01 安装 → 02 小 Bug → 项目规则）
想搭建 AI 助手 → 从 OpenClaw Part 2 开始（OC-01 → OC-02 → OC-03）
想试 Codex → 从 Codex Part 3 开始（CX-01 → CX-02 或 CX-03）
想让 AI 帮忙出办公产物 → 从 WorkBuddy Part 4 开始（WB-00 → WB-02 → WB-01）
都想学 → 先走 Claude Code CLI 主线，再补 Codex App 桌面工作流，然后学 OpenClaw 助手框架；办公同事另走 WorkBuddy 主线
进阶者（有基础）
Claude Code 重点：04-MCP、05-Hooks、06-Subagent、07-Skills
OpenClaw 重点：06-技能系统、08-多Agent路由
Codex 重点：CX-04 项目指令与权限配置、CX-05 MCP、CX-06 Skills、CX-07 Plugins / Connectors
高级者（深度定制）
Claude Code：09-Agent-SDK、10-综合实战
OpenClaw：08-多Agent、09-Docker部署、10-安全
Codex：CX-04 项目指令与权限、CX-08 Subagents、CX-09 Automations、CX-10 Review / PR、CX-13 安全企业
双工具协作 ：Codex + Claude Code 的定位、边界和共存策略详见 CX-14长期 Skill 治理：可参考 SkillClaw （skill 演化、去重、合并、共享；论文 arXiv:2604.08377 ）
📞 联系方式 👤 作者：老金 | 🔗 [GitHub](https://github.com/KimYx0207) | 🌐 [aiking.dev](https://aiking.dev/) | 𝕏 [老金带你玩AI](https://x.com/KimYx0207) | 📱 微信公众号：老金带你玩AI
☕ 请我喝杯咖啡 
微信支付
支付宝
🤝 贡献指南 欢迎提交 Issue 和 Pull Request！
发现错误或过时信息，请提交 Issue
有改进建议，欢迎提交 PR
想分享使用经验，欢迎在 Discussions 讨论
📄 许可证
🙏 致谢 感谢所有为 Claude Code、OpenClaw、Codex 和 WorkBuddy 生态做出贡献的开发者和社区成员！
📋 更新说明 完整更新记录统一维护在 CHANGELOG.md 。README 保留当前定位、目录、版本基线和阅读入口，避免同一条版本说明在多处漂移。
⚠️ 免责声明
本次核查日期为 2026-10-03，教程参考版本、实际测试与未能核实的范围见核查清单 。WorkBuddy 价格与活动保留注明日期的快照，采购前查看当前订单和官方说明。
选择预发布版本或使用 latest 前，先按上方版本表打开对应项目的官方发布记录，再核对本机版本。
部分功能可能随版本更新而变化，请以官方文档为准
本教程是学习和实践参考，重要项目请先在测试仓库 / 测试环境验证，再进入生产流程
⭐ 如果这个教程对你有帮助，欢迎 Star 支持！
也欢迎把它转给正在学习 AI 编程和 Agent 工作流的朋友。
核心功能 内容由编辑整理，部分信息来自 GitHub 与项目官网，版权归原作者所有。发现错误？报告问题
