CC-010：API Error (Request timed out.)

问题现象

发送请求后，终端等待一段时间后返回：

API Error (Request timed out.)

超时可能发生在 DNS、TLS、代理、网关排队、模型处理、工具执行或客户端等待阶段。旧版页面将它固定为“网络延迟/上下文过长”两类，证据不足；以下两类只作为常见排查方向。

情况 A：网络延迟问题
  Claude Code 发出请求 → 请求到达服务器过慢 → 超过客户端超时阈值 → 超时报错
 
情况 B：上下文过长
  当前会话积累了大量 token → 模型处理时间过长 → 超过超时阈值 → 超时报错

参考 CC-009 Connection error 核对最终域名、证书、官方服务状态和组织批准的网络配置。不要关闭 TLS 校验或安全软件。

方式一：清理上下文后继续对话

在 Claude Code 交互界面输入：

/clear

清理后重新发送请求。

方式二：关闭会话重新打开

直接退出 Claude Code，重新执行 claude 进入新会话。

方式三：压缩上下文

/compact

使用 compact 保留摘要后继续，适合不想完全丢失上下文的情况。

是否由上下文导致，应结合 /context、日志和模型限制判断；不要把所有 IDE 超时都归因于系统 Prompt。

做法	避免的问题
长任务中定期执行 `/compact` 压缩上下文	上下文堆积过多导致超时或截断
用 `claude doctor`、`/status` 和 `/context` 分层定位	避免凭单一报错猜测根因
自动化任务设置合理重试与幂等性	避免超时后重复提交产生额外操作或费用