Anthropic SDK 入门:Messages API 第一步
把 Claude 接进自己的程序,最直接的入口是 Anthropic 官方 SDK 和它背后的 Messages API。它不依赖任何框架,十几行 Python 就能完成第一次模型调用;后面的工具调用、思考模式、提示缓存…
AI 开发 · 共 12 篇 · 按发布时间正序排列
Anthropic Python SDK 从入门到实战:Messages API 与工具链 12 篇
把 Claude 接进自己的程序,最直接的入口是 Anthropic 官方 SDK 和它背后的 Messages API。它不依赖任何框架,十几行 Python 就能完成第一次模型调用;后面的工具调用、思考模式、提示缓存…
第 1 篇/post/1688的第一次调用已经跑通:create 发出请求,等模型把整段回复生成完,一次性拿回完整消息。这个过程里屏幕是静止的——回复越长,静止越久,几百 token 的答案要干等十几秒才整块出现。流式输…
前两篇拿回的都是自然语言:第 1 篇/post/1688的第一次调用返回一段解释,第 2 篇/post/1695让这段话逐字上屏。可真实工程里,模型的输出多数时候不是给人读的,而是给程序用的——分类结果要落进布尔分支,抽…
第 3 篇/post/1696把工具的"定义"讲完了:tools 参数声明工具名、描述与参数模式,tool_choice 控制模型用不用它。但那一步结束时,模型只是"开口要了工具"——真正把工具跑起来、把结果送回去、让对…
第 4 篇/post/1691把工具调用滚成了循环,而循环能一直转的前提,是每一轮请求都带着完整的对话历史——Messages API 无状态,服务端不保存任何一次调用的现场,模型“记得你说过什么”,完全是因为你的代码把…
第 5 篇/post/1689结尾预告的主题到了:让模型先想再答。前五篇的所有调用都没有传过任何与思考有关的参数——这不是遗漏,而是从当前这代模型起,思考默认就是开着的;教学模型 claudesonnet55 上真正要回…
第 5 篇/post/1689算过一笔账:每轮新增 1000 token 的轻量对话,用 claudesonnet55 跑 100 轮,光输入就累计 10.10 美元——Messages API 无状态,历史每轮全量重发…
第 7 篇/post/1693用提示缓存把重复前缀的输入打到一折,但每一分新内容仍按全价计费,而且每个请求都得当场等回复。工程里还有一类任务根本没人等:夜里跑几万条文档摘要、给全站历史评论打情感标签、把一批评测集整体重跑…
前八篇把能力讲完了:调用、流式、结构化、工具、多轮、思考、缓存、批处理,主线始终是同一个 create。但有一件事被一路押后——钱。第 1 篇/post/1688只给了四档模型的输入价,还留了一句"计费按输入输出分别结算…
第 4 篇/post/1691把工具调用循环拆到了最细:手写 schema、手写分发、手写回传,一个 get_weather 从定义到执行全在你的仓库里。这套打法对项目专属工具毫无问题,但工具世界的大头本来就不在你的仓库…
调用跑通只是起点。生产环境的每一次请求都走在"会失败"的边缘:参数拼错是 400,发得太快是 429,赶上高峰是 529,网络抖一下连响应都拿不到。本系列前面各篇零散地处置过它们——第 1 篇/post/1688的报错速…
第 11 篇/post/1697结尾预告的收官项目来了:一个本地文档问答助手。把一个文件夹的 md 与 txt 文档喂给它,启动时切块编号建库;你用中文提问,它先调检索工具找相关片段,再作答并标注出处;多轮追问不必重复检…