Claude Code hook 莫名其妙拦下 Edit
PreToolUse hook 不停地拒掉 Edit、连安全的修改也拦。多半是 exit code 逻辑、stdin 解析、或者 matcher 范围出了问题。
🤖 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 MCP 调用反复超时
Claude Code 里的 MCP 工具调用（filesystem、GitHub、自定义）反复超时，可是直接 curl server 又能通。多半是 transport、stdio 帧、或者响应形态有问题。
Claude Code 输出被上下文截断
agent 长回复半句话被切掉，是上下文压力惹的祸。多半是 compaction、max_tokens 上限、或者某次工具输出把预算吃光了。
Claude Code settings.json 改了不生效
改了 ~/.claude/settings.json 或项目 .claude/settings.json，重启后 Claude Code 完全无视 hook、permissions、env。多半是 JSON 语法、scope 选错、或者优先级被覆盖。
Claude Code Skill 没被发现或不会自动触发
你在 ~/.claude/skills/ 下加了 Skill，/<name> 却说找不到，或者一直不自动触发。多半是 SKILL.md frontmatter、路径或 description 写得不够具体。
Claude Code subagent 结果回传不到主会话
Task/Agent subagent 跑完了，但主会话什么都没收到、或者总结对不上。多半是 final message 格式、上下文窗口、或者线程路由出了问题。
Claude Code Bash 沙箱阻止预期命令 —— 排查与修复
Claude Code 拒绝运行你已加白名单的命令,Bash 沙箱判定它不安全或未授权。从权限作用域、模式匹配、settings.json 配置三方面定位。
Claude Code 项目 CLAUDE.md 未加载到上下文 —— 排查与修复
Claude Code 启动后忽略你的项目 CLAUDE.md：规范、命令、说明都没到模型那里。从路径、作用域、合并优先级三方面定位问题。
Claude Code 会话恢复后丢失先前工作记忆 —— 排查与修复
恢复 Claude Code 会话却像全新开始 —— 计划没了、决定没了、未完成的重构也没了。从快照范围、压缩、记忆分层定位问题。
Claude Code 自定义状态栏脚本报错或卡顿 —— 排查与修复
Claude Code 状态栏报错、空白或让整个提示卡顿 —— 自定义脚本在静默失败。从退出码、输出格式、超时限制三方面定位。
Claude Code 权限提示陷入循环
明明给过 allow，每次 Bash、Edit、Read 都还在问——settings.json 范围错了、allowlist pattern 写得太窄，或者有 hook 在重复问。
Claude Code 任务 token 预算过大
单个任务烧 200K+ token、执行到一半撞上下文顶、被迫摘要——拆任务、用 sub-agent、收紧读取范围。
Claude Code 工具执行卡死无超时
Bash 命令永远跑、agent 永远等——没设超时一个挂死的进程就锁住整个 session。设超时、识别 hang、干净地 kill。