搜「claude opus 4.5怎么排查」的人,大多已经不是在问它是什么,而是卡在某个具体位置:请求发出去了没回、回了但答非所问、或者干脆报一串英文。这篇不铺概念,按「先确认卡在哪一层」的顺序走一遍:入口对不对、参数填没填进对的那格、报错该怎么读。看完你能自己定位,不用每次都靠猜。
搜「claude opus 4.5怎么排查」的人,大多已经不在问它是什么了,而是卡在某个具体位置:请求发出去没动静、回是回了但答非所问、或者干脆甩回来一串英文报错。这篇不铺概念,就按「先确认卡在哪一层」的顺序走一遍。看完你能自己定位,不用每次都靠猜。
先说个前提:排查这事儿最怕一口气全改。你换个地址、改个参数、又换把 Key,最后通了,但你不知道是哪一步救回来的,下次再犯还是抓瞎。所以先把范围切开,一次只动一处,跑一次对比一次。慢是慢点,但省事。
先分清卡在哪一层,别一口气全改
把问题拆成三处:入口层管地址、Key、模型名这些「你连的是谁」;参数层管长度、温度、输出格式这些「你怎么问的」;返回层管报错码和内容质量这些「它怎么回的」。听着像废话,但大多数人排查失败就是因为把三层的动作混在一起做。
判断方法其实很简单。报错里带状态码的,基本在入口层或参数层,因为那头压根没开始正常回答;能正常返回但内容不对的,才轮到参数层和提示词。要是整站打不开、大范围超时,先别怀疑自己,多半是对方那头的事,这种情况你的配置怎么改都没用。
入口层按这个顺序查,别跳步
- base URL:多写或少写一段路径都不行,注意末尾斜杠和后缀,抄文档时连格式一起抄;
- Key:确认是不是这一家的,有没有混进别家的 Key,有没有带了两个;
- 模型名:按对方文档里的写法原样复制,大小写、连字符、日期后缀错一个字就是另一个模型;
- 想快速分清是地址问题还是 Key 问题,拿同一把 Key 去站内测速页面打一次,通就是你的地址问题,不通就往 Key 上查。
模型名这块最容易失手。有人凭印象手打,把连字符打成下划线,或者后缀少截了一段,请求照发,报错却是「找不到模型」,于是以为整条链路都坏了。实际用下来,抄全、别改、别自作聪明补全,能省掉大半入口层的坑。
如果你走的是中转站,中间多了一层,报错文案经常被改写,看起来和官方不太一样。别急着下结论,先对照站内的中转站检测页和状态记录,看它当时是不是在正常服务,再决定是自己改还是换条路。
参数不是填了就对,得填进对的那一格
这一步的典型误判是把参数塞进提示词文本里。长度上限这类东西,各家叫法不同,但它必须是请求体里的独立字段,你写在提示词里说「最多写多少字」,模型未必照做,接口那头也没认出来。格式对了,行为才稳。
| 现象 | 更可能的原因 | 先动哪里 |
|---|---|---|
| 返回内容被硬截断 | 长度上限字段没设或设太小 | 请求体里的独立长度字段 |
| 同样的问题答案忽长忽短、跑偏 | 温度偏高 | 先把温度降下来再问一次 |
| 要求 JSON 却总带多余解释 | 只靠提示词约束格式 | 看有没有专门的格式参数或工具调用通道 |
| 改完反而更乱 | 一次动了多个参数 | 回退到上一版,一次只改一处 |
温度这件事,判断标准可以很土:同一个问题连问几次,答案差异大就说明它太飘,先降再看。至于结构化输出,别只靠嘴说,看看对方有没有专门的格式参数,能用字段约束就别全靠提示词,稳得多。
报错要读对,别一上来就换站
报错文案是排查里信息量最大的东西,可惜很多人扫一眼「报错了」就换站。带状态码的,基本能直接指到层:身份类的是 Key 的事,路径或模型名找不到的是入口层,频率或额度被卡的是另一回事,服务端那类数字开头的,是对方那头在忙。
- 先看码再看文案把状态码抄下来,对照上面几类归位,别被花哨的英文描述带跑。
- 429 要分清两件事是并发挤爆还是额度用完,处理方式完全不同,站内有专门讲速率限制的页面,对着分一下再动手。
- 把出错请求原样存下来去掉 Key,其余字段一字不改,能复现才叫能排查,光记「报错了」没用。
- 改一处,跑一次改完立刻重跑,通了就记下改了什么,别攒一堆改动再试。
最后提醒一句适用范围:上面这套针对的是「配置和调用层面」的问题。如果对方模型本身在某个时间段整体不稳定,你本地怎么查都查不出花来,这时候该做的是看状态、换时间、换通道,而不是继续折腾参数。
下一步把入口和参数的对照表存下来,下次遇到报错先按层归位。各家中转站的实时状态和可信度记录在站内页面里,不用凭印象判断。→常见问题
换了模型名就报错,是不是这个模型用不了?
先别下结论。核对三点:模型名是不是按文档原样抄的、你这把 Key 的权限里有没有它、你走的这条通道支不支持它。三点都过了还报,再去看服务状态页,而不是急着换平台。
能返回内容,但答得不对,算排查问题吗?
算,但归到参数层和提示词层。先固定输入,只调温度和长度各测一次,看差异出在哪。如果是长文档场景答漏,多半是上下文被截断,去站内上下文相关页面确认你这次的实际长度。
怎么判断是我的问题还是中转站的问题?
拿同一把 Key、同一段请求,分别走一次站内测速和你的业务代码。测速通、代码不通,是你的代码或地址;两边都不通,问题在通道那头。这条对照能省掉大半瞎试。