Claude Code 从入门到精通（全书摘要）

概述

本书是一份完整的 Claude Code 实战教程，从零开始覆盖从安装到构建完整产品的全流程。全书分三部分：起步、核心能力、进阶实战，最后附有源码架构分析。

📝 与已有 Wiki 的关系
本仓库已有 [Claude Code使用指南](Claude Code使用指南)（active 正式页），两者内容互补。该指南侧重命令速查和配置参考，本书侧重学习路径和思维模型。

§01 为什么是 Claude Code

AI 编程工具三年三变：Copilot（补全） → Cursor（对话） → Claude Code（终端 Agent）。

核心差异：

Copilot 是你的输入法
Cursor 是你的结对伙伴
Claude Code 是你的独立工程师团队

Claude Code 不只是写代码，它帮你构建产品。你描述需求，它规划步骤、读代码、写代码、跑测试、操作 git，全程自动完成。

受众：工程师（提效 10 倍）、产品经理（做 MVP）、创业者（一人公司）。

§02 10 分钟完成安装

三种安装方式：

Native Install：curl -fsSL https://claude.ai/install.sh | bash（推荐）
Homebrew：brew install --cask claude-code
WinGet：winget install Anthropic.ClaudeCode

五种使用环境：终端 CLI（最完整）、VS Code 扩展、Desktop App、Web 版、JetBrains 插件。

付费方案：Pro ($20/月) → Max 5x ($100/月) → Max 20x ($200/月)

§03 你的第一个项目

做一个「AI 新闻聚合 CLI 工具」，核心五步：

描述需求 → 审查方案 → 确认执行 → 验证结果 → 迭代改进

心态转变：你的价值不在于写代码，而在于定义要做什么、判断做得对不对。把 Claude 当团队成员管理。

§04 核心工作流

Plan 模式（先想清楚再动手）

按两次 Shift+Tab 进入。Claude 只规划不执行。Boris 推荐的流程：Plan 模式讨论 → 编辑器写执行指令 → 切换到执行模式开启 Auto。

判断标准：需要跟同事解释才能让他做的任务 = 值得 Plan 模式。

Auto 模式

AI 分类器替你做权限判断：安全操作自动放行，危险操作拦截。两层防御：Prompt Injection 探测器 + Transcript 分类器。

权限管理

/permissions 配置白名单，支持通配符。可提交到 git 团队共享。

Git 操作

一句话 commit/PR。Git Worktrees 实现多分支并行工作（claude --worktree）。

Computer Use

Claude 看屏幕截图，操控鼠标键盘。适用于测试 Web 应用 UI、操作无 API 的桌面软件。

Voice Mode

/voice 进入语音模式，支持 20 种语言。适合脑暴和快速启动任务。

会话管理

/clear：清空上下文，切换任务时用
/compact：压缩上下文
/btw：侧链提问，不污染主上下文
Esc × 2 或 /rewind：回滚

六个常见坑

一个会话什么都塞
反复纠正越改越偏（纠正两次不行就重来）
看着像对的就接受了（实际跑一遍）
过度微操（关注结果，不是过程）
需求模糊（越具体越好）
不写 CLAUDE.md

§05 CLAUDE.md：给 AI 一张地图

核心原则：从护栏开始，别写手册。每次 Claude 犯错就加一条规则。

该写什么：Claude 猜不到的（自定义命令、代码风格偏好、常见陷阱）。不该写什么：Claude 读代码就能知道的。

层级结构：~/.claude/CLAUDE.md（全局）→ ./CLAUDE.md（项目）→ 子目录级。

飞轮效应：Claude 犯错 → 记录到 CLAUDE.md → 下次不再犯 → 错误率持续降低。

§06 进阶对话技巧

三条原则

具体化：指定文件、场景、偏好
指向已有模式：照着现成的范本做
描述症状，不要猜原因：说现象让 Claude 自己定位

Context Engineering

上下文不是越多越好。定期用 /context 检查窗口使用情况。有效方式：@ 引用文件、粘贴截图、pipe 数据。

让 Claude 采访你

大功能先让 Claude 采访 → 生成 Spec → 新会话执行。不要在同一个长会话里既讨论又实现。

Effort 级别

Low / Medium / High（默认）/ Max。Boris 从不调低：Claude 想得更深，返工更少。High 是默认值。

§07 扩展能力：Skills、Hooks 与 MCP

机制	本质	确定性	场景
Skills	Markdown 指令包	高但非 100%	领域知识、可复用工作流
Hooks	Shell 脚本钩子	100%	格式化、lint、安全检查
MCP	外部工具连接器	100%	数据库、API、第三方服务

Skills：.claude/skills/ 目录下 SKILL.md。@skill-name 手动调用，Claude 也可自动判断。

Hooks：生命周期钩子（PreToolUse / PostToolUse / Stop / PostCompact 等）。CLAUDE.md 是建议，Hooks 是强制执行。

MCP：claude mcp add 添加服务器。实用推荐：Slack MCP、数据库 MCP、Figma MCP、Sentry MCP、GitHub MCP。

§08 多 Agent 协作

Boris 日常：本地 5 个 Claude Code + 云端 5-10 个网页会话并行。

Git Worktrees：claude --worktree 创建隔离环境，--tmux 集成 Tmux。

Subagents：.claude/agents/ 定义专家（security-reviewer / code-simplifier 等），独立上下文不消耗主 session。

Agent Teams：Writer/Reviewer 模式、测试驱动模式、Coordinator Mode 四阶段协调。

Fan-out 批处理：非交互模式 -p + /batch 命令，大规模重构利器。

异步工作：Remote Control、Web 版、/schedule（云端定时）、/loop（本地长运行）。

§09 从零构建一个完整产品

以「AI 周报助手」为例走完整流程：

Phase 0：Claude 采访 → 生成 SPEC.md
Phase 1：项目初始化 + CLAUDE.md 配置
Phase 2：Plan 模式讨论 → Auto 模式实现（每步验证）
Phase 3：截图反馈 → UI 迭代
Phase 4：Skills + MCP + Hooks 扩展
Phase 5：Vercel 部署 + CI/CD

五条实战经验：