超时 / 请求超时修复指南——Claude Code 与 Codex CLI
Claude Code 或 Codex CLI 接入 DeepSeek、OpenRouter 等服务商时遇到"超时 / 请求超时"的分步修复方法。
报错输出
Error: Request timed out after 600000ms.
Anthropic API Error: 529 Overloaded
常见变体
codex: request timed out after 10 minutes
Error: TimeoutError: Request timed out
at Object.fetch (node:internal/…)
具体文本随 Agent 版本与服务商略有差异，以状态码和消息类型为准。
快速定位
简短提示词后立即超时指向网络；长提示词后超时指向模型。
Claude Code
claude /status Codex CLI
codex exec "hi"常见原因
- 模型响应慢（长推理、大上下文），客户端放弃等待。
- 过长的提示词或超大上下文拉长了首 token 时间。
- 与服务商所在地区的网络受限或拥塞。
- 高峰时段服务商过载（529）。
按场景修复
1 大提示词或大仓库超时
- 缩短提示词或缩小上下文（减小仓库范围、只给相关文件）。
- 把长任务拆成小步骤，而不是一次巨型请求。
- 批量工作改用上下文更大或速度更快的模型。
2 小提示词也超时
- 这指向网络路径——在同一 Shell 中运行 curl 测试。
- 修改配置前先确认服务商是否过载（529）。
- 在非高峰时段重试，确认是否与负载相关。
3 配置变更后超时
- 新模型可能推理更久——降低推理强度或更换模型。
- 代理或 VPN 变更会增加延迟——重新运行 curl 计时测试。
- 先与之前可用的模型对比，再判断是否是端点问题。
Agent 差异修复
Claude Code
- 修复
- 重试请求、缩短提示词或上下文，长时间会话改用 deepseek-v4-flash。区域性网络问题可能需要更换网络。
- 验证
- 在网络空闲时重新发起请求，确认可以完成。
Codex CLI
- 修复
- 缩小上下文（减小仓库范围）、简单任务降低推理强度，或改用更快的模型。修改配置前先确认服务商是否过载（529）。
- 验证
- 用简短提示词运行 `codex exec "hi"`，将网络路径与工作负载隔离验证。
Claude Code 与 Codex CLI 对照速查
| Claude Code | Codex CLI | |
|---|---|---|
| 小提示词超时 | Network path likely | Network path likely |
| 大提示词超时 | Model speed/context | Model speed/context |
| 过载信号 | 529 Overloaded | 529 Overloaded |
避免复发
- 日常任务用快速模型，把慢的推理模型留给难题。
- 保持提示词与上下文精简；大上下文是最常见的超时诱因。
- 长会话放在非高峰时段，或做好重试逻辑。
相关错误
相关接入指南
常见问题
可以调大超时时间吗？
大多数客户端使用固定的客户端超时时间。实际可行的方法是换更快的模型、缩短提示词，或改善到服务商的网络路径。
同时出现超时和 529 是什么意思？
529 表示服务商过载；超时是客户端在等待中放弃。等待后在非高峰重试，或换用负载较低的模型或端点。