Claude Code /insightsで「AI活用のクセ」を見直す
Claude Codeを日々使っていると、「自分の使い方って効率的なのかな?」と気になることがある。なんとなく便利に使えている気はするけど、改善できる余地があるのかどうか、客観的に判断するのは難しい。
そんなときに試してほしいのが /insights コマンドだ。自分のClaude Code利用データをもとに、使い方の傾向や改善ポイントをレポートとして出力してくれる。開発における「ふりかえり」をAIの力で手軽に行える機能、という位置づけになる。
/insightsの基本:何が分かるのか
/insights を実行すると、ローカルに蓄積された利用データを解析して、以下のような情報をレポート形式で提示してくれる。
- 統計データ:メッセージ数、セッション数、ファイル変更数など
- うまくいっている点:よく使っている機能や効果的な行動パターン
- 阻害要因:会話の途中放棄が多い、ツール活用が少ないといった傾向
- 改善提案:次に試すべきアクションの候補
たとえば、ある利用者のレポートでは「約35日間で総メッセージ4,516、セッション1,042、ファイル変更6,267」といった数値が出たという事例がある。こうした数字を見ると、自分がどれくらいClaude Codeに頼っているか、どんなペースで作業しているかが可視化される。
ただし、数値が大きければ良いというわけではない。長時間のブラウザ自動化や探索的な試行錯誤が多いと、メトリクスが実態以上に膨らむこともある。あくまで「傾向を知るための材料」として捉えるのがポイントだ。
実際の使い方:3ステップで試せる
手順はシンプル。Claude Codeの対話中に /insights と入力するだけだ。
1. ターミナルでClaude Codeを起動
2. 対話画面で /insights と入力してEnter
3. レポートが生成されるのを待つ
生成されるレポートには、統計に加えて「何が機能しているか」「何が阻害要因になっているか」が言語化されている。たとえば「計画を立ててから並列実行するパターンがうまく機能している」とか、「会話を途中で放棄しているケースが多い」といった具合だ。
注意点として、/insights は比較的新しい機能のため、バージョンやプランによっては利用できない可能性がある。試す前に /help コマンドで一覧を確認しておくと確実だ。公式ドキュメントのスラッシュコマンド一覧には載っていないこともあるので、実際のCLI上で確認するのが間違いない。
レポートを「次の行動」に変換する
レポートを眺めて終わりでは意味がない。改善に繋げるには、以下のような流れで活用するのがおすすめだ。
1. 現状把握
まず /insights でレポートを出す。統計と評価コメントを一通り読んで、自分の利用傾向を把握する。
2. 阻害要因を1つだけ選ぶ レポートに複数の改善点が挙がっていても、一度に全部対処しようとしない。「会話を途中で放棄しがち」「ツールの活用が少ない」など、最も気になる1点に絞る。
3. 対策を1つだけ入れる 選んだ阻害要因に対して、具体的な行動を1つ決める。たとえば「放棄が多い」なら「1セッション1タスクに絞る」、「ツール活用が少ない」なら「カスタムコマンドを1つ追加してみる」など。
4. 次回の /insights で変化を確認
1〜2週間後にもう一度 /insights を実行して、数値や評価コメントがどう変わったかを見る。変化があれば成功、なければ別のアプローチを試す。
この「1つ選ぶ → 1つ試す → 確認する」のサイクルを回すのがコツだ。一気に変えようとすると、何が効いたのか分からなくなる。
数値の「読み方」には注意が必要
ここで大事な話を一つ。レポートに出てくる数値や評価を、そのまま鵜呑みにしないほうがいい。
たとえば「会話を途中で放棄している」と指摘されても、それが必ずしも悪いとは限らない。新しいアプローチを探索しているときは、試しては戻り、試しては戻りを繰り返すのが自然だ。その過程が「放棄」としてカウントされることもある。
また、ブラウザ自動化やCI連携など、長時間・高負荷なタスクを多くこなしていると、メッセージ数やセッション数が実態以上に膨らむ。「たくさん使っている=良い」わけでも「少ない=悪い」わけでもない。
重要なのは、数値を「自分の目的」に照らして解釈すること。効率化したいのか、学習のために試行錯誤したいのか、目的によって評価は変わる。
並列作業を増やす前に知っておきたいこと
/insights のレポートで「並列実行がうまくいっている」と出ると、「もっと並列でやれば効率上がるのでは?」と考えたくなる。ただ、ここには落とし穴がある。
複数のエージェントを同時に動かす運用は、以下のようなトラブルを招くことがある。
- ファイル変更が競合して、意図しない上書きが発生
- メモリ不足(OOM)でプロセスが落ちる
- ビルドやテストが途中で壊れる
対策としては、規模を抑える(同時実行数を絞る)、検証ゲートを挟む(lint、テスト、差分確認を都度行う)といった方法がある。並列化は効率の源泉にもなるが、リスク管理とセットで考える必要がある。
ふりかえりの習慣に組み込む
/insights は、週次や月次のふりかえりに取り入れると効果的だ。開発チームでスプリントレトロスペクティブをやっている人なら、個人版のふりかえりツールとして使える。
定期的にレポートを出して、「先月と比べて会話の放棄率は減ったか」「新しく試したカスタムコマンドは効いているか」をチェックする。数値の変化を追うことで、改善が実感できるようになる。
AIツールは「使えば使うほど便利」というより、「使い方を調整するほど便利」になる。/insights は、その調整のヒントをくれる機能だと思って活用してみてほしい。