2026年にClaude CodeからCodexへ移行する方法：ステップごとのガイド

Codexは対応するClaude Code設定を取り込めます。指示、スキル、MCP、フック、ワークフローを元の一覧で確認し、手作業は設定に応じて見積もります。

記事の全文を読む

重要なポイント

2026年6月2日、OpenAIはCodexに「Import other agent setup」機能を追加しました。この機能は ~/.claude をスキャンし、スキル、MCP設定、指示、最大30日分のセッション履歴を取得して、CLAUDE.mdをAGENTS.mdに変換します。移る量は自分の設定一覧とインポーターの対応範囲によります。検出結果を、必要な設定の一覧と照合してください。移行されないものは、Codexに相当するものがないトリガーを持つフック、MCPトークン、/name形式のスラッシュコマンドです。このガイドでは、Migrationツールが取得するもの、手動で仕上げる必要があるもの、そして完全に切り替えることが本当に妥当なタイミングを解説します。

Ailootドキュメント：API、キー、セットアップ。

Codex Migrationツールはそもそもなぜ必要なのでしょうか？

重要なポイント

2026年6月2日より前は、Claude CodeからCodexへの切り替えは丸一日かかる手作業でした。CLAUDE.mdをAGENTS.mdに名前変更し、スキルのパスを書き換え、MCPサーバーを再接続し、記憶を頼りにサブエージェントを復元する必要がありました。Migrationツールなら1回のスキャンで済みます。Codex Appを開いて「Import other agent setup」をクリックすると、~/.claudeフォルダーの一覧と移行計画が表示されます。

OpenAIは2026年6月上旬にこの機能をCodexに追加しました。公式の変更履歴には、簡潔にこう記されています。

オンボーディング中を含め、Claude CodeおよびClaude Coworkからサポート対象の設定をインポートするCodexへの移行フローを追加しました。

— OpenAI Codex Changelog, https://developers.openai.com/codex/changelog

つまり、Codex Appを初めて起動したとき、または起動済みクライアントの設定から、別のエージェントのローカル設定を読み取るウィザードを開始できます。現在、Claude CodeとClaude Coworkがサポートされています。

OpenAIがこれを行う理由は明らかです。Sitesの公開と2026年5〜6月のCodex Appのアップデートを経て、CodexにはClaude Codeが以前OpenAI製品を上回っていた機能、つまりターミナル、プラグイン、長時間のセッション、オーケストレーションがすべて備わりました。移行によって、Claude Codeをすでにスタックに組み込んでいるチームにとって最後の障壁が取り除かれます。「対応設定を取り込み、元の一覧と照らして確認できます」。

一方、あなたに移行が必要かどうかは、それほど明確ではありません。CodexとClaude Codeの比較ガイドで両者を直接比較しました。長時間のアーキテクチャ議論やPlan ModeではClaudeが依然として優位で、自律型タスクや並行PRではCodexのほうが高速です。完全に切り替えると決めたなら、この先を読んでください。併用を検討しているなら、共同作業のパターンのほうが参考になるかもしれません。

Migrationツールは何を自動で移行しますか？

重要なポイント

大まかに言うと、スキャナーは5つのグループを取得します。指示（CLAUDE.md → AGENTS.md）、ユーザースキル、MCPサーバー設定、決定論的ロジックを持つフック、最大30日分のセッション履歴です。この記事では実測の移行割合や完了時間を確認していません。各分類の必要項目数を記録し、インポート・検証済み、手動確認待ち、非対応へ分け、その一覧から残作業を見積もります。

各グループについて、~/.claudeの各部分がどう扱われるのかを詳しく見ていきます。

1. 指示とコンテキスト。 CLAUDE.mdファイルは、~/.claude/内のグローバルファイルもリポジトリ内のプロジェクトファイルも、AGENTS.md形式に変換されます。グローバルファイルは~/.codex/AGENTS.mdに配置され、プロジェクトファイルはリポジトリのルートや子フォルダーに残ります。AGENTS.md形式は、ルールを記述する同種のMarkdownファイルで、違いは主に見た目のもの、つまりセクション名といくつかの個別指示です。AGENTS.mdとは何か、そしてCodexに必要な理由について説明しました。

2. スキル。 ~/.claude/skills/フォルダー全体がスキャンされ、各スキルはCodexの構造に合わせて調整されたうえで、$HOME/.agents/skillsに配置されます。リポジトリ内の.claude/skills/にあるプロジェクトスキルは、.agents/skillsに移されます。frontmatter付きのSKILL.md形式は、ほぼそのまま移行されます。Claude固有のトリガーを使用するスキルには、確認フラグが付けられます。

3. MCPサーバー。 .mcp.json設定（グローバルとプロジェクト単位の両方）がCodex形式にインポートされます。サーバー名、起動コマンド、パスは保持されます。移行されないのは、トークンと環境変数です。セキュリティ上の理由から、移行中に露出しないよう、CodexはAPIキーとパスワードを再入力するよう求めます。これは一度だけの作業です。Codex AppのMCPセクションを開き、パスワードマネージャーに保存してあるトークンを入力してください。

4. フック。 ここは複雑なグループです。rm -rfのブロック、認証情報らしいパスの検出、証拠の記録など、決定論的なロジックを持つフックは完全に移行されます。Codexに相当するものがないトリガー（たとえばClaude Code固有のライフサイクルイベント）を持つフックには「manual review」のマークが付けられ、自動では有効化されません。Claude Codeのフックの仕組みで詳しく説明しました。比較のために言うと、Codexのフックの種類は少なめです。

5. セッション履歴。 Claude Codeでの直近30日分までのアクティビティが、参照用としてインポートされます。これは「前回中断したところから完全に続けられる」という意味ではありませんが、過去の会話がCodexで見えるため、プロジェクトのコンテキストをすべて説明し直さずにすばやく思い出せます。

Migrationツールは、実際に使っているファイルと実験の成果物を区別せず、すべて移行します。移行後は、ここ6か月使っていないものを手動で整理するとよいでしょう。

移行されないものと、その理由

重要なポイント

Codexに存在しないもの、または根本的に異なる動作をするものが5つあります。Migrationツールはそれらにフラグを付けますが、変換はしません。MCPトークンと環境変数、/name形式のスラッシュコマンド、Claude Code固有のライフサイクルフック、サブエージェントを基盤にしたチームワークフロー、CLAUDE.md形式に合わせて作られた大規模な指示です。

各グループについて、「移行後に何をするか」という観点から見ていきます。

MCPトークンとAPIキー。 これは最も予測しやすい部分です。スキャン後、CodexはClaude内で見つかったすべてのMCPサーバーを一覧表示します。それぞれのキーとトークンを求められます。パスワードマネージャーを手元に置き、すべてのサーバーをまとめて設定するのが簡単です。その後は、MCPはCodexでもClaude Codeでも同じように動作します。選んだMCPサーバーのコマンドと接続パラメーターを、そのドキュメントと照らし合わせて確認してください。

スラッシュコマンド/name。 Claude Codeでは、/skill-nameでスキルを呼び出すことに慣れているでしょう。Codexの正式な呼び出し方法は異なり、$skill-nameです。/nameコマンドが動くことをスキルが読み込まれた証拠とみなすのは、移行時によくある間違いです。

移行後、Codexでいくつかの重要なスキルを$skill-nameで試してください。動作すれば、移行は本当に成功しています。ウィザードの「skills migrated」チェックボックスを信じず、実際に呼び出して確認してください。

Codexに相当するものがないフック。 特定のClaude Codeイベントにフックを設定していた場合、たとえば特定のツールの組み合わせに対するpre-tool-useなど、そのトリガーはCodexに存在しない可能性があります。Migrationツールはそのようなフックにフラグを付け、無効のままにします。Codex向けに書き換えるか、削除するか、並行稼働するならClaude Codeに残すかを決める必要があります。良いルールは、決定論的なフックだけを移すことです。それ以外は、新しいツールに同じ仕組みを複製しない理由になります。

サブエージェントを基盤にしたチームワークフロー。 Claude Codeのサブエージェントとは何か、およびネストしたサブエージェントの使い方について説明しました。Codexでは、サブエージェントはプロファイルとロールで構成します（以下を参照）。Claudeで複数のサブエージェントを連鎖させる複雑なパイプラインを使っていたなら、Codexのプロファイル概念を使って書き直す必要があります。Migrationツールは、このようなセットアップに「requires architectural rework」のマークを付けます。

Claude固有の大規模なCLAUDE.mdファイル。 ファイルが各プロジェクトのセクションを含む2,000〜3,000行に膨らんでいる場合、Codexは受け入れるかもしれませんが、好ましいパターンではありません。AGENTS.mdは簡潔にし、分散して配置するよう設計されています。グローバルルールは~/.codex/AGENTS.mdに、プロジェクト固有のルールはリポジトリのルートに、限定的な上書き設定は子フォルダーに置きます。移行後、CLAUDE.mdを「巨大な指示ファイル」のままにせず、階層ごとに分割してください。CLAUDE.mdを適切に設定する方法で説明した方法は、AGENTS.mdにも当てはまります。

Codex Appで行う4つのステップ

重要なポイント

移行と検証の時間は、~/.claudeの大きさとClaude固有設定の量によります。最新のCodex Appをダウンロードし、Settingsを開いて「Import other agent setup」を選択し、スキャンが終わるのを待ってインポートを確定します。その後、$skill-nameでスキルを呼び出してテストし、MCPトークンを入力し、有効化されなかったフックを確認してください。

具体的なチェックリストはこちらです。

ステップ1：Codex Appを26.608以降に更新する
Migrationツールはバージョン26.608（2026年6月9日リリース）で登場しました。macOSではCodex Appを開き、アップデートを確認します。Windowsでも同様にしてください。Codex CLIを使っている場合は、現在のAppと互換性があることを確認します。最新バージョンでなければ、Settingsに「Import other agent setup」が表示されません。
ステップ2：Settingsからインポートを開始する
Codex AppでSettingsを開き、「Import other agent setup」を探します。Codex Appをインストールしたばかりなら、オンボーディング中にウィザードが移行を提案します。開始すると、ウィザードはファイルシステムをスキャンします。対象は~/.claude/と、CLAUDE.mdまたは.claude/を含むリポジトリです。ファイル数によって、スキャンには30秒から数分かかります。
ステップ3：移行計画を確認する
スキャン後、Codexはインベントリを表示します。見つかったスキル数、MCPサーバー数、CLAUDE.mdファイル数、移行対象となるフック、利用可能なセッション履歴の日数が表示されます。移行したくないグループのチェックを外せます。デフォルトでは、Codexが安全にインポートできると判断したものがすべて選択されています。
ステップ4：完了を待ってトークンを入力する
インポートには1〜5分かかります。完了すると、Codexが「こちらは自動で移行できませんでした。手動で確認してください」というフォローアップ画面を開きます。通常は、トークンが必要なMCPサーバーの一覧です。パスワードマネージャーを開き、Codexのフォームにキーを入力してください。これで移行の主要部分は完了です。

続いて、結果を確認します。Claude Codeで普段作業していたプロジェクトを開き、次の項目を確認してください。

cat ~/.codex/AGENTS.md — グローバルルールが入っていますか？
任意のスキルを実行する：$skill-name。読み込まれるはずです。
プロジェクト内の.mcp.jsonを開き、必要なサーバーが動作していることを確認する。
普段の作業を反映した会話を始める。Codexは使用できないインポート済みフックを表示します。これらが個別に手動対応する項目です。残りが一定割合とは確認されていません。

フックとサブエージェント：Codexでの相当機能と書き換えが必要な部分

重要なポイント

トリガーの種類では、CodexのフックはClaude Codeのフックほど成熟していませんが、基本的なセキュリティタスクには十分です。サブエージェントの代わりにプロファイルとロールを使います。複雑なサブエージェントのパイプラインはそのまま移行できないため、プロファイルを使って再検討する必要があります。ワークフローの一覧によっては、ここに多くの手作業が必要です。

フック。 Claude Codeでは、各ライフサイクルイベント（pre-tool-use、post-tool-use、on-error、on-context-loadなど）にシェルコマンドを割り当てられます。Codexのイベントは少なく、実行前の確認、証拠の記録、危険なコマンドのブロックができます。特定の組み合わせをフィルタリングするpre-tool-useフックを使っていた場合、Codexでは一般的な実行前チェックで代用するか、削除する必要があります。Claude Codeのフックのアーキテクチャで詳しく説明しました。広範囲に使っていたなら、各トリガーと必要な効果を列挙し、対応する代替を特定して、有効化前に検証してください。

サブエージェント。 Claude Codeでは、サブエージェントは独自のシステムプロンプトを持つ別コンテキストで、/commandまたはメインの会話から起動します。Codexにはプロファイルという類似概念があります。特定のスキル、権限、承認ポリシーを持つプロファイルを定義できます。プロファイルも、特定の種類のタスクに合わせてコンテキストを分離するというほぼ同じ問題を解決しますが、明示的にエージェントを呼び出すのではなく、設定を通じて行います。

実際には、次のようになります。

独自のプロンプトを持つ「security-reviewer」サブエージェントを使っていたなら、必要な権限と高い推論レベルを設定したsecurity-reviewプロファイルをCodexで作成します。
「feature-developer」サブエージェントを使っていたなら、それは通常の作業用プロファイルに相当します。特別な設定は不要です。
ネストしたサブエージェントを使っていたなら、Codexでそのまま置き換えることはできません。プロファイルの連鎖か明示的なスキルで再設計してください。

Migrationツールは、サブエージェント名を使ってプロファイルを作成し、移行されなかったトリガーにフラグを付けようとします。必要な作業量は役割、トリガー、権限、依存関係の数によります。必要な各パイプラインを試してから移行済みとしてください。

完全に移行する場合と両方のツールを使い続ける場合

重要なポイント

スタックが自律型PR、長時間の並行タスク、GitHubとの深い統合で構成されているなら、Codexへの完全な移行が妥当です。アーキテクチャの作業と実装作業が混在する場合は、両ツールの併用がより効果的です。私の経験では、vibe-codingを行う起業家は、完全に切り替えるより併用するほうがメリットを得やすい傾向があります。

判断のための簡単な基準です。

Codexに完全移行するのが妥当なのは、次のような場合です。

主に自律型PRや並行タスクに取り組んでいる。
GitHubのワークフローが深く統合されており、Codex Cloud Agentが作業の80%を処理する。
アーキテクチャの議論やPlan Modeに多くの時間を使わない。
2つではなく1つのツールに料金を払いたい。

Claude CodeとCodexを併用するのが妥当なのは、次のような場合です。

長時間のアーキテクチャ上の意思決定にPlan Modeを定期的に使う。
並行作業が必要で、Codexをクラウドで1つのタスクに使う間、Claude Codeで別のタスクのコンテキストを保持したい。
Plan Modeを使うほどではない単発のハックや小規模プロジェクトに多く取り組む。
一晩では書き換えられない複雑なサブエージェントのパイプラインがある。

私は両方を使っています。長い会話にはClaude Codeを使い、Codexには「バグをN個並行して修正」や「PRをレビュー」といった作業を任せています。この方法については、Claude CodeとCodexを併用するガイドで詳しく説明しました。

移行について私が最も伝えたいのは、Migrationツールが切り替えの技術的な障壁を取り除いても、そもそも切り替える必要があるかどうかまでは答えてくれない、ということです。まず、自分がどのような作業をしているかを判断してください。それからツールを選びましょう。

出典

Codex Changelog (developers.openai.com) — Migrate to Codexフローの項目を含む公式リリースノート。
Codex vs. Claude Code 2026 (Ailoot) — 移行するかを決める前に2つのツールを直接比較。
Claude Code and Codex Together (Ailoot) — 完全な切り替えを迷っている場合の共同作業パターン。
Hooks in Claude Code (Ailoot) — 移行対象を把握するための、Claudeにおけるフックの仕組み。

Ailoot経由でニューラルネットワークを利用したい場合は、Ailootをご覧ください。

詳細を見る