Claude Code & OpenClaw & Codex 中文教程

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

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

⠀

Codex 主线以 Codex App 为核心；CLI / Web / SDK / GitHub Action 等只作为 App 生态补充。

⠀

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

⠀

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

⠀

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

📖 项目简介

⠀

这是一套系统化、小白可入门、团队可落地的 AI Coding 与 Agent 工作流中文教程，覆盖三类代表性工具：

⠀

Claude Code

OpenClaw

Codex

是什么

Anthropic 官方 AI 编程 CLI 工具

开源 AI 私人助手框架

OpenAI 编程 Agent 平台

干什么

终端里写代码、调Bug、做架构

消息平台上管邮件、排日程、自动化一切

App / CLI / Web / IDE / SDK 分层协作的编程 Agent

谁出的

Anthropic 官方

Peter Steinberger（原名 Clawdbot，因 Claude 商标被迫改名）

OpenAI 官方（CLI 开源 Apache-2.0）

教程数

13 篇 + 1 速查卡

12 篇完整教程

14 篇完整教程

⠀

👤 作者定位

⠀

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

⠀

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

⠀

🧬 为什么放在一起？

⠀

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

⠀

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

⠀

✨ 核心特色

⠀

🎓 三线学习路径：Claude Code 编程线 + OpenClaw 助手线 + Codex Agent 线，按目标选择
🚀 快速上手：Claude Code 3 小时上手 / OpenClaw 5 分钟跑起来 / Codex 20 分钟上手
👶 分层友好：零基础看路线图，开发者看实操，团队负责人看规范和安全
💻 实战导向：1500+ 个代码块、命令片段、配置模板和提示词示例，边学边练
📊 质量保证：关键版本号与 CLI 行为优先对照官方 Release / 文档修订；细节仍可能随上游快速变化，请以你本机版本为准
🔄 持续更新：适配最新稳定版（Claude Code v2.1.158 / OpenClaw 稳定版 v2026.5.27 / Codex CLI v0.135.0，实际以 GitHub Releases 和本机 codex --version 为准）

🎯 按身份选择路线

⠀

你是谁

先解决什么问题

推荐入口

零基础小白

看懂概念，跑起第一个 AI 工具

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 官方编程神器

⠀

序号

教程名称

学时

难度

必学度

说明

Claude Code完整安装指南

2-3h

⭐

⭐⭐⭐

环境搭建、API配置、IDE集成

基础使用完整指南

4-6h

⭐

⭐⭐⭐

三种使用模式、30+命令详解

Commands系统完整指南

4-6h

⭐⭐

Slash 命令、Skills 工作流与兼容层

MCP集成完整指南

4-6h

⭐⭐

⭐⭐⭐

10+核心服务器、自定义开发

Hooks系统完整指南

4-6h

⭐⭐

⭐⭐⭐

多事件 Hook、4 类处理器、自动化工作流

Subagent子代理完整指南

1-2h

⭐⭐

官方 Subagents、Task 委派、Agent Teams（实验性）

Skills定制完整指南

6-8h

⭐⭐

创建可复用功能包

Plugins生态完整指南

4-6h

⭐⭐

⭐

/plugin、市场、作用域与本地开发

Agent-SDK完整指南

6-8h

⭐⭐⭐

⭐⭐

编程开发AI Agent

综合实战完整指南

2-3h

⭐⭐⭐

⭐⭐

团队协作、CI/CD集成

企业实战完整指南

4-6h

⭐⭐⭐

⭐

企业级最佳实践

Remote Control完整指南

1-2h

⭐⭐

跨设备继续本地会话、/remote-control、claude remote-control

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

快速开始

🟢

5 分钟跑起来第一个对话

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 主线出发做双工具选择和共存

📋 环境要求

⠀

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：macOS / Windows 桌面端（macOS 从官方 Codex App 入口安装；Windows 以 Microsoft Store / winget -s msstore 等官方安装入口为准；Linux 使用 CLI 或 Web）
Codex CLI：CLI v0.135.0 对照官方 Release；安装可用 OpenAI 官方 install script、Windows PowerShell install script、npm、Homebrew 或 GitHub Release 二进制包，实际以 Codex CLI 文档为准
Codex Web / Cloud：现代浏览器 + 支持 Codex 的 ChatGPT 账号或组织工作区
认证方式：ChatGPT 账户登录或 OpenAI API Key

🚀 快速开始

⠀

克隆仓库

⠀

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

⠀

完整掌握路径

⠀

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 辅助 + 安全

📊 项目统计

⠀

指标

数值

教程总数

39 篇完整教程（Claude Code 13 / OpenClaw 12 / Codex 14）+ 1 速查卡

内容体量

80万+ Markdown 内容量（含正文、命令、代码、配置、提示词和 FAQ）

中文核心内容

20万+ 中文字

代码 / 命令 / 配置示例

1500+ 个代码块与实操片段（核心示例按当前版本持续校验）

FAQ / 问答条目

250+ 个

覆盖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 等

Claude Code版本

2.1.158（2026-05-30 验证）

OpenClaw版本

稳定版 v2026.5.27（2026-05-30 对照 Releases）；v2026.5.28 为 beta，v2026.5.29-alpha.1 仅见 tag，预发布请自行取舍

Codex版本

CLI v0.135.0（2026-05-29 GitHub Release）；v0.136.0-alpha.1 为预发布；实际以 codex --version、App 更新日志与 GitHub 为准

🔖 版本说明

⠀

版本校验方法：本仓库教程中的版本号和 CLI 行为，优先对照官方 Release / 官方文档修订。上游产品迭代很快，部分细节可能在你阅读时已发生变化。

遇到版本不一致时：以你本机 claude --version、codex --version 或 npm list -g 的输出为准，教程示例按官方最新文档调整。

⠀

产品

当前验证版本

本轮复核

官方来源

Claude Code

v2.1.158

2026-05-30

GitHub Releases

OpenClaw

稳定版 v2026.5.27

2026-05-30

GitHub Releases

Codex CLI

v0.135.0

2026-05-30

GitHub Releases

⠀

⚠️ 版本号会随上游更新而失效。教程中标注的版本号是编写/验证时的快照，不代表实时最新。遇到命令或参数不一致时，优先查官方 Release Notes 和 CLI 帮助（--help）。

🔌 第三方模型配置说明

⠀

三大工具均支持多种模型接入方式，具体配置见各教程：

⠀

产品

支持方式

配置入口

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 编程工具，想系统学习
✅ 开发者：想用 Claude Code 提升编程效率 + 用 OpenClaw 自动化日常工作
✅ 团队负责人 / PM：为团队制定 AI 工具使用规范、评审流程和里程碑验收方式
✅ 企业用户：企业级部署、安全边界、权限管理和最佳实践
✅ 高校 / 培训机构：设计 AI Coding、Agent 工作流和企业实践课程
✅ AI 爱好者：想搭建自己的 AI 私人助手

💡 学习建议

⠀

初学者（零基础）

⠀

想学编程 AI → 从 Claude Code Part 1 开始（01 → 04 → 05）

⠀

想玩 AI 助手 → 从 OpenClaw Part 2 开始（OC-01 → OC-02 → OC-03）

⠀

想试 Codex → 从 Codex Part 3 开始（CX-01 → CX-02 或 CX-03）

⠀

都想学 → 先 Claude Code 3 小时上手，再 Codex 20 分钟上手，最后 OpenClaw 1 小时上手

⠀

进阶者（有基础）

⠀

Claude Code 重点：04-MCP、05-Hooks、06-Subagent、07-Skills
OpenClaw 重点：06-技能系统、08-多Agent路由
Codex 重点：CX-05 配置系统、CX-06 Skills、CX-07 MCP

⠀

高级者（深度定制）

⠀

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）

📞 联系方式

⠀

获取更多 AI 资讯、企业赋能和高校培训支持：

⠀

作者：老金
GitHub：https://github.com/KimYx0207
官网：https://aiking.dev/
X：老金带你玩AI
微信公众号：老金带你玩AI
开源知识库 / 群二维码：https://my.feishu.cn/wiki/OhQ8wqntFihcI1kWVDlcNdpznFf

🤝 贡献指南

⠀

欢迎提交 Issue 和 Pull Request！

⠀

发现错误或过时信息，请提交 Issue
有改进建议，欢迎提交 PR
想分享使用经验，欢迎在 Discussions 讨论

📄 许可证

⠀

本项目采用 MIT License 开源协议。

🙏 致谢

⠀

感谢所有为 Claude Code 和 OpenClaw 生态做出贡献的开发者和社区成员！

📋 更新说明

⠀

完整更新记录统一维护在 CHANGELOG.md。README 只保留当前项目介绍、目录和使用入口，避免版本说明在多处漂移。

⚠️ 免责声明

⠀

Claude Code 教程基于 v2.1.158 编写（Release）；OpenClaw 教程以稳定版 v2026.5.27 为修订参考；Codex 教程按 Codex CLI v0.135.0 与 2026-05 OpenAI 官方 Codex 文档修订，CLI/App 版本以本机和官方 Releases 为准
预发布与 latest 以各项目 Releases 与本机版本为准（持续更新中）
部分功能可能随版本更新而变化，请以官方文档为准
本教程是学习和实践参考，重要项目请先在测试仓库 / 测试环境验证，再进入生产流程

⭐ 如果这个教程对你有帮助，欢迎 Star 支持！