启动参数看官方文档启用调试模式并可选择性过滤类别Syntax--debug [categories]示例claude --debug "api,mcp"全网调研整理典型场景调试 MCP server 连接失败或工具调用异常时,精准捕获 MCP 协议通信日志排查 API 调用超时或请求/响应异常,查看完整的 API 层诊断信息在 CI/headless 管道中用 -p 非交互模式运行时,诊断脚本化执行与交互模式的行为差异理解 Claude 工具调用顺序、context window 状态变化和 permission check 决策过程配合 --debug-file 持久化日志,用于附在 bug report 或与团队共享排查结果实用技巧用 ! 前缀排除噪音类别,如 --debug "api,mcp,!statsig" 可过滤掉 statsig 遥测日志用 --debug-file ./debug.log 隐式启用 debug 并写入文件,避免终端滚动丢失,也是 --debug 的等效开关--debug 输出到 stderr,可用 2>&1 | tee debug.log 同时展示并持久化,便于 diff 比对与 --verbose 区分:--debug 针对 API/MCP 层深度诊断,--verbose 是范围更广的一般详细日志调试初期不加 categories 先全量开启,确认日志方向后再用类别参数(如 "api" 或 "mcp")缩小范围常见坑不加 categories 时日志量极大,交互模式下严重干扰正常输出,建议加 categories 或重定向到文件categories 参数拼写错误时不报错,静默忽略无效类别,易误判为该类别确实无日志--debug 仅在启动时生效,无法在会话运行中动态切换或添加调试类别来源CLI reference - Claude Code DocsClaude Code: 10 CLI flags you probably aren't using - mager.coAdvanced Best Practices - Debugging Guide | SFEIR InstituteCLI Flags and Environment Variables - Debug and Configuration Flags | DeepWikiClaude Code Cheat Sheet 2026: Commands, Flags, Shortcuts - blakecrosley.com创建于v0.2.117最近更新v1.0.123变化次数2新增 1改进 1变化时间线(按版本倒序)改进v1.0.123· 2025/09/24 · 2025/09/24将 --debug 日志迁移到文件以便于查看和过滤新增v0.2.117· 2025/05/18 · 2025/05/18引入新的 debug 启动参数上一个--dangerously-skip-permissions回到命令字典下一个--disable-slash-commands