ORANGE BOOK · CLAUDE CODE

Claude Code 橙皮书上手与进阶指南

从序言开始阅读 五分钟快速上手
项 信息
当前版本 v1.0.0
最后更新 2026-04-19
适配 Claude Code ≥ 2.5（核心命令向下兼容到 1.x）
模型默认 Claude Sonnet 4.5（也讲解 Opus 4.7、国产模型路由方案）
语言 简体中文
许可协议 CC BY-SA 4.0（署名 + 相同方式共享）
反馈 / 勘误 在仓库提 Issue，或邮件至 book@claudebook.community

如何使用本书：本书允许你免费下载、传播、翻译、改编，但必须署名作者并保持相同协议开源，禁止任何形式的"封装售卖"或"去名转售"。

这本书是写给谁的

  • 完全没听过 Claude Code，但想找一个能"替自己干活"的 AI 工具的人。
  • 听过 ChatGPT，用了一段时间发现"它只能聊天，不能做事"，正在寻找下一站的人。
  • 用过 Cursor 但只把它当代码补全器，想知道还能怎么进一步用 AI 的人。
  • 每天被琐事压得喘不过气的上班族、自由职业者、创业者、学生。
  • 内容创作者、营销人员、设计师、行政、运营——所有"不写代码但被信息和文件淹没"的人。
  • 想给爸妈、给伴侣、给团队配一个"AI 小助理"的人。
  • 好奇 AI Agent，但被各种英文文档和命令行劝退过的人。

如果你属于以上任何一类，你来对地方了。

这本书不是什么

  • 不是 Claude Code 的官方 API 文档，也不是底层架构剖析。
  • 不是面向资深工程师的"高级技巧汇编"。
  • 不是堆术语、堆参数、堆截图的"功能罗列"。

它是一本实战手册。每一章都让你"打开终端就能跟着做"，做完就能立刻看到效果。

你将获得什么

读完整本书，你会：

  1. 真正理解 Claude Code 是什么、和 ChatGPT / Cursor / Copilot 有何本质差别、它能不能解决你的问题。
  2. 在自己的电脑上把 Claude Code 跑起来，并选好最适合你的"登录方式"（订阅 / API / 国内中转）。
  3. 写出能稳定执行的提示词，并学会用 CLAUDE.md 给 Claude 配一个"长期大脑"。
  4. 学会用 Skills + MCP + Hooks + Subagents 四大扩展系统，让 Claude Code 会读邮件、能控浏览器、可调数据库、能并行干活。
  5. 把至少 6 个生活/工作场景交给 Claude Code 自动跑（每天早报、周报、价格监控、文件整理、邮件分类、内容创作）。
  6. 学会用 /loop 把 Claude Code 变成一个 24 小时不下班的"轮班员工"。
  7. 知道怎么把 Claude Code 用得安全、隐私不泄露、API Key 不被偷、月成本控制在 30 元到 200 元之间。
  8. 避开新手最容易踩的 8 大坑。
  9. 如果你愿意，还能发布自己的 Skill 或 Plugin，加入社区，甚至把 AI 自动化做成副业。

阅读路径建议

这本书一共 12 章 + 5 个附录。你不必从头读到尾，下面几条路径任选其一。

路径 A：完全新手（推荐）

按章节顺序从 00 序言 一路读到 12 从用户到创造者，每章跟着做完再看下一章。预计 1 个周末看完，跑完一遍。

路径 B：只想立刻用起来

预计 1 小时跑通，先用起来再说。

路径 C：已经会用，想进阶

路径 D：我不写代码，只想用它干活

路径 E：我是程序员，关心写代码这件事本身

完整目录

章节 你会学到
00 序言：为什么每个普通人都该会用 Claude Code 一个上班族 24 小时的真实故事，告诉你 AI 编码助手究竟能改变什么
第一章 认识 Claude Code Claude Code 是什么，和 ChatGPT/Cursor/Copilot 有何不同，20 个能帮你做的事
第二章 五分钟快速上手 三平台一键安装，第一个任务，5 个常见报错
第三章 登录与订阅（如何用最少的钱跑起来） Pro/Max/API 三种付费方式、国内三种使用方案、月成本控制在 30 元
第四章 学会和它对话（提示词与 CLAUDE.md） ROCFE 五要素、XML 模板、CLAUDE.md 三层记忆系统
第五章 四大扩展系统（Skills MCP Hooks Subagents） Claude Code 真正的"超能力"在这一章
第六章 生活场景实战 整理文件、价格监控、旅行规划、健身打卡、给爸妈用
第七章 工作场景实战（不止程序员） 写作、营销、设计、行政、数据、求职、招聘七大画像
第八章 编程与代码场景 /init 项目化、读代码、改 Bug、写测试、Git、Code Review、Plan Mode
第九章 自动化与定时任务（/loop 与 Hooks） /loop Cron、Hooks 四种事件、个人早报实战、11 个开箱即用模板
第十章 安全与隐私 沙箱、权限分级、API Key、防注入、企业 SSO、Anthropic 数据政策
第十一章 避坑指南 新手 8 大坑、报错对照表、性能与成本调优、claude doctor 解读
第十二章 从用户到创造者 发布自己的 Skill / Plugin、加入社区、副业与个人 IP
附录 A 常用命令与斜杠命令速查表 80+ CLI 命令 + 30+ 斜杠命令一页查
附录 B 30 个开箱即用提示词 复制就能跑的 30 个高质量提示词
附录 C 术语表 30+ 个核心术语的中英对照与白话解释
附录 D 资源与社区链接 官方文档、GitHub、Discord、中文社区与延伸阅读
附录 E 100 项达成清单 把全书拆成 100 个可打卡的小任务，跟踪你的成长

如何使用这本书

  1. 先看「30 秒导读」：每一章的开头都有一个 30 秒就能读完的导读，告诉你这章在解决什么问题、做完会得到什么。如果不感兴趣，可以直接跳过。
  2. 跟着「先做这一步」：所有的命令、配置、提示词都给了完整可复制版本，建议至少跑通一次，再回头看原理。
  3. 对照「本章一图回顾」：章末的小结帮你把这章串成一条线，方便日后翻查。
  4. 遇到报错先翻附录：80% 的常见报错都在 第十一章 避坑指南 和 附录 A 常用命令与斜杠命令速查表 里。

本书使用约定

  • 代码块：可以直接复制到终端或配置文件里运行的内容。
  • 「引号」：界面上的按钮、菜单或选项名称。
  • 粗体：值得你停下来重点理解的关键词。
  • 命令前面的 $ 表示这是终端里输入的命令，复制时不要带 $。
  • 在 Claude Code 对话框里输入的"斜杠命令"以 / 开头，例如 /init、/agents。
  • 引用 Claude 的回复时用 > 引用块或带"Claude:"前缀。

关于 Claude Code 的一些常见误会

  • 「Claude Code 只给程序员用？」——不。它本质是一个能"读你电脑文件、调命令、调 API、写文件"的通用 Agent，写代码只是它的看家本事之一。本书有整整一章（第七章）讲非程序员场景。
  • 「我必须有信用卡才能用？」——不。本书第三章会给你三种"先用起来"的方式，包括完全免费的"试用 + 国产模型路由"组合。
  • 「国内不能用？」——能。但需要选对方案，第三章会教你三条最稳的路。
  • 「它会不会偷偷上传我的代码？」——默认不会。Anthropic 对 Claude Code 用户数据有明确承诺，第十章会逐条拆开看。

一句话总结

这本书要做的事情只有一件：让你这个普通人，不靠任何技术背景，也能把 Claude Code 用得比 90% 的人都好。

准备好了吗？翻开 00 序言 开始吧。

电子书封面（KDP 出版）

封面生成（单一标准脚本、参数与版式常量）见仓库内 tools/橙皮书-KDP封面生成方案.md（仅源稿维护，未发布至站点）。 下文为本书目录素材速查。

Amazon KDP 要求电子书封面为 1600×2560 像素（高宽比 1.6:1）。本目录内：

文件 说明
cover-claudebook-orange-series.png 横版系列主视觉（版式与字阶的参考真源）
ebook-cover-from-horizontal-ref-1600x2560.png 与上者同一版式语言的竖版 KDP 封图（系列上架推荐）
ebook-cover-kdp-1600x2560.png 旧版渐变脚本遗留图（可选删除或忽略；出版以 ebook-cover-from-horizontal-ref-1600x2560.png 为准）

在仓库根目录执行，可重新生成「横图同系」竖版：

python3 tools/render_orangebook_landscape_ref_vertical.py -o claudebook/ebook-cover-from-horizontal-ref-1600x2560.png

主标题、副标题、作者等可通过 --main-en、--main-cn、--sub、--author、--series-decor 覆盖（见 python3 tools/render_orangebook_landscape_ref_vertical.py -h）。

其余书目生成时请沿用同一文档中的命名习惯与检查清单。

版本与变更

版本 日期 主要变更
v1.0.0 2026-04-19 初版发布：12 章正文 + 5 个附录，覆盖入门到创造者全路径，适配 Claude Code 2.5

后续如有新增/勘误，会在本表追加，并在每章相关段落加 （v1.x 更新） 标注。

通用版工具箱（附录卷）

本书是 Claude Code 的"产品专属指南"。如果你想要一份跨工具、不绑定任何产品的"通用 AI 工具箱"——100 个通用提示词、150+ AI 黑话翻译、30 天通用打卡计划、50 个高频 FAQ、安全红线、家庭 AI 公约——请翻 《AI 橙皮书（附录卷）：通用 AI 工具箱》。

它和本书是"互补"的：本书讲 "Claude Code 怎么用"，附录卷讲 "任何 AI 都通用的方法"——换工具不卡壳。

版权与署名

  • 本书根据 CC BY-SA 4.0 协议开源，欢迎转载、翻译、改编。
  • 转载请注明原书《Claude Code 橙皮书：上手与进阶指南》及原始仓库地址。
  • 改编版本必须保持同一协议开源。
  • 商业用途请先联系作者邮箱获取授权。
  • 本书中提到的 "Claude"、"Claude Code"、"Anthropic" 是 Anthropic PBC 的注册商标，本书与 Anthropic 官方无任何关联，是社区独立著作。

如果这本书帮到了你，最好的"赞赏"就是把它转发给一位被琐事压垮的朋友。