SuperAPI AI 工具集

clade-sdk-patterns

编程与开发

查看项目

更新于 10-16 06:20

技能介绍

用途:为使用 @claude-ai/sdk(TypeScript)与 anthropic(Python)SDK 的开发者提供生产级代码模式参考,帮助正确配置客户端并处理常见工程问题。

主要能力:客户端配置(apiKey、maxRetries、timeout、baseURL、defaultHeaders);类型化错误处理(AuthenticationError、RateLimitError、APIError、APIConnectionError 等);流式输出(TypeScript 事件回调与异步迭代器、Python 上下文管理器);TypeScript 类型定义(Message、MessageParam、ContentBlock、Tool 等);提示缓存(cache_control: ephemeral,需 1024+ tokens 且带 beta 头);消息批量(最多 10000 条,轮询 processing_status)。

使用方式:TypeScript 中 import Anthropic from '@claude-ai/sdk',默认读取 ANTHROPIC_API_KEY 环境变量;Python 中 import anthropic,使用 Anthropic() 或 AsyncAnthropic()。流式可用 client.messages.stream 或 stream: true。批量用 client.messages.batches.create 并轮询 retrieve。

适用场景:需要稳定调用 Anthropic API 的后端服务、需要流式响应的交互应用、需要降低成本的高频或批量任务。

限制:资料未提供具体价格、平台支持范围与完整安装步骤;提示缓存与批量功能标注为 beta,需按资料中的 beta 头使用;前置条件为已完成 clade-install-auth 并熟悉 TypeScript 泛型或 Python 类型提示及 async/await。