最近，有读者问我一个 macOS 终端（Terminal）的怪问题。
他在终端里粘贴文本的时候，命令行前后总会自动多出一些奇怪的符号。比如，本来想粘贴一段 curl 命令，结果变成了下面这样：
00~sh <(curl -L https://nix.dev/install-nix)01~
开头多了一个 00~，结尾多了一个 01~。这就很麻烦，因为你必须手动把它们删掉，否则命令就会报错。
这个问题困扰了他很久，尝试修改 .zshrc 配置也没能彻底解决。今天，我就来分享一下这个问题的成因和最终的解决方案。
一、 问题的成因
这两个符号其实不是乱码，而是 Bracketed Paste Mode（括号粘贴模式）的转义序列残留。
在 Shell 的机制里，为了防止用户粘贴恶意代码（比如带有换行符的命令）导致意外执行，终端引入了一种安全模式。当在这个模式下粘贴时，终端会先发送 \e[200~（开始标记），粘贴文本，然后再发送 \e[201~（结束标记）。
Zsh 或 Bash 接收到这两个标记后，就会知道：“哦，这是粘贴进来的内容，不是用户手打的，先不要执行。”
如果你看到的只是 00~ 和 01~，说明开头的转义字符 \e[（Escape）丢失了或者没有被正确解析，剩下的字符就暴露出来了。
二、 为什么它是“间歇性”的？
通常，我们在 .zshrc 里把这个功能关掉就可以了。但是这位读者发现，有时候是正常的，但只要运行过 claude 的命令行工具（CLI），退出之后，粘贴功能就坏了。
这就找到了问题的根源：外部程序“借”用了终端，却忘了“还”。
claude CLI 在启动时，为了处理多行输入，向终端发送指令开启了“括号粘贴模式”。但是，当用户退出该工具回到 Zsh 时，它没有正确发送关闭指令。
此时，Zsh 虽然接管了界面，但底层的终端模拟器（Terminal App）还以为自己处于那个特殊模式里。这就是为什么修改 Zsh 的 unset 变量无效，因为这是终端状态层面的问题，而不是 Shell 变量层面的问题。
三、 解决方案
既然外部程序“不讲武德”，退出时不关门，那我们就得给 Zsh 装一个“自动闭门器”。
最简单的办法是利用 Zsh 的 precmd 钩子函数。这个函数会在每次命令行提示符（Prompt）显示之前自动执行。
我们可以在 .zshrc 文件中加入一段代码，强行在每次回到命令行时，都发送一次“关闭括号粘贴模式”的指令。
打开你的 ~/.zshrc 文件：
nano ~/.zshrc
在文件的末尾添加如下内容：
# 强制在每次显示提示符前关闭括号粘贴模式
# 修复 claude 等 CLI 工具退出后残留的 00~ 01~ 问题
precmd() {printf "\e[?2004l"
}
保存并退出后，执行 source ~/.zshrc 使其生效。
四、 原理解释
precmd()：这是 Zsh 的内置钩子，每次执行完一个命令、准备显示新的输入提示符之前，都会运行它。printf "\e[?2004l"：这是一段 ANSI 转义序列。\e[?2004h是开启括号粘贴模式，而结尾的l(low) 代表关闭（Lock/Low）。
通过这个配置，无论你刚才运行了 claude、vim 还是其他什么把终端搞乱的程序，只要你退回到 Zsh 的界面，precmd 就会立刻执行，默默地帮你把这个模式关掉。
这样，你的粘贴体验就恢复顺滑了。
（完）