Tech BlogAWSツール & 技術ブログ
メニュー

カテゴリ

AWS & AI ツール

タグ

Claude Code11AI10AWS6開発ツール5セキュリティ5効率化4S33CloudFront3プラグイン2Claude2API2チートシート2すべて見る →

Claude Codeの/insightsコマンドで、自分の使い方のクセを知る

AIClaude Code効率化CLAUDE.md開発ツール

はじめに

Claude Codeを毎日使っていると、こんなことを感じることはないでしょうか。

  • なんとなく同じような指示を毎回繰り返している気がする
  • Claudeの出力が微妙にズレていることがあるけど、原因がわからない
  • CLAUDE.mdを書いているけど、本当に効果的な指示になっているのか不安

こうしたモヤモヤを解消してくれるのが、Claude Codeに組み込まれている /insightsコマンドです。

過去のセッション履歴を分析し、自分の使い方の傾向、良い点、改善点をレポートとして出してくれます。しかも、改善提案はCLAUDE.mdにそのままコピペできる形式で提示されるので、分析して終わりではなく、すぐに精度向上のアクションにつなげられます。

/insightsコマンドとは

Claude Codeのセッション中に /insights と入力するだけで実行できるコマンドです。

過去のセッション履歴をClaude自身が振り返り、以下のような観点で分析レポートを生成してくれます。

  • 利用傾向 — どんなタスクに多く使っているか、セッションの長さや頻度
  • 良い点 — 効果的に使えているパターン、上手くいっている指示の出し方
  • 改善点 — 非効率なやり取り、繰り返し発生している問題、精度が落ちている箇所
  • 具体的な改善提案 — CLAUDE.mdに追加すべきルールや指示の提案

特徴的なのは、かなり詳細なレベルまでレポートしてくれることです。「もっとコンテキストを与えましょう」のような一般的なアドバイスではなく、自分の実際のセッション内容に基づいた具体的な指摘が返ってきます。

使い方

使い方は非常にシンプルです。

/insights

これだけです。Claude Codeのセッション中に入力すれば、過去のセッション履歴を分析して結果を返してくれます。

特別な設定やプラグインは不要で、Claude Codeの標準機能として使えます。

レポートに含まれる内容

/insightsが返してくれるレポートは、大きく以下のようなセクションで構成されています。

利用パターンの分析

自分がClaude Codeをどう使っているかの傾向を教えてくれます。

  • どのような種類のタスクに使うことが多いか（コード生成、デバッグ、リファクタリングなど）
  • セッションの長さや、やり取りの回数の傾向
  • よく使うツールやコマンドの傾向

これだけでも「自分はこういう使い方に偏っていたのか」という発見があります。

良い点のフィードバック

効果的に使えているパターンを具体的に指摘してくれます。

たとえば、「プロジェクトの構成をCLAUDE.mdで明確に伝えているため、ファイル探索の無駄が減っている」「コミット前にビルド確認を依頼するフローが定着している」といった、自分では意識していなかった良い習慣を言語化してくれることがあります。

改善点と具体的な提案

ここが/insightsの一番の価値です。

改善点は「こうすべき」という抽象的なアドバイスではなく、CLAUDE.mdにそのまま追記できる形式で提案してくれます。

たとえば、以下のようなイメージです。

## 提案: CLAUDE.mdに追加すべきルール

以下をCLAUDE.mdに追記することで、精度の向上が期待できます:

- テストコードを変更した場合は、必ず `npm run test` を実行して結果を確認すること
- コンポーネントの修正時は、関連するページでの表示確認も行うこと
- ...

このように、コピペして使える具体的なルール文として出力されるため、分析結果を即座にCLAUDE.mdに反映できます。レポートを読んで「なるほど」と思って終わりではなく、その場で改善を適用できるのが実用的です。

どんなときに使うと効果的か

Claudeの精度に「ん？」と思ったとき

一番のおすすめタイミングは、Claudeの出力精度に違和感を覚えたときです。

たとえば、こんな場面。

  • 指示した通りに動いてくれない場面が増えた
  • 以前はうまくいっていたのに、最近なんとなく噛み合わない
  • 毎回同じ補足説明をしている気がする

こうした「なんとなくの違和感」の原因が、/insightsのレポートで明確になることがあります。

自分の指示の出し方にクセがあるのか、CLAUDE.mdの記述が不十分なのか、あるいは特定のパターンでClaudeが誤解しやすい書き方をしているのか——セッション履歴に基づいて具体的に指摘してくれるので、原因の切り分けに役立ちます。

CLAUDE.mdを見直したいとき

CLAUDE.mdを最初に書いてからしばらく経つと、プロジェクトの状況が変わっていたり、新しい慣習が生まれていたりします。

/insightsを実行すると、現在のセッション傾向に基づいて今のCLAUDE.mdに足りていないルールを提案してくれるので、定期的なCLAUDE.mdのメンテナンスにも使えます。

定期的な振り返りとして

週に1回、あるいは月に1回など、定期的に/insightsを実行して自分の使い方を振り返るのも効果的です。

使い始めの頃と比べて傾向が変わっていたり、新しい改善ポイントが見つかったりします。Claude Codeの使い方は日々の中で無意識に変化していくものなので、定期的に客観視する機会があると、より効率的な使い方に近づけます。

実際に使ってみての所感

このブログの開発でも/insightsを試してみましたが、自分では気づいていなかった傾向を的確に指摘されたのが印象的でした。

「ここは良くできている」という点については、確かに意識的にやっていた部分もあれば、無意識にやっていたことを言語化してもらって「ああ、これは続けよう」と再認識できた部分もあります。

改善点については、言われてみれば確かにそうだと思うものが多く、CLAUDE.mdに反映した後のセッションでは実際にやり取りがスムーズになった実感があります。

特に、CLAUDE.mdにコピペできる形式で提案が出てくるのは本当に便利です。「分析はしたけど、具体的に何を書けばいいかわからない」という状態にならず、提案をそのまま貼り付けて、必要に応じて調整するだけで改善が完了します。

注意点

いくつか留意しておくべき点もあります。

セッション履歴が少ないと精度が下がる

/insightsは過去のセッション履歴を分析対象としているため、Claude Codeを使い始めたばかりの段階ではデータが少なく、あまり有意義なレポートが得られない可能性があります。ある程度使い込んでから試すのがおすすめです。

すべての提案を鵜呑みにしない

CLAUDE.mdへの追記提案は便利ですが、プロジェクトの事情を完全に理解した上での提案ではありません。提案内容を確認し、自分のプロジェクトに合っているかを判断した上で採用しましょう。

実行タイミング

/insightsの分析にはそれなりの時間がかかります。作業の合間や、1日の終わりなど、急いでいないタイミングで実行するのが良いでしょう。

まとめ

/insightsは、Claude Codeの使い方を客観的に振り返るためのセルフレビュー機能です。

  • 過去のセッションを分析し、利用傾向・良い点・改善点を詳細にレポートしてくれる
  • 改善提案はCLAUDE.mdにコピペできる形式で出力される
  • Claudeの精度に違和感を覚えたとき、CLAUDE.mdを見直したいときに特に有効
  • 定期的に実行することで、自分の使い方の変化に気づける

Claude Codeを使い込んでいる人ほど、自分の使い方にクセや偏りが生まれやすいものです。「最近Claudeの精度がイマイチだな」と感じたら、Claudeのせいにする前に、まず /insights を試してみてください。意外な発見があるかもしれません。

関連記事

← 記事一覧に戻る