Appearance
Claude Code Bash 工具调用卡住无响应:设置 ANTHROPIC_DEFAULT_HAIKU_MODEL 解决
问题
执行任何 Bash 工具调用时,Claude Code 进入卡死状态:
- Spinner 一直转,计时器持续计数
- 0 个 token 被消耗,无任何进度
- 按 Escape 并重新提交同一命令,立即正常执行
症状集中在 Bash 工具(Bash 工具调用),而非 Read/Edit 等其他工具。有时整个会话全程卡住,有时只有部分请求受影响(约 1/5 概率)。
解决方案
根因(社区定位): Bash 工具调用内部依赖 Haiku 模型处理某些辅助任务,当 ANTHROPIC_DEFAULT_HAIKU_MODEL 未设置或指向失效的模型版本时,该内部调用无限等待,导致整个工具调用卡死。
解决方法:设置 ANTHROPIC_DEFAULT_HAIKU_MODEL 环境变量
bash
# 临时生效(当前 shell 会话)
export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5
# 永久生效(写入 ~/.bashrc 或 ~/.zshrc)
echo 'export ANTHROPIC_DEFAULT_HAIKU_MODEL=claude-haiku-4-5' >> ~/.bashrc
source ~/.bashrc通过 settings.json 设置(推荐):
json
{
"env": {
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5"
}
}其他临时绕过方法:
- 卡住后按 Escape,重新输入相同内容,通常下一次就会正常执行
- 在 Plan Mode 卡住时:输入"执行计划"然后立即切换到其他应用,等待权限弹窗通知后确认
注意: 此问题在 Max 订阅用户和 API Key 用户均有报告,与具体模型(Sonnet/Opus)和操作系统(macOS/Windows/WSL)无关。