亲手实测
这里的每一篇文章都是作者亲手跑过的：写明复现条件、实测环境、测试方法、结果与分析，结论仅在标注环境下验证。不转述二手信息，复现不了就写复现不了。
claude install 断链、%h 未展开？Debian 容器实测装出来是好的（未复现）
GitHub 上有 Fedora 用户报告：官方一键安装脚本装完后 ~/.local/bin/claude 是条断链，指向字面量 %h/.local/share/claude/versions/2.1.220——%h 这个占位符没被展开成家目录。我们在干净的 Debian 12 容器里按原报告的完整命令实测，装出来的符号链接是正常的（%h 已正确展开），且当前 install.sh 分发的版本已是 2.1.223（报告版本为 2.1.220）。本文是一篇「未复现实录」：完整给出实测环境、命令与输出证据，分析未复现的三种可能解释，并附上如果你正被断链卡住的一分钟手工修复。
阅读实测报告Claude Code 报 No conversation found to continue：你的 -p 会话被交互模式过滤掉了
用 claude -p 跑完一条无头命令，接着敲 claude --continue 想进交互模式续聊，得到的却是 No conversation found to continue——但会话文件明明就在磁盘上。这是 v2.1.90 引入的回归：--resume 选择器'不展示 -p/SDK 会话'的过滤逻辑，误伤了本应无条件继续最近会话的 --continue。本文在 macOS + v2.1.220 上完整复现（GitHub issue 报告的是 Fedora，两平台坐实），给出两条实测可用的绕行：无头续聊 -p --continue 一直是通的；交互模式用 CLAUDE_CODE_ENTRYPOINT=sdk-cli 前缀可以绕过过滤、完整加载历史。
阅读实测报告Claude Code 到底在用哪个模型？settings.json、环境变量、--model 的优先级实测
多智能体、CI、批量脚本都依赖一个前提：会话真的跑在你配置的模型上。但模型可以在四个地方指定——settings.json、ANTHROPIC_MODEL 环境变量、--model 参数、会话内 /model——文档没有一张表告诉你谁覆盖谁，GitHub 上还有 Windows 用户报告 settings.json 配置被静默忽略、一整天的任务跑错模型全部作废。本文用 modelUsage 铁证逐层实测出优先级链：--model > ANTHROPIC_MODEL > 项目 settings.json > 内置默认，[1m] 后缀写法同样生效；并给出一个比任何 UI 提示都可靠的验证手段。
阅读实测报告Claude Code Hooks 的 stdin 陷阱：python heredoc 会吃掉你的 hook JSON
官方文档说 hook 通过 stdin 接收 JSON 输入，这没错。但如果你在 hook 脚本里用 python heredoc（python3 - <<'EOF'）来解析这份 JSON，会掉进一个静默失败的坑：heredoc 把 python 的 stdin 重定向成了脚本本身，json.load(sys.stdin) 读到的永远是空。更糟的是，按最佳实践写的 hook 会吞掉一切异常静默退出——你不会看到任何报错，只会发现 hook '好像没生效'。这篇记录真实踩坑过程、两行代码的修复方案，和一个通用教训：静默容错的代码，调试时是你自己的敌人。
阅读实测报告Claude Code 的 auto 模式是用模型审模型的——模型一挂，连 cat 都跑不了
auto 权限模式在放行 Bash 前会额外调用一次当前会话模型，来判定这条命令安不安全——判定器和干活的是同一个模型。模型一旦不可用，你会撞进一个反直觉的半瘫状态：读文件、搜代码全都正常，但一条 cat 都跑不了。这篇文章记录了一次真实排查：我先后提出三个听起来都很合理的假设，又用对照实验把它们逐个推翻，最后只剩下一条真正可靠的退路。
阅读实测报告