取り組みの背景：/insights コマンドとは
Claude Code には、あまり知られていながら強力なコマンドがあります。/insights コマンドは、自分のローカルセッション履歴を分析し、コーディング習慣・繰り返しパターン・非効率なワークフローを可視化するインタラクティブな HTML レポートを生成するツールです。
2026年2月に Anthropic のエンジニア Thariq Shihipar によって発表されたこの機能は、外部サーバーへのデータ送信を一切行わず、すでにマシン上に保存されているセッションデータのみを使用します。プライバシーへの配慮と実用性を両立した、個人開発者にとって嬉しい設計です。
/insights コマンドの起動方法
必要な環境
/insights コマンドを利用するには、Claude Code が最新バージョンにアップデートされている必要があります。ターミナルで以下を実行してバージョンを確認してください。
# Claude Code のバージョン確認
claude --version
# 最新バージョンへのアップデート
npm update -g @anthropic-ai/claude-codeコマンドの実行
Claude Code セッションを開始した状態で、/insights と入力するだけです。
> /insights
コマンドを実行すると、Claude Code は過去 30 日間のセッション履歴を読み込み、分析を開始します。セッション数やデータ量によっては数秒から数十秒かかることがあります。
分析が完了すると、インタラクティブな HTML ファイルが自動的に生成され、ブラウザで開くよう促されます。ファイルは通常、~/.claude/insights/ 配下に保存されます。
# 生成されたレポートの場所を確認
ls ~/.claude/insights/
# → insights-2026-04-04.html などのファイルが確認できます/insights レポートの読み方：6つの主要分析指標
生成された HTML レポートには、以下のような詳細な分析情報が含まれています。
1. セッション統計の概要
レポートの冒頭には、分析期間全体のサマリーが表示されます。
- 総セッション数：過去 30 日間に Claude Code を起動した回数
- 平均セッション時間：1 セッションあたりの平均作業時間
- 総会話ターン数：Claude とやり取りした合計メッセージ数
- 最も活動的な時間帯：どの時間帯に最も多く使用しているか
この統計を見ることで、自分のコーディングリズムを客観的に把握できます。
2. よく使う機能・コマンドのランキング
/help、/clear、/project などのスラッシュコマンドや、ファイル参照 @ファイル名、サブエージェント呼び出しなど、自分がよく使う機能が頻度順にランキング表示されます。
「使っているつもりでいたが実は使っていなかった機能」や、「もっと効率的な代替コマンドがある操作」を発見するきっかけになります。
3. 繰り返しパターンの検出
Claude Code は、似たような操作や指示を繰り返していないかを自動的に検出します。たとえば、
- 毎回同じようなコード修正を依頼している
- 特定のエラーメッセージを頻繁に貼り付けている
- 同じファイルを何度も参照させている
こうした繰り返しパターンが検出された場合、CLAUDE.md へのルール追加や、カスタムスラッシュコマンドの作成で自動化できる可能性があります。
4. フリクションポイントの特定
作業の流れが滞りやすい箇所（フリクションポイント）を特定します。たとえば、
- Claude からの回答を何度も修正依頼している箇所
- 長い会話の途中でコンテキストが失われている箇所
- エラーの修正に複数ターンかかっているパターン
これらを把握することで、最初のプロンプトの改善や、CLAUDE.md への補足情報追記など、根本的な改善施策を検討できます。
5. 会話の長さとコンテキスト使用傾向
セッションごとの会話の長さ分布と、コンテキストウィンドウの使用率が可視化されます。
- 短いセッション（〜5 ターン）：タスクが明確で効率的
- 長いセッション（50 ターン以上）：複雑なタスクか、指示が曖昧な可能性
- コンテキスト使用率が高い：
/compactコマンドの活用や、セッション分割を検討
6. Claude への指示スタイルの分析
自分がよく使う表現・指示パターンが分析されます。「〜してください」「〜を修正して」「〜を確認して」など、Claude にどのような形式で依頼しているかを把握できます。
より効果的な指示の出し方（コード例を添付する、期待する出力形式を明示するなど）を発見するヒントが得られます。
分析結果を活用した生産性改善の実践
/insights レポートを読むだけでは意味がありません。結果を実際の改善に活かしましょう。
CLAUDE.md への反映
繰り返しパターンやフリクションポイントが検出されたら、その内容を CLAUDE.md に追記します。
## コーディングスタイルと規約
- TypeScript の型定義は必ず interface で行う（type エイリアスは避ける）
- テストファイルは __tests__ ディレクトリに配置する
- コミットメッセージは「feat:」「fix:」「docs:」などのプレフィックスを付ける
## よくある作業パターン
- API エンドポイントを追加するときは必ず OpenAPI スキーマも更新する
- コンポーネントを作成する場合は、ストーリーブックのファイルも同時に作成するこうしたルールを事前に定義しておくことで、毎回同じ指示を繰り返す必要がなくなります。
カスタムスラッシュコマンドの作成
よく行う操作をスラッシュコマンドとして登録することで、コマンド 1 つで複雑なタスクを実行できます。
<!-- .claude/commands/refactor-component.md -->
---
name: refactor-component
description: Reactコンポーネントをベストプラクティスに沿ってリファクタリングする
---
以下の手順でコンポーネントをリファクタリングしてください：
1. Props に TypeScript 型定義を追加
2. 不要な state を削除または useCallback で最適化
3. アクセシビリティ属性（aria-label 等）を確認・追加
4. コンポーネントのテストを更新より体系的な Claude Code 生産性の向上については、Claude Code 並列エージェント開発マスターガイド も参考にしてください。
/resume コマンドとの組み合わせ
/insights で発見した改善点を活かしながら、Claude Code のセッション管理と /resume 活用ガイド を読んで、長いセッションをより効率的に継続する方法も合わせて学ぶことをお勧めします。
よくあるエラーと対処法
Q. /insights を実行してもレポートが生成されない
原因 1: セッション履歴が不足している Claude Code を使い始めたばかりで、履歴データが少ない場合は分析ができません。最低でも数回以上のセッションが必要です。
原因 2: 古いバージョンを使用している
claude --version でバージョンを確認し、npm update -g @anthropic-ai/claude-code でアップデートしてください。
原因 3: 権限の問題
# ~/.claude ディレクトリの権限を確認
ls -la ~/.claude/
# 必要に応じて権限を修正
chmod -R 755 ~/.claude/Q. レポートの内容が古い
/insights は実行時点から過去 30 日間を分析します。昨日や今日のセッションは反映されますが、30 日以上前のデータは含まれません。定期的に実行することで、最新の傾向を把握できます。
Q. セッションの一部が分析から除外されている
セッションのトランスクリプトが 30,000 文字を超える場合、25,000 文字ごとにチャンク分割されて要約が生成されます。特に長いセッションでは、詳細な分析ではなく要約レベルでの傾向把握になる点をご了承ください。
Q. 別のコンピューターのデータも含めたい
/insights はローカルのセッションデータのみを分析します。複数デバイス間でのデータ統合は現時点では非対応です。
/powerup コマンドとの使い分け
Claude Code には、/insights の他にも学習支援コマンドとして /powerup があります。2 つのコマンドの使い分けを整理しておきましょう。
/powerup は、Claude Code の機能を対話的に学ぶためのチュートリアルシステムです。アニメーションデモ付きの 18 のレッスンが用意されており、「Claude Code をこれから使いこなしたい」「特定の機能の使い方を知りたい」という場合に適しています。
/insights は、すでに Claude Code を使っている人が「自分の使い方の何を改善すべきか」を振り返るための分析ツールです。一定期間使用した後に実行することで、最大の効果が得られます。
理想的なワークフローとしては、
/powerupで Claude Code の機能を体系的に学ぶ- 実際に数週間使い続ける
/insightsで自分の使い方を分析し、改善点を把握する- 改善策を
CLAUDE.mdやカスタムコマンドに落とし込む - また数週間後に
/insightsを実行し、改善効果を確認する
というサイクルを回すと、継続的な生産性向上が見込めます。
まとめ
Claude Code の /insights コマンドは、自分のコーディング習慣を客観的に振り返り、無意識の非効率を発見するための強力なツールです。
レポートから得られる主な洞察をまとめると、
- 繰り返しているパターンを
CLAUDE.mdに明文化して自動化できる - フリクションポイントを特定してプロンプトの質を向上できる
- コンテキスト使用傾向を把握してセッション管理を最適化できる
- 自分の作業リズムを知ることで、より集中した開発時間を設計できる
まだ使っていない方は、ぜひ一度 Claude Code セッションで /insights を試してみてください。数週間分のデータが蓄積されている方ほど、発見が多いはずです。
さらに生産性を高めたい方には、Claude Code 並列エージェント開発マスターガイド で、ワークツリーとサブエージェントを組み合わせた高速開発手法も解説しています。