我想成为一名 Claude 架构师 (完整课程)

要成为一名 Claude 架构师并开发生产级应用，你需要理解 Claude Code、Claude Agent SDK、Claude API 和 Model Context Protocols。本文将帮助你学习所有内容，并基于以下考试：

然而，正如你清楚看到的，要获得这份“认证”，你需要成为 Claude 合作伙伴；否则，你无法参加此考试。

如果你有能力学习如何成为一名“Claude 认证架构师”，那么你就能构建生产级应用。你不需要证书也能构建生产级应用。你只需要知识。

所以我彻底拆解了整个考试指南，并从中提取了真正重要的内容，以便你成为一名 Claude 架构师。

该考试虽然只对 Claude 合作伙伴开放，但提供了一份宝贵的学习路线图。通过理解其涵盖的主题——Claude Code、Claude Agent SDK、Claude API 和 Model Context Protocol (MCP)——你可以掌握成为 Claude 架构师和构建生产级应用所需的技能。这些都是可变现的技能。

该考试意味着你需要学习以下内容：

• 客户支持解决代理 (Agent SDK + MCP + 升级)
• 使用 Claude Code 进行代码生成 (CLAUDE.md + 计划模式 + 斜杠命令)
• 多代理研究系统 (协调器-子代理编排)
• 开发者生产力工具 (内置工具 + MCP 服务器)
• 用于 CI/CD 的 Claude Code (非交互式管道 + 结构化输出)
• 结构化数据提取 (JSON 模式 + tool_use + 验证循环)

领域 1：代理架构与编排 (27%)

该考试测试了三个你需要立即拒绝的反模式：解析自然语言来确定循环终止，将任意迭代上限作为主要的停止机制，以及将助手文本作为完成指示器。这些都是错误的。

最大的错误是：人们认为子代理与协调器共享内存。它们不共享。子代理在独立上下文中操作。每条信息都必须在 prompt 中明确传递。

能为你节省最多分数的一条规则：当涉及财务或安全关键时，仅靠 prompt 指令是不够的。你必须通过Hook和前置门以编程方式强制执行工具排序。

在哪里学习：

• Agent SDK 概述 用于代理循环机制和子代理模式
• 使用 Claude Agent SDK 构建代理 用于 Anthropic 自己的Hook、编排和会话最佳实践
• Agent SDK Python 仓库 + 示例 用于动手实践代码：Hook、自定义工具、fork_session

如果你不知道如何开始，请前往 Claude 并粘贴此 prompt，它将帮助你学习领域 1：

要构建什么来学习：一个带有 3-4 个 MCP 工具、正确处理 stop_reason、一个用于规范数据格式的 PostToolUse Hook，以及一个用于阻止策略违规的工具调用拦截Hook的多工具代理。这一个练习涵盖了领域 1 的大部分内容。

领域 2：工具设计与 MCP 集成 (18%)

工具描述被极度忽视，考试希望对此进行测试。

工具描述是 Claude 用于工具选择的主要机制。如果你的描述模糊或重叠，选择就会变得不可靠。

一个示例问题提供了 get_customer 和 lookup_order，它们的描述几乎相同，导致持续的错误路由。正确的解决方法不是少样本示例，不是路由分类器，也不是工具整合。解决方法是更好的描述。

熟练掌握 tool_choice 选项：“auto”（模型可能返回文本），“any”（必须调用一个工具，选择哪个），强制选择（必须调用一个特定工具）。了解每个选项何时适用。

给一个代理 18 个工具会降低选择可靠性。将每个子代理的范围限制在其角色相关的 4-5 个工具内。

在哪里学习：

• Claude Code 的 MCP 集成 用于服务器范围、环境变量扩展、项目 vs 用户配置
• MCP 规范和社区服务器 用于理解协议并了解何时使用社区服务器 vs 自定义构建
• Claude Agent SDK TypeScript 仓库 用于工具定义模式和结构化错误响应

如果你不知道如何开始，请前往 Claude 并粘贴此 prompt，它将帮助你学习领域 2：

要构建什么：两个功能有意相似的 MCP 工具。编写足够模糊的描述以导致错误路由。然后修复它们。体验其中的区别。

领域 3：Claude Code 配置与工作流 (20%)

这区分了使用 Claude Code 的人与为团队配置 Claude Code 的人。

CLAUDE.md 层次结构至关重要。三个级别：用户级别 (~/.claude/CLAUDE.md)、项目级别 (.claude/CLAUDE.md)、目录级别 (子目录文件)。考试最喜欢的陷阱：团队成员错过指令，因为它们存在于用户级配置中（不受版本控制，不共享）。

路径特定规则是潜藏概念。.claude/rules/ 带有 YAML frontmatter glob 模式，例如 **/*.test.tsx，可以将约定应用于整个代码库。目录级别的 CLAUDE.md 无法做到这一点，因为它受目录绑定。

计划模式 vs 直接执行：

• 计划模式：单体重构、多文件迁移、架构决策
• 直接执行：单文件 bug 修复、一次验证检查、清晰范围

了解上下文：skill frontmatter 中的 context: fork（隔离详细输出）。了解 -p 标志（非交互式 CI/CD）。了解独立的审查实例比同一会话中的自我审查发现更多问题。

在哪里学习：

• Claude Code 官方文档 用于 CLAUDE.md 层次结构、规则目录、斜杠命令、skills frontmatter
• Claude Code CLI 速查表 用于一个实用参考中的命令、技能、Hook和 CI/CD 标志
• 创建完美的 CLAUDE.md 用于真实的团队配置模式和 MCP 集成

如果你不知道如何开始，请前往 Claude 并粘贴此 prompt，它将帮助你学习领域 3：

要构建什么：一个带有 CLAUDE.md 层次结构、带有 glob 模式的 .claude/rules/、一个使用 context: fork 的技能，以及一个在 .mcp.json 中带有环境变量扩展的 MCP 服务器。在一个多文件重构上测试计划模式，在一个单一 bug 修复上测试直接执行。

领域 4：Prompt 工程与结构化输出 (20%)

这两个词将帮助你贯穿整个领域：明确。

“保守”并不能提高精确度。“只报告高置信度发现”并不能减少误报。有效的方法是：精确定义哪些问题要报告，哪些要跳过，并为每个严重级别提供具体的代码示例。

少样本示例是测试的最高杠杆技术。2-4 个有针对性的示例，展示如何处理模糊情况，并解释为什么选择某个行动而不是替代方案。

带有 JSON 模式的 tool_use 可以消除语法错误。但不能消除语义错误。模式设计：当源数据可能缺失时使用可空字段（防止捏造值），“不明确”的枚举值，“其他”+详细字符串。

消息批处理 API：节省 50%，最长 24 小时处理，无延迟 SLA，无多轮工具调用。用于夜间报告的批处理。用于阻塞式合并前检查的同步处理。

在哪里学习：

• Anthropic Prompt 工程文档 用于少样本模式、明确标准和结构化输出
• Anthropic API 工具使用文档 用于 tool_use、tool_choice 配置、JSON 模式强制执行
• 考试指南自身的示例问题（Q10、Q11、Q12）是该领域的最佳学习材料。仔细研究每个干扰项，并理解它为何错误。

如果你不知道如何开始，请前往 Claude 并粘贴此 prompt，它将帮助你学习领域 4：

要构建什么：一个使用带有必填、可选和可空字段的 tool_use 的提取管道。添加一个验证-重试循环。通过 Batches API 运行一个批处理。按 custom_id 处理失败。

领域 5：上下文管理与可靠性 (15%)

权重最小。但这里的错误会波及全局。

渐进式摘要会破坏事务性数据。解决方法：持久的“案例事实”块，包含提取的金额、日期、订单号。从不摘要。包含在每个 prompt 中。

“中间遗失”效应：模型会遗漏埋藏在长输入中的发现。将关键摘要放在开头。

三个有效的升级触发器：客户请求人工服务（立即响应），策略空白，无法进展。考试会用两个不可靠的触发器诱惑你：情感分析和自我报告的置信度分数。

正确的错误传播：结构化上下文（失败类型、尝试的查询、部分结果、替代方案）。反模式：静默抑制错误或因单一失败而终止整个工作流。

在哪里学习：

• 使用 Claude Agent SDK 构建代理 涵盖上下文管理、错误传播和升级设计
• Agent SDK 会话文档 用于恢复、fork_session、/compact
• Everything Claude Code 仓库 用于经过实战检验的上下文管理模式、暂存文件和战略性压缩

如果你不知道如何开始，请前往 Claude 并粘贴此 prompt，它将帮助你学习领域 5：

要构建什么：一个带有两个子代理的协调器。模拟超时。验证协调器是否获得结构化错误上下文并继续处理部分结果。用冲突的源进行测试。

ANTHROPIC 推荐学习：

1. 使用 Claude API 进行构建
2. Model Context Protocol 介绍
3. Claude Code 实战
4. Claude 101

• 原文链接： x.com/hooeem/status/2033...
• 登链社区 AI 助手，为大家转译优秀英文文章，如有翻译不通的地方，还请包涵～