開發者基於 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（原文片段到此中斷，後文未給出）。文中未說明該選項的預設狀態，也未給出開啟或關閉的完整命令。