Claude调用Bash工具总是卡住不动？排查思路和解决方案分享

最近在折腾 Claude 的时候，不知道大家有没有遇到过一个特别搞心态的情况：

当你兴冲冲地给 Claude 下达指令，让它用 Bash 工具跑个脚本或者检查点什么，结果界面上一动不动。既没有报错，也没有输出，就像是卡死了一样。尤其是使用某些第三方站点（比如文里提到的 Any 站 Fable 之类的）时，这种情况似乎更容易发生，而且往往卡在一个莫名其妙的“bash 分类器”阶段。

Claude 在调用 Bash 工具时界面卡住的示例

作为一个过来人，今天想就这个“ Claude 调用 Bash 工具卡住”的问题，和大家聊聊我的排查思路和解决办法。毕竟，花钱买服务，时间都耗在等待上太亏了。

一、 为什么会卡在“分类器”？

Claude 内部工具调用流程示意图

首先，我们要理解一下 Claude 在调用工具时都干了什么。当你允许 Claude 使用 Bash 时，它并不是直接接管你的终端，而是需要先经过一个内部的“思考判定”过程（我们可以通俗地理解为一个分类器）。Claude 需要判断你当前的请求到底需不需要用 Bash，用 Bash 执行什么命令才安全，怎么执行最稳妥。

卡住通常意味着这个判定过程出了问题，或者后续的指令传输断了。

二、 排查清单：按这几个步骤来试试

既然知道了大概原理，我们就可以像医生看病一样，一步步排查原因。我总结了几个最常见的“病因”和对应药方：

1. 网络与 API 延迟问题

这是最常见的非技术性原因。如果你用的是第三方转发站，数据流从你 -> 第三方站 -> Anthropic 官方 -> 再返回，中间任何一个环节网络拥堵，都会导致卡顿。

• 自测方法：简单的Ping测试或者换个时间段再试。如果是第三方站特有的问题，不妨切回官方原版或者另一个节点对比一下。
• 解决思路：如果确认是网络波动，除了换路线没啥好办法。但如果是该服务商并发太大导致的排队，那只能换家服务商了。

2. 流式输出被中断

Claude 的 API 默认是流式输出的。有时候，工具调用需要生成的 Token 特别多，或者返回的内容包含大量特殊字符。如果客户端或者代理服务器在处理这些字符流时没做好缓冲，就会表现为“卡住”。

• 解决思路：如果你是开发者，检查一下代码里的 stream: true 处理逻辑，对于 Tool Use 的输出块是否有特殊处理？作为普通用户，可以尝试清除 Browser 缓存或者换个浏览器（比如从 Chrome 换到 Arc 或 Firefox）试试。

3. 模型的“过度思考”

有些时候，提示词写得过于复杂，或者上下文里塞了太多让模型纠结的信息，导致 Claude 在“是否要用 Bash”以及“用什么命令”这个问题上陷入了死循环。它可能在内心疯狂演绎：“这个命令会不会导致删库跑路？是不是不该执行？”结果这一思考，就把连接时间耗超了。

• 解决思路：简化提示词。明确告诉它“请直接执行...”，尽量避免包含模糊不清的描述。把你的需求拆解成更小、更明确的步骤。

4. 上下文长度超限

这是个很隐蔽的坑。如果你之前的对话记录非常长，或者上传了很多文件内容，模型在调用工具时的上下文窗口可能已经挤满了。这时候它试图加载工具定义和执行逻辑，结果“爆内存”了，表现为静默卡住。

• 解决思路：开启新对话。这是最暴力的解决办法。有时候，清空之前的记录后，瞬间就通畅了。

5. 第三方站点的实现 Bug

如果是特定站点（如文中的 Fable）才出现的问题，很大概率是该站点对 Anthropic API 的 betas 功能支持不完善。官方经常更新 API 功能，比如 Bash 分析功能的参数变了，第三方没及时适配，就会导致请求发出去没响应。

• 解决思路：遇到这种情况，作为用户基本无解。建议直接去该站点的反馈渠道催更，或者暂时放弃该站点的工具使用功能，回归纯文本对话。

三、 避坑小技巧

最后，分享几个能减少这类问题发生频率的小技巧：

1. 指令要单一：一次只让它干一件事，不要在一个Prompt里既让它分析代码又让它修改环境配置。
2. 善用System Prompt：如果你有条件修改系统提示，可以限制它的工具调用频率，比如“除非明确需要，否则优先不使用 Bash”。
3. 关注官方状态：这招很重要，有时候不是你的问题，是 Anthropic 那边挂了。出门左转查查状态页，心里有底。

写在最后

Claude 的工具能力确实强大，但目前的生态和网络环境下，稳定性确实还有提升空间。遇到“卡住别慌”，先刷新，再换新对话，最后查服务商。希望这些经验能帮大家少掉几根头发，继续愉快地 Coding！

如果你有更奇葩的卡顿原因和解决妙招，欢迎在评论区留言分享，咱们一起填坑！