
Claude Codeが同じミスを繰り返す問題。「メモリ」ではなく「学習」で解くOSSが382スター
Claude Codeのメモリ機能を使っている人は多いと思います。でも「昨日と同じ修正を今日もした」という経験はないでしょうか。
この記事では、メモリとはまったく別のアプローチ——修正内容を「学習」に変えるOSSプラグイン「claude-smart」を紹介します。インストールから使い方、既存のagentmemoryとの違いまで解説します。
「記録」と「学習」はそもそも違う
Claude Codeの公式メモリ(`~/.claude/memory/`)は事実の記録です。「このプロジェクトはTypeScriptで書かれている」「テストにはVitestを使う」といった情報を保存して、次のセッションで参照します。
claude-smartはこれとは別の仕組みで動きます。修正のたびに「なぜその修正が必要だったか」を分析し、構造化されたルールとして抽出します。
たとえばインポートの順序を3回修正したとします。
メモリの場合、「インポート順序を修正した」という事実が3件記録されます。
claude-smartの場合、「このプロジェクトではインポート順序はA→B→Cの順にする」というルール1件に集約されます。
公式の説明では「修正がトランスクリプトの再生ではなく、構造化・重複除去されたルールになる」とされています。つまりメモリは過去の記録、claude-smartは過去から導き出したルールブックです。
インストールは1行で終わる
npx claude-smart installCodexユーザーの場合は `--host codex` オプションを付けます。
対応環境はApple Silicon macOS 14以降、Windows x64、Linux。Intel Macには対応していません。
インストール後にClaude Codeを再起動すれば準備完了です。セッションで修正が行われるたびに、自動的にルール抽出が動きます。
3種類のデータが自動で分かれる
claude-smartは学習内容を3つのカテゴリに自動分類します。
プリファレンス: 作業スタイルの好み(使うフォーマッタ、コミュニケーション方針など)
プロジェクト固有スキル: そのプロジェクトでだけ適用するルール
共有スキル: 複数プロジェクトに転用できるパターン
プロジェクト固有のルール(「このリポジトリではセミコロンを付けない」)と、汎用的なパターン(「テスト名はitではなくtestで始める」)が自動で分離されます。プロジェクトを跨いだ汚染が起きにくい設計です。
データはすべてローカルのSQLite(`~/.reflexio/data/reflexio.db`)に保存されます。外部APIへの送信はありません。検索もONNX埋め込みモデルがローカルで動くので、オフラインでも機能します。ライセンスはApache 2.0です。
使い方はほぼ自動
基本的にはインストールするだけで自動学習が始まります。修正を明示的に学習させたい場合は、コマンドを使います。
/claude-smart:learn インポート順はreact→lib→localの順学習済みルールの一覧は `/claude-smart:show` で確認できます。ダッシュボード(`/claude-smart:dashboard`)をブラウザで開くと、蓄積されたルールを視覚的に把握できます。
学習が適用された回答には、末尾に引用表示が付きます。
✨ 2 claude-smart learnings applied [cs:s1-252,p1-5aed]どのルールが使われたか追跡できるので、意図しないルールが適用されていないかの確認も簡単です。
agentmemoryとの使い分け
agentmemoryはセッション間で記憶を持続させるツールです。claude-smartは修正からルールを抽出するツールです。
役割が違うので競合しません。agentmemoryでプロジェクトの事実(「DBはPostgreSQLを使っている」)を記録し、claude-smartで作業パターン(「マイグレーションは必ずdownも書く」)を学習させる——という併用が理想的な構成になります。
まとめ
Claude Codeが同じミスを繰り返すとき、それはメモリ不足ではなく学習不足かもしれません。claude-smartは`npx`一発でインストールでき、修正のたびにルールが蓄積されていきます。382スターのOSSプラグイン、試してみる価値はあります。
GitHub: ReflexioAI/claude-smart(Apache 2.0)
対応環境: Apple Silicon macOS 14+、Windows x64、Linux