主题
EE-15 Command timed out after 2m 0.0s
| 字段 | 内容 |
|---|---|
| 影响组件 | Claude Code 内置终端命令执行 |
| 系统环境 | Linux / macOS / Windows |
问题现象
Claude Code 执行终端命令时返回:
Command timed out after 2m 0.0s1
API 请求本身正常,只是命令超时。
根因分析
Claude Code 对终端命令设置了 2 分钟超时。以下场景容易触发:
npm install、docker build等耗时命令- 交互式命令(等待用户输入,永远不结束)
- 命令输出量过大,传输阻塞
修复步骤
- 对于耗时命令,让 Claude Code 放到后台执行或拆分步骤。
- 交互式命令改用非交互模式,例如:
bash
npm install --yes
apt-get install -y package-name1
2
2
- 确实需要长时间运行的命令,直接在外部终端执行,再把结果粘贴回对话。
预防措施
| 做法 | 避免的问题 |
|---|---|
| 构建、安装类命令在项目目录外手动执行 | 触发 2 分钟超时 |
| 避免让 Agent 运行交互式命令 | 进程挂起直到超时 |