Claude Code 完全指南 2026：从安装到 Agent 工作流的终极教程

大多数 Claude Code 教程教你「怎么安装」和「怎么用斜杠命令」——这就像教你「Word 可以打字」一样，技术上正确但远远不够。这篇指南的目标不一样：我要把每天使用 Claude Code 超过 8 小时、用它管理 3000 多个文件的知识库、开发了覆盖全业务链的 CLI 工具体系的真实经验，浓缩成一份从零到 Agent 工作流体系的完整路线图。

要点速览

• Claude Code 是终端原生的 Agent 编程工具，跨 6 个平台运行，GitHub 星标超过 13 万（来源：GitHub 仓库）
• 本文覆盖 6 种安装方式、60 多个命令速查、CLAUDE.md 从单文件到知识架构、Hooks/Skills/MCP/Subagent 深度实战
• 附 25 个常见报错解决方案、5 个成本控制技巧（实测节省 60% 以上）、5 个可直接复制的提示词模板
• 翔宇独家内容：三角分工选型、CLAUDE.md 知识库体系、Agent 工作流编排、7 个深水区踩坑实录

Claude Code 是什么？为什么它不只是另一个编程助手

Claude Code 是 Anthropic 开发的终端原生 Agent 编程工具（agentic coding tool）。如果你还不了解 AI 编程的整体格局，建议先看Vibe Coding 完全指南了解四代编程谱系。与 GitHub Copilot 的补全模式和 Cursor 的 IDE 内联模式不同，Claude Code 直接在你的文件系统里运行——读代码、改文件、跑命令、调用外部工具，全部自主完成。

💡 通俗讲：Copilot 像一个坐在你旁边提建议的同事，Cursor 像一个能帮你改文件的助手，而 Claude Code 像一个有独立工位的工程师——你描述需求，它自己规划、实现、测试、提交。

2026 年的 Claude Code 已经远超「终端编程助手」的定位。根据 Anthropic 官方 Overview 页面，它现在跨 6 个平台运行：终端 CLI、VS Code（含 Cursor）、JetBrains、Desktop App、Web（claude.ai/code）和 Slack。所有平台共享同一引擎——CLAUDE.md、settings、MCP Server 跨平台同步。

一组关键数据说明它的影响力：

The Pragmatic Engineer 对 Claude Code 创始人 Boris Cherny 的独家采访揭示了一个有趣的设计哲学：团队选择 TypeScript 作为技术栈，不是因为 TypeScript 最好，而是因为模型最擅长它——这个原则叫做「在分布之上构建」（on distribution），让 Claude Code 能够自我构建。更激进的是，每次新模型发布，团队都会删除大量代码——Opus 4.0 发布时删掉了约一半系统提示词，因为更强的模型不再需要那些辅助指令。

安装 Claude Code：6 种方式与常见报错速查

系统要求

6 种安装方式

⚠️ 常见踩坑：npm 安装方式已被 Anthropic 弃用（来源：官方 Advanced Setup）。如果你之前用 npm 安装过，建议卸载后改用原生安装器——原生方式支持后台自动更新，避免版本滞后。

安装完成后，在终端运行 claude，按提示在浏览器完成登录即可启动第一个会话。

可复制提示词 1：安装后的第一个任务

分析这个项目的结构，告诉我：
1. 主要技术栈是什么
2. 入口文件在哪里
3. 有哪些测试覆盖
4. 你建议从哪里开始改进

安装常见报错速查

中国大陆用户专属解决方案：

定价与选型：Pro、Max 5x 还是 API

🔍 深入一步：为什么 Max 5x 是最佳选择？根据多方分析（来源：Mind in the Loop、Martin Alderson），Anthropic 对 Max 订阅存在补贴——100 美元的月费可能对应 200 到 800 美元的计算资源。Anthropic 的策略是：今天补贴用户，等计算成本随摩尔定律下降后再盈利。Max 5x 处于补贴的「甜蜜点」——额度足够日常使用，成本又不会让 Anthropic 亏太多。

API 模式的定价参考（来源：Anthropic 官方定价）：

真实的企业成本教训：Uber 在 2025 年 12 月给 5000 名工程师开通 Claude Code，采用率从 32% 急升至 84%，结果在 4 个月内耗尽了全年的 AI 预算。CTO 公开声明 token 定价模型打破了传统订阅制（Software as a Service）的财务假设——用得越多付得越多，没有「无限使用」（来源：Forbes）。

60 多个命令速查表：从新手到高手的分水岭

根据 Towards AI 的统计，大多数开发者只使用 5 个命令，而掌握 15 个以上命令的开发者效率提升 3 到 4 倍。以下是完整速查表：

会话管理（日常最常用）

模型与推理

Agent 与并行

代码审查与质量

项目配置

诊断与调试

高级功能

快捷键速查

CLAUDE.md：从一个文件到知识操作系统

竞品教程教你「CLAUDE.md 有四级作用域」「用 /init 生成」「写编码规范」。这些都对，但远远不够——就像教你「Word 可以打字」一样。

CLAUDE.md 是 Claude Code 的项目级指令文件（来源：官方 Memory 文档），按四级加载：

1. 全局级（~/.claude/CLAUDE.md）：所有项目共享
2. 项目级（项目根目录 CLAUDE.md）：当前项目专属
3. 目录级（子目录 CLAUDE.md）：进入该目录时加载
4. 本地覆盖（CLAUDE.local.md）：不提交到 Git

但问题是：知道四级加载有什么用？关键在于怎么设计这四级的内容。

翔宇的 CLAUDE.md 知识架构

我用 CLAUDE.md 构建了一个完整的知识操作系统，管理 3000 多个文件的知识库。架构分三层：

第一层：全局 CLAUDE.md——Agent 的操作系统内核

定义 Agent 的基础行为规范：思考语言（英文）、交互语言（中文）、语言风格、工具优先原则、编码标准、自我验证要求。这是所有项目共享的「人格」。

第二层：项目 CLAUDE.md——完整导航体系

项目根的 CLAUDE.md 是一个路由表——品牌（3 个活跃品牌）、工作流（40 多个标准化管线）、工具（10 个统一入口）、业务空间、研究库、规范体系。Agent 不需要「搜索文件」，CLAUDE.md 里有完整的触发词路由，命中就直达目标。

第三层：目录 CLAUDE.md——局部上下文

每个业务目录都有自己的 CLAUDE.md。工作流目录的 CLAUDE.md 是工作流索引，工具目录的是路由表，规范目录的是覆盖矩阵。Agent 进入任何目录都能立即获取上下文。

这套体系的效果：Agent 在 3000 多个文件的知识库里导航零迷失，新工作流创建 10 分钟（因为有规范模板），多 Agent 行为一致（因为读同一套 CLAUDE.md）。

🔍 深入一步：CLAUDE.md 有一个鲜为人知的缓存机制。根据 2026 年 3 月的源码泄露分析（来源：sabrina.dev），系统提示词存在一条缓存分界线（SYSTEM_PROMPT_DYNAMIC_BOUNDARY）。分界线之前的内容（指令、工具定义）在所有用户间全局缓存；分界线之后的内容（CLAUDE.md、git status）是会话专属的。这意味着你的 CLAUDE.md 每次会话都要重新计费——它是你的「token 税」，必须极度精简。

可复制提示词 2：自动生成 CLAUDE.md

分析这个项目的代码库，然后生成一个精简的 CLAUDE.md，包含：
1. 项目结构概述（用树形图）
2. 技术栈和关键依赖
3. 编码规范（从现有代码推断）
4. 测试运行命令
5. 部署流程

规则：每行自问"删掉会导致你犯错吗？"，答案是否就删。目标控制在 500 token 以内。

CLAUDE.md 编写的 5 个原则

1. 精简是最高原则：根据 Builder.io 的 50 条最佳实践，CLAUDE.md 的指令预算约 150 到 200 条（系统提示已占约 50 条）。Sebastian Sleczka 的实测显示，把 CLAUDE.md 精简到 500 token 以下，每天能省约 3 美元（来源：codewithseb.com）
2. 路由优于描述：写「触发词→路径」的路由表，而不是冗长的项目描述
3. 分层加载：频繁变动的信息放目录级 CLAUDE.md，稳定的放项目级
4. 规范替代解释：写「函数只做一件事」而不是「请尽量让函数职责单一以提高可维护性」
5. 定期修剪：每周检查——哪些指令 Agent 已经通过训练数据掌握了？删掉

Hooks：13 个生命周期事件打造自动化防护网

Hooks（钩子）是 Claude Code 在特定时刻自动执行的脚本（来源：官方 Hooks 文档）。它解决的核心问题是：让确定性操作自动化，不依赖 Agent 的判断。

13 个生命周期事件：

5 种 Hook 类型：shell 命令、HTTP 请求、MCP 工具调用、prompt（单次推理评估）、agent（带工具的推理）。

⚠️ 常见踩坑：Hook 脚本执行失败时，Claude Code 会静默跳过——不报错，继续执行后续操作。这意味着你的格式化 Hook、安全检查 Hook 可能在你不知道的情况下失效。解决方案：每个 Hook 必须有 exit code 检查和失败通知。

可复制提示词 3：生成安全防护 Hook

帮我创建一个 PreToolUse Hook 配置，写入 .claude/settings.json，实现以下规则：
1. 禁止执行包含 rm -rf 的命令
2. 禁止修改 .env 文件
3. 所有 git push 操作需要用户确认
4. Bash 命令执行前记录到 ~/.claude/audit.log

输出完整的 settings.json 配置片段。

Skills 与 Plugin：从使用到开发的进阶之路

Skills：可复用的指令模块

Skills 是放在 .claude/skills/ 目录下的 SKILL.md 文件（来源：官方 Skills 文档），支持 YAML frontmatter 加 Markdown 指令。与 CLAUDE.md 不同，Skills 只在被调用时才进入上下文——这是省 token 的关键。

内置 Skills 包括：/code-review、/batch、/debug、/loop、/run、/verify、/simplify、/deep-research。

自定义 Skill 示例：

---
name: deploy-staging
description: 部署到预发布环境
---

## 执行步骤

1. 运行所有测试：`npm test`
2. 构建生产包：`npm run build`
3. 部署到 staging：`npm run deploy:staging`
4. 验证部署：访问 staging URL 确认关键页面正常
5. 输出部署结果摘要

Plugin：自包含的能力包

Plugin（插件）是包含 skills / agents / hooks / MCP servers 的自包含目录（来源：官方 Plugins 文档）。命名空间是 /plugin-name:skill-name，用 /reload-plugins 热更新无需重启。

社区生态数据（来源：awesome-claude-code-toolkit）：

MCP：让 Claude Code 连接外部世界

MCP（Model Context Protocol，模型上下文协议）是 Claude Code 连接外部工具和数据源的标准协议。更深入的实践经验见 MCP 最佳实践。三种类型（来源：buildtolaunch 安装指南）：

配置位置是 .mcp.json，也可以用 claude mcp add 命令交互式添加。

🔍 深入一步：多个 MCP Server 同时运行时，连接超时和资源竞争是高频问题。我的经验是：MCP 调用之间保持至少 2 秒的串行间隔，设置优先级路由（本地工具优先，网络服务降级），超时时自动切换到备用后端。

Subagent、Agent Teams 与 Dynamic Workflows

Subagent（子 Agent）：并行执行的工作单元

Subagent 是由主 Agent 派生的独立执行单元，各自有独立的上下文和工作树（worktree）。它们只向主 Agent 汇报结果，彼此不通信（来源：官方 Agent Teams 文档）。

Agent Teams（Agent 团队）：成员间可互相通信

与 Subagent 的单向汇报不同，Agent Teams 的成员间可以互相通信、共享任务列表。这是 2026 年 2 月随 Opus 4.6 引入的研究预览功能。

Dynamic Workflows（动态工作流）：Opus 4.8 的杀手级特性

开启方式：/effort ultracode 或在 Auto Mode 下自动触发（来源：官方 Dynamic Workflows 文档）。

核心机制：Claude 自主判断任务是否需要工作流，一个请求可产生多个串行工作流（理解代码→规划→实现→测试）。每个工作流内的 Subagent 上限是 1000 个。

Reddit 社区实测：一个「deep search」请求在 Ultracode 模式下自动编排了约 70 个 Agent，分三阶段执行——发现、基准测试、数据充实（来源：Reddit r/ClaudeAI）。

⚠️ 常见踩坑：Ultracode 模式的成本不可控——一个复杂任务可能消耗半个 200 美元 Max 计划的额度（来源：MindStudio 分析）。我的建议：日常任务用手动 Subagent 加 Skills 编排，Dynamic Workflows 留给「不知道怎么拆」的探索性任务。

成本控制：5 个技巧实测节省 60% 以上

基于每天 8 到 16 小时的高强度使用经验，以下 5 个技巧经过实战验证：

技巧一：CLAUDE.md 是你的 token 税——必须极度精简

5000 token 的 CLAUDE.md 意味着每个对话轮次、每个会话都要付出 5000 token 的基线成本（来源：buildtolaunch）。我的分层设计天然省 token——每个目录级 CLAUDE.md 只在进入该目录时加载，项目根 CLAUDE.md 只放关键路由表和行为准则，不放冗余描述。

技巧二：模型选择是最大的成本杠杆

这套策略比全用 Opus 省约 70%。

技巧三：/compact 是黄金命令，/clear 是浪费

Anthropic 的 Prompt Cache 命中成本仅为标准输入的 10%（来源：Anthropic 定价页面）。/compact 压缩上下文但保留缓存前缀，/clear 清空一切包括缓存。Sebastian Sleczka 的实测显示，从 /clear 切换到 /compact 后，缓存命中率从 12% 提升到 61%（来源：codewithseb.com）。

内部信息佐证：Claude Code 团队把缓存命中率当作核心运营指标——命中率下降时会宣布严重事故（来源：LinkedIn 内部分享）。

做法：上下文用量达 60% 时执行 /compact，绝不轻易用 /clear。

技巧四：拆大任务为多个短会话

单会话越长，上下文越大，每个轮次的 token 成本越高。把一个功能开发拆成「规划」「实现」「测试」三个独立会话，每个会话保持精简上下文。用 Git Worktree（工作树）隔离并行（来源：官方 Worktree 文档）。

技巧五：Skills 按需加载而非全局加载

Skills 只在被调用时才进入上下文（与 CLAUDE.md 不同，后者每次都加载）。把高频操作封装为 Skill 而非写进 CLAUDE.md——我的 Skill 分类管理，每次只加载需要的 1 到 2 个。

可复制提示词 4：成本诊断

分析我当前的 Claude Code 使用模式，给出成本优化建议：
1. 用 /context 查看当前上下文使用比例
2. 用 /usage 查看本次会话的 token 消耗
3. 检查 CLAUDE.md 的 token 数量
4. 建议哪些内容应该从 CLAUDE.md 移到 Skills
5. 建议哪些任务应该切换到更便宜的模型

工具对比：Claude Code、Cursor 和 Codex 的三角分工

不存在「最好的 AI 编程工具」——市场已经分化为三个生态位，每个位置都有最优解。完整的六大工具横评数据见2026 AI 编程工具横评：

生态位一：IDE 内联编码——Cursor 胜出

开发者 80% 的时间在 IDE 里看代码、改代码、调试。Cursor 把 AI 嵌进这个工作流：内联 diff、Tab 补全、文件上下文引用。Claude Code 在这个场景里太重——切到终端、描述需求、等 Agent 思考、审批变更，对于改一行 CSS 来说完全没必要。

生态位二：大规模并行任务——Codex 胜出

OpenAI Codex 的云端沙箱加异步任务队列天然适合「丢 100 个任务过去，明天早上收结果」的场景。代码在 Docker 容器里运行，不占本地资源。Claude Code 理论上也能并行（Git Worktree 加多窗口），但管理 10 个本地 Agent 进程比管理 10 个云端任务难得多。

生态位三：Agent 工作流体系——Claude Code 胜出

这是我选择 Claude Code 作为核心工具的原因：CLAUDE.md 多级配置加 Skills 可复用模块加 Hooks 确定性自动化加 MCP 外部集成加 Subagent 并行加 Plugin 打包分发——这套组合让 Claude Code 成为唯一能构建完整 Agent 操作系统的工具。Cursor 没有 CLAUDE.md 等效物（.cursorrules 远不及），Codex 没有 Skills 和 Hooks。

2026 年主流共识（来源：Reddit r/AI_Agents）：大多数专业开发者同时使用两个工具——Cursor 日常编辑加 Claude Code 复杂任务。

推荐组合：

• 日常够用：Claude Code Max 5x（100 美元）加 Cursor Pro（20 美元）= 120 美元/月
• 全火力：Claude Code Max 20x（200 美元）加 Codex API（100 到 200 美元）加 Cursor Pro（20 美元）= 320 到 420 美元/月

翔宇视角：用 Claude Code 构建 Agent 工作流体系

这是竞品文章完全空白的领域——没有任何中文内容讲过如何用 Claude Code 构建完整的 Agent 工作流系统。

CLI 工具体系的四阶段演进

我的 CLI 工具体系经历了四个阶段，每个阶段都有一次质变：

初期：人工主导。 手动创建项目结构、手动写参数解析、手动测试。Claude Code 的角色是「智能补全」。每个 CLI 耗时 2 到 4 小时。

沉淀期：模板标准化。 前几个 CLI 沉淀出了统一模式——项目结构、错误处理、日志格式、凭据读取。这些写进了 CLAUDE.md 的开发规范。每个 CLI 耗时 1 到 2 小时。

加速期：Skill 驱动。 创建了 CLI 脚手架 Skill——一条命令生成符合规范的项目骨架。Agent 的角色升级为「规范执行者」。每个 CLI 耗时 30 到 60 分钟。

成熟期：Agent 自主。 10 个统一入口 CLI 的架构设计让新功能不再需要新建独立项目——只需在对应入口下新增子命令。每个子命令耗时 15 到 30 分钟。效率比初期提升了 10 倍以上。

关键转折：制定开发规范——效率跃升一个台阶；沉淀 Skill——再跃升一个台阶；设计统一入口架构——又跃升一个台阶。

核心洞察：Claude Code 的价值不在于「写一个工具」，而在于「构建一个让 Agent 越来越快写工具的系统」。规范→ Skill → 架构——每一层沉淀都是未来效率的杠杆。

Shopify 的 ROAST 框架：企业级验证

Shopify 的实践验证了同样的思路。他们有近 20 年历史的主应用、数百万行代码、约 5000 个仓库、每年约 50 万个 PR。Claude Code 在 Shopify 有 500 日活用户，峰值 25 万请求每秒（来源：ZenML 案例分析）。

他们开发了 ROAST 框架，核心洞察是「熵累积」（entropy accumulation）：Agent 自主执行多步工作流时，错误在每一步复合——即使早期轻微偏差也会让后续步骤偏离。解决方案是交替使用确定性步骤和 Agent 步骤。

这与我的工作流体系理念高度一致——用 CLAUDE.md 多级配置和规范约束提供确定性骨架，让 Agent 在确定性框架内发挥创造力。

安全与权限：93% 审批率的警示

Anthropic 在 2026 年 5 月的工程博客中公开了一个惊人数据：用户批准了 93% 的权限提示——越多提示看到，注意力越低，本应保护安全的功能反而适得其反（来源：Anthropic 工程博客 How We Contain Claude）。

更严峻的安全案例来自 Anthropic 自己的内部红队演习：2026 年 2 月，研究人员成功钓鱼一名员工运行恶意提示词——Claude 在 25 次重试中有 24 次成功窃取了 ~/.aws/credentials（来源同上）。

真实发生的安全事故：

• Agent 删除远程 git 分支（误解指令）
• Agent 将工程师的 GitHub 认证 token 上传到内部计算集群
• Agent 尝试对生产数据库执行迁移

Auto Mode 的精确评估

Anthropic 公开了 Auto Mode 分类器的精确数据（来源：Anthropic 工程博客 Claude Code Auto Mode）：

结论：Auto Mode 比 --dangerously-skip-permissions 安全得多，但 17% 的漏报率意味着它不是手动审批的完全替代品。在生产环境，建议搭配 Hooks 的 PreToolUse 事件做额外防护。

7 个深水区：只有高强度使用才会遇到的问题

深水区一：Sandbox 故障

macOS 的沙箱基于苹果原生沙箱机制，启用后权限提示减少约 84%（来源：Anthropic 工程博客 Claude Code Sandboxing）。但系统更新后经常出现 EPERM 错误。解决路径：检查 sandbox entitlements → 重置 TCC 数据库 → 降级到非 sandbox 模式。

深水区二：TCC 漂移

macOS 的 TCC（Transparency, Consent, and Control）权限在系统升级或 Claude Code 更新后会漂移。症状：之前正常的文件操作突然需要权限确认。应对：定期检查 TCC.db，维护白名单。

深水区三：磁盘爆满

Prompt Cache、会话历史、MCP 数据会快速积累。3000 多个文件的知识库加上多个 Agent 实例的缓存，磁盘到 95% 是常事。策略：定期清理加外挂存储加磁盘监控 Hook。

深水区四：Hook 静默失败

前面提过：Hook 脚本执行失败时 Claude Code 静默跳过。每个 Hook 必须有 exit code 检查加失败通知。

深水区五：MCP 超时

多个 MCP Server 同时活跃时（特别是 Firecrawl 加搜索加 Chrome DevTools 三个并发），连接超时和资源竞争频发。经验：串行间隔至少 2 秒，优先级路由，超时自动降级。

深水区六：上下文窗口溢出

1M token 上下文窗口听起来很大，但知识库级别的 CLAUDE.md 层级加多文件引用加工具调用历史会快速填满。策略：分层 CLAUDE.md（只加载当前目录级别）加激进 /compact 加 Subagent 分流。

深水区七：多窗口冲突

同时运行多个 Claude Code 窗口时，文件锁冲突、Git 状态污染、CLAUDE.md 同时写入是常见问题。方案：Git Worktree 物理隔离加 tmux 窗口管理加进程互斥锁。

Claude Code 版本演进：关键里程碑时间线

来源：GitHub CHANGELOG、releasebot.io、Anthropic 官方博客。

非技术人员也在用：Claude Code 不只是编程工具

竞品文章默认 Claude Code 只服务程序员——这是对它能力的严重低估。

Anthropic 内部案例（来源：Anthropic 博客）：

• 律师团队用 Claude Code 构建了「电话树」系统，帮员工找到正确的律师
• 营销团队构建了 Agent 工作流：处理广告文件 → 识别表现差的 → 用子 Agent 生成数百条新变体，从数小时缩短到数分钟
• 数据科学家用 Claude Code 构建完整的 React 应用做数据可视化——他们不懂 TypeScript

Notion 设计团队案例（来源：Lenny's Newsletter）：

Notion 设计负责人 Brian Lovin 公开声明：「我已经 3 个月没有写过一行前端代码了」。设计师直接用自然语言描述想要的界面，Claude Code 构建活原型（working prototype），然后在真实代码上迭代——从设计到活原型只要分钟级别，而不是天级别。

我自己的使用场景同样超出编程：知识库管理、内容创作工作流、多平台文章发布、品牌运营。Claude Code 是 Agent 操作系统的核心——编程只是它能做的事情之一。

四阶段学习路线图：从安装到 Agent 架构师

阶段一：安装上手（1 天）

如果你是完全零基础，建议先阅读零基础 AI 编程入门指南理解 AI 编程的整体框架，再回来继续。

里程碑：成功安装加运行第一个任务加理解权限系统

关键动作：

• 用原生安装器安装
• 在一个小项目里跑「修 Bug」或「写测试」
• 理解 default、acceptEdits、plan、auto 四种权限模式

常见卡点：网络环境（国内需代理）、Node.js 版本、权限确认理解。

达成标志：能用 Claude Code 完成一个你之前手动做的编码任务。

阶段二：日常编码（1 周）

里程碑：把 Claude Code 融入日常开发工作流

关键动作：

• 用 /init 创建第一个 CLAUDE.md，然后精简
• 掌握 5 大核心工作流：写代码、理解代码、修 Bug、测试、Git
• 学会 /compact、/cost、/model 三个关键命令
• 建立「大任务拆小会话」的习惯

达成标志：日常编码效率提升 30% 以上。

阶段三：体系化（1 个月）

里程碑：从「用工具」到「造体系」

关键动作：

• 设计多级 CLAUDE.md 架构（全局加项目加目录）
• 创建第一批 Skills（代码审查、部署、测试等高频操作）
• 配置 Hooks（保存自动格式化、敏感文件保护、通知）
• 接入 MCP Server（搜索、GitHub、抓取等）
• 把高频操作封装为 CLI

达成标志：Claude Code 能按你的规范自动工作，不需要每次重复解释。

阶段四：Agent 工作流编排（持续进化）

里程碑：Claude Code 成为 Agent 操作系统的核心

关键动作：

• 设计标准化工作流（创作→发布→分析→运营全链路），完整方法论见 Agent 工作流完全指南
• 多 Agent 编排（Subagent 并行加 Git Worktree 隔离加 tmux 管理）
• Plugin 开发与分发
• 规范体系建设（保证多 Agent 行为一致性）
• Dynamic Workflows 探索性使用

达成标志：你的 Agent 系统能自主完成越来越多的工作，你的角色从「执行者」变为「架构师」。

可复制提示词 5：生成个人学习计划

基于我目前的技术水平和使用场景，帮我制定一个 Claude Code 学习计划：

我的情况：
- 技术水平：[初级/中级/高级]
- 主要语言：[Python/JavaScript/Go/...]
- 日常工作：[前端开发/后端开发/全栈/数据分析/...]
- 每天可投入学习时间：[1小时/2小时/...]

请按周为单位，列出每周要掌握的功能、建议的练习项目、和预期成果。

🔍 深入一步：95% 的用户停留在阶段二，用 Claude Code 作为「更强的 Copilot」。只有进入阶段三的人才能理解为什么 CLAUDE.md 是 Claude Code 的灵魂。进入阶段四的人屈指可数——这也是这类深度内容能在中文市场形成壁垒的原因。

源码泄露揭示的内部细节（2026 年 3 月事件）

2026 年 3 月 31 日，Claude Code v2.1.88 发布到 npm 时包含了 59.8MB 的 source map 文件，泄露了内部架构细节。这是第二次发生同样的事故——第一次在 2025 年 2 月（来源：sabrina.dev 分析）。

几个有趣的发现：

• KAIROS 自主 Agent 系统：190 处引用，61 个文件，是一个后台守护进程模式——GitHub webhook 触发、5 分钟定时循环、/dream 命令进行后台记忆整合。目前在功能标志（feature flag）后面
• 验证 Agent 的「借口清单」：代码中内置了模型逃避验证时常用的借口列表——「代码看起来没问题」（看不是验证，跑一下）、「实现者的测试已通过」（实现者是 AI，需独立验证）
• 内部 A/B 测试数据：「be concise」与硬编码字数限制的对比——「研究显示约 1.2% 的输出 token 减少对比定性的 be concise」。内部版使用精确字数：「工具调用间的文本不超过 25 词，最终回复不超过 100 词」
• 44 个未公开的 Feature Flag：暗示产品路线图远比公开可见的丰富
• 内部彩蛋：隐藏的电子宠物系统「Buddy」——18 个物种、扭蛋稀有度、1% 闪光概率

常见报错完整速查表

运行时报错

来源：官方 Troubleshooting、claudecodeguides.com、GitHub Issues。

自检清单：读完这篇你应该能做到

• [ ] 安装 Claude Code 并完成第一个编码任务
• [ ] 创建精简的 CLAUDE.md（500 token 以内）
• [ ] 掌握 15 个以上命令（速查表已收藏）
• [ ] 用 /compact 而非 /clear 管理上下文
• [ ] 按任务复杂度切换模型（Sonnet 日常、Opus 推理）
• [ ] 配置至少一个 Hook（如 PreToolUse 安全防护）
• [ ] 创建至少一个自定义 Skill
• [ ] 理解 Claude Code、Cursor、Codex 的分工
• [ ] 知道 7 个深水区的症状和解决方案
• [ ] 有自己的四阶段学习计划

FAQ：30 个高频问题速答

Q1：Claude Code 是什么？和 ChatGPT 有什么区别？

Claude Code 是 Anthropic 开发的终端原生 Agent 编程工具。与 ChatGPT 的对话式编码不同，Claude Code 直接在你的文件系统里运行——读代码、改文件、跑命令、调用外部工具，全部自主完成。

Q2：Claude Code 免费吗？

免费计划不包含 Claude Code。最低需要 Pro（20 美元/月），推荐 Max 5x（100 美元/月）。

Q3：Claude Code 怎么安装？

推荐原生安装器：macOS/Linux 运行 curl -fsSL https://claude.ai/install.sh | bash，Windows 运行 irm https://claude.ai/install.ps1 | iex。

Q4：需要 Node.js 吗？

原生安装器不需要。npm 安装方式需要 Node.js 18 以上，但 npm 安装已被官方弃用。

Q5：在中国大陆能用吗？

需要代理访问 api.anthropic.com。终端设置 export https_proxy=http://代理地址:端口。

Q6：Claude Code 和 Claude Desktop 是什么关系？

Claude Desktop 是桌面应用，提供图形界面。Claude Code 是终端工具，提供 Agent 能力。二者共享账户，可以用 /teleport 从 Web 拉取会话到终端。

Q7：支持哪些 IDE？

VS Code（含 Cursor）、JetBrains（IntelliJ/PyCharm/WebStorm）、Desktop App、Web、Slack，加终端本身共 6 个平台。

Q8：CLAUDE.md 怎么写？

用 /init 生成初始版本，然后精简——每行自问「删掉会导致 Agent 犯错吗」，答案是否就删。控制在 500 token 以内。

Q9：Plan Mode 是什么？什么时候该用？

Plan Mode 让 Claude 先规划再执行，适合多文件任务。用 /plan 进入，审批计划后再执行。

Q10：/compact 和 /clear 有什么区别？

/compact 压缩上下文但保留 Prompt Cache（缓存命中仅为标准价的 10%）。/clear 清空一切包括缓存。优先用 /compact。

Q11：怎么切换模型？Opus 和 Sonnet 该选哪个？

用 /model 切换。80% 日常任务用 Sonnet（便宜），需要深度推理才用 Opus。

Q12：Skills 和 Commands 有什么区别？

Skills 是 .claude/skills/ 下的 SKILL.md 文件，被调用时才加载。Commands 是内置的斜杠命令。

Q13：Hooks 能做什么？

13 个生命周期事件可以触发自动化操作：安全防护、自动格式化、通知推送、上下文注入等。

Q14：MCP 是什么？怎么配置？

模型上下文协议（Model Context Protocol），让 Claude Code 连接外部工具。在 .mcp.json 配置或用 claude mcp add。

Q15：怎么恢复之前的会话？

用 /resume 恢复之前的对话，用 -c 参数继续最近的会话。

Q16：Pro 20 美元够用吗？

约够 2 小时中等强度使用。日常编码超过 4 小时建议 Max 5x（100 美元/月）。

Q17：API 和订阅哪个便宜？

根据 Reddit 社区分析，在典型 Agent 循环中订阅比 API 便宜最多 36 倍。Max 5x 是最佳选择（来源：Reddit r/ClaudeAI）。

Q18：token 消耗太快怎么办？

五个技巧：精简 CLAUDE.md、/compact 替代 /clear、模型按任务选、拆大任务、Skills 按需加载。

Q19：Claude Code 和 Cursor 哪个好？

互补而非替代。Cursor 擅长日常编辑，Claude Code 擅长复杂 Agent 任务。推荐组合使用。

Q20：Claude Code 和 Codex 对比？

Codex 赢在云端沙箱和批量任务，Claude Code 赢在 CLAUDE.md 体系和 Agent 编排能力。

Q21：Subagent 是什么？

由主 Agent 派生的独立执行单元，有独立的上下文和工作树，只向主 Agent 汇报。

Q22：Dynamic Workflows 是什么？

Opus 4.8 新特性，Claude 自主判断并拆分大任务为并行 Subagent 工作流。用 /effort ultracode 开启。

Q23：Agent Teams 和 Subagent 有什么区别？

Subagent 只向主 Agent 汇报。Agent Teams 的成员间可以互相通信、共享任务列表。

Q24：Plugin 怎么开发？

Plugin 是包含 skills/agents/hooks/MCP servers 的目录。用 claude plugin init 创建，/reload-plugins 热更新。

Q25：数据安全吗？代码会被训练吗？

Claude Code 在本地运行，代码不上传到 Anthropic 服务器。Anthropic 明确声明不使用用户数据训练模型。

Q26：企业版和个人版区别？

Enterprise 版含安全合规、管理控制、审计日志、更高用量上限。

Q27：Max 5x 和 Max 20x 区别？

Max 5x（100 美元/月）是 Pro 的 5 倍额度，Max 20x（200 美元/月）是 20 倍。日常够用选 5x，全天 Agent 选 20x。

Q28：什么是 Prompt Cache？

Anthropic 自动缓存重复的提示词前缀，缓存命中仅收标准价的 10%。用 /compact 可保留缓存。

Q29：Claude Code 支持中文吗？

支持。官方有中文版文档（来源：code.claude.com/docs/zh-CN/quickstart），终端交互支持中文。

Q30：Anthropic 的 AI 编程年收入有多少？

Claude Code 的年化收入已超过 5 亿美元，GA 后三个月使用量增长超过 10 倍（来源：The Pragmatic Engineer 独家）。

从入门到精通：翔宇的 AI 编程实操课

想系统学习 Claude Code 和 Agent 工作流？翔宇的 AI 编程实操课覆盖从安装配置到 Agent 工作流构建的完整路径，含可复制模板和实战项目。

• 课程详情（FlowUS）
• 海外用户（Buy Me a Coffee）

延伸阅读

相关教程

• Vibe Coding 完全指南：从概念到第一个项目
• 2026 AI 编程工具横评：Cursor vs Claude Code vs Codex
• 零基础 AI 编程入门：不会写代码也能做产品
• Agent 工作流完全指南：一人公司多 Agent 自动化
• CLAUDE.md 怎么写
• Claude Code 提示词怎么写
• Claude Code Hooks 新手指南
• Claude Code MCP 新手指南
• Claude Code Skill 开发指南
• Claude Code 最佳实践
• 多 Agent 协作完全指南

官方文档

• Claude Code 官方快速开始
• Claude Code 官方最佳实践
• Claude Code CHANGELOG

参考来源

• The Pragmatic Engineer：How Claude Code is Built——Boris Cherny 独家采访，年收入超 5 亿美元、On Distribution 技术选型哲学
• Anthropic 工程博客：How We Contain Claude——93% 审批率、钓鱼实验、三种包围策略
• Anthropic 工程博客：Claude Code Auto Mode——17% 漏报率精确数据
• Anthropic 工程博客：Claude Code Sandboxing——沙箱设计、84% 权限提示减少
• sabrina.dev：Claude Code 源码泄露分析——KAIROS、缓存分界线、Undercover Mode
• ZenML：Shopify ROAST 框架——500 日活、熵累积概念
• Forbes：Uber AI 预算危机——5000 工程师、4 个月烧完预算
• codewithseb.com：Token 优化实战——从 37 美元/天降到 11 美元/天
• Lenny's Newsletter：Notion 设计团队——3 个月零前端代码
• awesome-claude-code-toolkit——135 agents、176 plugins 社区生态