Skip to main content
agentscope-extensions-model-anthropic 接入 Anthropic Claude Model,并提供 Anthropic 专属 formatter 和请求 DTO 支持。

添加依赖

ModelRegistry

设置 ANTHROPIC_API_KEY 后,使用 anthropic:<model> 字符串 id:

显式 builder

需要自定义 endpoint、formatter、transport、prompt caching、thinking 或生成参数时,使用 builder:

Bearer Token 鉴权

对于需要 Authorization: Bearer <token> 的 Anthropic 兼容网关,通过模型 builder 设置 authToken:
传入的 Token 不需要包含 Bearer 前缀,SDK 会自动添加。apiKey 设置 X-Api-Key, authToken 设置 Authorization;两者只能配置一个,同时配置会在创建模型时抛出 IllegalArgumentException。 这些鉴权请求头由 SDK 管理,请通过 builder 配置,不要通过 GenerateOptions.additionalHeaders 添加。

Spring Boot

Spring Boot 应用可以使用 Anthropic starter:
通过 Bearer Token 接入网关的配置示例:
agentscope.anthropic.auth-token 为可选配置,未设置或为空白时不启用 Bearer 鉴权。 原有的 agentscope.anthropic.api-key 配置仍然可用,但同时配置两个非空白凭据会导致启动失败。 Builder customizer 在校验前执行,可以通过 apiKey(null) 或 authToken(null) 清除其中一种凭据。 完整 builder 选项、formatter、credential 和 registry context 细节见 模型。