开发者基于 Claude Code 官方文档分享最小排错记录方法

2026 年 11 月 11 日，开发者在 DEV Community 的 AI 栏目发文，介绍了一种基于 Claude Code 官方文档的排错最小记录方法，并强调这并非一次新的产品实测，只是对官方文档的整理。

作者的建议是：每当改完配置、升级客户端或脚本运行失败后，先不要急着把整段会话日志贴出去，而应在每次失败或对照实验时单独留一行或一张很小的表，至少分开记录若干脱敏字段，包括：用 claude --version 打印的 CLI 版本；脱敏后的启动参数，例如是否带有 --bare、--settings、--model，但不附带 Key 或助手脚本里的秘密值；实际工作目录，因为自动化或管道启动时 cwd 不一定就是你以为的项目根目录；分开记录的退出码与墙钟耗时（秒），作者特别提醒耗时和版本号不能写在同一栏，耗时不是版本号，版本也不是耗时；错误码或原文摘要，以及请求时间，若能拿到请求 ID 则一并记下；认证方式只记类型，例如订阅登录或 API Key 环境变量，不要记录 Key、Cookie、Token 的值。此外，作者建议对同一条命令在升级前和升级后各留一行记录，这样差异才不会靠回忆来填补。

文章末尾同时提醒注意一个日志开关的状态：据 Claude Code 官方监测文档，OTEL_LOG_RAW_API_BODIES 会发出完整的 Anthropic Messages API 请求和响应 JSON（原文片段到此中断，后文未给出）。文中未说明该选项的默认状态，也未给出开启或关闭的完整命令。