Skip to content

Claude Code Bash 工具调用卡住无响应:设置 ANTHROPIC_DEFAULT_HAIKU_MODEL 解决

问题

执行任何 Bash 工具调用时,Claude Code 进入卡死状态:

  • Spinner 一直转,计时器持续计数
  • 0 个 token 被消耗,无任何进度
  • 按 Escape 并重新提交同一命令,立即正常执行

症状集中在 Bash 工具(Bash 工具调用),而非 Read/Edit 等其他工具。有时整个会话全程卡住,有时只有部分请求受影响(约 1/5 概率)。

来源:GitHub Issue #26224

解决方案

根因(社区定位): 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)无关。