Claude Code Bash 沙箱阻止预期命令 —— 排查与修复
Claude Code 反复对你已加白名单的命令弹窗。修法:模式末尾加通配符、拆开复合命令、检查新的 OS 沙箱回退。2026 年 6 月核对。
🤖 Claude Code 与 Agent 工作流问题
Agent 卡循环、误改文件、上下文断裂、多 Agent 冲突、回滚、Plan 模式问题。
Claude Code / Codex 等 Agent 工作流的问题往往不是"模型不够强"——多半是"上下文喂错了"或"权限给太大"。 这里按真实故障分类：Agent 死循环、改错文件、上下文断、Plan 模式跑偏、多 Agent 冲突、回滚不干净、改动太散。每篇文章对应一种症状 + 最短修复路径。
常见问题
- Claude Code 卡死循环——怎么破 上下文耗尽 + 没"完成"条件——重 frame + 重启。
- Claude Code 改错文件了 git restore 恢复 + 写明"不要碰"清单。
- Claude Code 中途丢了项目上下文 Summarization 后丢细节——重启 + 5 行摘要。
- Claude Code Plan 模式偏离计划 Plan 是指南不是合同——加"不许超 plan"约束。
- 多 Agent 冲突：两个 agent 改了同样文件 并行 agent 要分隔 scope——人工合并。
- Agent 回滚不彻底 回滚只覆盖代码——artifact / DB / 配置单独处理。
- Claude Code 因额度耗尽中途停下 5 小时 / 周上限 / Sonnet 周上限分别处理。
- Claude Code 不照你给的审计报告做 报告当 checklist 写、按编号执行。
- Claude Code 重构 scope 越做越大 Prompt 里写死 scope + 邻近问题"列出不修"。
- Claude Code 覆盖了你未提交的改动 Agent 跑前总 commit / stash——丢了查 Local History。
- Claude Code 不理解你的项目架构 CLAUDE.md 加"该 / 不该"对照例子。
- Claude Code 反复问不必要的问题 给默认值——只为破坏性操作停下。
- Claude Code 部分执行后卡死 保存状态 + 新对话续——别和卡住的硬磕。
- Claude Code 输出与原 prompt 不符 让 agent 先复述任务再执行。
- Claude Code 跳过失败的测试 禁止 skip / xit；测试改要独立 commit。
- Claude Code 误把密钥提交到 git 立刻 rotate；禁止 git add .；CI 加 secret scan。
- Claude Code 写了一堆没用的 helper CR 砍未调用导出；helper 需 ≥ 2 处调用才合并。
本主题文章
Claude Code 不加载项目 CLAUDE.md(2026 修复)
Claude Code 启动后忽略你的项目 CLAUDE.md。运行 /memory 看清到底加载了什么,修正路径/大小写,几分钟内定位根因。
Claude Code hook 莫名其妙拦下 Edit
PreToolUse hook 不停拒掉 Edit、连安全修改也拦。根因几乎都是 exit code 2 的逻辑、deny JSON 格式、stdin 解析、或者 matcher 范围。
Claude Code MCP 调用反复超时（或卡住）
Claude Code 里的 MCP 工具调用超时或卡死，可是直接 curl 又能通。多半是 stdio 往 stdout 打了脏数据、搞错了启动超时和工具超时、initialize 没回、或者代理把 SSE 缓冲住了。修复方法 2026 年 6 月已核实。
Claude Code 输出被上下文截断
Claude Code 长回复半句话被切掉。最快的办法：让它「从最后一句继续」。真正的原因多半是 auto-compact、单轮输出上限、或者某次工具输出把预算吃光了。
Claude Code 会话恢复后丢失先前工作记忆 —— 排查与修复
恢复 Claude Code 会话却像全新开始 —— 计划没了、决定没了、未完成的重构也没了。从压缩、对话链断裂、临时工具结果三方面定位并修复。
Claude Code settings.json 改了不生效
改了 ~/.claude/settings.json 但 Claude Code 无视你的 hook、permission 或 env？先跑 /doctor。多半是 JSON 语法、scope 选错、或优先级被覆盖。
Claude Code Skill 没被发现或不会自动触发
你在 ~/.claude/skills/ 下加了 SKILL.md，/<name> 却说找不到，或者一直不自动触发。几分钟搞定路径、frontmatter、description 或 skill 预算问题。
Claude Code 状态栏脚本报错、空白或卡顿 —— 排查与修复
Claude Code 的 statusLine 报错、空白,或拖慢提示。修复 JSON-on-stdin 输入约定、缺失的 jq、退出码、缓慢的 git 调用,以及工作区信任。
Claude Code subagent 结果回传不到主会话
Task subagent 明明跑完了，主会话却什么都没显示、给个通用总结、或者硬说还在跑。几分钟修好 final message、输出过长、或路由的问题。
Claude Code 同一条命令反复问权限
明明给过 allow，Claude Code 还在反复弹同一个 Bash/Edit 提示。多半是 allow pattern 太窄、放错了 settings 范围，或者命令是复合命令——这里给出精确解法。
Claude Code 任务 token 预算过大
一个任务烧穿上下文窗口、重构到一半自动压缩、把 plan 弄丢——拆成小步、把读取丢给 sub-agent、状态落盘。
Claude Code Bash 工具卡死：修复挂起命令
dev server 或 curl 一直跑、Claude Code 卡在转圈。用 run_in_background、显式 timeout、再用 /tasks 杀掉卡住的 shell。2026 年 6 月实测。