Appearance
Claude Code · 22 篇 · 实战手册
把 Claude Code 变成你的工程搭档
写给独立开发者的 AI 编程指南。从安装、权限、上下文，到 MCP、Subagent、Skill 与完整实战，把命令行里的 Claude Code 用成稳定生产力。
claude
Claude Code v2.1.183Opus 4.8 · Claude Max
> 分析这个项目，找出风险并给出修改计划
好，我先读取项目结构和关键配置。
Read(package.json)docs:dev / docs:build / docs:preview
Search(.vitepress)config.ts · theme · rewrites
发现首页、导航、侧边栏和文章内链可以继续收敛。
Edit(index.md)重排首页入口，保留阅读路径
已生成可验证的修改，并通过构建。
›
22篇系统内容
6个学习模块
4套阅读路径
1张速查表
基础篇先建立正确心智
## 使用说明 搞清楚 Claude Code 是什么、怎么安装、如何配置 API，以及项目里的 CLAUDE.md 应该怎么写。
核心篇把高频工作流跑顺掌握 prompting、探索代码库、修 Bug、重构、写测试、多模态和上下文管理。
进阶篇扩展你的 AI 工程系统用 MCP、Subagent、Skill、Memory 和环境变量，把 Claude Code 调成更适合你的工作方式。
实战篇从单会话走到完整交付用 30 分钟单会话和 Capstone 项目，把前面的知识串成真正能复用的工程流程。
给人类读者：通读一遍 01-06 掌握基础，然后按需跳到感兴趣的核心篇或进阶篇。最后读 17-19 实战篇收尾。
给 AI 助手：用户遇到问题时，先读此索引定位到相关篇号，再读对应篇的 cheatsheet 字段快速获取答案。如需完整上下文，读整篇正文。
基础篇（01-04）：概念与安装
| 编号 | 标题 | 关键词 | 速查摘要 |
|---|---|---|---|
| 01 | Claude Code 是什么 | 定位, 对比, ChatGPT, Copilot, Cursor | 一句话：命令行版 AI 编程搭档，能读项目、改文件、跑命令。与 ChatGPT、Copilot/Cursor 的核心区别在于「代理能力」——不是给建议，是替你动手。 |
| 02 | 安装、登录与运行形态 | 安装, 登录, CLI, VS Code, JetBrains, 桌面 App, 网页版 | 官方脚本安装最优先（curl | bash 或 irm | iex）。五种形态：CLI 功能最全、VS Code 扩展有图形 diff、JetBrains 插件桥接 IDE、桌面 App 适合并行、网页版免安装。 |
| 03 | 工作原理、API 配置与第三方模型 | 代理循环, 工具, API key, 订阅, 国产模型, DeepSeek | 工作原理：想→做→看 代理循环。5 类工具让 Claude 能动手。API 配置：订阅登录 vs API key，优先级 API key > 订阅。第三方模型：改 ANTHROPIC_BASE_URL 接国产模型。 |
| 04 | 项目初始化与 CLAUDE.md | /init, CLAUDE.md, 项目记忆, 权限 | /init 生成 CLAUDE.md 草稿。CLAUDE.md 是 Claude 的「入职手册」，分用户级/项目级/子目录级三层，拼接加载。目标 200 行以内，每条规矩要具体可验证。 |
启动篇（05-06）：上手开工
| 编号 | 标题 | 关键词 | 速查摘要 |
|---|---|---|---|
| 05 | 界面操作与快捷键 | 快捷键, Esc, 模式, @, !, 多行输入 | 界面三要素：输入框、状态行、模式提示。核心快捷键：Esc 刹车/Esc Esc 倒车/Ctrl+D 退出/Shift+Tab 切模式。@ 点名文件，! 直接跑 shell 命令。 |
| 06 | 速查表与进阶索引 | 速查表, 命令, 快捷键, 斜杠命令 | 常用命令、快捷键、斜杠命令、环境变量全量速查表。 |
核心篇（07-12）：高频功能
| 编号 | 标题 | 关键词 | 速查摘要 |
|---|---|---|---|
| 07 | Prompting 四心法 | Prompt, 具体, 上下文, 验收标准, 计划 | 四心法：①具体>模糊（范围+约束+参照）②给上下文（@文件+整段报错）③给验收标准（测试/构建退出码）④复杂任务先列计划（Plan Mode 或「先别改」）。 |
| 08 | 四类高频工作流 | 探索, 修 Bug, 重构, 写测试 | 四类场景的标准打法：①探索陌生代码库（Plan Mode + 开放问题）②修 Bug（复现→定位→修复→验证）③重构（先认准范围→分步改→每步验证）④写测试（写+跑+修迭代）。 |
| 09 | 多模态：贴图改 UI | 多模态, 截图, 设计稿, 复刻 UI | 截图/设计稿直接粘贴给 Claude，它能读懂并实现。最佳实践：贴图 + 文字说明 + 验收标准，三步交圈。 |
| 10 | 会话经营 | 上下文窗口, 模式, 斜杠命令, /clear | |
| 11 | 权限与安全红线 | 权限, 安全, 拒绝规则, 目录限制 | |
| 12 | MCP：连接外部工具 | MCP, 工具, 数据源, 外部服务 |
进阶篇（13-16）：提效定制
| 编号 | 标题 | 关键词 |
|---|---|---|
| 13 | Subagent 与多 Agent 协作 | Subagent, Agent Teams, 并行, 扇出 |
| 14 | 自定义 Skill | Skill, 可复用, 工作法, skill-creator |
| 15 | Memory：跨会话记忆 | Memory, 自动记忆, 项目记忆, 持久化 |
| 16 | 并行任务与环境变量 | 并行, 环境变量, 插件, 配置 |
实战篇（17-19）：从零到交付
| 编号 | 标题 | 关键词 |
|---|---|---|
| 17 | Git 工作流 | Git, 提交, 冲突, 检查点, 回退 |
| 18 | 入门实战：30 分钟单会话 | 最小实战, 单会话, todo 脚本 |
| 19 | Capstone 综合实战 | 跨会话, 从零到交付, todo-cli, 完整工程流 |
心法篇（20-22）：格局与避坑
| 编号 | 标题 | 关键词 |
|---|---|---|
| 20 | 最佳实践五条法则 | 验收, 先探索, 具体, 精简, 及时纠偏 |
| 21 | 反模式与排障速查 | 反模式, 排障, 常见报错, 解法 |
| 22 | 独立开发者 AI 编程心法 | 心法, 总结, 独立开发者 |
阅读路径推荐
路径 A：零基础新手（推荐）
01 → 02 → 03 → 05 → 04 → 07 → 08 → 18 → 20先搞懂是什么、怎么装、怎么用，再学提问心法，跑一个最小实战，最后看最佳实践收尾。
路径 B：快速上手（半天内）
01 → 02 → 05 → 07 → 18看完概念直接装，上手界面和提问，跑一遍实战。
路径 C：有经验者按需跳读
01 → 04 → 07 → 08 → 12 → 14 → 19 → 20 → 21跳过基础安装，直接看项目初始化、提问心法、工作流、MCP、Skill、综合实战和避坑。
路径 D：AI 编程老手（想快速定位）
01(速查摘要) → 05(速查表) → 06(全量速查) → 按需跳其他篇先看概念定位，直接拿速查表开工，需要时再查对应篇。
荐读顺序
- 必须先读：01、02、05、07
- 强烈推荐：04、08、11、18、20
- 按需选读：03、09、10、12、13、14、15、16、17、19、21、22