改完 CLAUDE.md、装了插件或加了 hook 之后,行为突然不对,不必先连着换模型和 Key。官方排错入口是先开一局「关掉定制」的会话,看问题还在不在。下面依据 Claude Code 官方文档整理,不是一次新的产品实测。
先跑同一条最短复现:加上 --safe-mode
在项目目录启动:
claude --safe-mode 也可以设置 CLAUDE_CODE_SAFE_MODE。按官方说明,这一局会关掉 CLAUDE.md、skills、plugins、hooks、MCP、自定义命令和 agents、LSP 和自动记忆等定制。认证、模型选择、内置工具和权限仍按正常方式工作。
然后用同一条最短请求复现。若问题在 safe-mode 里消失,原因就落在被关掉的定制里。官方建议再检查上下文、MCP 和 hooks,逐项加回定位。它也可以用来判断,是不是某项定制触发了自动模型回退。
它和 --bare 不是一回事
--bare 是为了让脚本和 CI 少做自动发现、启动更快,会跳过 hooks、skills、自定义命令、subagents、已装插件、MCP、自动记忆和 CLAUDE.md;默认工具只保留 Bash、读文件和改文件。
--safe-mode 是排错模式:认证、模型、内置工具和权限保持正常,不要用 --bare 代替这步隔离。组织托管策略在 safe-mode 里仍然生效;托管的 plugins、skills、CLAUDE.md 和策略配置的 MCP 则不会加载。公司管理的客户端里,它并不是完全空白的环境。
若 safe-mode 下问题还在
官方下一步是换一份干净配置再试:新建空目录,设置 CLAUDE_CONFIG_DIR 指向新的配置目录,并加上 --setting-sources user,避免读入项目里的 .claude/settings.json、CLAUDE.md 和 .mcp.json。首次启动会再走一遍设置向导,说明干净目录已生效。
- 问题消失:原因在你的用户或项目配置。可把
~/.claude.json和~/.claude下的文件逐项拷回,看哪一项把问题带回来。 - 问题仍在:原因可能在这些配置之外。用
/status看托管设置,再检查环境变量,并对照官方 Troubleshooting。
不要把 claude --safe-mode 和终端里的 claude doctor、会话里的 /doctor 混成同一条命令。后两者是安装和设置体检;--safe-mode 是换启动方式来隔离定制。
披露: 我维护 QuickRouter。本文依据官方文档整理隔离步骤,不是一次新的产品实测。一切以你当前客户端与官方文档为准。
