AI 编程与 Agent 工作流中文实战教程
一套面向个人、团队和高校的系统化中文教程，带你从零上手 Claude Code、OpenClaw、Codex 和 WorkBuddy 四类主流 AI 编程与 Agent 工具。
- Star 数
- ★ 6.3k
- 最近更新
- 8 天前
- License
- MIT
- 主语言
- Python
- FA 评分
- 38/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用ChatGPT · Codex · Claude Code
- 费用
- 软件免费，模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 刚入门的开发者：按 README 中的快速开始路径，从 Claude Code 01 或 OpenClaw OC-03 开始，完成第一个低风险任务，如安装并跑通一个简单的对话。
- 不适合
- 只想看英文文档、不愿读中文教程的读者
- 指望教程自带可运行环境或虚拟实验环境的人
这个 Agent 能做什么，适合哪些场景？
这是一个由老金（KimYx0207）维护的开源中文教程仓库，覆盖 Claude Code、OpenClaw、Codex 和 WorkBuddy 四类主流 AI 编程和 Agent 工具。仓库包含 50 篇完整教程和 1 张速查卡，总内容量超过 80 万字，提供超过 1500 个代码块、命令、配置示例和 250 多个问答条目。教程按工具分为四条主线，每条主线都从安装、基础使用到企业级安全实践逐步推进，并配有清晰的学习路径（如三线学习路径、按身份选择路线）。项目采用 MIT 许可，支持中文阅读，并针对国内办公场景，如企业中 AI 赋能、高校培训、团队规范制定等。
仓库本身不执行操作，而是提供系统化的学习文档。它包含针对 Claude Code（Anthropic 官方 CLI）的 13 篇教程，覆盖安装、基础使用、MCP、Hooks、Subagents、Skills、Plugins 等；针对 OpenClaw（开源 AI 助手）的 12 篇教程，涵盖安装部署、模型配置、消息平台接入、技能系统、记忆系统、多 Agent 协作等；针对 Codex（OpenAI 编程 Agent）的 14 篇教程，以 Codex App 为主线，覆盖安装、桌面工作流、Commands、MCP、Skills、Subagents 等；以及针对 WorkBuddy（腾讯 AI 办公助手）的 11 篇教程，面向办公人和国内团队。每篇教程都给出了具体的命令、配置示例和环境要求，例如 Claude Code 的标准安装命令 npm install -g @anthropic-ai/claude-code。
- 刚入门的开发者：按 README 中的快速开始路径，从 Claude Code 01 或 OpenClaw OC-03 开始，完成第一个低风险任务，如安装并跑通一个简单的对话。
- 在职开发者：希望将 AI 集成到真实项目中，可重点阅读 Claude Code 02/04/05 或 Codex CX-02/CX-04/CX-05，学习用 MCP 接入工具、用 Hooks 自动化工作流。
- 团队负责人或项目经理：需要建立团队 AI 工具使用规范，可参照 Claude Code 10/11 和 Codex CX-13 等章节，制定协作规范、里程碑检查和 Review 流程。
- 企业培训讲师或高校教师：希望设计可讲、可练、可验收的课程路径，可参考仓库的路线图、企业安全章节和 FAQ/检查清单。
- 办公人/业务用户：不懂命令行但想用 AI 出周报、调研、PPT，可走 WorkBuddy 主线（WB-01 至 WB-10），用微信扫码登录即可使用专家、技能、知识库等功能。
- AI 爱好者：想搭建自己的 AI 私人助手，可学习 OpenClaw 的 OC-01 到 OC-11，如配置消息平台、技能和记忆系统。
如何安装或部署这个 Agent？
克隆仓库：git clone https://github.com/KimYx0207/AI-Coding-Guide-Zh.git，然后根据所选工具安装依赖。Claude Code 需要 Node.js 18+，可通过 npm install -g @anthropic-ai/claude-code 安装，并用 Claude 订阅或 Anthropic Console 认证。OpenClaw 需要 Node.js 24.x（或 22.19+），并准备 AI 模型 API Key（OpenAI/Anthropic/Google）或使用 Ollama 本地模型。Codex App 可从官方渠道安装（macOS 从官方入口，Windows 用 Microsoft Store 或 winget -s msstore），用 ChatGPT 账户登录或 OpenAI API Key 认证。WorkBuddy 桌面 App 从腾讯云官方渠道下载，微信扫码登录。
如何使用这个 Agent？
根据你的身份选择学习路径。新手可参考 README 中的快速开始：Claude Code 路线（3小时）按 01→04→05 顺序学习；OpenClaw 路线（1小时）按 OC-01→OC-02→OC-03→OC-04；Codex 路线（20分钟）按 CX-01→CX-02；WorkBuddy 路线（30分钟）按 WB-02→WB-01。每篇教程都有具体的操作步骤和命令示例，例如使用 Claude Code 时，在终端中运行 claude 启动 CLI，使用 /mcp 命令管理 MCP 服务器。
这个 Agent 有哪些优点和局限？
- 覆盖四类主流 AI 编程和 Agent 工具，提供从入门到企业的完整学习路径，适合不同角色用户。
- 教程内容详尽，包含 1500+ 代码块、命令和配置示例，以及 250+ FAQ，实用性强。
- 面向中文用户，特别考虑了国内办公场景，如企业微信、腾讯文档等，对国内团队友好。
- 持续更新，版本号与官方 Release 对齐（如 Claude Code v2.1.222），并说明版本校验方法。
- 教程内容量大，初学者可能感到信息过载，需要花费大量时间阅读。
- 部分工具（如 Codex、WorkBuddy）依赖特定平台或账号，存在厂商锁定风险。
- 版本更新频繁，教程中的版本号可能过时，需要用户自行核对官方文档。
- 内容为教程性质，不提供实际运行环境或虚拟实验室，需要用户自行搭建环境。
这个 Agent 与同类方案有什么区别？
该教程将 Claude Code、OpenClaw、Codex 和 WorkBuddy 四者放在一起对比，指出它们分别适用于编程、自动化、多入口协作和办公场景。此外，CX-14 专门对比 Codex 与 Claude Code 的差异，帮助用户在两个工具之间做出选择。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| AI 编程与 Agent 工作流中文实战教程 当前 | 38 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 6.3k | 8 天前 | Python | ChatGPT · Codex · Claude Code |
| Project Cairn | 67 · 存在缺口 | Agent 插件 / 技能免费 | ★ 241 | 5 天前 | Shell | Codex · Claude Code |
| Hivemind——代理共享记忆与技能引擎 | 56 · 缺口较多 | 命令行工具免费版 + 付费版 | ★ 1.6k | 4 天前 | TypeScript | Codex · Claude Code · Claude API |
| NoPUA — 以爱释放 AI 潜能 | 52 · 缺口较多 | Agent 插件 / 技能免费 + 模型费 | ★ 1.4k | 20 天前 | Python | Codex · Claude Code |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
证据显示：仓库是教程集合，不包含可执行代码或自动化流程，因此没有权限管理、用户确认、数据流透明、敏感数据处理、依赖安全、外部影响或回滚机制的实际实现。这些标准因缺乏相关代码或配置而评为0。来源归属方面，README明确标注作者为老金，提供GitHub、网站、社交媒体和联系方式，并声明MIT许可证，因此评为2。扣分原因：无代码可评估安全属性；来源归属虽清晰但未验证。
证据显示：README内部一致，教程目录、版本号和统计数字相互匹配，自洽性评为2。依赖可用性方面，教程依赖外部工具（Claude Code、OpenClaw、Codex、WorkBuddy）和官方文档，但仓库本身不包含依赖清单或锁定文件，因此评为1。失败消息方面，教程中可能包含故障排除提示，但未提供系统化的错误处理或诊断信息，因此评为1。扣分原因：依赖外部资源但未提供验证机制；失败处理不系统。
证据显示：README明确区分了不同受众（初学者、开发者、团队负责人、企业培训）并提供了相应的学习路径，因此受众与场景评为2。能力边界方面，教程描述了各工具的功能和限制，但未明确说明教程本身的能力边界，因此评为1。触发精度方面，教程是静态文档，没有自动化触发机制，因此评为0。环境适配方面，提供了各工具的系统要求和安装说明，因此评为2。扣分原因：能力边界描述不完整；无触发机制。
证据显示：信息架构清晰，有目录、分部分和阅读指南，评为2。安装说明详细，覆盖各工具的系统要求和安装步骤，评为2。命名稳定性方面，教程编号和文件名一致，评为2。示例和FAQ丰富，有1500+示例和250+FAQ，评为2。已知限制方面，README提到版本可能过时，但未系统列出所有限制，评为1。许可证明确为MIT，评为2。版本和变更日志有CHANGELOG.md和版本说明，评为2。维护责任明确，作者提供联系方式并欢迎贡献，评为2。扣分原因：已知限制不全面。
证据显示：输出可用性方面，教程提供可操作的步骤和示例，用户可直接跟随，评为2。边际价值方面，教程填补了中文AI编程教程的空白，提供系统化学习路径，评为2。成本效益方面，教程免费开源，但需要用户投入时间学习，且依赖外部付费工具，因此评为1。扣分原因：成本效益评估受外部工具费用影响。
证据显示：声明可追溯性方面，README引用官方文档和版本号，并说明验证方法，评为2。跨来源佐证方面，教程声称对照官方文档，但未提供具体引用链接，因此评为1。事实与推断分离方面，教程将版本信息与建议分开，但部分内容可能混合，因此评为1。扣分原因：缺乏具体引用；事实与推断分离不彻底。
- 源码中未见：最小权限约束只授予完成任务所需的权限：用专用账号或只读令牌，并限定可访问的目录和仓库。
- 源码中未见：执行前用户确认开启或自行加上执行前确认；先在沙箱或测试环境跑通，确认行为后再接入真实数据。
- 源码中未见：数据流向说明运行时观察它连接了哪些外部服务（代理或防火墙日志）；弄清数据去向之前不要输入敏感数据。
- 源码中未见：敏感信息处理使用专用、低权限、可随时吊销的 API 密钥，不要复用生产凭据，也不要让密钥出现在日志里。
- 源码中未见：依赖安全审查安装前固定版本并做一次依赖扫描（如 npm audit、pip-audit）；优先放在容器里运行。
- 源码中未见：外部影响披露先弄清它会写入、发送或修改哪些外部系统，用测试账号或测试仓库验证后再接入正式环境。
- 源码中未见：回滚或恢复路径运行前先备份，或在 git 分支、快照上操作，确保改动可以撤销。
- 仓库是教程集合，不包含可执行代码，因此无法评估实际安全属性。
- 教程依赖外部工具和官方文档，但未提供依赖锁定或验证机制。
- 版本号可能过时，用户应以官方最新信息为准。
- 作者身份未经验证，来源归属虽清晰但不可靠。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
v5.5 v5.5：四工具教学补齐与近期变化复核
发布说明摘录
这次更新把四条教程线里影响读者照做的近期变化补进正文，尤其纠正了 v5.4 把 Mods 简介当成完整教学的记录。 - Claude Code：Mods 工坊有完整文件、加载与信任、热重载、离线测试和停用步骤；同步托管读取、沙箱、IDE、记忆、插件和云任务边界。 - Codex：补 MCP 认证排障、网络撤权、任务隐藏/归档/删除、工作树占用与附图入口，讲清 Guardian 和 Touch ID 的适用条件。 - OpenClaw：补技能搜索、自学习模式与费用、只读配置及 include 备份、Sora / video-frames 退役路线，以及消息平台、定时任务、后台工作和手机入口的变化。 - WorkBuddy：补原生手机 App、文件浏览器、专家、消息引用、技能、连接器和定时任务步骤，历史说明保留日期。 …在 GitHub 查看 ↗ -
v5.4 v5.4：正文、当前功能与跟练的第二轮复核
发布说明摘录
正文、功能与练习的第二轮复核 - 重新核对全部 50 篇教程和速查卡的当前入口、功能变化、重复 FAQ 与练习衔接，在既有核查清单加入四工具的功能覆盖矩阵；正确原文和注明日期的历史说明保留。 - Claude Code 修正不存在的 CLI 参数、日常 bypass 建议、MCP 本地配置及归档服务入口；补 AGENTS.md、mcp_tool、omitClaudeMd、Mods、账号资源同步、插件配置和企业供应商/遥测说明。语音步骤按当前录音、转写、提交和按键配置重写。 - Claude Code Notification 保留可选 title，无标题时使用默认值；格式化器采用参数列表，Git 检查使用 NUL 分隔文件名、拒绝把检查失败当通过，并返回合法的 PreToolUse ask 结构。SDK 区分可用工具池与免审批工具，删除无依据的固定并发上限。 …在 GitHub 查看 ↗ -
v5.3 v5.3：四主线全面核查与实操修正
发布说明摘录
这次把 50 篇教程和速查卡全部扫了一遍，重点修正会让读者装错、配错或跟练失败的内容。47 篇教程和 1 张速查卡有必要更新；Codex 插件、Codex Review/PR、WorkBuddy 资料库三篇核心主线核对后保留。 - Claude Code：当前安装与 npm Node 22+ 要求、权限语义、Remote Control/Channels；Python SDK 消息类型、有限运算计算器、Hooks 通知与 Action 报告检查。 - Codex：ChatGPT 桌面入口、CLI 参数及权限 profile；新 Cloud 环境准备和发布、代理 Secrets、Scheduled 与导入范围。 - OpenClaw：匹配版本的 Docker 初始化、首次 token/数据库密码配置与三类状态卷备份，路由/模型/技能/记忆及 Agent 配置迁移；工具策略与实际隔离边界。 - WorkBuddy：实际登录、菜单、连接器与远程助理流程，虚构 CSV 跟练和参考结果；价格与未证实能力保留清楚的核查范围。 …在 GitHub 查看 ↗