はじめに
最近、開発支援ツールとして「Claude Code」を活用しているのですが、単なるコーディング支援にとどまらず、「どのようにAIを活用しているか」「どこに開発の摩擦（フリクション）があるか」を可視化する機能が非常に優秀みたいです。
「ClaudeCodeのレポート機能がイケてる」と聞いたので、Claude Codeのレポート機能（/insightsコマンドや管理者向けAPI）の活用方法について記載します。
/insights コマンド：個人の開発ワークフローを分析・改善
Claude Codeをターミナルで立ち上げ、/insights コマンドを実行すると、これまでのAIとのセッション履歴を分析し、詳細な「インサイトレポート」を自動生成してくれます。
レポートから得られる主なインサイト
レポートでは、単なるログではなく、定量的・定性的な分析結果が出力されます。
> /insights
<message>
Your shareable insights report is ready:
file://C:\Users\tazawa\.claude\usage-data\report-2026-07-10-233657.html
Want to dig into any section or try one of the suggestions?
</message>
レポートの実行結果例（サンプル）
実際に /insights を実行すると、以下のようなHTMLがダウンロードされます。
[What you're doing right] (上手くいっている点)
- コンポーネントのリファクタリングにおいて、明確で独立したタスク指示を出せています。
-
CLAUDE.mdを活用してプロジェクト全体のコーディング規約をAIに共有できている点は素晴らしいです。 -
/commitコマンドを使って、質の高いコミットメッセージを効率的に生成しています。
[What is costing you time] (時間を浪費している点)
- データベースのスキーマ変更に関するやり取りで、全体像が共有されないまま進んだため、不要な手戻りが数回発生しました。
-
api/users.tsの型エラーのデバッグに15ターン消費しました。関連するDTOファイルの型定義が不足していたため、AIが原因特定に苦戦しました。
[Recommendations] (改善提案)
- 💡 DB関連の変更を依頼する際は、最初に
/add schema.prismaのようにスキーマ全体をコンテキストに追加してください。 - 💡 型エラーの修正を依頼する前に、コンパイラのエラーログを直接プロンプトに貼り付けると解決が早まります。
- 💡
CLAUDE.mdに「プロジェクト標準のエラーハンドリング手法」を追記することで、AIからの提案精度がさらに向上します。
==================================================
- 基礎数値（Raw Numbers）: 実行したセッション数、メッセージ数、追加したコードの行数、変更したファイル数、コミット数など
- 上手くいっている点（What you're doing right）: 効果的に機能しているプロンプトのパターンや、スムーズに実装できたタスクの傾向
- 時間を浪費している点（What is costing you time）: AIがバグの根本原因を見失ってデバッグループに陥っている箇所など、開発のボトルネック
- 具体的な改善提案（Recommendations）: 「プレコミットフックを導入して自動でLintを走らせるべき」「事前にアーキテクチャのマップを渡した方が良い」といった、ワークフロー自体の改善案
活用メリット
開発メンバー自身に定期的に /insights を実行して振り返ってもらうことで、「AIに任せるべきタスク」と「人間が介入すべきタスク」の境界線が明確になります。
例えば「特定のコンポーネント修正でAIが何度もリトライしている」といった非効率なループを発見した場合、プロジェクトのルートディレクトリに配置する CLAUDE.md（Claude Code用の指示書）をアップデートして共通ルールを明確化するなど、チーム全体の生産性向上に繋げることができます。
おわりに
Claude Codeのレポート機能は、単なる作業記録ではなく「AIとのコラボレーションのパフォーマンスレビュー」を実施してくれる画期的な機能です。
AIエージェント時代において、ツールの力を最大限に引き出すためには「AIとの働き方の振り返り」が不可欠です。まだ試していない方は、ぜひ一度ターミナルで /insights と打ち込んでみてください。
参考（感謝）
- AIに聞きながら