主题
《Claude 终极使用指南》
面向进阶用户的 Claude / Claude Code / CoWork 全栈实战白皮书
版本：v1.0 · 构建日期：2026-07-29 · 目标读者：具备计算机基础、希望把 Claude 深度嵌入日常工作流、代码编写与项目管理的开发者与技术管理者
一、这本手册和别的教程有什么不同
市面上 90% 的 Claude 教程停留在「写好提示词的 10 个技巧」。这本手册不是。
它的核心假设是：你已经会用 Claude 聊天了，你现在需要的是把它变成基础设施。
因此本手册围绕三条主线展开：
| 主线 | 你将获得的能力 |
|---|---|
| 控制力 | 用 XML 标签、系统提示词、上下文布局精确操纵模型行为，而不是「许愿」 |
| 自动化 | 用 Claude Code + Hooks + Subagents + MCP 把重复劳动固化成可执行管线 |
| 可扩展性 | 用 Skills / Plugins / CLAUDE.md 把个人经验沉淀成团队资产 |
以及一个独特的第四块：元认知披露（Metacognition Disclosure）。第 04 章由模型以第一人称视角，直接讲清楚注意力在长上下文中如何分布、幻觉在哪一步产生、什么样的指令会被稀释、如何用工程手段把这些弱点锁死。这一章不讲「你应该礼貌地请求 Claude」，只讲机制。
二、设计理念
2.1 高内聚、低耦合
每个章节目录是一个独立的知识模块，遵循以下约定：
- 一个目录 = 一个可独立学习的主题，删掉任何一个目录，其余目录仍然自洽。
- 一个文件 = 一个可独立回答的问题。文件名即问题域，方便
grep与全文检索。 - 跨模块引用一律使用相对链接，不复制正文。需要同一段知识时，链接过去而不是粘贴过来 —— 避免"同一事实在三个文件里给出三种版本"。
- 编号前缀（
01-、02.3-）保证排序稳定，同时给你留出插空位：想在02.3和02.4之间加内容，命名为02.35-xxx.md即可，无需重排全目录。
2.2 可增量演进
本手册被设计成你自己的知识库骨架，而不是只读的成品：
- 每个章节目录下的文件相互不依赖执行顺序，可随时新增。
12-附录速查/存放高频查询的表格类内容，与正文解耦 —— 正文讲原理，附录讲参数。assets/预留给你自己的截图、图表与配置样例。- 根目录的
CLAUDE.md是给 Claude Code 读的项目记忆文件。当你用claude在本目录启动会话让它帮你续写章节时，它会自动遵守本手册的排版与术语规范。这本身也是 CLAUDE.md 的一个真实用例演示。
2.3 全局写作规范（贡献时请遵守）
- UI 双语映射：任何界面元素一律写作
[English] (中文)，例如[New Chat] (新建对话)、[Artifacts] (工件)、[Connectors] (连接器)。理由：Claude 客户端的中文本地化随版本漂移，英文原文才是稳定锚点；而中文对照保证可读性。 - 代码块必须带语言标记：
bash/json/yaml/markdown/python/text/diff。提示词示例统一用```text或```markdown。 - 命令行示例必须是可直接粘贴执行的真实命令，禁止伪代码。不确定的地方标注
# 需替换为你的实际值。 - 版本敏感信息必须标注，例如「需 Claude Code v2.1.199+」。
- 不写"很简单""只需要"这类词，读者的环境永远比你想的复杂。
三、完整目录索引
📍 00 · 导航与学习路径
| 文件 | 内容 |
|---|---|
| 00.1 如何使用本手册 | 阅读方式、代码块约定、如何用 Claude 自己读这本手册 |
| 00.2 四条学习路径 | 按角色（开发者/架构师/技术管理者/自动化玩家）给出的最短路径 |
| 00.3 术语表·中英对照 | 全手册术语的权威中英映射，写作与检索的唯一标准 |
🧱 01 · 基础篇 —— Claude 网页与客户端
| 文件 | 内容 |
|---|---|
| 01.1 产品矩阵与形态选择 | Web / Desktop / Code / CoWork / API / Chrome / Excel 的边界与选型决策树 |
| 01.2 界面全解与快捷键 | 每个按钮的英中对照与真实用途，含隐藏功能 |
| 01.3 Projects 项目与知识库 | Project Knowledge 的检索机制、容量策略与反模式 |
| 01.4 Artifacts 工件深度用法 | 触发条件、可用库清单、存储限制、迭代编辑技巧 |
| 01.5 模型选择与用量管理 | Opus/Sonnet/Haiku/Fable 的实际取舍、额度机制、降级策略 |
| 01.6 连接器与外部集成 | Connectors、Chrome 扩展、Slack、移动端的协同拓扑 |
✍️ 02 · 核心篇 —— 高级提示词工程
| 文件 | 内容 |
|---|---|
| 02.1 提示词的第一性原理 | 从 next-token 预测推导出的四条不变量 |
| 02.2 XML 标签控制术 | 重点章：为什么 XML 有效、标签命名法、嵌套结构、闭环校验 |
| 02.3 示例工程 Few-shot | 正例/负例配比、边界样本、示例污染的排查 |
| 02.4 角色与系统提示词 | System vs User 的真实权重差异、人格锚定与漂移防治 |
| 02.5 思维链与 Extended Thinking | 何时开启、effort 级别、交错思考、过度思考的抑制 |
| 02.6 提示词链与工作流编排 | 单提示词 vs 多阶段链，含可复制的编排模板 |
| 02.7 反模式清单 | 20 个让效果变差的常见写法及其修复 |
🧠 03 · 核心篇 —— 上下文与长文本管理
| 文件 | 内容 |
|---|---|
| 03.1 上下文窗口的物理学 | Token 预算的真实构成、什么在偷偷占用你的窗口 |
| 03.2 注意力分布与位置效应 | 重点章：首尾优先、中段衰减的工程对策 |
| 03.3 长文档处理战术 | 引文抽取法、分块 Map-Reduce、索引化预处理 |
| 03.4 压缩 Compact 与会话续航 | /compact 幸存规则、checkpoint 与 rewind |
| 03.5 Prompt Caching 与成本工程 | 缓存命中的前缀规则、把成本压到 1/10 的布局法 |
🔬 04 · 元认知篇 —— Hack Claude
| 文件 | 内容 |
|---|---|
| 04.1 我的底层运作机制 | 第一人称披露：一次响应内部到底发生了什么 |
| 04.2 注意力机制自白 | 指令稀释、位置权重、系统提示词与用户消息的博弈 |
| 04.3 幻觉的成因与锁死方案 | 重点章：五类幻觉的产生路径与逐类反制手段 |
| 04.4 拒绝与边界的真实逻辑 | 为什么会误拒、如何合法地降低误拒率 |
| 04.5 性能压榨 Checklist | 30 条可勾选的调优动作，按收益/成本排序 |
⌨️ 05 · Claude Code 入门
| 文件 | 内容 |
|---|---|
| 05.1 安装与环境配置 | 各平台安装、认证、诊断、企业代理 |
| 05.2 第一次会话完整走查 | 从 claude 到第一个 commit 的逐步实录 |
| 05.3 CLI 命令与 Flag 速查 | 全部子命令与高价值 flag 的实战解释 |
| 05.4 斜杠命令速查 | 按工作流阶段组织的全量 / 命令 |
| 05.5 权限模型与安全边界 | 六种权限模式、规则语法、沙箱 |
| 05.6 CLAUDE.md 项目记忆 | 加载顺序、rules 目录、auto memory、失效排查 |
🚀 06 · Claude Code 深度解析
| 文件 | 内容 |
|---|---|
| 06.1 终端接管逻辑与工具循环 | 重点章：Agent Loop 的每一步、它凭什么敢跑命令 |
| 06.2 测试驱动与自修复循环 | 重点章：Auto-debugging 的真实机制与可复制流程 |
| 06.3 Git 与 GitHub 工作流 | 提交、分支、PR、Review、冲突处理、危险操作防护 |
| 06.4 Subagents 子代理编排 | frontmatter 全字段、上下文隔离、并行策略 |
| 06.5 Hooks 生命周期钩子 | 全事件表、JSON 协议、可直接用的拦截脚本 |
| 06.6 Headless 与 CI 集成 | -p 模式、结构化输出、GitHub Actions 流水线 |
| 06.7 Worktrees 与并行开发 | 多分支并行、后台会话、agent view |
| 06.8 Settings 配置全解 | 五层配置优先级、常用键、环境变量 |
🔌 07 · MCP 从入门到精通
| 文件 | 内容 |
|---|---|
| 07.1 MCP 协议原理 | 为什么需要 MCP、三种传输、四类原语 |
| 07.2 安装与作用域管理 | claude mcp add 全形态、local/project/user 优先级 |
| 07.3 认证与安全 | OAuth 流程、动态请求头、提示词注入防护 |
| 07.4 手写一个 MCP Server | 实战：从零写一个可用的 Python/TS server |
| 07.5 工具规模化与 Tool Search | 上百个工具时的延迟加载机制与调优 |
| 07.6 MCP 实战配方 | Sentry / GitHub / Postgres / Notion 的可粘贴配置 |
🧩 08 · Skills 从入门到精通
| 文件 | 内容 |
|---|---|
| 08.1 Skill 是什么与三层加载模型 | 渐进式披露的成本模型 |
| 08.2 SKILL.md 规范全解 | 全部 frontmatter 字段与语义 |
| 08.3 编写高触发率的 description | 重点章：触发失败的根因与写法公式 |
| 08.4 渐进式披露与资源组织 | 脚本、参考文档、模板的目录布局 |
| 08.5 四种扩展机制怎么选 | Skill / CLAUDE.md / Subagent / MCP 的决策矩阵 |
| 08.6 Skill 实战示例集 | 4 个可直接复制的完整 Skill |
🗂️ 09 · CoWork 协作空间指南
| 文件 | 内容 |
|---|---|
| 09.1 CoWork 定位与界面 | 它到底是什么、和 Claude Code 的边界 |
| 09.2 文件夹挂载与产物交付 | 工作区路径模型、沙箱、交付物落盘 |
| 09.3 Skills 与 Plugins 在 CoWork | 文档生成技能、插件市场、自建技能 |
| 09.4 定时任务与 Artifacts | 自动化日报、可复用的实时看板 |
| 09.5 CoWork 与 Claude Code 协同 | 双引擎工作流的分工方案 |
🏢 10 · Plugins 与团队工程化
| 文件 | 内容 |
|---|---|
| 10.1 Plugin 与 Marketplace | 插件结构、发布、私有市场 |
| 10.2 团队标准化配置 | 把个人配置升级为团队基线 |
| 10.3 企业级管控 | managed settings、权限收敛、审计 |
🎯 11 · 实战场景库
| 文件 | 内容 |
|---|---|
| 11.1 遗留代码库考古 | 接手陌生百万行代码的 7 步流程 |
| 11.2 从零构建全栈功能 | Plan → Implement → Verify 全链路 |
| 11.3 Bug 猎杀与根因分析 | 复现、二分、修复、回归 |
| 11.4 大规模重构与迁移 | 跨 200 文件的安全改造法 |
| 11.5 Code Review 与安全审计 | 多代理评审与 /security-review |
| 11.6 文档与知识库自动化 | 让代码库自己写文档 |
| 11.7 数据分析与报表 | CoWork + 脚本的数据管线 |
📎 12 · 附录速查
| 文件 | 内容 |
|---|---|
| 12.1 完整命令速查卡 | CLI + 斜杠命令 + 快捷键，可打印 |
| 12.2 环境变量速查 | 高价值环境变量清单 |
| 12.3 故障排查手册 | 症状 → 诊断 → 修复 |
| 12.4 提示词模板库 | 12 个可直接粘贴的高质量模板 |
| 12.5 官方资源与延伸阅读 | 权威链接索引 |
四、快速开始
bash
# 1. 用 Claude Code 打开本手册目录，让它成为你的学习助教
cd ~/Projects/LearnClaude
claude
# 2. 在会话中直接提问，它会读取本目录下的 CLAUDE.md 与文档
> 我想在两周内把 Claude Code 用到能自动跑测试和提 PR，给我一条最短路径
# 3. 想让它帮你续写某一章
> 阅读 docs/07-MCP-从入门到精通/ 下的所有文件，然后为 07.7 补一篇「MCP 性能调优」，
严格遵守 CLAUDE.md 里的写作规范如果你只想读，不想装任何东西，直接从 00.2 四条学习路径 开始。
五、版本与维护
| 项 | 说明 |
|---|---|
| 内容基准 | Claude Code v2.1.x 系列、Claude Fable 5 / Opus 5 / Sonnet 5 / Haiku 4.5 |
| 校验日期 | 2026-07-29 |
| 更新方式 | 官方文档变动频繁，涉及具体 flag 与版本号处请以 docs.claude.com 与 code.claude.com/docs 为准 |
| 贡献规范 | 见本文 2.3 全局写作规范 |
⚠️ 免责声明：本手册中的第 04 章「元认知篇」是基于公开的模型行为特征、官方 prompt engineering 文档与大量实测归纳出的工程化心智模型，用于指导实践。它不是对模型权重内部结构的逐字描述 —— 神经网络的内部机制没有任何人（包括模型自己）能完全精确地自省。请把它当作一张高精度的工程地图，而不是源代码。