Claude Codeのセッションログ(.jsonl)をjqで読み解く：コスト・会話フロー・コンテキストの可視化

概要

Claude Codeの実行履歴が保存されるJSONLファイルをjqで解析し、トークン消費やコスト、コンテキスト注入の内訳を正確に把握するための技術ガイド。

詳細内容

Claude Codeのセッション履歴（~/.claude/projects/内に保存されるJSONLファイル）の内部構造を、jqコマンドを用いた実地検証に基づき詳解しています。主な内容は、1) 拡張思考（Thinking）によるメッセージ分割の挙動と、リクエストIDに基づいた重複排除の重要性。2) プロンプトキャッシュ（cache_read/cache_creation）が累積していく仕組みの可視化。3) `cost-state`行に含まれる、本体（Sonnet）とタイトル生成（Haiku）の混在コストの分離方法。4) ツール実行結果やコンテキスト注入（attachment）の構造特定です。単純な合算では誤差が生じやすいトークン数やコストを、生データから正しく抽出する具体的なフィルタリング手法を提示しています。

元記事を読む他のサマリーを見る