Cover image for Claude Code Team Memory: CLAUDE.md, Git, or MCP?

Seiji Nakaya

チームがClaude Codeエージェントに決定事項や文脈を記憶させたい場合、3つのツールが候補に挙がります:CLAUDE.mdファイル、Git自体、そしてMCPメモリサーバーです。これらはしばしば競合関係にあると位置づけられますが、そうではありません — それぞれ異なるレイヤーをカバーしています。以下に境界を説明します。

CLAUDE.md:リポジトリごとの常設指示

CLAUDE.mdは、Claude Codeが自動的に読み込むファイルです。安定したリポジトリスコープの規約に適した場所です:コーディングスタイル、アーキテクチャノート、「テストはこのコマンドで実行する」「金額は整数セントで扱う」など。

得意なこと:めったに変わらない耐久性のあるルール;セットアップ不要;コードと一緒にバージョン管理される。

限界:静的でリポジトリ単位です。「今朝何を決めたか」という毎日変わる内容には向きませんし、リポジトリをまたがることも、エージェントが決定したその瞬間に記録することもできません。また、2つのエージェントが同時に同じファイルを編集することを防ぐのにも役立ちません。

Git:コードの信頼できる情報源

Gitはすでにコードとその履歴を保存しており、コミットメッセージやPRでなぜ変更が起きたかを説明しています。一部のチームはこれを共有の「メモリ」として拡張しようとします — リポジトリにコミットされたMarkdown vaultやchangelogです。

得意なこと:コード自体の正規記録であり、続けるべきです。帰属と履歴は無料で手に入ります。

限界:ほとんどの調整文脈には添付するdiffがありません — 「このモジュールにはまだ触れないで」「Xに標準化する」「paymentsを誰が担当するか」。これをGitに押し込めば、調整がpull、merge、resolveが必要なファイルになります。まさに避けたいマージコンフリクトを再導入することになります。Gitはまたポーリングベースです:エージェントはfetchした後にしか更新を見られず、書かれた瞬間に見られるわけではありません。

MCPメモリ:コードを取り巻く作業文脈

MCPメモリサーバーは、エージェントがツールを通じてライブで読み書きできる小さな共有ストアを提供し、セッションやマシンをまたいで利用できます。MCPはAIアプリケーションを外部システムに接続するためのオープンスタンダードです。これはコミットには決して入らない決定や文脈のためのレイヤーであり、一部のツールではファイルクレームやタスクボードのような調整プリミティブも提供します。

得意なこと:エージェントが決定した瞬間に記録できる;別のマシン上の別のエージェントに接続時に提供できる;ベンダーニュートラル(Claude Code、Cursor、Codexなど任意のMCPクライアント)。

限界:コードストアではありません。Gitになろうとすべきではなく、良い実装はリポジトリのfetchやcloneを行いません。

境界を一行で

  • Gitコードの信頼できる情報源です。
  • CLAUDE.md安定したリポジトリごとの指示を保持します。
  • MCPメモリはコードを取り巻くライブでマシンをまたいだ決定と調整を保持します。

これらは組み合わせられます。コードはGitに、規約はCLAUDE.mdに、そして動きの速いチーム文脈 — 「v2を決めた」「carolがpaymentsを担当」「APIは凍結されたか?」 — を、すべてのエージェントが読み書きできる共有MCPレイヤーに置きます。

Vibsyncの位置づけ

VibsyncがそのMCPレイヤーです:永続的なチームメモリ(remember / recall)、非同期のエージェント間Q&A(ask / reply)、ファイルクレーム + タスク調整 — 単一エンドポイント、ベンダーニュートラル、独自モデル持ち込み対応。意図的にソースを読み込まず、Gitが信頼できる情報源であり続けます。あるエージェントが記録した決定は、別のマシンの新しいセッションに継承され、誰もcontextをコピー&ペーストする必要がありません。

チームが新しいClaude Codeセッションに同じ決定を何度も説明し直しているなら、それがこのレイヤーが埋めるギャップです。ベータ期間中は無料でお試しください — エージェントをmcp.vibsync.com/mcpに向けます。

開示:この比較はVibsyncチームによって書かれています。VibsyncはLOOSEDAYS Co., Ltd.によって構築されています。


元々はVibsyncブログで公開されました。

#### HASHNODE BODY (below; set fields from the comment)

チームがClaude Codeエージェントに決定事項や文脈を記憶させたい場合、3つのツールが候補に挙がります:CLAUDE.mdファイル、Git自体、そしてMCPメモリサーバーです。これらはしばしば競合関係にあると位置づけられますが、そうではありません — それぞれ異なるレイヤーをカバーしています。以下に境界を説明します。

CLAUDE.md:リポジトリごとの常設指示

CLAUDE.mdは、Claude Codeが自動的に読み込むファイルです。安定したリポジトリスコープの規約に適した場所です:コーディングスタイル、アーキテクチャノート、「テストはこのコマンドで実行する」「金額は整数セントで扱う」など。

得意なこと:めったに変わらない耐久性のあるルール;セットアップ不要;コードと一緒にバージョン管理される。

限界:静的でリポジトリ単位です。「今朝何を決めたか」という毎日変わる内容には向きませんし、リポジトリをまたがることも、エージェントが決定したその瞬間に記録することもできません。また、2つのエージェントが同時に同じファイルを編集することを防ぐのにも役立ちません。

Git:コードの信頼できる情報源

Gitはすでにコードとその履歴を保存しており、コミットメッセージやPRでなぜ変更が起きたかを説明しています。一部のチームはこれを共有の「メモリ」として拡張しようとします — リポジトリにコミットされたMarkdown vaultやchangelogです。

得意なこと:コード自体の正規記録であり、続けるべきです。帰属と履歴は無料で手に入ります。

限界:ほとんどの調整文脈には添付するdiffがありません — 「このモジュールにはまだ触れないで」「Xに標準化する」「paymentsを誰が担当するか」。これをGitに押し込めれば、調整がpull、merge、resolveが必要なファイルになります。まさに避けたいマージコンフリクトを再導入することになります。Gitはまたポーリングベースです:エージェントはfetchした後にしか更新を見られず、書かれた瞬間に見られるわけではありません。

MCPメモリ:コードを取り巻く作業文脈

MCPメモリサーバーは、エージェントがツールを通じてライブで読み書きできる小さな共有ストアを提供し、セッションやマシンをまたいで利用できます。MCPはAIアプリケーションを外部システムに接続するためのオープンスタンダードです。これはコミットには決して入らない決定や文脈のためのレイヤーであり、一部のツールではファイルクレームやタスクボードのような調整プリミティブも提供します。

得意なこと:エージェントが決定した瞬間に記録できる;別のマシン上の別のエージェントに接続時に提供できる;ベンダーニュートラル(Claude Code、Cursor、Codexなど任意のMCPクライアント)。

限界:コードストアではありません。Gitになろうとすべきではなく、良い実装はリポジトリのfetchやcloneを行いません。

境界を一行で

  • Gitコードの信頼できる情報源です。
  • CLAUDE.md安定したリポジトリごとの指示を保持します。
  • MCPメモリはコードを取り巻くライブでマシンをまたいだ決定と調整を保持します。

これらは組み合わせられます。コードはGitに、規約はCLAUDE.mdに、そして動きの速いチーム文脈 — 「v2を決めた」「carolがpaymentsを担当」「APIは凍結されたか?」 — を、すべてのエージェントが読み書きできる共有MCPレイヤーに置きます。

Vibsyncの位置づけ

VibsyncがそのMCPレイヤーです:永続的なチームメモリ(remember / recall)、非同期のエージェント間Q&A(ask / reply)、ファイルクレーム + タスク調整 — 単一エンドポイント、ベンダーニュートラル、独自モデル持ち込み対応。意図的にソースを読み込まず、Gitが信頼できる情報源であり続けます。あるエージェントが記録した決定は、別のマシンの新しいセッションに継承され、誰もcontextをコピー&ペーストする必要がありません。

チームが新しいClaude Codeセッションに同じ決定を何度も説明し直しているなら、それがこのレイヤーが埋めるギャップです。ベータ期間中は無料でお試しください — エージェントをmcp.vibsync.com/mcpに向けます。

開示:この比較はVibsyncチームによって書かれています。VibsyncはLOOSEDAYS Co., Ltd.によって構築されています。


元々はVibsyncブログで公開されました。