ai-coding-guide
agent
Warn
Health Pass
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Community trust — 911 GitHub stars
Code Warn
- Code scan incomplete — No supported source files were scanned during light audit
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
📘 面向小白的 AI 编程 CLI 中文教程:Claude Code + Codex 92 篇精修
README.md
AI 编程(Claude Code + Codex)指南
📘 92 篇精修中文教程,带你从装好到熟练 —— Claude Code 53 篇 + Codex 39 篇,把命令行变成你最快的那只手。

这教程跟其他教程的差异
- 以官方文档为事实来源:所有功能 / 命令 / 默认行为对照 Claude Code 官方 和 Codex 官方 核实,不抄第三方猜测、不靠传言。
- 面向小白做大量易懂化改写:每个新概念三段式(场景引入 + 生活化类比 + 实际场景);不熟命令行也能跟上。
- 有真实经验印记:每篇 3+ 处第一人称踩坑/判断(带具体细节、真实数字),不写「我觉得」式空话。
- 可照跑、可自验:每个动手环节给完整命令 + 预期输出,让你边读边动手即时反馈。
- 暗色工程风原创配图:64 张 SVG/PNG 配图,统一暗色风格、不堆字、节点 ≤ 10。
目录
Claude Code 篇(53 篇)
从「是什么 / 安装」到代理循环、MCP、子代理、Skill、Hooks、Agent SDK、GitHub Actions,再到最佳实践 / 反模式 / FAQ / 术语表。
→ 从这里开始:claude-code/01-what-is-claude-code.md
Codex 篇(39 篇)
四种入口、AGENTS.md、沙箱审批、config.toml、Chronicle 记忆、Worktrees、从 Claude Code 迁移等。
→ 从这里开始:codex/01-what-is-codex.md
怎么读
- 挑一个工具(建议从 Claude Code 起步)。
- 按编号顺序往下读,每篇 3-10 分钟。
- 边读边动手 —— 每篇都有可照跑的命令 + 预期输出。
- 学完一个章节就把它集成进你每天的开发流程。
常见疑问
| Q | A |
|---|---|
| 要付费吗? | 教程本身 完全免费(MIT)。但 Claude Code / Codex 这两个工具本身需要订阅或 API 付费(订阅最便宜,每月 $20 起,详见各篇「订阅与计费」) |
| 需要魔法上网吗? | 安装、登录、使用都需要。教程里已标注每个工具的具体要求 |
| 没用过命令行能学吗? | 能。第一组「基础入门」专门照顾新手,从命令行基础带起 |
| Claude Code 和 Codex 学哪个? | 看你常用什么模型。两个工具理念接近、各有所长。推荐先从 Claude Code 起步,再读 Codex 篇的「从 Claude Code 迁移」横向对比 |
| 教程会更新吗? | 这两个工具迭代很快,重要变化会跟进。版本信息见 Commits |
技术栈
教程站基于 VitePress 搭建,Catppuccin Mocha 暗色主题(仿 Claude Code CLI 会话窗口风格),代码块 Shiki 高亮,配图 SVG → @2x PNG,搜索 / mermaid / OG 卡片开箱即用。
贡献 / 反馈
- 发现错别字、过时信息、坏链接 → 直接提 Issue
- 想改进某句表述、补充踩坑案例 → 欢迎 PR
- 想加新主题、新工具 → 先开 Issue 讨论方向
状态
🟢 稳定:92 篇全部成稿,已完成四轮审核(事实核实 / 表达优化 / 16 子代理复核)。后续以增量小修小补为主,新工具上线时新增专篇。
如果这套教程帮你少踩坑、少绕弯,⭐ Star 一下让更多人看见。
License
MIT © 2026 stormzhang
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found