Claude API 与 Agent 工程实战 · 中文技术教程

Claude API 与 Agent 工程实战 · 中文技术教程

从系统提示词到多代理编排:读懂 Claude 的工程内核

这本教程讲什么

素材库逐字捕获了 ChatGPT、Claude、Gemini、Grok 等产品在用户首次发消息前注入的「隐藏系统指令」。但其中约 80% 是原始泄露数据(身份声明+安全规则)。所以本教程聚焦其中最有工程教学价值的部分——Anthropic 官方随 Claude Code 分发的 Claude API SDK 多语言文档(prompt-caching、tool-use、streaming、managed-agents、agent-design 等核心概念)+ 工程技能(code-review、dataviz)+ 多代理架构(11 个子代理)+ 设计技能,把它们讲成一门能落地「用 Claude 做 Agent 应用」的实战课。

七章学习路径一览

本教程按「懂提示词 → 用 API → 多语言 → 设计 Agent → 工程技能 → 多代理 → 横向对比」的递进组织:

第 1 章 认识系统提示词与 Claude API ── 隐藏指令是什么、API 全景
第 2 章 Claude API 核心能力 ── 工具调用/流式/缓存/计数/模型/错误(核心)
第 3 章 多语言 SDK 实战 ── Python/TS 详解 + 其余语言对照
第 4 章 Agent 设计与托管代理 ── agent-design + managed-agents
        │
第 5 章 Claude Code 工程技能 ── 代码审查/数据可视化/技能生成
第 6 章 多代理架构与设计技能 ── 11 子代理 + 22 设计技能
        │
第 7 章 系统提示词横向对比(附录) ── 各厂商安全哲学与人设差异
​

第 14 章是「Claude API 与 Agent 工程主干」,第 56 章是「工程技能与多代理」,第 7 章是「横向对比附录」。

章节目录

第 1 章 认识系统提示词与 Claude API
系统提示词是什么(为什么模型「知道自己是谁」)、Claude API 全景、各语言 SDK 总览。读完你理解「隐藏指令」的工程意义,并知道 Claude API 能做什么。

第 2 章 Claude API 核心能力(全书核心)
工具调用(tool use)、流式响应(streaming)、提示缓存(prompt caching)、Token 计数、模型选择与迁移、错误码、批处理(batches)、文件 API。每个概念独立成节,讲透原理与用法。

第 3 章 多语言 SDK 实战
Python 与 TypeScript 两大主力 SDK 详解,Go/Java/PHP/Ruby/C#/curl 合并对照。读完你能用任一语言接入 Claude API。

第 4 章 Agent 设计与托管代理
agent-design 设计原则、managed-agents(平台托管的有状态 agent)、live-sources。读完你能设计并部署一个 Claude agent。

第 5 章 Claude Code 工程技能
代码审查分级方法论、数据可视化(图表选型/配色/反模式)、技能生成器(run-skill-generator)、Claude Code 文档技能、深度研究。读完你能复用官方工作流方法论。

第 6 章 多代理架构与设计技能
Claude Code 的 11 个子代理(Explore/Plan/worker/observer/general-purpose 等)如何协作;Claude Design 的 22 个设计技能(前端/3D/动画/PPT/HTML 邮件/设计系统)。读完你理解多代理编排,并掌握设计工作流。

第 7 章 系统提示词横向对比(附录)
精选各厂商系统提示词做对比:Anthropic vs OpenAI vs Google vs xAI 的安全哲学、人设演进、工具定义差异。不做全量逐篇,只选代表性样本分析。

适合读者

本教程适合想用 Claude API 做 Agent 应用的开发者:

• 想接入 Claude API、做 LLM 应用的后端/全栈工程师
• 想设计多代理系统的 AI 应用工程师
• 对「系统提示词里到底写了什么」好奇、想读懂各厂商工程哲学的人
• 用 Claude Code / Cursor 等、想理解其内置技能与子代理机制的开发者

前置知识:

• 一门编程语言基础(Python 或 TypeScript 最佳)
• HTTP/JSON/API 调用的基本概念
• LLM 的基本认知(不必熟练,第 1~2 章会重建)

关于原文版本与汉化进度

本教程的素材来自「system_prompts_leaks」档案库。原始泄露提示词仅作附录对比。