MemoryLake
すべての記事に戻る
Tutorial2026年10月27日·11 分で読了

コンテキストを失わずに Claude Projects を Claude Code へ移行する方法 (2026年版)

Claude プロジェクトは、多くの場合、思考が行われる場所です。Claude の動作に関する指示を設定し、仕様書やスタイルガイドをアップロードし、何週間もチャットを重ねて製品の仕様を固めてきました。現在は Claude Code で構築が行われており、そのプロジェクトがすでに知っているすべての情報から開始したいと考えるでしょう。

2026年現在、これには2つの方法があります。Anthropic は、既存の一部のプロジェクトを、Claude Code で最初にリリースされる新しいバージョンの Projects に移行し始めています。また、ターミナルで作業する場合、プロジェクトの指示、ファイル、決定事項を Claude Code が読み取るリポジトリに持ち込むという手動のルートもあります。

このガイドでは、Claude プロジェクトが保持するもの、Anthropic の移行で引き継がれる内容、各要素が Claude Code のどこに配置されるか、そしてロールアウトの対象外である場合やターミナルで作業する場合に手動で移行する方法について説明します。プロジェクトではなく会話自体を移行したい場合は、Claude のチャットを Claude Code に移行するためのガイドでその方法を解説しています。

Claude プロジェクトが保持するもの

Claude チャットのプロジェクトには4種類のコンテキストがあり、それぞれ異なる方法で保存されます。

プロジェクトの指示。 Anthropic のヘルプセンターによると、「Claude はプロジェクト内のすべてのチャットに対してこれらの指示を使用します」とされています。これらは、トーン、役割、ルールといった恒久的な指示(ブリーフ)です。

プロジェクトのナレッジ。 アップロードしたファイルです。「このスペースにアップロードしたものはすべて、そのプロジェクト内のすべてのチャットで使用されます」。有料プランでは、大規模なナレッジベースはリトリーバル(検索)に切り替わります。これについては、RAG モードでの Claude プロジェクトに関するガイドで説明しています。

プロジェクトのチャット。 プロジェクト内の会話です。ヘルプセンターには重要な注意書きがあります。「情報がプロジェクトのナレッジベースに追加されない限り、プロジェクト内のチャット間でコンテキストは共有されません」。

プロジェクトのメモリ。 「各プロジェクトには独自のメモリがあります」。プロジェクトで作業している間、Claude はプロジェクト外のチャットからのメモリとともにそのメモリを使用し、新しいメモリはプロジェクトに保存されます。

Claude Code に移行する場合、これらそれぞれに移行先が必要であり、その移行先は使用する Claude Code のバージョンによって異なります。

Claude Code がプロジェクトのコンテキストを保持する場所

claude.ai/code の新しい Projects において

Anthropic は、新しいバージョンのプロジェクトを「Claude Code を皮切りに段階的に」展開しています。ヘルプセンターの言葉を借りれば、「プロジェクトは一つの会話です。思いついたときに必要なことを伝えれば、Claude が作業をクラウドで実行される並列スレッドに分割します」。さらに、「すべてのスレッドは、プロジェクトのファイル、リポジトリ、指示、およびメモリから開始されます」と付け加えられています。

Claude Code のドキュメントには、そのコンテキストがどこに存在するか詳しく記載されています。

  • プロジェクトのメモリ: 「要件、決定事項、落とし穴など、Claude がプロジェクトについて保持するメモ。ファイルとして保存されます」。すべてのクラウドスレッドは、開始時にインデックスファイル MEMORY.md を読み取ります。
  • プロジェクトの指示: 「各新しいスレッドおよびプロジェクトの会話内の Claude に送信されるテキスト。最大 16,000 文字まで」。
  • リポジトリ、ファイル、および環境: すべてのスレッドがクローンするリポジトリ、読み取り可能なファイル、および実行されるクラウド環境。

新しい Projects は、claude.ai/code、デスクトップアプリ、および Claude モバイルアプリで利用可能です。ドキュメントの制限事項セクションには、「ターミナル CLI、VS Code 拡張機能、または JetBrains プラグイン」では利用できないと記されています。Claude Code Projects とプロジェクトメモリに関するガイドでは、移行後のメモリの仕組みについて解説しています。

自分のマシン上の Claude Code において

ターミナルでは、Claude Code はファイルからコンテキストを読み取ります。メモリのドキュメントには以下のスコープがリストされています。

  • プロジェクトの指示 (./CLAUDE.md): 「プロジェクトのチーム共有の指示」。ソース管理を通じてチームメンバーと共有されます。
  • ローカルの指示 (./CLAUDE.local.md): 「個人のプロジェクト固有の好み。.gitignore に追加します」。
  • ユーザーの指示 (~/.claude/CLAUDE.md): 「すべてのプロジェクトに適用される個人の好み」。
  • 自動メモリ (Auto memory): Claude が自身で書き込むもので、「ユーザーの好み、ユーザーからの修正、コードから導き出せないプロジェクトのコンテキスト」をカバーします。

リポジトリは、仕様書、アーキテクチャメモ、API リファレンスなど、コードに関するナレッジファイルを置く場所でもあります。Claude Code はタスクに応じてこれらを読み取ります。

Anthropic の移行によって引き継がれるもの

ヘルプセンターの既存プロジェクトに関するセクションでは、移行について次のように説明されています。「一部の Pro および Max ユーザーを対象に、既存のプロジェクトを新しいバージョンに移行し始めました。移行によって失われたり削除されたりするものはありません。指示、ファイル、完全なチャット履歴、スケジュールされたタスクなど、プロジェクト内のすべてが引き継がれます。中断したところからすぐに再開できます」。

これが自分に当てはまるかどうかは、さらに2つの文で決まります。「過去 30 日以内に既存のプロジェクトを使用した場合、プロジェクトを移行する前にメールでお知らせします」。そして、「チャットおよび Cowork 内の他の既存プロジェクトは、当面は現在のバージョンのまま維持され、ロールアウトの拡大に合わせて移行されます」。

Claude Code のドキュメントには、ロールアウトの別の側面が記載されています。アクセス権は「クラウドセッションを使用しており、claude.ai チャットまたは Cowork に既存のプロジェクトがないアカウントから開始」され、以前のプロジェクトは「再設計されたエクスペリエンスが適用されるまで、現在と同じように動作し続けます」。Projects の再設計に関するガイドでは、この計画が最初に発表された際の内容をカバーしています。

移行されるプロジェクトに含まれるリストには、指示、ファイル、チャット履歴、スケジュールされたタスクが挙げられています。プロジェクトのメモリについては明記されていないため、移行後はプロジェクトのメモリを開き、依存している情報が含まれているか確認してください。

移行だけでは解決しないこと

プロジェクトが移行されたとしても、いくつか意識的に行うべきことがあります。

チャット内にのみ存在する決定事項。 移行されたプロジェクトにはチャット履歴が含まれますが、新しいスレッドはプロジェクトのファイル、指示、およびメモリから開始されます。3週間前のチャットで到達した決定事項は履歴にはありますが、スレッドがその決定事項を反映して開始されるかどうかは、それがメモリまたは指示に到達したかどうかに依存します。

リポジトリのルール。 新しい Projects では、プロジェクトの指示と各リポジトリの CLAUDE.md が別々に保持されます。ドキュメントには、「ビルドコマンドなど、一つのリポジトリに関するルールは、そのリポジトリの CLAUDE.md に属します」とあります。クラウドスレッドはルートの CLAUDE.md を読み取りますが、「サブディレクトリ内の CLAUDE.md ファイルやパス固有のルールはロードされません」。

ターミナルでの作業。 新しい Projects はターミナル CLI では動作しません。そこで構築を行う場合、プロジェクトのコンテキストをリポジトリに反映させる必要があります。

多くの人が最初に試すこと

移行を待つ。 ロールアウトは段階的に行われており、Anthropic は他のプロジェクトは当面現在のバージョンのままであると述べています。

すべてのナレッジファイルをリポジトリにアップロードする。 リポジトリに属するものもありますが、会議メモや価格表などはコードではなくコンテキストであり、すべてのセッションにノイズを加えることになります。

プロジェクトの指示をそのまま CLAUDE.md に貼り付ける。 「シニアプロダクトマネージャーとして回答してほしい」といったチャット向けに書かれた指示は、コーディングエージェントには適さないことが多く、長い CLAUDE.md ファイルはすべてのセッションでロードされます。

プロジェクトのメモリがターミナルに表示されることを期待する。 ターミナルセッションは、自分のマシン上の自動メモリを使用します。これは別の保存場所です。

手動での移行

ステップ 1: プロジェクトの現状を把握する

プロジェクトを開き、以下の4つのリストを書き出します。

  • 指示: プロジェクトの指示をテキストファイルにコピーします。
  • ナレッジファイル: 各ファイルをリストアップし、それがコードに関するもの(仕様書、スキーマ、アーキテクチャメモ)か、その周辺の作業に関するもの(リサーチ、計画、メモ)かを判断します。
  • チャット内の決定事項: プロジェクトの最近のチャットを確認し、決定事項を1行ずつ書き出します。何が決まったか、何が除外されたか、何がまだ未解決か、その理由も添えます。
  • プロジェクトのメモリ: プロジェクトページの「Memory」を開き、Claude がそこに保存した内容のうち、保持したいものをメモします。

決定事項のリストは多くの人が見落としがちですが、最も重要な部分です。プロジェクトのナレッジベースに含まれていない限り、プロジェクトのチャット間でコンテキストは共有されないというヘルプセンターの注意を思い出してください。

ステップ 2: プロジェクトの場所を選択する

claude.ai/code で新しい Projects が利用可能で、特にプロジェクトがすでに移行されている場合は、プロジェクトの指示とファイルをプロジェクト内に保持できます。作業が行われるリポジトリを追加してください。あなたの役割は、メモリと指示を確認し、リポジトリ固有のルールを各リポジトリに移動することです。

ターミナルで作業する場合、または新しい Projects がまだ利用できない場合は、リポジトリが移行先となります。ほとんどの作業が行われるリポジトリを選択してください。

ステップ 3: 各要素を Claude Code が読み取れる場所に配置する

新しい Projects の場合:

  1. 移行後にプロジェクトのメモリを確認し、ステップ 1 のリストにある欠落している要件や決定事項を覚えるよう、プロジェクトの会話で Claude に依頼します。
  2. プロジェクトの指示を整理し、すべてのスレッドが開始すべき簡潔なブリーフにします。
  3. リポジトリのルールを各リポジトリの CLAUDE.md に移動し、ルートに配置することで、すべてのクラウドスレッドがそれらを読み取れるようにします。

ターミナルの Claude Code の場合:

  1. プロジェクトの指示を CLAUDE.md のセクションとして書き直します。 規約、アーキテクチャ、ワークフローなど、コードに適用される内容を保持します。個人の好みは CLAUDE.local.md または ~/.claude/CLAUDE.md に入れます。
  2. コード関連のナレッジファイルをリポジトリの docs/ フォルダなどに追加し、CLAUDE.md からそれらを指し示します。
  3. 決定事項をロードされる場所に書き込みます。 確定したルールは CLAUDE.md に入れます。なぜそのアプローチが却下されたかなど、コードから導き出せないコンテキストは自動メモリに入れることができます。最初のセッションで Claude にそれを覚えるよう伝えてください。
  4. セッションを開始し、コードを書く前にプロジェクトについて知っていることを要約するよう Claude に依頼します。

CLAUDE.md は短く保ってください。Claude Code のサブディレクトリ CLAUDE.md 制限に関するガイドでは、長い指示ファイルがどのようにロードされるかを説明しています。

より良い方法:プロジェクトのコンテナを超えて存続する一つのリストにプロジェクトの決定事項を保持する

手動の移行は機能しますし、Anthropic の移行も対象者には役立ちます。どちらも同じパターンを示しています。プロジェクトの最も有用なコンテキストである決定事項や制約事項が、新しいコンテナで再構築され続けているということです。チャットのプロジェクトメモリ、クラウドのプロジェクトメモリ、CLAUDE.md、および自動メモリは、重複する事実を保存する4つの場所であり、ChatGPT や Codex で計画やレビューを行う際には、それらの決定事項を再び説明することになります。

MemoryLake は、これらの決定事項を管理する一つのリストに保持し、Claude Code や、接続した ChatGPT、Codex などの他のアシスタントから利用できるようにするためのメモリレイヤーです。

エントリーは自分自身の言葉で書き込みます。Claude プロジェクト、プロジェクトメモリ、自動メモリ、CLAUDE.md ファイル、またはベンダーのストアから何かが読み取られたり、書き込まれたり、削除されたりすることはありません。業務内容については、組織のツール外に保持するものに関するポリシーに従ってください。

ステップ 1: API キーを作成する

サインインし、ダッシュボードからキーを生成します。このキーは MemoryLake ワークスペースに属し、Claude アカウントとは別個のものです。

APIキー作成画面が表示されている MemoryLake コンソール。エージェントで使用するために新しいキーが作成され、コピーされています
APIキー作成画面が表示されている MemoryLake コンソール。エージェントで使用するために新しいキーが作成され、コピーされています

ステップ 2: 最初のメモリをアップロードする

手動移行のステップ 1 で作成した決定事項リストから始めます。何が決まったか、その理由、そして何が除外されたか。1つの決定につき1つのエントリーを作成し、日付を入れ、所属するプロジェクトのラベルを付けます。

最初のドキュメントがアップロードされた MemoryLake ワークスペース。各ファイルが検索可能なメモリとしてリストされています
最初のドキュメントがアップロードされた MemoryLake ワークスペース。各ファイルが検索可能なメモリとしてリストされています

ステップ 3: AI とエージェントを接続する

Claude Code や、使用している他のアシスタントを接続します。ターミナルまたはクラウドスレッドでの次のセッションは、決定事項が手の届くところにある状態で開始されます。

メモリレイヤーに接続可能な AI クライアントとエージェントフレームワークがリストされている MemoryLake の統合画面
メモリレイヤーに接続可能な AI クライアントとエージェントフレームワークがリストされている MemoryLake の統合画面

実務における変化

第一の違いは、構築がファイルだけでなく、プロジェクトの推論から始まることです。Claude Code は何が決定され、なぜそうなったかを知っています。

第二に、各要素が適切な場所に配置されることです。リポジトリのルールはリポジトリに、プロジェクトのメモはプロジェクトメモリまたは自動メモリに、そして個人の好みは個人のものとして残ります。

第三に、次の移行が容易になることです。ロールアウトが他のプロジェクトに及んだときや、プロジェクトの作業を ChatGPT に移すとき、決定事項はすでに特定のコンテナの外に存在しています。

Claude プロジェクトを Claude Code に移行するためのベストプラクティス

最初に決定事項を書き出す。 これらは古いチャットの中に置き去りにされやすい部分です。

自動移行後にプロジェクトのメモリを確認する。 移行リストにはメモリについて明記されていません。

リポジトリのルールをリポジトリに置く。 ルートの CLAUDE.md に置くことで、クラウドスレッドとターミナルセッションの両方がそれを読み取ります。

コードの知識と作業のコンテキストを分ける。 仕様書はリポジトリに入れますが、会議メモを入れる必要はありません。

個人の好みを共有の CLAUDE.md に入れない。 CLAUDE.local.md またはユーザーファイルを使用してください。

構築前にプロジェクトの内容を再説明するよう Claude に求める。 コンテキストが正しく届いているかを確認する最も手っ取り早い方法です。

チャット内であっても Claude がプロジェクトファイルを忘れてしまう場合は、Claude がプロジェクトのナレッジファイルを忘れる問題に関するガイドで解決策を解説しています。

結論

Claude プロジェクトは、指示、ナレッジファイル、チャット、および独自のメモリを保持します。Anthropic は既存の一部のプロジェクトを、Claude Code で開始される新しいバージョンに移行しており、移行によって失われるものはないとしています。引き継がれるリストには、指示、ファイル、チャット履歴、スケジュールされたタスクが含まれています。新しい Projects はターミナル CLI では動作せず、他のプロジェクトは当面現在の場所に残ります。

プロジェクトが自動で移行される場合でも、自分で移行する場合でも、やるべきことは同じです。決定事項を書き出し、リポジトリのルールを CLAUDE.md に配置し、メモリの内容を確認し、コードを書く前にプロジェクトの内容を再説明するよう Claude に依頼することです。

よくある質問

Claude プロジェクトを Claude Code に移行できますか?

Anthropic は、一部の Pro および Max ユーザーの既存プロジェクトを、Claude Code で最初にリリースされる新しいバージョンの Projects に移行し始めています。過去 30 日間にプロジェクトを使用した場合、移行前にメールで通知されます。それ以外の場合は、手動でリポジトリ内にプロジェクトを再構築してください。

Anthropic がプロジェクトを移行する際、何が引き継がれますか?

ヘルプセンターには、指示、ファイル、完全なチャット履歴、およびスケジュールされたタスクがリストされており、移行によって失われたり削除されたりするものはないとされています。

Claude Code ターミナルで新しい Projects を使用できますか?

いいえ。Anthropic のドキュメントによると、Projects は claude.ai/code、デスクトップアプリ、および Claude モバイルアプリで利用可能ですが、ターミナル CLI、VS Code 拡張機能、または JetBrains プラグインでは利用できません。

Claude Code でプロジェクトの指示はどこに置くべきですか?

新しい Projects では、プロジェクトの指示(project instructions)に入れます。ターミナルでは、CLAUDE.md のセクションとして書き直し、個人の好みは CLAUDE.local.md または ~/.claude/CLAUDE.md に保持します。

プロジェクトのメモリは自分のコンピュータ上の Claude Code に表示されますか?

ターミナルセッションは、自分のマシンに保存される自動メモリ(auto memory)を使用します。新しい Projects のメモリは、クラウドスレッドが読み取る別のファイルセットです。

プロジェクトのナレッジファイルはどうすればよいですか?

仕様書やアーキテクチャメモなど、コードに関するファイルはリポジトリに置き、CLAUDE.md からそれらを指し示します。コードに関係のない作業コンテキストはリポジトリから除外してください。