用途:该技能用于通过 Anthropic Messages API(Claude API)构建集成,适合聊天机器人、助手等应用,并覆盖流式输出、提示缓存、工具调用(函数调用)、视觉理解与扩展思考等能力。SDK 为 @anthropic-ai/sdk@0.70.1,状态标注为 Production Ready。
主要能力:支持 messages.create 创建消息;stream 流式响应;system 块配合 cache_control 实现提示缓存(资料称可节省约 90% 成本,缓存持续 5 分钟);tools 定义与 tool_use/tool_result 工具调用循环;image 内容块支持 JPEG、PNG、WebP、GIF(最大 5MB);thinking 启用扩展思考并设置 budget_tokens。
使用方式:Node.js 可用 bun add @anthropic-ai/sdk 安装,通过环境变量 ANTHROPIC_API_KEY 初始化客户端;Cloudflare Workers 使用 fetch 调用 https://api.anthropic.com/v1/messages,请求头包含 x-api-key、anthropic-version: 2023-06-01、content-type: application/json;Next.js 同样使用该 SDK。必须显式设置 max_tokens,并固定模型版本(如 claude-sonnet-4-5-20250929),不要使用 -latest 后缀。
适用场景:聊天机器人、助手、图像理解(OCR、分析、描述)、需要工具调用的多轮交互、长系统提示或文档的缓存优化、高并发下的限流规划。
限制与注意事项:API 密钥不得硬编码或暴露在客户端;需处理 429、529 等错误并实现指数退避;提示缓存的 cache_control 需放在最后一个且内容不少于 1024 token 的块上;工具 schema 必须为合法 JSON Schema,tool_result 的 tool_use_id 需与 tool_use 匹配;content 为数组,需检查 stop_reason。资料未提供具体价格、各平台完整部署步骤及所有错误细节,相关参考文件包括 setup-guide.md、prompt-caching-guide.md、tool-use-patterns.md、vision-capabilities.md、top-errors.md、rate-limits.md 及 templates 目录下的示例。