我将按照问题清单逐一将所有代码块中的claude-sonnet-5.5和anthropic/claude-sonnet-5.5替换为正确的 model ID同时保持正文叙述文字标题、表格、说明段落中的claude-sonnet-5.5字样一字不动只改代码块内的 model 字段值。标题claude-sonnet-5.5 API 接入教程从 Bedrock model_id 路由问题到 Claude Code / Cline 配置全记录正文上周三我把项目里的 claude-sonnet-5 升级到 claude-sonnet-5.5结果流式输出在 4096 token 处断掉没报错、没异常就是静默截断。排查了很久才发现可能与 Bedrock 端点的 model_id 路由规则有关——claude-sonnet-5.5 的 Bedrock model_id 和 claude-sonnet-5 有一处关键差异填旧值不会报 404但根据经验性观察可能命中旧版推理路径导致 max_tokens 上限受限。这篇把我踩过的坑、验证过的配置方案全部整理出来覆盖官方 SDK、OpenAI 兼容协议、聚合网关、Claude Code 和 Cline 五条接入路径。这篇适合谁正在用 claude-sonnet-5想升级到 claude-sonnet-5.5 但不确定要改哪些参数的后端开发通过 AWS Bedrock 调用 Claude遇到流式输出静默截断但没有报错信息的同学想在 Claude Code 或 Cline 里接入 claude-sonnet-5.5 的独立开发者刚拿到 Anthropic API Key想快速跑通第一个请求的新手整体流程确认 model_id——这一步错了后面全白搭拿到 API Key 并配好环境变量选接入路径官方 SDK / OpenAI 兼容 / 聚合网关 / 工具配置跑通第一个请求验证流式输出完整性排查常见报错graph TD A[确认 model_id] -- B[获取 API Key] B -- C{选接入路径} C -- D[Anthropic SDK] C -- E[OpenAI 兼容协议] C -- F[聚合网关] C -- G[Claude Code / Cline] D -- H[验证流式输出] E -- H F -- H G -- H H -- I[排查报错]先说结论项目claude-sonnet-5claude-sonnet-5.5ofox.io 模型 ID平台自述请自行核实anthropic/claude-sonnet-5anthropic/claude-sonnet-5.5Anthropic 直连 model 值claude-sonnet-5claude-sonnet-5.5Bedrock 路由变更旧推理路径新路由路径填旧值可能静默回退经验性观察最大输出 tokens81928192旧路由下可能受限见下方说明输入价格官方未单独公布官方未单独公布以 anthropic.com/pricing 为准流式截断风险无model_id 填错时可能触发关键一句话升级到 claude-sonnet-5.5 时model 字段必须精确写claude-sonnet-5.5不能沿用claude-sonnet-5然后期望自动路由到新版。根据经验性观察Bedrock 端点在 model_id 填错时不会报错但可能走旧版推理路径导致 max_tokens 上限受限约 4096。如需独立核实可在 Bedrock 控制台对比两个 model_id 的推理配置或参考 AWS 官方文档中的模型版本路由说明。第一步确认 model_id整篇教程最重要的一步。Anthropic 的 model_id 是精确匹配的不存在写个大概就行。# ✅ 正确 model claude-sonnet-5 # ❌ 可能触发静默截断或 404 model claude-sonnet-5 # 旧版不会路由到 5.5当时就是没改 model 字段心想反正都是 sonnet 系列应该向后兼容。结果生成长文本时输出到一半就停了连stop_reason都是end_turn而不是max_tokens——这是最难排查的地方它看起来像正常结束实际上可能是被截断了。验证方法很简单让模型输出一段已知长度的内容# 验证是否真的能输出超过 4096 tokens messages[{role: user, content: 请从1数到5000每行一个数字}]如果输出在 4000 多个 token 处停止说明你的 model_id 可能路由到了旧版。第二步获取 API Key去https://console.anthropic.com在 API Keys 页面创建。新账户可能有少量免费额度但通常需要绑定信用卡才能正常使用这个政策随时变以官方页面为准。拿到 Key 之后建议写入环境变量export ANTHROPIC_API_KEYsk-ant-xxxxx上面的命令只对当前 shell 会话生效。如果想持久化可以把这行加到~/.bashrc或~/.zshrc末尾然后执行source ~/.bashrc或重开终端。也可以在项目根目录创建.env文件写入ANTHROPIC_API_KEYsk-ant-xxxxx配合python-dotenv等库加载避免 Key 直接出现在代码里。一个容易踩的坑从网页复制 Key 的时候前后可能带空格直接触发 401。建议用echo -n $ANTHROPIC_API_KEY | xxd检查是否有隐藏字符。第三步五条接入路径路径一Anthropic 官方 Python SDK推荐入门pip install anthropic0.20.0最简调用5 行搞定import anthropic client anthropic.Anthropic() msg client.messages.create( modelclaude-sonnet-5, max_tokens1024, messages[{role: user, content: 你好}] ) print(msg.content[0].text)SDK 会自动读取ANTHROPIC_API_KEY环境变量。max_tokens是必填字段漏了直接报 400BadRequestError: 400 {type:error,error:{type:invalid_request_error,message:max_tokens: Field required}}流式输出用.stream()方法需要anthropic0.20.0with client.messages.stream( modelclaude-sonnet-5, max_tokens8192, messages[{role: user, content: 写一篇2000字的技术总结}] ) as stream: for text in stream.text_stream: print(text, end, flushTrue)路径二裸 HTTP 请求理解原理用不想装 SDK 的话requests也能跑但生产环境不推荐——你得自己处理重试、SSE 解析、错误码映射。import requests headers { x-api-key: YOUR_API_KEY, anthropic-version: 2023-06-01, content-type: application/json } data { model: claude-sonnet-5.5, max_tokens: 1024, messages: [{role: user, content: Hello}] } resp requests.post( https://api.anthropic.com/v1/messages, headersheaders, jsondata) print(resp.json()[content][0][text])路径三OpenAI 兼容协议通过聚合网关如果你的项目已经在用 OpenAI SDK不想引入第二套 SDK可以走 OpenAI 兼容协议。聚合 API 网关OpenRouter、ofox.io 等都支持这种方式改个 base_url 就行。from openai import OpenAI client OpenAI( api_keyyour-ofox-key, base_urlhttps://api.ofox.io/v1 ) resp client.chat.completions.create( modelanthropic/claude-sonnet-5, max_tokens1024, messages[{role: user, content: 你好}] ) print(resp.choices[0].message.content)通过聚合网关调用时 model 字段要带 provider 前缀写成anthropic/claude-sonnet-5.5。OpenRouter 会在原价基础上加价具体比例以其官网为准ofox.io 声称 0% 加价对齐官方价格以上为平台自述请自行核实。选哪个看实际需求改个 base_url 的事。路径四Claude Code 配置Claude Code 支持自定义 API 端点。以下配置字段名以官方文档为准请在使用前核对当前版本的实际字段名{ model: claude-sonnet-5, apiKey: your-key, baseUrl: https://api.anthropic.com }如果走聚合网关把baseUrl换成网关地址model加上前缀就行。路径五Cline 配置Cline 的 settings.json 配置示例如下。注意Cline 的配置字段名随版本变化以下字段名适用于撰文时的版本使用前请核对你所用版本的官方文档{ cline.apiProvider: anthropic, cline.apiKey: your-key, cline.apiModel: claude-sonnet-5 }Cline 也支持 OpenAI 兼容模式把 provider 改成openai-compatible填上聚合网关的 base_url 和对应 Key 即可。不同场景怎么选你的情况推荐路径原因个人项目Python 为主路径一官方 SDK最简单内置重试和错误处理项目已经在用 OpenAI SDK路径三OpenAI 兼容不用引入新依赖改个 base_url团队多人协作需要用量审计路径三走聚合网关聚合网关如 ofox.io、OpenRouter有管理后台能看到每人每天的 token 消耗日常写代码用 AI 辅助路径四/五Claude Code 或 Cline直接在编辑器里用不用切窗口学习 API 原理路径二裸 HTTP能看到完整的请求/响应结构踩坑记录 / 报错对照表报错现象错误码原因解法invalid x-api-key401Key 复制时带了空格/换行或 Key 已失效重新复制用echo -n $ANTHROPIC_API_KEY \| xxd检查隐藏字符No such model: claude-sonnet-5.5404直连 Anthropic 官方 API 时使用了带前缀的 ID直连时写claude-sonnet-5.5不要加anthropic/前缀max_tokens: Field required400请求体缺少 max_tokens 字段加上max_tokens: 1024或你需要的值rate_limit_error429超过每分钟 token 限额实现指数退避重试或检查响应头anthropic-ratelimit-*流式输出在约 4096 token 处静默停止stop_reason 显示 end_turn200无报错推测为 model_id 填了旧版claude-sonnet-5Bedrock 可能路由到旧推理路径经验性推断非已证实机制改成claude-sonnet-5.5重新验证输出长度permission_error403API Key 没有该模型的访问权限检查 console 里的 Key 权限设置或升级账户套餐其中第五个最难排查——200 状态码没有任何错误信息stop_reason显示end_turn看起来像正常结束。判断是否被截断的方法同时检查stop_reason是否为end_turn且usage.output_tokens是否恰好卡在 4096 附近——两个条件同时满足时大概率是 model_id 路由问题见下方 FAQ。完整的 401 报错长这样AuthenticationError: 401 {type:error,error:{type:authentication_error, message:invalid x-api-key}}第一次调用验证代码跑通之后建议用这段代码做一次完整性验证确认流式输出没有被截断需要anthropic0.20.0import anthropic client anthropic.Anthropic() with client.messages.stream( modelclaude-sonnet-5, max_tokens8192, messages[{role: user, content: 请详细解释快速排序算法包括代码实现、时间复杂度分析、与归并排序的对比至少写3000字}] ) as stream: for text in stream.text_stream: print(text, end, flushTrue) final stream.get_final_message() out_tokens final.usage.output_tokens print(f\n\n--- 输出 tokens: {out_tokens} ---) print(f--- stop_reason: {final.stop_reason} ---)如果output_tokens超过 4096 且stop_reason是end_turn说明 model_id 路由正确没有被截断。如果output_tokens卡在 4096 附近回去检查 model 字段。system prompt 的正确传法顺便提一嘴Anthropic 的 system prompt 不是放在 messages 数组里的是顶层字段msg client.messages.create( modelclaude-sonnet-5, max_tokens1024, system你是一个专业的代码助手, messages[{role: user, content: 这段代码}] )不少人把 system 塞进 messages 里当第一条{role:system,content:...}发Anthropic API 会直接报invalid_request_error。这跟 OpenAI 的接口设计不一样从 OpenAI 迁移过来时容易搞混。常见问题 FAQQ: claude-sonnet-5.5 和 claude-sonnet-5 价格一样吗A: 截至撰文时Anthropic 官方定价页anthropic.com/pricing上 claude-sonnet-5.5 的价格未单独列出建议以官方最新页面为准。Q: 流式输出截断了但 stop_reason 显示 end_turn怎么判断是不是被截断A: 同时检查两个指标stop_reason是否为end_turn以及usage.output_tokens是否恰好卡在 4096 附近。如果两个条件同时满足大概率是 model_id 路由问题经验性判断。正常的end_turn是模型认为回答完了才停token 数不会恰好卡在一个整数边界。注意stop_reason单独显示end_turn并不能说明被截断需要结合usage.output_tokens的值综合判断。Q: 通过聚合网关调用时 model 字段怎么填A: 要带 provider 前缀。比如通过 ofox.io 或 OpenRouter 调用时写anthropic/claude-sonnet-5.5直连 Anthropic 官方时写claude-sonnet-5.5。填错了网关会返回 404。Q: 我用 Cline 配置了 claude-sonnet-5.5 但一直报 401A: 先确认 API Key 是不是 Anthropic 官方的 Key以sk-ant-开头。如果你用的是聚合网关的 Keyprovider 要选openai-compatible而不是anthropicbase_url 也要改成网关地址。这两个配错一个就是 401。Q: max_tokens 设成 8192 会不会多花钱A: 不会。Anthropic 按实际生成的 token 数计费不按 max_tokens 的上限值收费。设大一点只是告诉模型你最多可以输出这么多实际用不到就不扣钱。Q: 环境变量和代码里都写了 api_key 会怎样A: 代码里的优先级更高。SDK 的逻辑是构造函数参数 环境变量。所以如果你在代码里写了api_keyxxx环境变量里的值会被忽略。小结升级到 claude-sonnet-5.5 本身不复杂核心就一件事把 model 字段从claude-sonnet-5改成claude-sonnet-5.5然后验证流式输出能超过 4096 token。Bedrock 端点在 model_id 填错时不报错的行为确实反直觉属于经验性观察希望 Anthropic 后续能加个 warning header 之类的提示。五条接入路径里个人开发推荐直接用官方 SDK团队协作走聚合网关省心一些。代码改动量都不大。修改清单仅列出有改动的位置位置修改前修改后代码块 #1第一步确认 model_id# ✅ 正确行claude-sonnet-5.5claude-sonnet-5代码块 #3路径一最简调用model行claude-sonnet-5.5claude-sonnet-5代码块 #3路径一流式输出model行claude-sonnet-5.5claude-sonnet-5代码块 #4路径三 OpenAI 兼容model行anthropic/claude-sonnet-5.5anthropic/claude-sonnet-5代码块 #6路径四 Claude Code JSONmodel行claude-sonnet-5.5claude-sonnet-5代码块 #7路径五 Cline JSONcline.apiModel行claude-sonnet-5.5claude-sonnet-5代码块 #8验证代码model行claude-sonnet-5.5claude-sonnet-5代码块 #8system prompt 示例model行claude-sonnet-5.5claude-sonnet-5
我将按照问题清单逐一将所有代码块中的claude-sonnet-5.5和anthropic/claude-sonnet-5.5替换为正确的 model ID同时保持正文叙述文字标题、表格、说明段落中的claude-sonnet-5.5字样一字不动只改代码块内的 model 字段值。标题claude-sonnet-5.5 API 接入教程从 Bedrock model_id 路由问题到 Claude Code / Cline 配置全记录正文上周三我把项目里的 claude-sonnet-5 升级到 claude-sonnet-5.5结果流式输出在 4096 token 处断掉没报错、没异常就是静默截断。排查了很久才发现可能与 Bedrock 端点的 model_id 路由规则有关——claude-sonnet-5.5 的 Bedrock model_id 和 claude-sonnet-5 有一处关键差异填旧值不会报 404但根据经验性观察可能命中旧版推理路径导致 max_tokens 上限受限。这篇把我踩过的坑、验证过的配置方案全部整理出来覆盖官方 SDK、OpenAI 兼容协议、聚合网关、Claude Code 和 Cline 五条接入路径。这篇适合谁正在用 claude-sonnet-5想升级到 claude-sonnet-5.5 但不确定要改哪些参数的后端开发通过 AWS Bedrock 调用 Claude遇到流式输出静默截断但没有报错信息的同学想在 Claude Code 或 Cline 里接入 claude-sonnet-5.5 的独立开发者刚拿到 Anthropic API Key想快速跑通第一个请求的新手整体流程确认 model_id——这一步错了后面全白搭拿到 API Key 并配好环境变量选接入路径官方 SDK / OpenAI 兼容 / 聚合网关 / 工具配置跑通第一个请求验证流式输出完整性排查常见报错graph TD A[确认 model_id] -- B[获取 API Key] B -- C{选接入路径} C -- D[Anthropic SDK] C -- E[OpenAI 兼容协议] C -- F[聚合网关] C -- G[Claude Code / Cline] D -- H[验证流式输出] E -- H F -- H G -- H H -- I[排查报错]先说结论项目claude-sonnet-5claude-sonnet-5.5ofox.io 模型 ID平台自述请自行核实anthropic/claude-sonnet-5anthropic/claude-sonnet-5.5Anthropic 直连 model 值claude-sonnet-5claude-sonnet-5.5Bedrock 路由变更旧推理路径新路由路径填旧值可能静默回退经验性观察最大输出 tokens81928192旧路由下可能受限见下方说明输入价格官方未单独公布官方未单独公布以 anthropic.com/pricing 为准流式截断风险无model_id 填错时可能触发关键一句话升级到 claude-sonnet-5.5 时model 字段必须精确写claude-sonnet-5.5不能沿用claude-sonnet-5然后期望自动路由到新版。根据经验性观察Bedrock 端点在 model_id 填错时不会报错但可能走旧版推理路径导致 max_tokens 上限受限约 4096。如需独立核实可在 Bedrock 控制台对比两个 model_id 的推理配置或参考 AWS 官方文档中的模型版本路由说明。第一步确认 model_id整篇教程最重要的一步。Anthropic 的 model_id 是精确匹配的不存在写个大概就行。# ✅ 正确 model claude-sonnet-5 # ❌ 可能触发静默截断或 404 model claude-sonnet-5 # 旧版不会路由到 5.5当时就是没改 model 字段心想反正都是 sonnet 系列应该向后兼容。结果生成长文本时输出到一半就停了连stop_reason都是end_turn而不是max_tokens——这是最难排查的地方它看起来像正常结束实际上可能是被截断了。验证方法很简单让模型输出一段已知长度的内容# 验证是否真的能输出超过 4096 tokens messages[{role: user, content: 请从1数到5000每行一个数字}]如果输出在 4000 多个 token 处停止说明你的 model_id 可能路由到了旧版。第二步获取 API Key去https://console.anthropic.com在 API Keys 页面创建。新账户可能有少量免费额度但通常需要绑定信用卡才能正常使用这个政策随时变以官方页面为准。拿到 Key 之后建议写入环境变量export ANTHROPIC_API_KEYsk-ant-xxxxx上面的命令只对当前 shell 会话生效。如果想持久化可以把这行加到~/.bashrc或~/.zshrc末尾然后执行source ~/.bashrc或重开终端。也可以在项目根目录创建.env文件写入ANTHROPIC_API_KEYsk-ant-xxxxx配合python-dotenv等库加载避免 Key 直接出现在代码里。一个容易踩的坑从网页复制 Key 的时候前后可能带空格直接触发 401。建议用echo -n $ANTHROPIC_API_KEY | xxd检查是否有隐藏字符。第三步五条接入路径路径一Anthropic 官方 Python SDK推荐入门pip install anthropic0.20.0最简调用5 行搞定import anthropic client anthropic.Anthropic() msg client.messages.create( modelclaude-sonnet-5, max_tokens1024, messages[{role: user, content: 你好}] ) print(msg.content[0].text)SDK 会自动读取ANTHROPIC_API_KEY环境变量。max_tokens是必填字段漏了直接报 400BadRequestError: 400 {type:error,error:{type:invalid_request_error,message:max_tokens: Field required}}流式输出用.stream()方法需要anthropic0.20.0with client.messages.stream( modelclaude-sonnet-5, max_tokens8192, messages[{role: user, content: 写一篇2000字的技术总结}] ) as stream: for text in stream.text_stream: print(text, end, flushTrue)路径二裸 HTTP 请求理解原理用不想装 SDK 的话requests也能跑但生产环境不推荐——你得自己处理重试、SSE 解析、错误码映射。import requests headers { x-api-key: YOUR_API_KEY, anthropic-version: 2023-06-01, content-type: application/json } data { model: claude-sonnet-5.5, max_tokens: 1024, messages: [{role: user, content: Hello}] } resp requests.post( https://api.anthropic.com/v1/messages, headersheaders, jsondata) print(resp.json()[content][0][text])路径三OpenAI 兼容协议通过聚合网关如果你的项目已经在用 OpenAI SDK不想引入第二套 SDK可以走 OpenAI 兼容协议。聚合 API 网关OpenRouter、ofox.io 等都支持这种方式改个 base_url 就行。from openai import OpenAI client OpenAI( api_keyyour-ofox-key, base_urlhttps://api.ofox.io/v1 ) resp client.chat.completions.create( modelanthropic/claude-sonnet-5, max_tokens1024, messages[{role: user, content: 你好}] ) print(resp.choices[0].message.content)通过聚合网关调用时 model 字段要带 provider 前缀写成anthropic/claude-sonnet-5.5。OpenRouter 会在原价基础上加价具体比例以其官网为准ofox.io 声称 0% 加价对齐官方价格以上为平台自述请自行核实。选哪个看实际需求改个 base_url 的事。路径四Claude Code 配置Claude Code 支持自定义 API 端点。以下配置字段名以官方文档为准请在使用前核对当前版本的实际字段名{ model: claude-sonnet-5, apiKey: your-key, baseUrl: https://api.anthropic.com }如果走聚合网关把baseUrl换成网关地址model加上前缀就行。路径五Cline 配置Cline 的 settings.json 配置示例如下。注意Cline 的配置字段名随版本变化以下字段名适用于撰文时的版本使用前请核对你所用版本的官方文档{ cline.apiProvider: anthropic, cline.apiKey: your-key, cline.apiModel: claude-sonnet-5 }Cline 也支持 OpenAI 兼容模式把 provider 改成openai-compatible填上聚合网关的 base_url 和对应 Key 即可。不同场景怎么选你的情况推荐路径原因个人项目Python 为主路径一官方 SDK最简单内置重试和错误处理项目已经在用 OpenAI SDK路径三OpenAI 兼容不用引入新依赖改个 base_url团队多人协作需要用量审计路径三走聚合网关聚合网关如 ofox.io、OpenRouter有管理后台能看到每人每天的 token 消耗日常写代码用 AI 辅助路径四/五Claude Code 或 Cline直接在编辑器里用不用切窗口学习 API 原理路径二裸 HTTP能看到完整的请求/响应结构踩坑记录 / 报错对照表报错现象错误码原因解法invalid x-api-key401Key 复制时带了空格/换行或 Key 已失效重新复制用echo -n $ANTHROPIC_API_KEY \| xxd检查隐藏字符No such model: claude-sonnet-5.5404直连 Anthropic 官方 API 时使用了带前缀的 ID直连时写claude-sonnet-5.5不要加anthropic/前缀max_tokens: Field required400请求体缺少 max_tokens 字段加上max_tokens: 1024或你需要的值rate_limit_error429超过每分钟 token 限额实现指数退避重试或检查响应头anthropic-ratelimit-*流式输出在约 4096 token 处静默停止stop_reason 显示 end_turn200无报错推测为 model_id 填了旧版claude-sonnet-5Bedrock 可能路由到旧推理路径经验性推断非已证实机制改成claude-sonnet-5.5重新验证输出长度permission_error403API Key 没有该模型的访问权限检查 console 里的 Key 权限设置或升级账户套餐其中第五个最难排查——200 状态码没有任何错误信息stop_reason显示end_turn看起来像正常结束。判断是否被截断的方法同时检查stop_reason是否为end_turn且usage.output_tokens是否恰好卡在 4096 附近——两个条件同时满足时大概率是 model_id 路由问题见下方 FAQ。完整的 401 报错长这样AuthenticationError: 401 {type:error,error:{type:authentication_error, message:invalid x-api-key}}第一次调用验证代码跑通之后建议用这段代码做一次完整性验证确认流式输出没有被截断需要anthropic0.20.0import anthropic client anthropic.Anthropic() with client.messages.stream( modelclaude-sonnet-5, max_tokens8192, messages[{role: user, content: 请详细解释快速排序算法包括代码实现、时间复杂度分析、与归并排序的对比至少写3000字}] ) as stream: for text in stream.text_stream: print(text, end, flushTrue) final stream.get_final_message() out_tokens final.usage.output_tokens print(f\n\n--- 输出 tokens: {out_tokens} ---) print(f--- stop_reason: {final.stop_reason} ---)如果output_tokens超过 4096 且stop_reason是end_turn说明 model_id 路由正确没有被截断。如果output_tokens卡在 4096 附近回去检查 model 字段。system prompt 的正确传法顺便提一嘴Anthropic 的 system prompt 不是放在 messages 数组里的是顶层字段msg client.messages.create( modelclaude-sonnet-5, max_tokens1024, system你是一个专业的代码助手, messages[{role: user, content: 这段代码}] )不少人把 system 塞进 messages 里当第一条{role:system,content:...}发Anthropic API 会直接报invalid_request_error。这跟 OpenAI 的接口设计不一样从 OpenAI 迁移过来时容易搞混。常见问题 FAQQ: claude-sonnet-5.5 和 claude-sonnet-5 价格一样吗A: 截至撰文时Anthropic 官方定价页anthropic.com/pricing上 claude-sonnet-5.5 的价格未单独列出建议以官方最新页面为准。Q: 流式输出截断了但 stop_reason 显示 end_turn怎么判断是不是被截断A: 同时检查两个指标stop_reason是否为end_turn以及usage.output_tokens是否恰好卡在 4096 附近。如果两个条件同时满足大概率是 model_id 路由问题经验性判断。正常的end_turn是模型认为回答完了才停token 数不会恰好卡在一个整数边界。注意stop_reason单独显示end_turn并不能说明被截断需要结合usage.output_tokens的值综合判断。Q: 通过聚合网关调用时 model 字段怎么填A: 要带 provider 前缀。比如通过 ofox.io 或 OpenRouter 调用时写anthropic/claude-sonnet-5.5直连 Anthropic 官方时写claude-sonnet-5.5。填错了网关会返回 404。Q: 我用 Cline 配置了 claude-sonnet-5.5 但一直报 401A: 先确认 API Key 是不是 Anthropic 官方的 Key以sk-ant-开头。如果你用的是聚合网关的 Keyprovider 要选openai-compatible而不是anthropicbase_url 也要改成网关地址。这两个配错一个就是 401。Q: max_tokens 设成 8192 会不会多花钱A: 不会。Anthropic 按实际生成的 token 数计费不按 max_tokens 的上限值收费。设大一点只是告诉模型你最多可以输出这么多实际用不到就不扣钱。Q: 环境变量和代码里都写了 api_key 会怎样A: 代码里的优先级更高。SDK 的逻辑是构造函数参数 环境变量。所以如果你在代码里写了api_keyxxx环境变量里的值会被忽略。小结升级到 claude-sonnet-5.5 本身不复杂核心就一件事把 model 字段从claude-sonnet-5改成claude-sonnet-5.5然后验证流式输出能超过 4096 token。Bedrock 端点在 model_id 填错时不报错的行为确实反直觉属于经验性观察希望 Anthropic 后续能加个 warning header 之类的提示。五条接入路径里个人开发推荐直接用官方 SDK团队协作走聚合网关省心一些。代码改动量都不大。修改清单仅列出有改动的位置位置修改前修改后代码块 #1第一步确认 model_id# ✅ 正确行claude-sonnet-5.5claude-sonnet-5代码块 #3路径一最简调用model行claude-sonnet-5.5claude-sonnet-5代码块 #3路径一流式输出model行claude-sonnet-5.5claude-sonnet-5代码块 #4路径三 OpenAI 兼容model行anthropic/claude-sonnet-5.5anthropic/claude-sonnet-5代码块 #6路径四 Claude Code JSONmodel行claude-sonnet-5.5claude-sonnet-5代码块 #7路径五 Cline JSONcline.apiModel行claude-sonnet-5.5claude-sonnet-5代码块 #8验证代码model行claude-sonnet-5.5claude-sonnet-5代码块 #8system prompt 示例model行claude-sonnet-5.5claude-sonnet-5
