メインコンテンツへスキップ
見出し画像

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 install

    Codexユーザーの場合は `--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

     
     
    AI×開発の実験日記。Claude / Ollama / MLX を Mac で動かしたり自動化したり。SaaS勤務の30代、本業の合間に検証してnoteに書いてます。たまにやりすぎて寝不足。

    あなたへのおすすめ