企业官网建设流程全解析

Claude Code Router 请求超时怎么排查：定位耗时发生在哪一段

【免费下载链接】claude-code-routerOne local control plane for every AI agent: route across models, fuse new capabilities, orchestrate tools, and stay fully in control.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-router

用 Claude Code Router（CCR）代理模型请求时，任务变慢或直接超时，第一个要回答的问题是：耗时花在了哪一段。CCR 文档的排查入口是：先看请求日志里的耗时和错误信息，判断超时发生在哪一段。超时的主因有三类——上游服务延迟、Fusion 工具执行耗时、timeout 设置过短，三者的处理方式不同。下面按“开启日志 → 复现超时 → 在日志里定位段 → 调整对应 timeout”的顺序给出文档中的做法。

先开启请求日志与观测

排查超时依赖两个开关，到设置 → 日志与观测：

1. 打开请求日志，记录当天经过 CCR 的模型请求明细。
2. 打开Agent 观测，让观测面板展示 Agent 的执行链路。

两个面板都只记录开关打开之后的新数据，所以开启后要重新触发一次超时的任务，否则这次失败在日志里看不到。各开关和面板能力的完整说明见 日志与可观测性配置参考。

在请求日志里找到这条请求，看耗时字段

请求日志每条记录包含：请求时间、请求 ID、客户端、路径、请求模型、最终命中的供应商和模型（resolved provider、resolved model）、凭据、状态码、是否成功、耗时、token、成本估算、请求体、响应体和错误信息。

日志页支持按状态、供应商、模型、凭据、请求 ID、模型名、请求体或响应体筛选。超时通常表现为失败状态，可以先按状态或模型名缩小范围，再打开单条记录重点看三处：

• 耗时：这条请求实际花了多久；
• 状态码与错误信息：失败在什么环节、是什么错误；
• resolved provider/resolved model：请求最终被路由到了哪个供应商服务。

默认情况下请求体和响应体是全部记录的（requestLogBodyCapture默认all），一般不需要为此调整采样或捕获设置。

两个边界需要注意：

• 如果请求日志里根本查不到这条请求，先确认请求确实走了 CCR。常见问题要求的检查顺序是：CCR 服务是否正在运行、Agent 是否从 CCR 启动而不是直接打开、配置是否已应用且作用范围覆盖当前项目。
• 普通请求日志只保留本地当天的数据，进入第二天后，下一次读取或写入时会自动清理前一天的日志。超时排查要趁当天做，它不适合作为长期审计归档。

判断耗时集中在哪一段

文档把超时原因归纳为三类，对照日志中的现象归类：

Agent 观测面板为“工具调用耗时”这类情况提供另一个视角：它展示每个步骤何时发生、调用了哪个工具、工具获得了什么结果、耗时多久、是否出错，以及后续步骤如何继续，适合定位某一步耗时过长或工具结果异常的问题。请求日志提供单条模型请求的请求体、响应体和错误信息，两者配合使用。

耗时集中在工具调用时：调整 timeout

文档给出的结论是：如果耗时集中在工具调用，调大对应的 timeout。按工具所在链路，调整位置不同。

ToolHub 链路

在设置 → ToolHub中，超时毫秒是 ToolHub 解析和调用的基础超时，范围8000到300000，默认60000。如果后端 MCP server 需要更长的 request timeout，CCR 会按后端超时自动抬高实际调用超时；远程服务启动慢或请求耗时长时，单独调高该 server 的Startup timeout或Request timeout。

ToolHub 文档的排查条目与之一致：遇到调用超时，分别检查 ToolHub 的超时毫秒和单个 MCP server 的 request/startup timeout。

Fusion 链路

Fusion 工具循环不设置轮次上限或工具调用次数上限，但请求超时和客户端取消仍然生效。常见问题在 Fusion 相关检查项中也把“timeout 是否设置得太短”列为其中一项。注意媒体工具（图片生成、视频生成）的保留期、并发和超时属于 CCR 的内部安全策略，不在 Fusion UI 中要求用户配置，这些值无法在界面上手动调大。

验证调整结果

调大 timeout 后，重新触发同一个任务，在请求日志中再找这条记录：对比调整前后的记录，看该条请求的状态是否从超时失败变为正常返回，并查看耗时字段是否随之变化。如果状态恢复，说明原超时设置过短的问题已解除；如果耗时仍集中在同一步骤，或错误信息依旧，说明瓶颈在对应段的服务侧（上游供应商或 MCP server 本身），回到上一节的归类继续检查该段的服务状态与自身超时配置。

相关文档

• 常见问题
• 日志与可观测性配置参考
• 开启日志与观测
• ToolHub 配置

【免费下载链接】claude-code-routerOne local control plane for every AI agent: route across models, fuse new capabilities, orchestrate tools, and stay fully in control.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code-router