如何定位模型接入链路的超时问题?

模型接入出现超时，首先要避免把它笼统归为“网络不好”。一次请求往往经过多段链路：终端到兼容节点，兼容节点再到模型服务；若使用本地 Ollama，还会增加路由工具到本地服务这一段。只有先确认超时发生的位置，后续检查才不会变成无效重试。

最先检查客户端实际使用的连接配置。对于 Claude Code，可通过状态信息核对当前读取的 ANTHROPIC_BASE_URL、认证令牌和模型标识。问题常常不在服务端，而在旧终端仍保留旧环境变量，或地址的协议、路径与服务要求不一致。修改用户级配置或终端变量后，应新开终端再测试，不能用已有会话的结果判断配置是否生效。

随后把验证拆成最小请求。先用短对话确认终端能否获得响应，再逐步增加上下文和任务复杂度。短请求也超时，重点应放在地址、代理、鉴权和中转节点；短请求正常、长请求变慢，则更可能是输入过长、模型首次加载或机器资源不足。后者看起来像网络卡住，实质上是推理尚未完成。

按链路逐段排除

使用第三方兼容节点时，应确认该服务确实兼容 Anthropic Messages API，并能处理必要的版本与测试请求头。仅支持普通聊天接口的服务，即使能接受部分请求，也可能在工具调用或较复杂请求中失去响应。

使用本地 Ollama 时，排查顺序应更靠近本机：本地服务是否已启动、目标模型是否已下载、路由工具是否运行、路由配置中的模型名是否与本地实际名称一致。还要留意终端代理设置是否把本应直连的本地请求转发出去；这种情况常表现为本地服务偶发不可用。

超时定位的关键不是一次性检查所有配置，而是每次只验证一段链路。先确认请求去了哪里，再确认该节点能否继续转发，最后才评估模型处理请求的速度。这样即使更换兼容节点、本地模型或路由方式，也能明确问题属于配置、网络转发，还是模型与资源本身。