本文へスキップ
ReviewRamble

週刊ブリーフ

AIのレビューを、あなたの受信箱に。

  • ツール、モデル、MCPサーバー、リポジトリの新しいレビュー(結論を最初に)
  • 変更があったときに再確認した価格と評価
  • 公開された新しい分析記事

モデル、エージェント、MCPサーバー、そして本当に時間をかける価値のあるツール。

週に1通です。配信停止は各メールのリンクからできます。 メールアドレスの利用について

分析 コーディング

Claude Code のメモリーか Markdown の wiki か:それぞれの守備範囲

執筆: ReviewRamble editors ·

Claude Code のメモリーは、モデルが読むメモの集まりであって、従わなければならないルールの集まりではありません。CLAUDE.md にはあなたの指示が、Auto Memory には Claude があなたについて学んだことが入りますが、どちらも操作を止めることはできません。保管し、出典を示し、検証したい情報源が増えてきたら、Markdown の wiki のほうが向いています。それを自動で埋める hooks は、最後に慎重に加える選択肢です。

この記事は、これらの層の境界線を引きます。Claude Code に関する記述はすべて Anthropic のメモリー、hooks、Agent SDK のドキュメントに基づき、wiki のパターンは Andrej Karpathy の LLM Wiki gist、自動化は claude-memory-compiler の README に基づいています。私たちはこれらの構成を自分で動かしてはいません。

CLAUDE.md:あなたが書く指示

CLAUDE.md はあなたが書く Markdown ファイルで、Claude Code がセッションの開始時に毎回読み込みます。プロジェクト内、ホームフォルダー、組織レベルのいずれにも置けて、@path インポートで他のファイルを最大 4 階層まで取り込めます。Anthropic は各ファイルを 200 行未満に保つよう勧めています。長いファイルはコンテキストを多く消費し、指示が守られにくくなるからです。特定の種類のファイルにだけ関係する指示のためには .claude/rules/ が用意されています。

Claude Codeのウェブサイトのスクリーンショット
Claude Codeの公式サイト

新しい同僚に渡す引き継ぎメモだと考えてください。ビルドコマンド、社内の書き方、誰も触ってはいけないフォルダー。増え続ける事実を積み上げる場所ではありません。

Auto Memory:Claude が自分のために残すメモ

Auto Memory はローカルセッションでは既定でオンです。Claude は作業しながら、あなたの訂正や好みをもとに自分用のメモを ~/.claude/projects/<project>/memory/ に書きます。MEMORY.md というファイルが 1 件につき 1 行でそれらを索引し、各メモは個別のトピックファイルに入ります。セッション開始時に読み込まれるのは MEMORY.md の最初の 200 行か 25KB の、先に達したほうまでだけです。トピックファイルは、Claude が必要だと判断したときに読まれます。

大事な点が 2 つあります。メモリーはマシンごとに保存されるので、別のコンピューターやクラウドのセッションには引き継がれません。そしてただの Markdown なので、/memory を開けば Claude があなたについて何を決めたかを読み、間違いを削除できます。プロジェクトごとに autoMemoryEnabled を false にすればオフにできます。

コンテキストは強制ではない

Anthropic のメモリーのページははっきり書いています。Claude は CLAUDE.md も Auto Memory も、強制される設定ではなくコンテキストとして扱います。「migrations フォルダーは絶対に削除しない」という一行は、モデルがたいてい従う助言にすぎません。2 つの指示が矛盾していれば、Claude はどちらかを恣意的に選ぶことがあるとドキュメントは警告しています。

操作を本当に止めるのは PreToolUse hook です。ツール呼び出しの前に実行され、終了コード 2 で終わるか、permissionDecision に deny を返すと、Claude Code はその呼び出しを止めます。だから分け方は単純です。好みはメモリーに、絶対に起きてはならないことは hook か権限設定に入れます。

wiki が引き継ぐところ

メモリーが答えるのは「自分はどう働きたいか」です。「この 40 本の論文、会議メモ、ベンダーのページには何が書かれていて、それぞれの主張はどこから来たのか」には向きません。それを担うのが Karpathy の LLM Wiki パターンで、2026 年 4 月に、自分のエージェントに貼り付けて使うアイデアファイルとして公開されました。

層は 3 つあります。raw/ フォルダーには情報源を置き、モデルは読むだけで決して書き換えないので、そこが常に正本になります。wiki/ フォルダーには、モデルが書いて維持する Markdown ページを置きます。要約、人物や概念のページ、比較などです。スキーマファイル、Claude Code なら CLAUDE.md が、構成と、情報源を追加する手順、質問に答える手順、整理する手順を定めます。2 つのファイルが全体を見通せるようにします。index.md は全ページをリンクと 1 行の要約付きで並べ、log.md は取り込み、問い合わせ、点検のたびに追記だけしていく記録です。

メモを信頼できる知識に変えるのは、この整理の工程です。Karpathy はこれを lint と呼びます。定期的に見直して、ページ間の矛盾、新しい情報源に置き換えられた主張、どこからもリンクされていないページ、独自のページに値する概念、欠けている相互参照を探します。新しい情報源が 1 つ入るだけで 10〜15 ページに手が入ることがある、と彼は書いています。

私たちのレビューのうち 2 つが、このパターンの実例です。claude-obsidian (3.8) は Karpathy の考えをもとに出典付きの Obsidian wiki を作り、計画と記録を伴う書き込みのおかげで信頼できる反面、導入には時間がかかります。OpenWiki (4.2) は同じ考え方をコードベースに当てはめ、コードが変わったときに自分の書いたどの文が古くなったかを追跡します。見知らぬリポジトリを一度だけ把握したいなら、Understand Anything (3.5) は代わりにナレッジグラフを作りますが、初回の実行でトークンを多く使います。

OpenWikiのウェブサイトのスクリーンショット
OpenWikiの公式サイト

wiki を自動で埋める hooks

次の段階は、手作業での整理をやめることです。claude-memory-compiler は Karpathy のパターンを、素材があなた自身の Claude Code セッションになるように作り替えています。SessionEnd hook がセッション終了時にトランスクリプトを取り込み、PreCompact hook が自動圧縮で途中が要約される前にもう一度取り込み、バックグラウンドのスクリプトがモデルに決定事項、学んだこと、落とし穴を日次ログへ抜き出させます。コンパイル工程がそのログを相互にリンクした概念記事に変え、SessionStart hook が次のセッションに索引を入れます。lint スクリプトは 7 種類の点検を行います。

よくできた循環ですが、README があまり触れていない現実的なリスクがあります。

  • hooks はシェルのコードを実行します。hook は Claude Code が自身の環境、つまりあなたのユーザーアカウントの権限で実行するコマンドです。セットアップの指示どおりに他人の .claude/settings.json をプロジェクトにコピーすれば、セッションが始まるたび、終わるたびにその人のスクリプトを実行することになります。先に読んでください。
  • トランスクリプトには秘密情報が含まれます。セッションのトランスクリプトには、そこを通ったものがすべて入っています。貼り付けたキー、Claude が読んだ .env ファイルの中身、ログに出ていた顧客データ。コンパイラーはその文章をモデルに送り、抜き出した内容を Markdown ファイルに書き込みます。README と AGENTS.md を読んだ限り、機密情報を伏せる工程はありません。
  • コンパイル工程は確認なしに書き込みます。AGENTS.md によると compile.py は permission_mode を acceptEdits にして動き、フォルダー内のすべてのファイル操作を自動で承認します。
  • 料金に関する主張は Anthropic のドキュメントと食い違います。README は Anthropic が "has clarified that personal use of the Claude Agent SDK is covered under your existing Claude subscription" と述べ、AGENTS.md は Claude Code の保存済み認証情報を使うので API キーは不要だとしています。出典は示されていません。Anthropic の Agent SDK の概要とクイックスタートは API キーを設定するよう指示し、事前の承認がない限り、サードパーティの開発者は SDK で作ったエージェントで claude.ai のログインやその利用枠を提供できないと明記しています。サブスクリプションの主張は未確認として扱い、API の利用料を見込んでください。プロジェクト自身の表では、日次ログ 1 件のコンパイルに $0.45〜$0.65 かかります。

リポジトリも若く、動きがありません。作成は 2026 年 4 月 6 日、コミットは 2 件、スターは約 1,300、ライセンスファイルはなく、コードを再利用する権利はどこにも示されていません。

RAG が必要になる魔法のサイズはない

ここで挙げた情報源はどれも閾値を示していますが、一致しません。Karpathy は、索引を読む方式は約 100 の情報源と数百ページ程度までならうまく機能し、それを超えたらきちんとした検索ツールを使うよう勧めています。コンパイラーの資料は、50〜500 記事なら索引を読むほうがベクトル検索より優れ、約 2,000 記事か 200 万トークンでハイブリッド検索が必要になるとしています。どちらも計測結果は示していません。

役に立つ数字は、あなた自身の数字です。答えがわかっている質問を 20 個用意し、数週間ごとに尋ねて、モデルがどのページを開いたか、正しい情報源を引用したかを記録してください。存在するページを答えが拾い損ねるようになったら、あるいは索引が 1 回のセッションに楽に収まらなくなったら、検索を加えます。その段階では、Supermemory (4.0) のようなホスト型メモリーや、Memory リファレンスサーバー (3.5) のようなローカルのグラフが別の選択肢になります。MemoryBase (3.2) は別の問題、つまり ChatGPT と Claude の間で会話の文脈を持ち運ぶ問題を解決するものです。

どの層がどの仕事をするか

層書くのは誰か用途操作を止められるか
CLAUDE.mdあなた作業の指示と社内ルールいいえ、コンテキストです
Auto MemoryClaude学習した好みと訂正いいえ、コンテキストです
PreToolUse hookあなた必ず守られるべきルールはい
LLM WikiClaude(あなたの情報源から)出所のわかる、整理された知識いいえ
トランスクリプト取り込み hooksスクリプト(自動)セッションから wiki を埋めるいいえ、しかもコードを実行します

段階的な導入

  1. まず CLAUDE.md から。いちばんよく繰り返す指示を書き、ファイルを 200 行未満に保ち、特定のファイルに関するルールは .claude/rules/ に移します。
  2. Auto Memory は動かしたまま、中身を読む。1〜2 週間ごとに /memory を開き、間違っているものや古いものを削除します。
  3. 厳格なルールは hooks に移す。破られたら困ることはすべて、文章ではなく PreToolUse hook か権限の拒否設定にします。
  4. wiki は手作業で始める。raw/、wiki/、index.md、log.md を作り、ルールを CLAUDE.md に書き、情報源を 1 つずつ取り込み、lint を定期的に実行します。
  5. 検索を加える前に計測する。テスト用の質問を保管し、それが外れ始めてから初めて検索を加えます。
  6. 取り込みの自動化は最後に、やるとしても。hook のスクリプトはすべて読み、wiki を共有フォルダーに置かず、ログに何が書かれるかを確認し、利用上限を設定した API キーを使います。

注意点:モデルが維持する wiki の質は、lint の点検と、あなたがその結果を読むかどうかで決まります。lint は矛盾を指摘できても、どちらが正しいかは判断できません。読み違えた情報源を自信たっぷりに要約したものは、正しい要約とまったく同じに見えます。raw/ を書き換えずに残しておくから検証できるのであって、それも誰かが実際に検証して初めて意味を持ちます。

結論:CLAUDE.md は冷蔵庫に貼るメモ、Auto Memory は同居人が覚えていく習慣、hook はドアの鍵、wiki は領収書付きの書類棚だと考えてください。ほとんどの人は今週中に最初の 3 つが必要で、書類棚は領収書がたまってからで十分です。全部を代わりに整理してくれるロボットは、そのコードを読み終えるまで待たせておけばいいのです。

ReviewRambleブリーフ

AIをレビュー。週に一度、あなたの受信箱に。

AI、ロボティクス、テックの重要な評価を、使うべきもの、避けるべきものとあわせてお届けします。誇張も、すべてを並べただけのまとめもありません。

モデル、エージェント、MCPサーバー、そして本当に時間をかける価値のあるツール。

週に1通です。配信停止は各メールのリンクからできます。 メールアドレスの利用について