踩坑实录
真实工程踩坑复盘：现象、根因、验证过的解法一条龙记录。历法计算、时区、CI/CD、LLM 应用——每篇都来自本站开发运维中亲手踩过并修复的坑，只写实测，不写理论。
加载中...
Claude Code 禁止 rm -rf 怎么配：deny 规则两周拦下 14 次，实测还有 7 种写法照样能删，一个 hook 补齐
为了防 Claude Code 误删文件，我在全局 settings 里加了一条 deny 规则 Bash(rm -rf *)。翻本机 10 月 7 日到 21 日的会话记录：这条规则拦下 14 次删除，模型被拒后 8 次换新目录名、6 次直接放弃删除，一次都没换写法绕过。但在 Claude Code 2.1.285 上用 stub 逐字回放 22 种删除写法后发现：rm -fr、rm -r -f、rm -Rf、rm -r 在手动、auto、bypass 三种模式下都照删不误，/bin/rm、find -delete、bash -c 在手动和 bypass 模式下也能删。auto 模式下，工作目录内的 rm -fr 会被当成「acceptEdits 也会放行」的操作，连分类器都不过。另一道闸是内置的 dangerous-rm 检查，目标是 $D/* 这类变量展开时触发，bypass 模式也拦；多行命令里前面有 heredoc，它就跟不上同一条命令里的变量赋值。文末给出一个 PreToolUse hook，三种模式下补齐全部递归删除写法，并告诉模型被拒后该怎么做。
claude-codehooks+5
pitfalls2026年10月21日7 min
401左脚踩右脚的上升飞轮，没那么容易实现
给一个日更公众号做了 40 天「LLM 提案 + 代码判定」的自动调优循环：18 个版本、8 次回滚，其中 3 次回滚掉的是人拍板的决定，还有一个旋钮与父版本完全相同的版本也被判了回滚。按真实数据算，每个版本要攒约 2.5 万阅读才分得出 20% 的差异，日均 60 阅读的小号要跑 400 天。本文复盘飞轮转不起来的五个原因，以及真正起作用的是什么。
公众号复盘+4
pitfalls2026年10月21日7 min
111Claude Code 接 DeepSeek / GLM / Kimi 开 auto 模式：temporarily unavailable 括号里的原因怎么看，哪些重试没用（故障注入实测）
用第三方模型跑 Claude Code auto 模式，每个有副作用的动作都会用你的会话模型向同一个后端多发一次判定请求：系统提示词 132,470 字符，单次约 2.97 万输入 token，比主循环那一步还多。判定请求一失败，就出现「xxx is temporarily unavailable, so auto mode cannot determine the safety of Bash」。本文用故障注入代理把每种失败对应的报错原文测了一遍：500 → (server error)、429 → (rate-limited)、529 → (overloaded)、断连 → (connection failed)，这几种会自动重试 5 次；超过 60 秒没回 → (timed out)；**没有括号 = 后端拒收（4xx），只试 1 次，重试多少遍都一样**；后端回了但模型没给判定 → could not evaluate，连续 3 次就退回人工确认。另外实测 CLAUDE_CODE_AUTO_MODE_MODEL 不生效，判定器只能跟着会话模型换。Claude Code 2.1.285，真实后端 DeepSeek v4-pro 与小米 MiMo v2.5。
claude-codedeepseek+7
pitfalls2026年10月11日11 min
892LM Studio 速度慢怎么办：Mac 实测首字等 39 秒的真正原因是 prompt 预填充，不是 GPU 没开满
在 24GB M4 Mac mini 上用 LM Studio 跑 gemma-4-e4b（Q4_K_M）实测：生成速度约 29.5 tok/s，GPU offload 从全开调到全关只慢 11%；真正让人觉得慢的是长 prompt 的预填充——1.3 万 token 的 prompt 要等 39.4 秒才出第一个字（约 330 token/s），全 CPU 时还要再慢 3.4~3.7 倍。相同前缀的第二次请求首字只要 0.1 秒（前缀缓存）。--parallel 4 时同时来 4 个请求，每个只剩 9.7 tok/s。
mac-mini本地大模型+5
pitfalls2026年10月5日7 min
529Ollama 显存不足怎么办：24GB Mac 实测 num_ctx、并发、KV 量化各吃多少内存，以及它不会拦你的那个坑
24GB 的 M4 Mac mini，Ollama 0.19 只认到 17.8 GiB 显存，默认上下文只给 4096。实测 qwen3:4b：上下文从 4k 开到 32k，占用从 3.73GB 涨到 9.89GB；OLLAMA_NUM_PARALLEL=4 时 8k 上下文占用等于单路 32k，但 ollama ps 只显示 8192；开 Flash Attention + q4_0 KV 量化后 32k 只要 4.31GB、64k 只要 5.77GB，速度不变。上下文开到远超内存时 Ollama 不会提前拒绝，而是直接开始分配，16 秒内系统可用内存掉到 23%。全部挪到 CPU 只慢 25%。
mac-mini本地大模型+5
pitfalls2026年10月5日7 min
529Claude Code 上下文太长怎么办：Prompt is too long 会自动压缩，中转站 / DeepSeek 的 maximum context length 却不会（实测）
Claude Code 靠报错文案判断「上下文太长」：后端说 prompt is too long 或 input is too long for requested model，它会自动压缩对话后重发，用户无感；DeepSeek 和 OpenAI 风格中转返回的 This model's maximum context length is …，它不认识，直接报 API Error: 400，每轮都失败。手动 /compact 有效；更好的办法是用 CLAUDE_CODE_MAX_CONTEXT_TOKENS（非 claude- 模型 ID）或 CLAUDE_CODE_AUTO_COMPACT_WINDOW（claude- 模型 ID）告诉它真实上限，让它提前压缩。Claude Code 2.1.285 + 本地 stub 实测。
claude-codedeepseek+6
pitfalls2026年10月5日8 min
951Claude Code 一直卡住、转圈没反应怎么办：后端不回时它要等 6 分钟，重试满 10 次可能卡一个多小时（实测）
Claude Code 转圈不动、或者停在 Retrying in 0s，多半是后端没有回数据。实测 2.1.285（API key + ANTHROPIC_BASE_URL）：后端不回响应头时每次等 6 分钟（360 秒）才判超时，把 API_TIMEOUT_MS 调到 60 万、90 万也不变，只能调小；默认重试 10 次，总共可能卡一个多小时。中转站如果把回复缓冲到生成完才返回，超过 6 分钟的回复永远拿不到。按 Esc 可以随时中断。全部在本地 stub 上实测。
claude-code中转站+6
pitfalls2026年10月5日10 min
834Claude Code 429 怎么办：Request rejected (429) 原文、会重试多久、retry-after 超过 60 秒直接放弃（实测）
Claude Code 遇到 429 会先自动重试，最多 10 次、约 3 分钟。retry-after 不超过 60 秒时会等满再试（实测 10 秒、60 秒都恢复成功），61 秒及以上一次都不重试，立刻报 API Error: Request rejected (429)。中转站（new-api）的中文限流提示会原样显示，空 body 显示 status code (no body)。交互模式下每句话会同时发 2 个请求，限流额度消耗也是 2 倍。全部在本地 stub 上实测，Claude Code 2.1.285。
claude-code中转站+5
pitfalls2026年10月4日9 min
578Clash Verge 开了 TUN 虚拟网卡反而上不了网：Hysteria2 流量绕回 TUN 自己，Tailscale 又把 DNS 截走了
macOS 上的 Clash Verge Rev 2.5.6，系统代理模式一切正常，一打开 TUN（虚拟网卡）就连百度都打不开。直接连 mihomo 内核的 API 排查，发现是两个独立的根因叠在一起：一是 Hysteria2 节点的 UDP 出站没有绑定到物理网卡，被 TUN 路由吸回自己，形成回环；二是系统 DNS 被 Tailscale MagicDNS（100.100.100.100）接管，查询走 Tailscale 的 utun，Clash 的 dns-hijack 拦不到，拿回来的是被污染的 IP。修法只需两段 Merge 覆写：route-exclude-address 把节点 IP 排除出 TUN，再打开 sniffer 从 SNI 还原域名。文中每一步都附复现命令和实测输出。
故障排查tailscale+7
pitfalls2026年10月4日6 min
200
Claude Code MCP 显示 Connected 却 0 个工具：Invalid result for tools/list（ttlMs / cacheScope）实测与修法
MCP server 显示已连接、工具数却是 0，日志里是 Invalid result for tools/list，ttlMs 与 cacheScope 校验失败。用自写 stub 在 Claude Code 2.1.280 / 2.1.285 / 2.1.288 上复现：根因不是「多了未知字段被严格校验拒掉」，而是 server 协商到 MCP 2026-07-28 后漏了这一版的必填字段（resultType、ttlMs、cacheScope），多加未知字段反而能正常通过。stdio 是否走新协议由一个默认关闭的远程开关决定，所以同一个版本有人中招、有人没事；2.1.280 打开协商后同样失败。用户侧设 MCP_PROTOCOL_NEGOTIATION=legacy（settings.json 的 env 也行）立即恢复，server 侧补上三个字段即可。
mcpclaude-code+4
pitfalls2026年10月3日7 min
237
Claude Code 安装失败实测：npm EACCES、镜像卡 600 秒、Node 20 静默装旧版、install.sh 返回地区拦截页、原生安装器顺手卸掉 npm 版——15 条报错原文与解法
在 macOS 上把 claude code 安装的失败面逐个真实复现，共 15 条报错原文，全部带墙钟和 exit code。npm 全局装到 /usr/local：EACCES，exit 243。cache 目录只是 0555，npm 却报 root-owned 并建议 sudo chown。本机 npmmirror 两次分别用了 147 秒、超过 600 秒，官方源两次都在 11–12 秒（仅 2 个样本）。Node 20 不钉版本号会静默装到 2.1.197，没有任何警告。境内直连 claude.ai/install.sh 时 curl exit 0，拿到的却是一张 447KB 的地区拦截页 HTML。原生安装器会调用 npm uninstall -g，把已有的 npm 版删掉，终端里不提示——本次实测真的删掉了本机的全局安装。
claude-codenodejs+6
pitfalls2026年9月29日11 min
287
Claude Code「bash denied by auto mode」怎么办：被拦原因、could not evaluate 与 unavailable for this model 逐条实测
auto 模式下 Bash 被拦，常见的有三种提示：denied by auto mode、Auto mode could not evaluate this action、auto mode unavailable for this model。本文在 Claude Code 2.1.280 上跑了 40 多次真实会话。结论：denied 是分类器判定你的命令越权，最常见的理由是 [Code from External]，也就是执行了你没有点名的外部代码，重试没用，要么在 prompt 里点名来源，要么在用户级 settings 的 autoMode.environment 里声明信任；could not evaluate 是分类器没给出可解析的结论；unavailable for this model 是模型比 claude-opus-4-6 旧，claude -p 下会被静默降级、只在 debug 日志里留一行 WARN。另外，2.1.280 的判定已经改到服务端，随主请求一起返回。经过「只允许 Claude Code 客户端」的中转网关时，本地兜底的分类器请求会被 503 拒绝，这就是「temporarily unavailable (server error)」的一个固定成因。
claude-codeauto-mode+4
pitfalls2026年9月27日9 min
822