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

コンテキストを失わずにCodexのスキルをClaude Codeへ移行する方法 (2026)

過去数ヶ月の間に、Codexで一連のスキルを構築してきたことでしょう。リリースの準備をするもの、チームの好みに合わせてマイグレーションスクリプトを書くもの、不安定なテストを仕分けするものなどです。現在、業務の一部をClaude Codeで実行しており、そこでも同じスキルを使いたいと考えています。リポジトリにフォルダをコピーし、Claude Codeを開いてスキルの名前を入力しましたが、何も表示されませんでした。

スキル自体に問題はありませんでした。場所が間違っていたのです。CodexとClaude Codeはどちらも同じスキル形式を使用していますが、それぞれ独自のフォルダでスキルを探します。OpenAIのドキュメントには次のように記載されています。「リポジトリの場合、Codexは現在の作業ディレクトリからリポジトリのルートまでのすべてのディレクトリにある.agents/skillsをスキャンします。」一方、Claude Codeは.claude/skills/を探します。

このガイドでは、各ツールにおけるスキルの定義、それぞれの探索場所、そのまま引き継がれるもの、一対一で対応しないもの、スキルを移行する2つの方法、2つではなく1つのコピーを保持する方法、そしてどちらのツールを使用していてもスキルの背後にある推論を利用可能にする方法について説明します。

CodexとClaude Codeにおけるスキルとは

両方のツールは同じオープン標準に基づいています。OpenAIのドキュメントには「スキルはオープンなエージェントスキル標準に基づいています」とあり、Anthropicのドキュメントには「Claude Codeのスキルは、複数のAIツールで動作するAgent Skillsオープン標準に従っています」と記載されています。

Codexにおいて、OpenAIはその構造を次のように説明しています。「スキルは、SKILL.mdファイルと、オプションのスクリプトおよびリファレンスを含むディレクトリです。SKILL.mdファイルにはnameとdescriptionを含める必要があります。」スキルのフォルダには、scripts/、references/、assets/、およびagents/openai.yamlファイルを保持することもできます。

Claude Codeにおいても、スキルはSKILL.mdファイルを含むフォルダです。---マーカーの間のフロントマターは、Claudeにそのスキルをいつ使用するかを伝え、その下のマークダウンに指示が保持されます。

つまり、スキルの核となるフォルダ、SKILL.mdファイル、そのname、description、および指示は、両方のツールで同じ形式です。これは移行にとって朗報です。作業の大部分は、場所の特定と、各ツールが標準の上に追加しているいくつかの要素への対応になります。

各ツールがスキルを探す場所

これが冒頭の例の原因です。

Codexは、リポジトリ、ユーザー、管理者、およびシステムの場所からスキルを読み取ります:

  • リポジトリ: 現在の作業ディレクトリおよびリポジトリルートまでのすべてのフォルダにある.agents/skills。
  • ユーザー: $HOME/.agents/skills(すべてのリポジトリに適用されるスキルの場合)。
  • 管理者: /etc/codex/skills(マシン上で共有されるもの)。
  • システム: skill-creatorやskill-installerなど、Codexに同梱されているスキル。

Claude Codeは、以下の場所からスキルを読み取ります:

  • プロジェクト: リポジトリ内の.claude/skills/<skill-name>/SKILL.md。
  • パーソナル: ~/.claude/skills/<skill-name>/SKILL.md(そのマシン上のすべてのプロジェクト用)。
  • エンタープライズ: 組織がデプロイする管理された設定ディレクトリ。
  • プラグイン: 有効にしたプラグインに同梱されているスキル。

どちらのツールのドキュメントにも、もう一方のツールのフォルダについては記載されていません。したがって、.agents/skillsにあるスキルは、.claude/skills/に配置されるまでClaude Codeには表示されず、その逆も同様であると考えてください。

モノレポに関してはもう一つ違いがあります。Anthropicのドキュメントによると、Claude Codeは「起動したディレクトリおよびリポジトリルートまでのすべての親ディレクトリにある.claude/skills/からプロジェクトスキルをロードする」とされています。さらに、「起動した場所より下のディレクトリにある.claude/skills/ディレクトリのスキルは、起動時にはロードされない」と付け加えられています。これらは、Claudeがそのサブディレクトリ内のファイルを初めて読み取ったり編集したりするときにロードされます。

そのまま引き継がれるもの

両方のツールが同じ標準に従っているため、最も頻繁に記述する部分はそのまま引き継がれます:

  • フォルダ名とSKILL.md。 構造は同じです。
  • nameとdescription。 両方のツールは、説明(description)を使用してスキルを適用するタイミングを決定します。
  • 指示(Instructions)。 マークダウンの本文は、どちらのツールでも理解できるプレーンテキストです。
  • サポートファイル。 スキルフォルダ内のスクリプト、リファレンス、テンプレートも一緒に移行されます。

移行後、説明(description)は再確認する価値があります。OpenAIのCodexに対するアドバイスは「明確な範囲と境界を持つ簡潔な説明を書くこと」です。AnthropicのドキュメントにはClaude Code向けの制限が追加されています。「コンテキストの使用量を減らすため、スキル一覧ではdescriptionとwhen_to_useを合わせたテキストは1,536文字で切り捨てられます。」Codexでは問題なかった長い説明も、Claude Codeの一覧では途中で切れてしまう可能性があります。

一対一で対応しないもの

Codexスキルのいくつかの部分は、OpenAIの製品に固有のものです。

agents/openai.yaml。 OpenAIはこのファイルの目的を次のように説明しています。「ChatGPTデスクトップアプリのUIメタデータを設定し、呼び出しポリシーを設定し、スキルをよりシームレスに使用するためのツール依存関係を宣言するためにagents/openai.yamlを追加します。」ここには表示名やアイコン、暗黙的な呼び出しポリシー、MCPサーバーなどの依存関係が保持されます。Claude Codeのスキルドキュメントには、このファイルを読み取ることについての記載はありません。

呼び出しポリシー(Invocation policy)。 Codexでは、このファイルのpolicyセクションにallow_implicit_invocationなどの設定を保持します。Claude Codeには同じ概念のために独自のフロントマターフィールドdisable-model-invocationがあります。ドキュメントには「Claudeがこのスキルを自動的にロードするのを防ぐには、trueに設定します」とあります。Codexでスキルの暗黙的な呼び出しをオフにしていた場合は、移行後にスキルのSKILL.mdでこのフィールドを設定してください。

ツールの依存関係。 Codexスキルがopenai.yamlでMCPサーバーを宣言している場合、Claude Codeではそのサーバーを別途設定する必要があります。それなしでもスキルの指示が機能するか確認するか、Claude Codeにサーバーを追加してください。

スキルの呼び出し方。 Codex CLIやIDE拡張機能では、OpenAIは「/skillsを実行するか、$を入力してスキルに言及する」としています。Claude Codeでは、/skill-nameを使用して直接スキルを呼び出します。

名前の重複。 OpenAIは次のように述べています。「2つのスキルが同じnameを共有している場合、Codexはそれらをマージしません。両方がスキルセレクターに表示される可能性があります。」Claude Codeも、同じ名前を持つネストされたスキルを利用可能な状態に保ちます。スキルセットを組み合わせる場合は、それらに頼る前に衝突する名前を変更してください。

ルート1: /import を使用する

Claude Codeにはこのためのコマンドがあります。コマンドリファレンスでは、/importを、マシン上のOpenAI Codexや他のコーディングエージェントから「指示ファイル、MCPサーバー、コマンド、サブエージェント、スキルを含む」設定をClaude Codeに取り込む方法として説明しています。

実行をより安全にするための2つのオプションがあります:

  • まずプレビューする。 リファレンスには「何も書き込まずにプレビューするには--dry-runを追加し、インタラクティブなピッカーをスキップするには--yesを追加します」とあります。
  • ターミナルから実行する。 claude importは、同じオプションを使用して/importを実行するインタラクティブセッションを開始します。

新しいプロジェクトをセットアップする際、/initもCodexの設定を見つけた場合に/importで引き継ぐことを提案します。

実行前に読んでおくべきAnthropicのメモリドキュメントの詳細が1つあります。/importは「AGENTS.mdなどの指示ファイルの1回限りのコピーを、対応するCLAUDE.mdに追加し、MCPサーバー、コマンド、サブエージェント、スキルを引き継ぐ」と記載されています。

重要なキーワードは「1回限りのコピー(one-time copy)」です。インポート後、AGENTS.mdとCLAUDE.mdは別々のファイルになります。来月AGENTS.mdの規約を変更しても、CLAUDE.mdも更新するか、再度インポートを実行しない限り、Claude Codeには反映されません。スキルについても同様の考え方が当てはまります。一度スキルがコピーされると、Codex版を編集してもClaude Code版は変更されません。

ドキュメントには、/importがagents/openai.yamlやその他のOpenAI固有のメタデータをどのように処理するかについては記載されていません。インポート後、Claude Codeで各スキルを開き、そのフロントマターとサポートファイルを確認してください。

ルート2: シンボリックリンクで1つのコピーを保持する

両方のツールを使い続ける場合、すべてのスキルの2つのコピーは次第に乖離していきます。どちらのツールもシンボリックリンクされたスキルフォルダをサポートしているため、1つのソースを維持できます。

OpenAIのドキュメントには「Codexはシンボリックリンクされたスキルフォルダをサポートしており、これらの場所をスキャンする際にシンボリックリンク先を追跡します」とあります。

Anthropicのドキュメントには、エンタープライズ、パーソナル、またはプロジェクトの場所にあるスキルエントリは、ディスク上の別の場所にあるディレクトリへのシンボリックリンクにできると記載されています。「Claude CodeはターゲットからSKILL.mdを読み取り、複数の場所が同じターゲットを指していても、スキルを一度だけロードします。」

シンプルなレイアウトは、各スキルを1つの実体フォルダに保持し、もう一方のツールの場所からそこを指すようにすることです:

  • スキルを.agents/skills/release-notes/に保持し、Codexがそれを見つけられるようにします。
  • そのフォルダへのシンボリックリンクとして.claude/skills/release-notesを追加します。

これにより、1つのSKILL.mdへの編集が両方のツールに反映されます。Codexは「スキルの変更を自動的に検出」しますが、ドキュメントには更新が表示されない場合はCodexを再起動するように記載されています。Claude Codeで編集が反映されない場合は、新しいセッションを開始してください。

2つの注意点があります。シンボリックリンクされたスキルは1つの説明を共有するため、両方のツールの一覧で機能するように記述してください。また、disable-model-invocationなどのClaude Code専用のフロントマターは、Codexも読み取るファイル内に配置されることになるため、追加後もCodexがスキルを正常にロードできるかテストしてください。

パーソナルスキル

リポジトリではなく自分専用に保持しているスキルにも、同じ選択肢が適用されます。Codexはパーソナルスキルを$HOME/.agents/skillsから読み取ります。Claude Codeはそれらを~/.claude/skills/から読み取ります。これらをコピーするか、/importを実行するか、個々のスキルフォルダをシンボリックリンクすることができます。

Anthropicのドキュメントでは、パーソナルの場所にある1つのフォルダ名が予約されています。Claude Codeは、claude.aiアカウントからダウンロードされたスキルのために~/.claude/skills/synced/を使用するため、自分のスキルにsyncedという名前を付けないでください。

以前に逆方向の移行を行ったことがある場合、プラグインについても同じ場所とパッケージ化の問題が発生したはずです。その方向については、Claude CodeプラグインをCodexに移行するためのガイドで説明しています。

開始前に確認すべきこと

  • 実際に使用しているスキルはどれか。 移行は、誰も呼び出さないスキルを整理する良い機会です。
  • OpenAI固有のメタデータに依存しているスキルはどれか。 呼び出しポリシーやMCPの依存関係があるagents/openai.yamlファイルを探してください。
  • 今後もCodexを使い続けるか。 はいの場合は、シンボリックリンクを検討してください。いいえの場合は、コピーまたは/importで十分です。
  • 名前の衝突。 両方のツールでスキル名を比較してください。
  • あなたの AGENTS.md。 Claude Codeがコピーを読み取るようにするか、両方のファイルを維持するかを決定してください。

多くの人が最初に試してしまうこと

.agents/skillsをリポジトリにコピーして、Claude Codeがそれを見つけると期待すること。 Claude Codeは.claude/skills/を読み取ります。

/importがファイルを同期し続けると仮定すること。 これは指示ファイルの1回限りのコピーを追加するだけです。

openai.yamlの設定がそのまま引き継がれると放置すること。 スキルを自動的に実行すべきでない場合は、Claude Codeでdisable-model-invocationを設定してください。

長い説明をそのままにしておくこと。 Claude Codeは一覧表示において、結合された説明テキストを切り捨てます。

同じスキルの2つのコピーを維持すること。 それらは乖離していきます。両方のツールを使用する場合はシンボリックリンクを使用してください。

手動移行の手順

ステップ 1: Codexスキルのリストアップ

リポジトリ内、$HOME/.agents/skills内、および使用している管理場所にあるスキルを収集します。

ステップ 2: インポートのプレビュー

Claude Codeで--dry-runを付けて/importを実行し、何が取り込まれるかを確認します。

ステップ 3: インポートまたはリンク

インポートを実行するか、1か所に保持するスキルフォルダに対して.claude/skills/からシンボリックリンクを作成します。

ステップ 4: フロントマターの調整

Codexスキルで暗黙的な呼び出しがオフになっていた場所にdisable-model-invocationを追加し、長い説明を短縮します。

ステップ 5: 依存関係の再接続

openai.yamlを通じてスキルが依存していたMCPサーバーを設定します。

ステップ 6: 各スキルを名前でテストする

/skill-nameで各スキルを呼び出し、次にそれを自動的にトリガーするはずのリクエストを試します。

より良い方法:スキルの背後にある理由を一箇所にまとめる

スキルはタスクの実行方法を捉えたものです。その背後にある理由(なぜリリースチェックリストに手動のステップがあるのか、どのマイグレーションパターンが古いものに取って代わったのか、テスト仕分けスキルが絶対に触れてはいけないものは何かなど)は、プロジェクトのコンテキストです。ツール間でスキルを移動させると、指示は引き継がれますが、なぜそのような内容になっているのかという履歴は、誰かの記憶の中にしか残らない可能性があります。

MemoryLakeは、決定事項、規約、ワークフローの背後にある理由など、そのようなプロジェクトコンテキストのためのメモリレイヤーです。これらを一箇所で管理し、ChatGPT、Claude Code、Codexなど、接続するアシスタントから利用できるようにします。

エントリはあなた自身の言葉で記述します。スキルフォルダ、SKILL.mdファイル、AGENTS.mdやCLAUDE.mdファイル、CodexやClaude Codeの設定、あるいはベンダーのストアから何かが読み取られたり、書き込まれたり、削除されたりすることはありません。スキルと/importは、OpenAIとAnthropicが説明している通りに機能します。

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

サインインしてダッシュボードからキーを生成します。他の資格情報と同様に、リポジトリの外に保存してください。

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

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

手動移行のステップ1でリストアップしたスキルから始めます。それぞれのスキルについて、なぜそれが存在するのか、何を変更してはいけないのかを書き留めます。1つのスキルにつき1つのエントリを作成します。

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

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

Claude Code、Codex、および使用している他のアシスタントを接続します。どのツールがスキルを実行していても、それぞれが同じ理由(推論)を参照できるようになります。

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

実務で何が変わるか

第一の違いは、よりクリーンな移行です。履歴は別の場所に保管されているため、スキルは指示のみに削ぎ落とすことができます。

第二は、ツール間での一貫性です。Claude CodeでもCodexでも、同じ推論を利用できます。

第三は、更新の容易さです。規約が変わったとき、1つのエントリとそれに従うスキルを更新するだけで済みます。

CodexスキルをClaude Codeに移行するためのベストプラクティス

Claude Codeが探す場所にスキルを置く。 .claude/skills/ または ~/.claude/skills/ を使用してください。

インポート前にプレビューする。 --dry-run を使用してください。

1回限りのコピーであることを忘れない。 指示ファイルは /import 後に同期されません。

両方のツールを使うならシンボリックリンク。 1つのフォルダにすることで乖離を防げます。

呼び出しポリシーを変換する。 Claude Codeでは disable-model-invocation を使用してください。

説明は短く保つ。 両方のツールが説明でマッチングを行い、Claude Codeは長いものを切り捨てます。

名前とリクエストの両方でテストする。 手動と自動の両方の呼び出しを確認してください。

結論

CodexとClaude Codeは、オープンなエージェントスキル標準に基づいた同じスキル形式を使用しているため、スキルのフォルダ、SKILL.md、名前、説明、および指示はそのまま引き継がれます。異なるのは、各ツールがどこを探すかです。Codexは.agents/skills、Claude Codeは.claude/skills/です。agents/openai.yamlにあるCodex固有のメタデータには、disable-model-invocationなどのClaude Code相当の設定が必要です。

スキルは、AGENTS.mdなどの指示ファイルの1回限りのコピーも追加する/importを使用して取り込むか、両方のツールが追従するシンボリックリンクで1つのコピーを保持することができます。いずれにせよ、移行後は各スキルを確認し、スキルの背後にある理由を両方のツールが利用できる場所に保管しておきましょう。

よくある質問

Claude CodeでCodexのスキルを使用できますか?

はい。どちらも同じオープン標準に従っています。Claude Codeが見つけられるように、スキルフォルダを.claude/skills/に移動またはリンクしてください。

Claude Codeはどこでスキルを探しますか?

プロジェクトとその親ディレクトリの.claude/skills/、~/.claude/skills/、管理された設定、および有効なプラグイン内です。

/import はCodexのスキルを取り込みますか?

はい。Claude Codeのコマンドリファレンスでは、指示ファイル、MCPサーバー、コマンド、サブエージェントと並んで、/importが取り込む設定の中にスキルが挙げられています。

/import は AGENTS.md と CLAUDE.md を同期させますか?

いいえ。Anthropicのドキュメントには、指示ファイルの1回限りのコピーを追加すると記載されています。

両方のツールで1つのスキルフォルダを使用できますか?

はい。CodexとClaude Codeはどちらもシンボリックリンクされたスキルフォルダをサポートしています。

agents/openai.yaml はどうなりますか?

Claude Codeのスキルドキュメントには、これを読み取ることについての記載はありません。SKILL.mdでdisable-model-invocationなどの同等のオプションを設定してください。

移行したスキルをClaude Codeで呼び出すにはどうすればよいですか?

/に続けてスキル名を入力するか、その説明に一致するタスクを記述してください。