この記事の目次
Claude Codeを使っていて何かうまくいかないとき、まず手がかりになるのがログファイルです。この記事では、エラーメッセージの種類ごとの原因や対処法には触れません。個別のエラー内容を調べたい場合はClaude Codeのエラー対処ガイドを参照してください。ここで扱うのは、ログという情報そのもの、つまりどこに保存されていて、どう読み、どのくらい残っているのかという扱い方です。
Claude Code エラーログの保存場所
保存先はOSによって異なり、Mac・Linuxではホームディレクトリ配下、Windowsではユーザープロファイル配下の.claudeフォルダに置かれていることが多いとされています。ただし正式な保存先はバージョンによって変わる可能性があるため、ご自身の環境で実際に確かめてみてください。
一般的に想定される保存先と、その存在を自分の手で確かめる方法を整理すると次のとおりです。
| OS | 想定される保存先 | 確認方法 |
|---|---|---|
| Mac / Linux | ホームディレクトリ配下の.claudeフォルダ内（例: ~/.claude/） |
ターミナルでls -la ~/.claudeを実行し、実際にフォルダが存在するか確認する |
| Windows | ユーザープロファイル配下の.claudeフォルダ内（例: %USERPROFILE%\.claude） |
エクスプローラーのアドレスバーに%USERPROFILE%\.claudeと入力して確認する |
OS別の保存場所
上の表は一般的に見られる配置の目安です。フォルダが存在しない、もしくは中身が空という場合の対処は、次の見出しでまとめて扱います。
見つからない場合の確認手順
想定した場所にフォルダが見当たらない場合は、隠しフォルダの表示設定を確認する、findコマンドで*.claude*のような名前のフォルダを検索する、といった手順で探すことができます。それでも見当たらない場合は、インストール方法（パッケージマネージャー経由かバイナリ配布かなど）によって配置が異なっている可能性があります。公式ドキュメント（code.claude.com/docs）の該当ページで、自分の導入方法に対応する記載を確認してください。
ログファイルの中身の読み方
ログファイルを開くだけなら、普段使っているテキストエディタで問題ありません。専用のビューアーは必須ではなく、まずはファイルをそのまま開いて全体の構造をざっと眺めるところから始められます。
ファイル形式については、jsonl形式（1行に1つのJSONオブジェクトが並ぶ形式）で書かれていると見られる情報がありますが、公式ドキュメントで明記された仕様としては確認できていません。会話履歴とツール実行の記録が同じファイルに混在しているのか別ファイルに分かれているのかも含め、詳細は公式ドキュメントで随時確認するのがよいでしょう。
開き方の基本
Mac・Linuxであればcatやlessコマンドで中身を表示できますし、Windowsであればメモ帳や任意のコードエディタで開けます。ファイルサイズが大きい場合は、VS Codeのようなコードエディタの方が行番号表示や検索がしやすく、読みやすいです。
会話履歴とツール実行記録の見分け方（要検証）
1行ごとにJSONが並ぶ形式であれば、roleやtypeといったキーの値を見ることで、ユーザーの発言、Claudeの応答、ツール実行の記録などを区別できる可能性があります。実際のファイルを開いて自分の目で構造をたどってみるのが早いです。
エラーが起きた行を絞り込んで探す方法
ログファイルが大きい場合は、テキストエディタの検索機能かターミナルのgrepコマンドを使うことで、目的の行にすばやくたどり着けます。どちらも一般的なファイル検索の方法であり、Claude Code特有の機能ではありません。
比較の軸を「向いている場面」と「具体的な操作」に絞ると、次のように使い分けられます。
| 方法 | 向いている場面 | 具体的な操作 |
|---|---|---|
| テキストエディタの検索機能 | 1つのファイルを目視しながら探したいとき | ログファイルを開き、MacはCmd+F、WindowsはCtrl+Fで検索窓を開いて検索語を入力する |
ターミナルのgrepコマンド |
複数のログファイルから一括で探したいとき | grep -i "error" ~/.claude/*のように検索語とファイルパスを指定して実行する（ファイルがjsonl形式であれば*.jsonlのように拡張子で絞り込むこともできます） |
「error」という単語で絞り込めば必ず該当行が見つかるとは限りません。ログの構造上、エラー情報が別のキー名で記録されている可能性もあるため、まずはerrorやfailといった一般的な単語で試し、ヒットしなければファイル全体を目視で確認する、という順番で進めるのが現実的です。
作業を始める前に、次のチェックリストで手順を確認しておくと迷いにくくなります。
- 保存先フォルダの存在を確認した
- ログファイルをテキストエディタで開けた
- 検索機能で「error」などのキーワードを試した
- 見つかった行の前後の文脈を読んだ
- 機微情報が含まれていないか確認した（次の見出しで詳しく触れます）
エディタでの検索手順
検索窓に単語を入力すると、多くのエディタでは一致した行がハイライトされ、次候補への移動もキー操作でできます。行数が多いファイルでも、目的の単語を含む行だけを順番にたどれるので、まずはこの方法から試すのが手軽です。
コマンドラインでの検索手順
grepに-nオプションを加えると行番号も一緒に表示されるため、後でエディタを開いて該当箇所にジャンプする際に役立ちます。ファイル名やパスの部分は環境によって異なるので、実際に存在するファイル名に置き換えて実行してください。
ログの保存期間の考え方
保存期間について、自動削除の仕組みがあるのか、何日分が残るのかという点は、現時点で公式情報として確認できていません。数字を推測で示すことは避け、確認できる情報源を自分で探す方法を紹介します。
確認できる公式情報の探し方
公式ドキュメントのFAQやトラブルシューティングの章に、保存期間の記載がないか探すのが最初の一歩です。記載が見つからなければ、現時点で確認できる情報はそこまでと考えてよいでしょう。
自分で控えを取っておく方法
保存期間が不明な以上、あとで見返したい重要なログは自分でコピーを別フォルダに残しておくと、あとで慌てずに済みます。エラーが起きた直後に該当ファイルを別名で保存しておけば、元のログが後で消えていたとしても手元に記録が残ります。
ログを詳しく出力する方法
デフォルトのログだけでは原因の特定に情報が足りない、という場面もあります。Claude Codeには、起動時のオプションや環境変数によって出力を詳しくできる仕組みがあると見られます。具体的なオプション名や挙動はバージョンによって異なるため、claude --helpで実際に用意されているログ関連のオプションを確認するのが手堅い方法です。
加えて、動作の細かな設定はsettings.jsonで管理されている部分もあるため、詳しく知りたい場合は設定ファイルの使い方ガイドもあわせて確認すると理解が深まります。
エラー報告でログを共有するときの注意点
ログをそのまま人に見せる前に、APIキーやファイルパス、社内の固有名詞といった機微な情報が含まれていないか必ず確認してください。ログには作業内容がそのまま記録されるため、意図せず見せたくない情報まで含まれていることがあります。
具体的には、共有前に該当箇所を黒塗りやマスクで隠す、キー情報らしき文字列を検索して除去する、といった作業を挟むのが安全です。特に法人での利用や企業のプロジェクトに関わるログの場合、社外のサポート窓口やコミュニティに投稿する前に、社内のセキュリティ方針に沿って確認する手順を踏んでおきましょう。組織での利用にあたるセキュリティ上の論点をさらに詳しく知りたい方は、Claude Codeの法人利用向けセキュリティガイドも参考になります。
まとめ
ここまで、ログファイルの保存場所を確認する方法、中身の読み方、エラー行の探し方、保存期間の調べ方、詳細出力の設定、そして共有時の注意点という順で見てきました。どの項目についても、公式ドキュメントと自分の手元の環境を照らし合わせながら判断していくことになります。
個別のエラーメッセージの原因や対処法を知りたい方はClaude Codeのエラー対処ガイドへ、CLIの基本操作から見直したい方はClaude Codeの使い方ガイドへ進んでみてください。
ログを読めるようになったあとは、日々の運用ルールづくりやトラブル対応の勘所といった、独学だけでは時間がかかりやすい部分も出てきます。そうした実践的な知識を、生成AIツールを使う仲間と一緒に積み上げていきたい方には、月額1,980円から参加できる学習コミュニティ「AI駆動ラボ」も選択肢のひとつです。自分の手でClaude Codeを使いこなせるようになるための場として、興味があれば覗いてみてください。