跳转到主要内容

说明

Claude 系列模型支持通过官方原生接口调用,使用之前确保安装或升级 anthropic 依赖:

模型信息

Claude Opus 4.7 新功能

  1. Claude Opus 4.7 官方增加了更高的推理参数
    xhigh 强度级别是介于highmax 之间的全新 effort 级别,适合编程和 agentic 任务。
  2. Claude Opus 4.7 思考内容官方改为了默认隐藏
    流式输出中思考过程默认不展示。如需查看思考摘要,需接口中额外传参display:

Claude Opus 4.7格式接口说明

Anthropic 原生接口effort值与官方保持一致,参考如下: AIHubmix Claude 原生接口 Claude Opus 4.7 调用示例 (返回思考摘要)

Claude 4.6 新功能

自适应思考(Adaptive Thinking)

Claude 4.6 推荐使用新的自适应思考模式,该模式下,Claude 会根据问题复杂度自动决定是否进行思考及深度思考:
thinking: {type: "enabled", budget_tokens: N} 在 4.6 上已弃用,未来版本将移除。

自动上下文压缩(Compaction,Beta)

当对话接近上下文窗口上限时,Claude 4.6 可自动对早期内容进行服务器端摘要压缩。 优势:
  • 支持超长对话
  • 无需客户端自行摘要
  • 提高 Agent 连续会话能力
注意:
  • 自动压缩可能丢失部分细节
  • 对强一致性场景建议评估测试

弃用与变更

  • **移除 **interleaved-thinking-2025-05-14Beta 头: 在 4.6 中,自适应思考已自动支持交错思考,不需要再添加 extra_headers 。如仍添加,该头会被安全忽略。

Claude 4 新功能

新的拒绝停止原因 (Refusal Stop Reason)

Claude 4 模型引入了新的 refusal 停止原因,用于处理模型因安全原因拒绝生成的内容:
在迁移到 Claude 4 时,您应该更新应用程序以处理 refusal 停止原因。

扩展思考 (Extended Thinking)

启用扩展思考后,Claude 4 模型的 Messages API 会返回 Claude 完整思考过程的摘要。摘要思考提供了扩展思考的全部智能优势,同时防止滥用。 虽然 API 在 Claude 3.7 和 4 模型之间保持一致,但扩展思考的流式响应可能以”块状”传递模式返回,流式事件之间可能存在延迟。 摘要由与您在请求中指定的模型不同的模型处理。思考模型不会看到摘要输出。

交错思考 (Interleaved Thinking)

Claude 4 模型支持将工具使用与扩展思考交错,允许更自然的对话,其中工具使用和响应可以与常规消息混合。 交错思考目前处于测试阶段。要启用交错思考,请在 API 请求中添加测试头 interleaved-thinking-2025-05-14
端点(Endpoint): POST /v1/messages

调用

Body 请求结构

请求参数

返回示例

返回结果

迁移到 Claude 4

如果您正在从 Claude 3.7 迁移到 Claude 4 模型,请注意以下变化:

更新模型名称

处理新的停止原因

更新您的应用程序以处理新的 refusal 停止原因:

移除不支持的功能

  • Token 高效工具使用:仅在 Claude Sonnet 3.7 中可用,Claude 4 中不再支持
  • 扩展输出output-128k-2025-02-19 测试头仅在 Claude Sonnet 3.7 中可用
如果您正在从 Claude Sonnet 3.7 迁移,建议从请求中移除这些测试头:

在应用中使用(以 Lobe-Chat 为例)

  • 进入设置页面选择模型服务商 Claude
  • API key 输入本站的 Key
  • 接口代理地址,直接输入下方的网址:
  • 建议打开「使用客户端请求模式」
  • 最后在模型列表添加自己要使用的模型(建议从我们网站的设置页面复制粘贴模型名后选择)\ 图片 图片

Claude 文本编辑工具

Claude 可以使用 Anthropic 定义的文本编辑工具来查看和修改文本文件,帮助你调试、修复和改进代码或其他文本文档。这使得 Claude 能够直接与你的文件进行交互,提供实际的操作帮助,而不仅仅是提出建议。

使用文本编辑工具前的准备

选择兼容的模型 Anthropic 的文本编辑工具支持以下 Claude 模型:
  • Claude 4 系列模型 (claude-opus-4-20250514, claude-sonnet-4-20250514): text_editor_20250429
  • Claude 3.7 Sonnet (claude-3-7-sonnet-20250219): text_editor_20250124
  • Claude 3.5 Sonnet (claude-3-5-sonnet-20241022): text_editor_20241022
Claude 4 模型使用了全新的文本编辑工具,与旧版本不兼容。请确保使用正确的工具类型和名称。

模型对应的工具配置

重要变化: Claude 4 模型不再支持 undo_edit 命令,请在代码中移除对此功能的依赖。

评估使用场景

以下是使用文本编辑工具的一些典型场景:
  • 代码调试:帮助识别和修复代码中的问题,从语法错误到逻辑问题。
  • 代码重构:通过有针对性的编辑来改进代码结构、可读性和性能。
  • 文档生成:为你的代码库添加文档字符串、注释或 README 文件。
  • 测试创建:根据对实现的理解创建单元测试。

使用文本编辑工具

通过 Messages API 向 Claude 提供文本编辑工具(命名为 str_replace_editor): 需要安装 anthropic 包:
调用示例:

迁移到 Claude 4(文本编辑工具)

如果您正在从 Claude 3.7 Sonnet 迁移到 Claude 4 模型,请注意以下变化:

更新工具配置

python

移除不支持的功能

  • undo_edit 命令:Claude 4 模型不再支持撤销编辑功能
  • 请从您的代码中移除任何依赖 undo_edit 的逻辑
返回示例:

更新时间:2026-06-01