{"id":51022826,"url":"https://github.com/stormzhang/ai-coding-guide","last_synced_at":"2026-06-21T17:01:43.799Z","repository":{"id":13302125,"uuid":"15988336","full_name":"stormzhang/ai-coding-guide","owner":"stormzhang","description":"📘 面向小白的 AI 编程 CLI 中文教程：Claude Code + Codex 92 篇精修","archived":false,"fork":false,"pushed_at":"2026-06-20T18:00:36.000Z","size":12176,"stargazers_count":911,"open_issues_count":2,"forks_count":339,"subscribers_count":145,"default_branch":"main","last_synced_at":"2026-06-20T19:21:16.566Z","etag":null,"topics":["agent","ai-coding","anthropic","chinese-tutorial","claude-code","cli","codex","llm","openai","tutorial"],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stormzhang.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2014-01-17T02:52:55.000Z","updated_at":"2026-06-20T18:00:40.000Z","dependencies_parsed_at":"2022-08-25T17:02:58.346Z","dependency_job_id":null,"html_url":"https://github.com/stormzhang/ai-coding-guide","commit_stats":null,"previous_names":["stormzhang/ai-coding-guide"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/stormzhang/ai-coding-guide","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stormzhang%2Fai-coding-guide","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stormzhang%2Fai-coding-guide/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stormzhang%2Fai-coding-guide/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stormzhang%2Fai-coding-guide/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stormzhang","download_url":"https://codeload.github.com/stormzhang/ai-coding-guide/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stormzhang%2Fai-coding-guide/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34618484,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-21T02:00:05.568Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent","ai-coding","anthropic","chinese-tutorial","claude-code","cli","codex","llm","openai","tutorial"],"created_at":"2026-06-21T17:01:39.415Z","updated_at":"2026-06-21T17:01:43.790Z","avatar_url":"https://github.com/stormzhang.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# AI 编程（Claude Code + Codex）指南\n\n\u003e 📘 **92 篇精修中文教程**，带你从装好到熟练 —— **Claude Code 53 篇 + Codex 39 篇**，把命令行变成你最快的那只手。\n\n[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)\n[![GitHub stars](https://img.shields.io/github/stars/stormzhang/ai-coding-guide?style=social)](https://github.com/stormzhang/ai-coding-guide/stargazers)\n[![Articles](https://img.shields.io/badge/articles-92-blue.svg)](#目录)\n[![Built with VitePress](https://img.shields.io/badge/Built%20with-VitePress-646cff.svg)](https://vitepress.dev)\n\n![AI 编程指南](og.png)\n\n## 这教程跟其他教程的差异\n\n- **以官方文档为事实来源**：所有功能 / 命令 / 默认行为对照 [Claude Code 官方](https://code.claude.com/docs/zh-CN) 和 [Codex 官方](https://developers.openai.com/codex) 核实，不抄第三方猜测、不靠传言。\n- **面向小白做大量易懂化改写**：每个新概念三段式（场景引入 + 生活化类比 + 实际场景）；不熟命令行也能跟上。\n- **有真实经验印记**：每篇 3+ 处第一人称踩坑/判断（带具体细节、真实数字），不写「我觉得」式空话。\n- **可照跑、可自验**：每个动手环节给完整命令 + 预期输出，让你边读边动手即时反馈。\n- **暗色工程风原创配图**：64 张 SVG/PNG 配图，统一暗色风格、不堆字、节点 ≤ 10。\n\n## 目录\n\n### Claude Code 篇（53 篇）\n从「是什么 / 安装」到代理循环、MCP、子代理、Skill、Hooks、Agent SDK、GitHub Actions，再到最佳实践 / 反模式 / FAQ / 术语表。\n\n→ 从这里开始：[`claude-code/01-what-is-claude-code.md`](claude-code/01-what-is-claude-code.md)\n\n### Codex 篇（39 篇）\n四种入口、AGENTS.md、沙箱审批、config.toml、Chronicle 记忆、Worktrees、从 Claude Code 迁移等。\n\n→ 从这里开始：[`codex/01-what-is-codex.md`](codex/01-what-is-codex.md)\n\n## 怎么读\n\n1. 挑一个工具（建议从 Claude Code 起步）。\n2. 按编号顺序往下读，每篇 3-10 分钟。\n3. **边读边动手** —— 每篇都有可照跑的命令 + 预期输出。\n4. 学完一个章节就把它集成进你每天的开发流程。\n\n## 常见疑问\n\n| Q | A |\n|---|---|\n| **要付费吗？** | 教程本身 **完全免费**（MIT）。但 Claude Code / Codex 这两个工具本身需要订阅或 API 付费（订阅最便宜，每月 $20 起，详见各篇「订阅与计费」） |\n| **需要魔法上网吗？** | 安装、登录、使用都需要。教程里已标注每个工具的具体要求 |\n| **没用过命令行能学吗？** | 能。第一组「基础入门」专门照顾新手，从命令行基础带起 |\n| **Claude Code 和 Codex 学哪个？** | 看你常用什么模型。两个工具理念接近、各有所长。推荐先从 Claude Code 起步，再读 Codex 篇的「从 Claude Code 迁移」横向对比 |\n| **教程会更新吗？** | 这两个工具迭代很快，重要变化会跟进。版本信息见 [Commits](https://github.com/stormzhang/ai-coding-guide/commits/main) |\n\n## 技术栈\n\n教程站基于 **VitePress** 搭建，**Catppuccin Mocha** 暗色主题（仿 Claude Code CLI 会话窗口风格），代码块 Shiki 高亮，配图 SVG → @2x PNG，搜索 / mermaid / OG 卡片开箱即用。\n\n## 贡献 / 反馈\n\n- 发现错别字、过时信息、坏链接 → 直接[提 Issue](https://github.com/stormzhang/ai-coding-guide/issues/new)\n- 想改进某句表述、补充踩坑案例 → 欢迎 PR\n- 想加新主题、新工具 → 先开 Issue 讨论方向\n\n## 状态\n\n🟢 **稳定**：92 篇全部成稿，已完成四轮审核（事实核实 / 表达优化 / 16 子代理复核）。后续以增量小修小补为主，新工具上线时新增专篇。\n\n---\n\n如果这套教程帮你少踩坑、少绕弯，⭐ Star 一下让更多人看见。\n\n## License\n\n[MIT](LICENSE) © 2026 [stormzhang](https://github.com/stormzhang)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstormzhang%2Fai-coding-guide","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstormzhang%2Fai-coding-guide","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstormzhang%2Fai-coding-guide/lists"}