AI 写的 Shell 脚本为何在 Mac 上失效
文章用变量分词差异说明:按 bash 语义生成的循环,在 zsh 中可能只执行一次,且命令退出码未必暴露错误。作者给出 Claude Code 和 VS Code 聊天工具的 Shell 配置思路。
AI 深度解读
AI 写出的 shell 命令,可能看着没问题,执行后也返回成功,却没有完成任务。作者给新 Mac 配置文件关联时,就遇到了这种情况:Claude Code 按 bash 的习惯生成循环,实际运行环境却是 zsh,16 种文件类型被当成了一个参数。
作者的处理很直接:保留自己使用的 zsh,只把 Claude Code 和 GitHub Copilot 的命令环境切到 bash。这篇经验值得看的地方,是它提醒了我们:检查 AI 命令时,除了看代码,还要看代码在哪种 shell 里运行。
同一个循环,为什么会少跑两次
从 macOS Catalina 开始,新建 Mac 账户默认使用 zsh。按原文描述,Claude Code 未另行指定时,会在用户的 shell 中执行命令,但生成的 shell 代码常带着 bash 的习惯。
下面这段对照,展示了作者踩中的差异:
$ bash -c 'v="a b c"; for x in $v; do echo "$x"; done'
a
b
c
$ zsh -c 'v="a b c"; for x in $v; do echo "$x"; done'
a b c
关键是 for x in $v:bash 会对这个未加引号的变量展开结果进行分词,循环三次;zsh 默认保留为一个词,只循环一次。两边都能正常执行,也都不会因为这个差异报错。
作者让 Claude Code 用 duti,把 16 种文本文件关联到 VS Code。AI 把类型列表放进一个字符串,再交给循环处理,结果 zsh 将整个列表一次性传给了 duti。
更麻烦的是,duti 输出了 unrecognized,退出码却是 0。代理后来自行发现了分词问题,但作者此前已经见过同类情况,于是决定修改配置。
退出码为 0,只能说明程序报告了正常退出,不能证明用户目标已经达成。
只给 AI 换 shell,具体改哪里
作者为 Claude Code 设置了 CLAUDE_CODE_SHELL,配置放在 ~/.claude/settings.json:
{ "env": { "CLAUDE_CODE_SHELL": "/opt/homebrew/bin/bash" } }
要留意的是路径 /opt/homebrew/bin/bash:它指向作者通过 Homebrew 安装的 bash,不是系统自带的 /bin/bash。
GitHub Copilot chat 则通过 VS Code 终端执行命令。作者在 VS Code 用户 settings.json 中,将 chat.tools.terminal.terminalProfile.osx 配为 {"path": "/opt/homebrew/bin/bash", "args": ["-l"]},给聊天工具单独指定终端配置。
两处都指向 Homebrew 的 bash 5,安装命令是 brew install bash。作者运行 /bin/bash --version | head -1,看到系统版本为 GNU bash, version 3.2.57(1)-release (arm64-apple-darwin26)。
改完后,还要让代理自己执行 echo "${BASH_VERSION:-not bash}"。作者得到的结果是 5.3.20(1)-release,由此确认命令确实进入了 bash。这个版本号是作者机器上的结果,不是必须安装的指定版本。
配置完成后,作者日常终端仍使用 zsh,只有代理的执行环境发生变化。
为什么加引号和反复提醒都不够
给 $v 加上双引号,不能实现这里想要的逐项循环。原文展示了 for x in "$v" 的结果:即使在 bash 中,它也只输出一次 a b c。引号保护了完整字符串,却没有把字符串变成列表。
作者也考虑过 zsh 的 setopt SH_WORD_SPLIT。这个选项可以改变分词行为,但若放进日常配置,会影响加载该配置的交互式 zsh;而非交互脚本又不会照常读取 ~/.zshrc,不能指望它统一解决代理命令的问题。
另一条路是要求 AI 始终编写 zsh。作者认为,提示可能被遗忘,固定配置更可靠。这是他的工程取舍:减少生成习惯和执行环境之间的错位。
我的判断
我赞同把代理运行环境显式配置下来。它容易检查,也比每次对话重申 shell 约束更稳定。不过,原文给出的是一次具体故障和修复经验,没有统计切换后减少了多少错误,也没有提供 bash 与 zsh 的系统性对照数据。
把代理切到 bash,可以解决这类默认分词差异,却不能保证生成命令都正确。对于受版本管理的脚本,明确解释器、用数组表达列表,也是值得采用的做法;原文没有比较这些方案的效果。
此外,/opt/homebrew/bin/bash 是作者机器上的路径,照抄前应确认本机安装位置。作者自己也明确说这不是教程,而是保存在 dotfiles 中的一次修复记录,涉及 Claude Code、VS Code 和 PR #108。
能拿来做什么
- 在 Mac 上让 AI 批量处理文件或配置前,先确认代理实际使用的 shell;如果采用本文方案,修改后让代理执行版本检查命令。
- 审查 AI 生成的循环时,重点检查「把多个项目塞进一个字符串,再用
$变量遍历」的写法,并确认它符合目标 shell 的规则。 - 给批量操作补上结果核验,例如检查文件关联是否真正生效,同时读取命令输出,避免只凭退出码判断成功。