改完配置、升级客户端，或脚本跑失败之后，先别急着把整段会话日志贴出去。没有一份能对照的最小记录，下次升级就只能靠回忆，还容易把「耗时」和「版本」写成同一栏。
下面是依据 Claude Code 官方文档整理的记录方法，不是一次新的产品实测。
先记这些，再决定要不要深入日志
建议每次失败或对照实验时，单独留一行（或一张很小的表），至少分开记录：
- CLI 版本。Claude Code 可用
claude --version，官方安装文档写明它会打印版本号。 - 启动参数（脱敏）。例如有没有
--bare、--settings、--model，不要附带 Key 或助手脚本里的秘密值。 - 实际工作目录。自动化或管道启动时，cwd 不一定是你以为的项目根目录。
- 退出码，和墙钟耗时（秒）。这两项必须分栏：耗时不是版本号，版本也不是耗时。
- 错误码或原文摘要，以及请求时间。若能拿到请求 ID，一并记下。
- 认证方式只记类型，例如「订阅登录」或「API Key 环境变量」，不要记录 Key、Cookie、Token 的值。
有对照才比较得了：同一条命令，升级前和升级后各留一行，差异才不会靠回忆。
不要为了求助打开完整正文日志
普通排错先留上面这些脱敏字段就够。Claude Code 官方监测文档说明：OTEL_LOG_RAW_API_BODIES 会发出完整的 Anthropic Messages API 请求和响应 JSON，正文包含整段对话历史；默认是关闭的。不要为了发帖求助随手打开，更不要把完整正文、Key 或会话记录贴到公开地方。
客户端或网关里显示的模型名，只反映客户端配置或报告，不能单独证明实际上游。经过第三方网关时，应交叉核对网关与上游可获得的记录；证据不够就写「尚未核实」。问模型「你是谁」不能代替路由验证。
记完再做最小验证
记录之后，用一个最短请求验证，而不是让 Agent 围着同一条报错反复重试。需要看设置来源时，在会话里用 /status 看 Setting sources，再用 claude doctor 查看被跳过的设置。这些步骤在上一篇配置来源教程里展开过，这里只强调：先有可对照的记录，再决定要不要改文件或换凭据。
披露：我维护 QuickRouter。本文依据 Claude Code 官方文档整理最小排错记录方法，不是一次新的产品实测，也不保证所有第三方网关行为相同。一切以你的控制台与当前官方文档为准。
官方来源：
- 版本核对：https://code.claude.com/docs/en/setup
- 监测与原始 API 正文日志：https://code.claude.com/docs/en/monitoring-usage
- 设置来源与
/status：https://code.claude.com/docs/en/settings