コンテキストを失わずに Claude Code から Warp へ移行する方法 (2026)

あなたの CLAUDE.md ファイル — 変換ではなくリンク。 Warp の /init は、CLAUDE.md を直接リンクします。これには他に6つのフォーマット（CLAUDE.md、.cursorrules、AGENT.md、GEMINI.md、.clinerules、.windsurfrules、.github/copilot-instructions.md）も含まれます。検出ではなくリンクです。リポジトリに CLAUDE.md がたくさんあっても、リンクするまでは何も機能しません。

あなたのスキル — ディレクトリの変更のみ。 Claude Code は .claude/skills/ を読み込みますが、Warp はプロジェクトのスキルを .agents/skills/ から、個人のスキルを ~/.agents/skills/ から読み込み、/skills でブラウズできます。SKILL.md の形式は同じです。これは書き換えではなく、移動です。

あなたの MCP サーバー — 両方のインターフェースを使用する場合は2回設定。 Warp は「ルールとスキルは移行の必要がありません。CLI と Warp アプリの両方が同じファイル場所からそれらを検出します」と述べていますが、MCP は例外です。「CLI は Warp アプリとは別に、独自の MCP サーバー設定を保持します」（macOS では ~/.warp_cli/.mcp.json）。

コードベースの理解 — 移動ではなく再構築。 Warp の Codebase Context は「Git で追跡されたコードベースをインデックス化」し、ドキュメントには「Warp サーバーにはコードは保存されません」と記載されています。再インデックスするだけで、エクスポートするものはありません。

移行されないもの: Claude があなたの作業について書き留めたすべての内容。 Claude Code の自動メモリは、各ファイルのフロントマターにある type フィールドでタグ付けされた4種類のノートを記録します。user（あなたの役割、専門知識、作業の好み）、feedback（あなたが Claude に与えた修正や確認したアプローチ）、project（進行中の作業、期限、コードや Git 履歴からは推測できない決定事項）、そして reference（プロジェクト外の情報を見つける場所）です。これはデフォルトで有効になっているため、ある程度の期間リポジトリで Claude Code を使用していた場合、意識していなくてもこのディレクトリが存在します。

エクスポート機能はありません。移行先でのインポート機能もありません。そして、最も価値のあるノートは feedback と project です。これらはまさに、Anthropic のドキュメントが指摘しているように、コードベースから推測できる場合には Claude が書き込みをスキップするカテゴリです。

また、パススコープのルールという仕組みも失われます。 Claude Code の .claude/rules/ では、Claude が一致するファイルに触れたときにのみ指示を読み込ませることができます。Warp の同等機能は配置によるものです。つまり、サブディレクトリ内の AGENTS.md です。これはより大まかなツールであり、依存する前に知っておくべき読み込み動作の注意点があります。これについては次のセクションで説明します。

Step 1: Claude Code を開くのをやめる前に、自動メモリディレクトリを読み取る

これは読み取りの作業であり、後からやり直すことができない唯一のステップです。

ノートは ~/.claude/projects/<project>/memory/ にあります。<project> パスは Git リポジトリから派生するため、同じリポジトリのすべてのワークツリーで1つのディレクトリを共有します。内部には、MEMORY.md インデックス（「メモリごとに1行、すべてのセッションに読み込まれる」）と、メモリごとのトピックファイルが1つずつあります。

まず MEMORY.md を開きます。これは Claude が自身のために維持している目次です。次に、それが指し示すトピックファイルを開きます。実用的な注意点が2つあります。Anthropic のドキュメントによると、「すべての会話の開始時に読み込まれるのは、MEMORY.md の最初の200行、または最初の25KBのいずれか早い方のみ」であり、そのしきい値を超えるコンテンツは「セッション開始時には読み込まれません」。そのため、インデックスが長い場合、一部はしばらく機能しておらず、今回初めてまともに読むことになるかもしれません。トピックファイルは起動時には一切読み込まれず、Claude は「必要に応じて読み込みます」。

読み進めながら、見つけたものを次の3つの山に分類してください。

• すでに CLAUDE.md にあるもの。 スキップします。そのまま無料でリンクされます。
• リポジトリから推測できるもの。 これもスキップします。Warp がコードをインデックス化します。
• どちらでもないもの。 これが実際の移行対象（ペイロード）です。あなたが実用的に与えた修正、理由付きの決定事項、期限、リポジトリ外のシステムへのポインタなどです。次に進む前に、これらをどこかにコピーしておいてください。

何も削除しないでください。Anthropic はトランスクリプト保持のクリーンアップ対象からメモリディレクトリを除外しています（「MEMORY.md とトピックファイルは、あなたまたは Claude が編集または削除するまで残ります」）。そのため、Claude Code をインストールしたままにしておいてもコストはかからず、オリジナルを読み取り可能な状態に保つことができます。

Step 2: 書き込まれた半分を配置し、読み込みモデルを正しく設定する

リポジトリのルートから Warp で /init を実行し、既存の CLAUDE.md をリンクすることを選択します。その後、次の3つのポイントを正しく設定してください。これらは失敗してもエラーが表示されません。

ファイル名は大文字と小文字を区別します。 Warp のドキュメントには、注意（Caution）として次のように記載されています。「Warp が認識できるように、ファイル名はすべて大文字にする必要があります（例: AGENTS.md。agents.md や Agents.md は不可）」。小文字のファイルはルールファイルとして認識されず、エラーも発生しません。

自動的に読み込まれるのは2つの場所のみです。 「Warp はルートおよび現在のディレクトリにある AGENTS.md（または WARP.md）を自動的に適用します」。それ以外については、「Warp はそのサブディレクトリのルールファイルも含めるようベストエフォートで試みます」が、これはそのディレクトリ内のファイルを編集していることが条件となります。ルールをリポジトリ全体に適用する必要がある場合、ルートファイルが唯一の確実な配置場所です。

最も具体的なファイルが優先されます。 Warp は、競合を「現在のサブディレクトリ、ルート、グローバルルール」の順に解決します。これは「最も具体的でプロジェクトに関連するルールが、より広範なルールよりも優先される」という意図によるものです。スコープが宣言的であった .claude/rules/ から移行する場合、この変更に注意する必要があります。古いサブディレクトリファイルが、そのディレクトリ内でのみ、新しいルート標準よりも優先されてしまいます。

次に、.claude/skills/ を .agents/skills/ に移動し、使用しているアプリまたは CLI のいずれか（あるいは両方）に対して MCP サーバーを設定し、/index を実行して Codebase Context を構築します。

Warp が提供し、Claude Code が提供しない機能が1つあります。それは「検証」です。「インタラクションで使用されたルールは、会話の References（参照）の下に表示されるか、特定のルールから派生したものとしてマークされます」。実行されるはずのルールで一度これを試し、デバッグが必要になる前に、読み込まれたルールがどのように表示されるかを確認しておきましょう。

これで書き込まれた半分は完全にカバーされました。しかし、学習された半分（Claude が書き留めたノート）はまだ行き場がありません。

Warp にはこれに対する回答があり、まだ使用できない場合でも理解しておく価値があります。

Agent Memory は、「Warp 上に存在し、組み込みの Warp Agent、Claude Code、Codex、および今後追加されるその他のサポートされているすべてのエージェントハーネス間で共有される永続的なメモリシステム」と説明されています。メモリはストア（個人、エージェント所有、またはチーム所有）に整理され、読み取り専用または読み書きアクセス権とストアごとの必須指示を伴って特定のエージェントにアタッチされます。各メモリは「どこから来たかを記録」し、すべての変更が検査用に記録され、作成と取得はバックグラウンドで実行されるため、「トークンを消費したり、アクティブなタスクにレイテンシを追加したりしません」。

3つの制限事項も同様に明確に述べられています。これは「リサーチプレビュー段階であり、デザインパートナーのチームごとに有効化」され、ウェイトリストがあります。サードパーティのハーネスは、クラウドエージェントとして実行される場合にのみカバーされます（「リサーチプレビュー期間中、サードパーティのハーネスをローカルで実行することはサポートされていません」）。また、プログラムによる API アクセスとセルフホストはどちらも「近日公開（Coming soon）」となっています。

つまり、優れた設計で正しい方向に向かっていますが、一般公開されておらず、ローカルの Claude Code セッションからはまだアクセスできません。チームがデザインパートナーである場合は、これを使用してください。それがネイティブなパスです。

そうでない場合は、学習された半分をどこかに着地させる必要があります。それを実現するのが MemoryLake です。これは単一のツールに依存しないメモリレイヤーであり、ステップ1で救出したノートを、今日の Warp からも、次に使用するツールからも読み取ることができます。セットアップは3つのステップです。

Step 1: API キーを作成する

サインインして API キーを作成します。接続するツール間で共通の1つの認証情報となります。

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

1つの項目につき1つの主張を含む、短いエントリにします。ソース素材はステップ1の3つ目の山であり、Claude Code 独自のノートタイプが良い分類ガイドになります。

定着した修正。 Claude Code の feedback カテゴリ（あなたが拒否したアプローチと確認したアプローチ）。これは最も価値の高い山であり、Warp のルールモデルにはこれに相当するものがありません。

理由を伴う決定事項。 「負荷がかかるとリードレプリカが遅延するため、移行は追加のみとする」。指示自体は AGENTS.md に記述すべきですが、その理由はここに置くべきです。これによって、次の四半期にルールが元に戻されてしまうのを防ぐことができます。

コードではない作業コンテキスト。 期限、現在の優先事項、どのサービスを誰が所有しているかなど。Claude Code の project カテゴリであり、ドキュメントでは Claude が「コードや Git 履歴からは推測できない」ものと説明されています。

外部へのポインタ。 ダッシュボード、課題トラッカー、ランブックなど。reference カテゴリです。

Step 3: AI とエージェントを接続する

使用しているものを接続します。MemoryLake は MCP および API 経由でアクセス可能であり、Warp は MCP サーバーをサポートしています。ただし、アプリと CLI は個別の MCP 設定を保持するため、共有セットアップは2回設定する必要があることに注意してください。Claude Code、Codex、Cline、OpenClaw も同様に接続でき、それ以外のツールも API を通じて同じメモリを読み取ることができます。

率直な3つの制限事項があります。MemoryLake は Claude Code の自動メモリを読み取り、エクスポート、または削除することはできません。 そのディレクトリ用の API は存在しないため、ステップ1の手動読み取りが必要になります。MemoryLake はあなたの AGENTS.md やグローバルルールを書き込みません。 上記の読み込み動作は Warp のものであり、メモリレイヤーがそれを変更することはありません。そして、メモリはコンテキストであり、強制力ではありません。 Anthropic 自身のドキュメントでも CLAUDE.md と自動メモリについて同様の指摘がされており、Claude は「これらを強制された設定ではなく、コンテキストとして扱う」とされています。常に維持しなければならないルールは、実行を失敗させるチェック（テストや Linter など）に含めるべきです。

ルールの移行は半日ではなく数分で完了します。 /init が CLAUDE.md をその場でリンクします。

学習された半分が不可視ではなくなります。 数ヶ月後にその存在に気づくのではなく、意図的に一度ディレクトリを読み取ることになります。

マシンローカルがデフォルトではなくなります。 Claude Code の自動メモリは明示的にマシン間で共有されませんが、移行したものは共有可能になります。

ルールのデバッグに明確な回答が得られます。 References（参照）により、実際に何が実行されたかが表示されます。これは CLAUDE.md では不可能でした。

次の移行コストが下がります。 知識はもはやどちらのツールのホームディレクトリ内にも閉じ込められていません。

切り替える「前」に MEMORY.md を読み取る。 これはすべての Claude Code セッションに読み込まれ、他のすべてのインデックスとなっています。

複製するのではなくリンクする。 /init は7つの外部フォーマットをリンクします。同じルールのコピーを2つ作成すると、1ヶ月以内に乖離してしまいます。

ファイル名の大文字・小文字をすぐに確認する。 すべて大文字でなければ存在しないものとみなされます。これは Warp のルールシステムで最も一般的な、エラーの出ない失敗です。

リポジトリ全体のルールはルートファイルに置く。 ルートと現在のディレクトリは自動的に読み込まれますが、それ以外はベストエフォートです。

サブディレクトリのファイルを監査し、古いオーバーライドがないか確認する。 最も具体的なファイルが優先され、古いファイルであっても具体的なまま優先され続けます。

重要なルールごとに、References で一度検証する。 読み込まれたものは事実であり、あなたが書いたものは意図にすぎません。

ルールの理由（推論）はルールファイルに含めない。 ルールはリクエスト時に適用され、コンテキストを奪い合います。一般的な構成については「what coding agents actually read（コーディングエージェントが実際に読み取るもの）」を参照してください。

スキルをメモリ（記憶）として扱わない。 スキルは手続き的で安定したものです。メモリは作業しながら書き込まれるものです。その違いについては「why agent skills aren't memory（エージェントのスキルがメモリではない理由）」を参照してください。

これは、移行先が歩み寄ってくれる珍しい移行例です。Warp の /init は CLAUDE.md を直接リンクし、スキルはディレクトリ名を変更するだけで移動でき、Codebase Context はリポジトリから自動的に再構築されます。コンテキストが完全に自分で書いたファイル内にあった場合は、半日で完了します。正しく設定すべきなのは、すべて大文字のファイル名、ルート対サブディレクトリの読み込みモデル、および最も具体的なものが優先される優先順位だけです。

一緒に移行できないのは、Claude が書き込んだ半分です。自動メモリはデフォルトで有効になっており、あなたの修正やプロジェクトの状態を ~/.claude/projects/<project>/memory/ に保持しますが、設計上マシンローカルであり、エクスポート機能はありません。Warp の Agent Memory は、その知識を保持するのに適した形式（クロスハーネス、ソース追跡、エージェントごとのアクセス）ですが、デザインパートナーチームに限定されたリサーチプレビュー段階であり、プレビュー期間中はローカルで実行されるサードパーティのハーネスをカバーしていません。

したがって、Claude Code を開くのをやめる前にメモリディレクトリを読み取り、CLAUDE.md にもなくコードからも推測できない修正や決定事項を保持し、それらを単一のツールのホームディレクトリに縛られないレイヤーに配置してください。ルールは数分でリンクされます。推論（理由）はあなただけが移行できる部分です。そもそもなぜそれが失われてしまったのかについては、「why Claude Code forgets across machines（なぜ Claude Code はマシン間で忘れてしまうのか）」で解説しています。