AI 编程与 Agent 工作流中文实战教程
一套面向个人、团队和高校的系统化中文教程,带你从零上手 Claude Code、OpenClaw、Codex 和 WorkBuddy 四类主流 AI 编程与 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。扣分原因:缺乏具体引用;事实与推断分离不彻底。
- 仓库是教程集合,不包含可执行代码,因此无法评估实际安全属性。
- 教程依赖外部工具和官方文档,但未提供依赖锁定或验证机制。
- 版本号可能过时,用户应以官方最新信息为准。
- 作者身份未经验证,来源归属虽清晰但不可靠。
这个 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 有哪些优点和局限?
- 覆盖四类主流 AI 编程和 Agent 工具,提供从入门到企业的完整学习路径,适合不同角色用户。
- 教程内容详尽,包含 1500+ 代码块、命令和配置示例,以及 250+ FAQ,实用性强。
- 面向中文用户,特别考虑了国内办公场景,如企业微信、腾讯文档等,对国内团队友好。
- 持续更新,版本号与官方 Release 对齐(如 Claude Code v2.1.222),并说明版本校验方法。
- 教程内容量大,初学者可能感到信息过载,需要花费大量时间阅读。
- 部分工具(如 Codex、WorkBuddy)依赖特定平台或账号,存在厂商锁定风险。
- 版本更新频繁,教程中的版本号可能过时,需要用户自行核对官方文档。
- 内容为教程性质,不提供实际运行环境或虚拟实验室,需要用户自行搭建环境。
如何安装或部署这个 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 与同类方案有什么区别?
该教程将 Claude Code、OpenClaw、Codex 和 WorkBuddy 四者放在一起对比,指出它们分别适用于编程、自动化、多入口协作和办公场景。此外,CX-14 专门对比 Codex 与 Claude Code 的差异,帮助用户在两个工具之间做出选择。