让编程任务形成完整步骤
Sonnet 5 的重点不只是补全代码，而是围绕目标规划连续工作。相较 Sonnet 4.6，它在编程、推理和工具使用上有所提升。可让它先拆解修改范围，再生成实现建议与测试计划；接入执行工具后，再根据运行反馈继续调整。
规格与接口特性
在选型前明确容量、输入输出与调用方式。
- 模型调用ID
- claude-sonnet-5
- 输入方式
- 文本、图片；对话入口可提交文件内容块
- 输出与交互
- 文本回答、函数工具调用交互
- 核心能力
- 推理、视觉理解、多步任务规划
- 调用入口
- /v1/chat/completions、/aichat2/conversations
- 会话与流式
- 托管会话ID续聊；对话入口支持SSE与NDJSON
推理与视觉理解属于模型能力，文件读取、会话管理和工具执行由所选入口及授权配置提供。
核心能力
了解 claude-sonnet-5 能为你的工作带来什么。
把工具反馈纳入下一步判断
面对需要查询、读取和验证的任务，它适合承担智能体中的决策环节。应用可提供函数工具，让模型结合返回结果推进工作；托管对话也可结合已授权的工具开展多轮协作。执行权限和可操作对象仍由应用设置，而非模型自行获得。
结合图文解释技术问题
文本与图片可以共同构成问题背景，例如将报错截图、界面状态与需求说明放在同一轮输入中。Sonnet 5 可据此给出解释和排查建议，适合将视觉信息转化为可讨论的文字结论，而不是把图像理解误当作图像生成能力。
适用场景
从具体任务出发，找到模型发挥作用的位置。
代码维护与缺陷排查
输入相关代码、错误日志和预期行为，要求模型输出问题假设、修改方案及回归测试建议。已有测试工具时，可把结果回传继续定位。交付物宜明确为补丁建议、测试用例和待核实事项，便于工程师审查后再合并。
带材料的技术研究
把技术文档、截图和需要比较的问题交给模型，整理方案差异、实施依赖与风险。需要读取文件时可使用对话入口的文件内容块与读取工具。最终要求按结论、依据和开放问题组织报告，方便团队继续决策。
持续跟进的工作助手
适合围绕同一项目连续整理需求、修订计划和追踪问题。使用托管会话ID承接后续讨论，必要时连接已授权的知识库或代码协作工具。将每轮目标限定为明确的分析或交付物，可减少任务范围不断扩张。
如何选择这个模型
结合任务复杂度、输入材料与预期结果选择。
从 Sonnet 4.6 迁移时关注任务完成度
如果现有任务常在规划、工具反馈或代码修改之间中断，Sonnet 5 值得优先测试。它的改进集中于推理、编程、工具使用和知识工作。迁移时应复用真实样例，比较正确率与后续修正量，同时重新计算Token用量，不要照搬旧版预算。
与 Opus 4.8 按难度分工
Sonnet 5 适合需要能力与投入平衡的日常工程和多步分析；官方评估中，较高推理投入可在部分任务上匹配 Opus 4.8，但不意味着全面等同。对极难判断、复杂审查或关键交付，应进行并行验证，再决定是否采用更高能力型号。
开始使用
从一次小规模任务到正式接入。
准备任务与材料
明确目标、必要输入与输出要求，使用真实业务样例作为起点。
在 API 调试区试用
打开试用页，确认此入口支持的参数，再提交小规模任务查看结果。
按 API 文档接入
保留完整模型 ID，使用文档规定的请求格式，并在 Pricing 页确认计费规则。
使用边界
在正式使用前，了解输出质量与能力范围。
- 工具使用能力不等于自动拥有浏览器、终端或系统权限。普通消息请求不会自行执行代码或点击界面；需要由应用提供执行工具，或在托管对话中连接可用工具，并明确允许执行的操作。
- Sonnet 5 使用更新的分词器，相同输入的Token数量约为旧版的1.0—1.35倍，取决于内容类型。迁移长提示词与代码任务时应重新统计用量，调整输入组织和输出预算，避免沿用旧估算。
- 官方评估显示它较 Sonnet 4.6 的幻觉与迎合有所减少，但仍可能给出错误判断。代码修改应通过测试，文档结论应核对原始材料；它也不是专门训练的网络安全模型，不宜把一般编程能力视为专业安全评估保证。
常见问题
解答使用 claude-sonnet-5 时的常见疑问。
Sonnet 5 比 Sonnet 4.6 更适合什么任务？
主要是需要连续推理和工具反馈的编程、调查与知识工作，例如拆解修改计划、结合测试结果修正方案。已有稳定的 Sonnet 4.6 工作流可先用同一批样例比较，不必仅因版本变化就立即迁移。
它能直接修复并运行我的项目吗？
它可以分析代码、提出修改并参与工具协作，但运行项目需要可用的执行环境与权限。只发送文本时得到的是代码或建议；接入工具后，才可依据执行反馈迭代，最终仍应保留测试与合并审查。
怎样同时提交截图和问题？
在 Chat Completions 的消息内容中组合 text 与 image_url 块，写清截图对应的现象和希望回答的问题。托管对话也可用 message 数组组织图文。图片用于理解与分析，回答以文字形式呈现。
读取PDF应该选哪个入口？
可使用 /aichat2/conversations 的 file_url 内容块，结合文件读取工作流进行摘要或分析。文件读取是入口提供的处理方式；不要把PDF地址当成图片地址提交给 Chat Completions，重要结论应核对原文。
多轮项目讨论需要重复发送历史吗？
托管对话可通过 stateful 保存会话，并在后续请求带回同一个 id 继续讨论。自行编排 Chat Completions 时，则由应用维护所需消息及工具结果。前者适合持续协作，后者便于控制上下文组织。
模型资料 · 更新日期：2026-10-01。调用参数与计费规则请查看 API 和定价栏目。