工具大全
亲手实测作者:Coocon2026年8月7日189 次阅读约 2 分钟阅读

claude install 断链、%h 未展开?Debian 容器实测装出来是好的(未复现)

本文性质:未复现实录。我们没有复现出报告中的问题——这不代表报告是错的,只代表在下述环境、用下述方法测不出来。全部命令与原始输出都在文中,欢迎交叉验证。

原始报告说了什么

GitHub issue #83484(Fedora 44 + bash,Claude Code 2.1.220):运行官方一键安装后,~/.local/bin/claude 是一条断掉的符号链接——

$ curl -fsSL https://claude.ai/install.sh | bash
$ file ~/.local/bin/claude
/home/user/.local/bin/claude: broken symbolic link to %h/.local/share/claude/versions/2.1.220

链接目标里的 %h 是个未展开的占位符(systemd 风格的家目录指示符),本应是 /home/user。报告者定位问题不在 shell 安装脚本,而在二进制内部的 install 子命令;并称此前版本正常,属回归。issue 关联了一个修复 PR(#83738,报告时未合并)。

我们的实测:装出来是好的

环境:干净的 Docker 容器 debian:bookworm-slim,root 用户,2026-08-06 执行与报告完全相同的安装命令:

$ curl -fsSL https://claude.ai/install.sh | bash
$ ls -la /root/.local/bin/claude
lrwxrwxrwx 1 root root 42 Aug  6 10:23 /root/.local/bin/claude -> /root/.local/share/claude/versions/2.1.223
$ file /root/.local/bin/claude
/root/.local/bin/claude: symbolic link to /root/.local/share/claude/versions/2.1.223

两个关键观察:

  1. 符号链接是正常的——目标路径里的家目录已正确展开为 /root,没有出现字面量 %h
  2. install.sh 当前分发的版本是 2.1.223,比报告中的 2.1.220 新了三个版本(2.1.221/222/223 分别发布于 8 月 3/4/5 日)

为什么没复现:三种可能解释

按证据强度排序:

解释一:已在 2.1.221–2.1.223 之间修复(最可能)。 报告发生在 2.1.220,关联修复 PR 存在,而现在 install.sh 直接分发 2.1.223——如果修复已合入其中任何一版,新装用户自然不会再遇到。但我们没有找到明确写着"修复 %h 展开"的发版说明,无法坐实。

解释二:发行版相关。 报告环境是 Fedora 44,我们测的是 Debian 12。%h 是 systemd 单元文件里的家目录指示符——如果二进制的 install 子命令在某些系统上从 systemd 相关配置读取路径模板,行为可能随发行版而异。这只是机制猜想,我们没有 Fedora 环境验证。

解释三:报告环境的残留状态。 报告者称"此前版本正常",旧安装的残留配置可能参与了路径生成。干净容器里没有任何残留,这或许正是测不出来的原因——但同样无法证实。

如果你正被断链卡住:一分钟修复

无论根因是什么,断链的修复是确定的(来自 issue 中报告者验证过的 workaround):

# 把断链指向真实存在的版本目录(版本号按你机器上实际的改)
ls ~/.local/share/claude/versions/        # 先看有哪些版本
ln -sf ~/.local/share/claude/versions/<版本号> ~/.local/bin/claude
claude --version                          # 验证可用

更省事的选择:直接重跑一次官方安装命令——当前分发的 2.1.223 在我们的实测里装出来就是好的。

适用边界

  • 本文只证明:Debian 12 干净环境 + 2026-08-06 的 install.sh(分发 2.1.223)不出现此问题
  • 不能证明:Fedora 上已修复、2.1.220 的问题不存在、或所有环境都正常
  • 如果你在其它发行版上仍能复现(尤其 Fedora + 2.1.221 及以后版本),请到 issue #83484 补充环境信息——那将直接推翻解释一、坐实解释二

相关文章

ANTHROPIC_BASE_URL 设了却不生效

在 zshrc 里 export 了 ANTHROPIC_BASE_URL 指向第三方中转站,Claude Code 却依然走 Google Vertex;同一台机器上,launchd 启动的 Web UI 干脆说未认证。两个坑的根子都不在中转站,而在「你以为环境变量设上了」。

claude-code中转站+2
pitfalls2026年8月24日4 min
28

Claude 没有写那个打印机驱动:14KB 胶水代码、一个 Linux 容器,和 HP 自己的二进制

一条「Claude 给只支持 Windows 的 HP 打印机写了 macOS 驱动」的推文拿到 262 万阅读。把仓库拉下来一看:Shell 6497 字节、Python 7638 字节、Dockerfile 550 字节,没有一行 C,真正做编码的是 HP 官方 Linux 驱动里的 rastertospl 二进制,跑在 Mac 上的 Linux 容器里。HN 上一群人指出了这件事。但这篇文章想说的不是拆台——四小时会话里真正有含金量的部分(读打印机吐出的错误页、绕过 CUPS 沙箱、libusb 直写),以及那个决定性转折点是人提出来的、不是 Claude 想到的,才是 AI 干脏活能力边界的准确刻度。

claude-code开源+6
claude2026年8月19日11 min
161

MCP Server 把 CPU 吃满 100%:一次 Cloudflare MCP 失控进程的排查与止血

Mac 风扇狂转、CPU 100%,定位到元凶是 Cloudflare 的 stdio MCP server:两个进程各吃满一个核,背后还堆着一排历史会话残留的僵尸实例。本文复盘现象、定位过程、stdio MCP 的进程模型缺陷,以及为什么低频运维操作用 REST API 比挂一个常驻 MCP 更合理。

mcpclaude-code+2
pitfalls2026年8月18日4 min
229

Zsh 历史记录莫名丢失?一个潜伏 10 年的 bug,改配置没用,升级 5.9.2 才是解法

确信昨天敲过的命令,今天 Ctrl+R 搜不到,~/.zsh_history 只剩几年前的老条目——这不是你配置的问题。Michael Stapelberg 用 inotify → fatrace → bpftrace → 给 Zsh 打崩溃补丁的完整排查,定位到一个 2015 年就存在的缺陷:退出时重写历史文件的过程被 Ctrl+C 打断,Zsh 会把只读了一半的历史写回去。Zsh 5.9.2 已修复(5.9.1 漏掉了)。本文拆解根因、给出各发行版升级现状表,并纠正一个流传很广的错误解法。

shelllinux+6
pitfalls2026年8月17日6 min
197