yeasy/claude_guide

Claude 技术指南

从零开始，系统掌握 Anthropic Claude 的核心能力与最佳实践

关于本书

Claude 是目前业界最先进的生产环境大语言模型之一。本书是面向开发者、产品负责人、自动化工程师和企业架构师的 Claude 生态落地手册，重点回答：什么时候选择 Claude，如何选择 Claude 的产品面，以及如何把 API、Claude Code、Agent SDK、MCP、Skills、Computer Use 和安全治理组合成可上线方案。

注：本书不会替代通用提示词工程、上下文工程、智能体理论或 Harness 工程专著；这些主题会在需要时交叉引用。本书聚焦 Claude 特有能力、接口边界、产品组合、迁移策略和上线判断。模型 ID、价格、上下文窗口和功能可用性变化很快，生产选型请以官方模型页、价格页和相关产品文档为准。

全书将系统性地介绍 Claude 的核心能力体系，包括：

• 提示工程（Prompt Engineering）：与 Claude 高效沟通的艺术
• 工具使用（Tool Use）：让 Claude 调用外部 API 和服务
• 模型上下文协议（MCP）：连接 Claude 与外部世界的标准接口
• 计算机操控（Computer Use）：Claude 自主操作桌面环境
• Skills 系统：可复用的定制化工作流
• 代码执行与 Agentic Coding：Claude 作为自主编程助手

本书围绕新一代 Claude Fable 5 与 Opus、Sonnet、Haiku 各系列的核心能力展开。模型 ID、价格、上下文窗口和弃用状态变化很快，生产选型请以官方模型页和价格页为准。

可执行黄金路径

仓库提供三条可离线测试、真实运行时再读取凭据的最小路径：

• Messages API 最小调用
• 完整客户端工具循环
• Agent SDK 成功/失败事件处理

依赖版本锁定在 examples/requirements.txt。测试不读取 API key、不访问网络：

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 凭据机制。不要把凭据写入仓库。

目标读者

前置知识要求：基础计算机操作经验；对大语言模型有初步了解（非必需）；能够访问 Claude（claude.ai 或 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、术语与资源
└── 定价、竞品对比与快变事实核验

点击从第一章开始阅读

阅读方式

在线阅读：GitBook 在线版

下载离线版本

本书提供 PDF 版本供离线阅读，可前往 GitHub Releases 页面下载最新版本。

如需获取默认分支自动更新的预览版，可直接下载 claude_guide.pdf。该文件会随主线更新覆盖，不代表正式发布版本。

本地阅读（先安装 mdPress）：

brew tap yeasy/tap && brew install mdpress
mdpress serve

启动本地服务器后，访问 本地阅读地址

五分钟体验路径

5 分钟内先建立正确直觉，不把体验路径误当完整学习路径：

1. 开始 Claude 对话（ch1）：访问 claude.ai 或 API，与 Claude 进行第一轮对话，体验其推理与表达能力（2 分钟）
2. 做一个 Claude 风格提示小练习（ch2.1-2.2）：用清晰任务、上下文和 XML 标签约束输出，理解 Claude 与通用聊天机器人的差异（2 分钟）
3. 理解工具调用入口（ch3.1）：先看 Claude 如何从回答走向行动，再按需要进入 MCP、Skills 或 Claude Code 分支（1 分钟）

完成这 3 步后，你会知道后续该按哪条路线深入；真正的生产级落地还需要继续学习工具、评估、成本、安全和部署章节。

学习路线图

graph LR
    A["<b>Claude 入门区</b><br/>第1-3章<br/>对话与核心能力"] -->|日常使用| B["<b>普通用户</b><br/>第1-3章<br/>高效对话与工具使用"]
    A -->|全栈开发| C["<b>开发者</b><br/>第1,3-7章<br/>API、工具、Agentic Coding"]
    A -->|企业架构| D["<b>企业架构师</b><br/>第1,8-11,13章与附录<br/>系统设计与优化"]
    A -->|优化提示| E["<b>提示词工程师</b><br/>第1-2,4-6章<br/>提示词技巧与优化"]
    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

学习角色对比

推荐阅读

本书是 AI 技术丛书的一部分。以下书籍与本书形成互补：

贡献与反馈

欢迎提交 Issue 或 PR，尤其欢迎：错别字修正、失效链接修复、实践案例补充。

许可证

本书采用 CC BY-NC-SA 4.0 授权。