> For the complete documentation index, see [llms.txt](https://yeasy.gitbook.io/claude_guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://yeasy.gitbook.io/claude_guide/readme.md).
# Claude 技术指南
## Claude 技术指南
[](https://creativecommons.org/licenses/by-nc-sa/4.0/) [](https://github.com/yeasy/claude_guide) [](https://github.com/yeasy/claude_guide/releases) [](https://yeasy.gitbook.io/claude_guide) [](https://github.com/yeasy/claude_guide/releases/latest)
> **从零开始，系统掌握 Anthropic Claude 的核心能力与最佳实践**
***
### 关于本书
**Claude** 是目前业界最先进的生产环境大语言模型之一。本书是面向开发者、产品负责人、自动化工程师和企业架构师的 Claude 生态落地手册，重点回答：什么时候选择 Claude，如何选择 Claude 的产品面，以及如何把 API、Claude Code、Agent SDK、MCP、Skills、Computer Use 和安全治理组合成可上线方案。
> *注：本书不会替代通用提示词工程、上下文工程、智能体理论或 Harness 工程专著；这些主题会在需要时交叉引用。本书聚焦 Claude 特有能力、接口边界、产品组合、迁移策略和上线判断。模型 ID、价格、上下文窗口和功能可用性变化很快，生产选型请以官方模型页、价格页和相关产品文档为准。*
全书将系统性地介绍 Claude 的核心能力体系，包括：
* [**提示工程（Prompt Engineering）**](/claude_guide/di-yi-bu-fen-ji-chu-pian/02_prompt.md)：与 Claude 高效沟通的艺术
* [**工具使用（Tool Use）**](/claude_guide/di-er-bu-fen-gong-ju-pian/03_tools.md)：让 Claude 调用外部 API 和服务
* [**模型上下文协议（MCP）**](/claude_guide/di-er-bu-fen-gong-ju-pian/04_mcp.md)：连接 Claude 与外部世界的标准接口
* [**计算机操控（Computer Use）**](/claude_guide/di-er-bu-fen-gong-ju-pian/05_computer_use.md)：Claude 自主操作桌面环境
* [**Skills 系统**](/claude_guide/di-san-bu-fen-jin-jie-pian/06_skills.md)：可复用的定制化工作流
* [**代码执行与 Agentic Coding**](/claude_guide/di-san-bu-fen-jin-jie-pian/07_coding.md)：Claude 作为自主编程助手
本书围绕新一代 Claude Fable 5 与 Opus、Sonnet、Haiku 各系列的核心能力展开。模型 ID、价格、上下文窗口和弃用状态变化很快，生产选型请以官方模型页和价格页为准。
#### 可执行黄金路径
仓库提供三条可离线测试、真实运行时再读取凭据的最小路径：
* [Messages API 最小调用](https://github.com/yeasy/claude_guide/tree/main/examples/messages_api.py)
* [完整客户端工具循环](https://github.com/yeasy/claude_guide/tree/main/examples/tool_use_loop.py)
* [Agent SDK 成功/失败事件处理](https://github.com/yeasy/claude_guide/tree/main/examples/agent_sdk_minimal.py)
依赖版本锁定在 [`examples/requirements.txt`](https://github.com/yeasy/claude_guide/tree/main/examples/requirements.txt)。测试不读取 API key、不访问网络：
```bash
python3 -m venv .venv && . .venv/bin/activate
python3 -m pip install -r examples/requirements.txt
python3 -m unittest discover -s tests -p 'test_*.py' -v
```
真实运行 `messages_api.py` 前按 Anthropic SDK 文档配置 `ANTHROPIC_API_KEY`；Agent SDK 示例使用该 SDK 支持的 Claude Code / API 凭据机制。不要把凭据写入仓库。
***
### 目标读者
| 读者类型 | 你将获得什么 |
| --------------- | ------------------------------- |
| **AI 应用开发者** | 掌握 Claude API 的高级用法，构建生产级 AI 应用 |
| **产品经理 / 业务人员** | 理解 Claude 能力边界，规划 AI 产品路线图 |
| **自动化工程师** | 利用 Claude 构建端到端工作流自动化 |
| **AI 研究爱好者** | 深入理解大语言模型的能力演进与设计原理 |
| **Claude 用户** | 提升日常使用效率，解锁高级功能 |
**前置知识要求**：基础计算机操作经验；对大语言模型有初步了解（非必需）；能够访问 Claude（[claude.ai](https://claude.ai) 或 [API](https://claude.com/platform/api)）。如果要动手完成 API、MCP、Computer Use 或 Claude Code 章节，还需要按路线准备对应基础：API 开发者需要 Python/JavaScript 与 HTTP/JSON 经验；MCP/Computer Use 构建者需要本地命令行、包管理和 Docker/容器基础；Claude Code 用户需要熟悉 Git、终端和项目权限边界。
***
### 内容大纲
```
第一部分：基础篇
├── Claude 概览与模型选择
└── 提示工程核心技术
第二部分：工具篇
├── Tool Use 工具调用
├── MCP 模型上下文协议
└── Computer Use 计算机操控
第三部分：进阶篇
├── Skills 技能系统
├── Agentic Coding 与 Claude Code
└── Agent 架构设计
第四部分：实战篇
├── 企业级应用案例
├── 成本优化与性能调优
└── 安全与伦理考量
第五部分：进阶能力
├── Claude 前沿特性
├── 上下文工程
└── 模型内部可解释性
附录
├── API、FAQ、术语与资源
└── 定价、竞品对比与快变事实核验
```
> [点击从第一章开始阅读](/claude_guide/di-yi-bu-fen-ji-chu-pian/01_intro.md)
***
### 阅读方式
**在线阅读**：[GitBook 在线版](https://yeasy.gitbook.io/claude_guide/)
### 下载离线版本
本书提供 PDF 版本供离线阅读，可前往 [GitHub Releases](https://github.com/yeasy/claude_guide/releases/latest) 页面下载最新版本。
如需获取默认分支自动更新的预览版，可直接下载 [claude\_guide.pdf](https://github.com/yeasy/claude_guide/releases/download/preview-pdf/claude_guide.pdf)。该文件会随主线更新覆盖，不代表正式发布版本。
**本地阅读**（先安装 [mdPress](https://github.com/yeasy/mdpress)）：
```bash
brew tap yeasy/tap && brew install mdpress
mdpress serve
```
启动本地服务器后，访问 [本地阅读地址](http://localhost:9000)
***
### 五分钟体验路径
5 分钟内先建立正确直觉，不把体验路径误当完整学习路径：
1. **开始 Claude 对话（ch1）**：访问 [claude.ai](https://claude.ai) 或 API，与 Claude 进行第一轮对话，体验其推理与表达能力（2分钟）
2. **做一个 Claude 风格提示小练习（ch2.1-2.2）**：用清晰任务、上下文和 XML 标签约束输出，理解 Claude 与通用聊天机器人的差异（2分钟）
3. **理解工具调用入口（ch3.1）**：先看 Claude 如何从回答走向行动，再按需要进入 MCP、Skills 或 Claude Code 分支（1分钟）
完成这 3 步后，你会知道后续该按哪条路线深入；真正的生产级落地还需要继续学习工具、评估、成本、安全和部署章节。
### 学习路线图
```mermaid
graph LR
A["Claude 入门区
第1-3章
对话与核心能力"] -->|日常使用| B["普通用户
第1-3章
高效对话与工具使用"]
A -->|全栈开发| C["开发者
第1,3-7章
API、工具、Agentic Coding"]
A -->|企业架构| D["企业架构师
第1,8-11,13章与附录
系统设计与优化"]
A -->|优化提示| E["提示词工程师
第1-2,4-6章
提示词技巧与优化"]
B -->|增强能力| C
C -->|系统规划| D
D -->|精细调优| E
style A fill:#e0f2f1
style B fill:#b2dfdb
style C fill:#80cbc4
style D fill:#4db6ac
style E fill:#26a69a
```
#### 学习角色对比
| 角色 | 推荐章节 | 学习重点 | 预期成果 |
| ---------- | -------------------- | ---------------------------------------- | ------------------ |
| **普通用户** | 第1-3章 | Claude 核心能力、对话技巧、日常工具使用 | 高效使用 Claude 完成日常任务 |
| **开发者** | 第1-2→3-8→9-11→附录 A/G | API 集成、Tool Use、MCP、Agentic Coding、成本与安全 | 构建 Claude 驱动的生产级应用 |
| **企业架构师** | 第1→8-11→13章，附录 A/F/G | 系统设计、成本优化、安全部署、快变事实核验 | 规划企业级 Claude 应用方案 |
| **提示词工程师** | 第1-2→3.1-3.3→4-6章 | 提示词结构、工具心智模型、多模态设计、优化方法 | 设计高质量的提示词系统 |
***
### 推荐阅读
本书是 AI 技术丛书的一部分。以下书籍与本书形成互补：
| 书名 | 与本书的关系 |
| ------------------------------------------------------------------------ | ------------------------------------- |
| [《零基础学 AI》](https://yeasy.gitbook.io/ai_beginner_guide) | AI 零基础入门，适合作为本书的前置阅读 |
| [《大模型提示词工程指南》](https://yeasy.gitbook.io/prompt_engineering_guide) | 深入提示词工程的通用原理与最佳实践 |
| [《大模型上下文工程权威指南》](https://yeasy.gitbook.io/context_engineering_guide) | 系统掌握上下文工程，从提示词到生产级 AI 系统 |
| [《智能体 AI 权威指南》](https://yeasy.gitbook.io/agentic_ai_guide) | 全面掌握智能体架构、多智能体协作与 AgentOps |
| [《大模型安全权威指南》](https://yeasy.gitbook.io/ai_security_guide) | LLM 安全攻防与治理 |
| [《OpenClaw 从入门到精通》](https://yeasy.gitbook.io/openclaw_guide) | 开源自驱型智能体框架的使用与原理 |
| [《大模型原理与架构》](https://yeasy.gitbook.io/llm_internals) | 深入理解大语言模型底层逻辑与架构 |
| [《智能体 Harness 工程指南》](https://yeasy.gitbook.io/harness_engineering_guide) | 深入 Claude Code 等智能体系统的 Harness 工程基础设施 |
***
### 贡献与反馈
欢迎提交 [Issue](https://github.com/yeasy/claude_guide/issues) 或 [PR](https://github.com/yeasy/claude_guide/pulls)，尤其欢迎：错别字修正、失效链接修复、实践案例补充。
### 许可证
本书采用 [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/) 授权。