第三方 API 调用 Claude Code / OpenClaw 出现 LLM request timed out 的解决方案
第三方 API 调用 Claude Code / OpenClaw 出现 LLM request timed out 的解决方案问题描述使用 Claude Code 或 OpenClaw 调用第三方 API如 GLM、DeepSeek、通义千问时频繁出现以下超时报错Error: LLM request timed out Request to https://open.bigmodel.cn/api/paas/v4/chat/completions failed after 60000ms 或者 FetchError: request to https://api.deepseek.com/v1/chat/completions failed, reason: connect ETIMEDOUT特征偶尔能成功调用大部分请求超时代码生成时尤其容易超时Token 量大的响应使用代理时问题更严重原因分析原因 1默认超时时间过短Claude Code 和 OpenClaw 的默认 API 超时时间通常是60秒。而国产模型的代码生成响应可能较慢尤其是生成大量代码时60秒不够用。原因 2代理中间跳增加延迟国内用户通过代理访问 API 时网络链条为本地 → 代理(国内) → API服务器(国内/海外)代理层本身会增加 1-3 秒的延迟多层代理后更容易超时。原因 3API 服务端限流第三方 API 通常有并发限制如 DeepSeek 免费版 2 QPS请求排队等待也计入超时时间。解决方案方案一增加 API 超时时间Claude Code编辑~/.claude.json{ hasCompletedOnboarding: true, apiKey: your-key, baseUrl: https://open.bigmodel.cn/api/paas/v4, timeout: 180000 }timeout单位是毫秒ms180000 3分钟。建议至少设为 1200002分钟。OpenClaw# 环境变量方式 export OPENCLAW_API_TIMEOUT180000 # 或者在 config 文件中设置 # ~/.openclaw/config.json { api_timeout_ms: 180000 }方案二直连 API 服务器去掉代理对于国内可直连的 APIGLM、DeepSeek、通义千问直接连接速度更快# 临时去掉代理 unset HTTP_PROXY unset HTTPS_PROXY # 或在 Claude Code 配置中指定不使用代理 # ~/.claude.json { proxy: null }方案三使用国内模型专用加速节点部分第三方 API 提供国内优化节点# 智谱 GLM 国内节点 baseUrl: https://open.bigmodel.cn/api/paas/v4 # DeepSeek 国内节点 baseUrl: https://api.deepseek.com方案四降低请求复杂度避免生成超长内容# Claude Code 命令方式 claude --max-tokens 4096 # 限制单次生成的最大 Token # 或在配置文件中设置 { maxTokens: 4096 }总结LLM request timed out的超时问题本质上不是 bug而是配置问题。三步解决增加 timeout → 检查网络路径 → 限制单次生成长度。对于免费版 API通常限流配合第三步效果最好。