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

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

過去1年間で、あなたはClaudeでいくつかのスキルを構築してきました。チーム好みの形式でリリースノートを作成するもの、会議の文字起こしをアクションアイテムに変換するもの、プルリクエストをハウスルールに照らしてチェックするものなどです。これらの一部はClaudeの設定にあり、ZIPファイルとしてアップロードされています。また、Claude Code用に作成したため、~/.claude/skillsに保存されているものもあります。現在、あなたはCodexをより頻繁に使用するようになり、同じスキルをそこでも使いたいと考えています。

幸いなことに、どちらのツールも同じフォーマットに基づいています。OpenAIのCodexドキュメントには、「スキルはオープンなエージェントスキル標準に基づいています」と記載されています。Anthropicのドキュメントでも、Claudeのスキルを同様に、SKILL.mdファイルを中心とした指示、スクリプト、リソースのフォルダとして説明しています。

実際の作業は細部にあります。それぞれのClaudeスキルがどこにあるのか、Codexのインポーターがどれを拾い上げるのか、どのフロントマター(frontmatter)フィールドをCodexが読み取るのか、そしてどのClaude Code機能が引き継がれないのか。このガイドでは、それらすべてに加えて、ファイルを移動する際に各スキルの背後にある「理由」を維持する方法についても説明します。

それぞれの側におけるスキルの定義

Anthropicのヘルプセンターでは、スキルを次のように一行で定義しています。「スキルとは、特定のタスクにおけるパフォーマンスを向上させるためにClaudeが動的にロードする、指示、スクリプト、リソースのフォルダです。」

OpenAIの定義も似ています。「スキルとは、SKILL.mdファイルと、オプションのスクリプトおよびリファレンスを含むディレクトリです。SKILL.mdファイルにはnameとdescriptionを含める必要があります。」

どちらのツールも、基本的には同じ方法でスキルをロードします。Codexは各スキルの名前と説明から開始し、使用を決定したときに完全な指示をロードします。AnthropicもClaudeのバージョンを「段階的な開示(progressive disclosure)」と表現しており、Claudeが利用可能なスキルを確認し、関連するものをロードします。

したがって、スキルのフォルダはほとんどの場合、移植可能です。問題は、各スキルをCodexが読み取る場所にどのように配置し、その過程で何を修正するかです。

Claudeスキルの保存場所

スキルは最大3つの場所に存在する可能性があり、それぞれ移動方法が異なります。

Claudeアプリ内のスキル。 これらはチャット内で作成したか、claude.aiまたはClaude DesktopでZIPファイルとしてアップロードしたスキルです。これらはコンピュータのフォルダではなく、あなたのアカウント上に存在します。Anthropicのヘルプセンターでは、コピーを取得する方法を説明しています。スキルリストからスキルを見つけ、詳細を開いてダウンロードします。更新されたレイアウトでは、スキルリストは「Customize」メニューに代わって「Plugins」の下にあります。

Claude Code内のスキル。 個人用スキルは ~/.claude/skills/<skill-name>/SKILL.md にあります。プロジェクト用スキルはリポジトリの .claude/skills/ にあります。プラグイン用スキルはプラグインの内部にあります。

claude.aiからClaude Codeに同期されたスキル。 claude.aiアカウントでClaude Codeにサインインすると、Claude Codeはアカウントのスキルを ~/.claude/skills/synced/ にダウンロードします。これらはアプリスキルのコピーであり、独立したオリジナルではありません。ドキュメントによると、ここでの編集は元には保存されないため、アプリ版をソースとして扱う必要があります。

移動を開始する前に、各場所にあるスキルをリストアップし、どれが重複しているかを確認してください。

Codexのインポーターが引き継ぐもの

Codexにはインポートフローがあり、これによって一部がカバーされます。OpenAIのインポートドキュメントによると、ChatGPTデスクトップアプリはClaude Code、Claude Cowork、またはCursorからインポートでき、CLIはClaude CodeまたはCursorからインポートできます。CLIでは、アイドルセッション中に /import を実行します。

インポート対象の表には「スキル」が含まれており、これらはCodexのスキルになります。また、「スラッシュコマンド」もスキルに変換されます。ドキュメントには、移行時に重要な保証が付け加えられています。「インポートによって、既存のエージェント設定が変更されたり削除されたりすることはありません。」

したがって、Claude Codeにあるスキルについては、まずインポーターを試すのが最善です。Claudeアプリで作成したスキルについては、インポートドキュメントにClaudeアプリがソースとして明記されていません。Coworkを使用している場合は、デスクトップアプリのインポート項目リストに何が表示されるか確認してください。そこにリストされていないものについては、スキルをダウンロードして手動でインストールしてください。

フックやMCPサーバーをスキルとパッケージ化できるClaude Codeプラグインをインポーターがどのように処理するかについては、Claude CodeプラグインをCodexに移行するガイドで詳しく解説しています。

Codexがスキルを読み取る場所

Codexは、以下の4種類の場所からスキルを読み取ります。

  • リポジトリ: 現在のフォルダ、およびリポジトリのルートまでのすべての親フォルダにある .agents/skills。
  • ユーザー: すべてのリポジトリで使用したいスキルのための $HOME/.agents/skills。
  • 管理者: 共有システム上の場所である /etc/codex/skills。
  • システム: skill-creator や skill-installer など、Codexに同梱されているスキル。

パスはClaude Codeのものとは異なります。~/.claude/skills/ にある個人用のClaude Codeスキルは、Codexでは ~/.agents/skills/ に対応します。リポジトリ内の .claude/skills/ にあるプロジェクトスキルは、.agents/skills/ に対応します。

また、Codexは重複した名前の処理方法が異なります。ドキュメントには次のようにあります。「2つのスキルが同じ name を共有している場合、Codexはそれらをマージしません。両方がスキルセレクターに表示される可能性があります。」スキルをインポートした後に同じものを手動でコピーすると、2つ存在することになってしまいます。

引き継がれるフロントマターのフィールド

ここが編集作業のメインとなる部分です。

Anthropicのドキュメントでは、スキルのフロントマターを2つのグループに分けています。Claude Codeは長いフィールドのリストを受け入れます。しかし、claude.aiへのスキルアップロードやSkills APIでは、name、description、license、compatibility、metadata、allowed-tools の6つのみが許可されています。

これには有益な結果があります。Claudeアプリにアップロードしたスキルはすでに共有フォーマットを使用しているため、編集は最小限で済みます。

Claude Code用に書かれたスキルは、argument-hint、disable-model-invocation、paths、context、model、effort、hooks など、Claude Codeのみが動作するフィールドを使用している可能性があります。Codexのドキュメントでは name と description が必須とされており、その他のフィールドについては説明されていないため、それらがCodexで機能することは期待しないでください。

いくつかはCodexに相当するものがあります:

  • disable-model-invocation: true は、Claudeが自らスキルを呼び出すのを防ぎます。Codexでは、agents/openai.yaml ファイルで allow_implicit_invocation を false に設定することで同じ効果が得られます。OpenAIのドキュメントによると、これによりCodexはスキルを暗黙的に呼び出さなくなりますが、明示的な呼び出しは引き続き機能します。
  • name の欠落 はClaude Codeでは機能し、フォルダ名が代用されます。Codexでは必須なので、追加してください。

ついでに説明文(description)も確認しましょう。Codexは多くのスキルがインストールされている場合に説明文を短縮します。ドキュメントでは次のようにアドバイスしています。「説明文が短縮されてもホストがスキルを一致させることができるよう、主要なユースケースとトリガーワードを前の方に配置してください。」

本文中で引き継がれないもの

Claude Codeは、他のツールではサポートされていないスキル指示内の機能をサポートしています。Anthropicのドキュメントには次のように記載されています。「動的なコンテキスト注入など、Claude Code専用の本文機能は、claude.aiのチャットやAPI経由では機能しません。」

Codexに移行する場合も同様です。以下の点に注意してください:

  • 出力を注入するシェル行: コマンドの前に感嘆符(!)を付けて記述されます。Claude Codeはスキルがロードされる前にこれらを実行します。
  • プレースホルダー: ${CLAUDE_PROJECT_DIR} や引数の置換など。
  • ファイル参照: Claude Codeが添付する @ を使った参照。

OpenAIのインポートドキュメントでも、インポート後に確認すべき事項として同じカテゴリを挙げています。「引数、シェル補完、またはファイルパスのプレースホルダーに依存するプロンプトテンプレートやコマンド形式のプロンプト。」これらはプレーンな指示として書き換えるか、コマンドをスキルの scripts/ フォルダ内のスクリプトに移動し、いつ実行するかをCodexに指示するように変更してください。

Codexでのスキルのオン/オフ切り替え

スキルを配置した後、一部を利用可能にしつつも、普段は無効にしておきたい場合があります。Codexでは、~/.codex/config.toml の [[skills.config]] エントリを使用して、削除せずにスキルを無効化できます。各エントリはパスで1つのスキルを指定するか、特定の名前を持つすべてのスキルに一致させ、disabledに設定します。OpenAIのドキュメントによると、複数のエントリが1つのスキルに一致する場合、最後の一致エントリが優先されます。

追加したスキルが表示されない場合、ドキュメントにはCodexがスキルの変更を自動的に検出すると記載されていますが、「更新が表示されない場合は、Codexを再起動してください」とも付け加えられています。設定ファイルを変更した後も同様です。

スキル内のツール権限

Claude Codeの allowed-tools フィールドは、スキルを呼び出すターンに対してツールを事前に承認します。OpenAIのインポートドキュメントでは、「インポートされたスキルやエージェントにおけるツールの制限や権限」をインポート後に確認すべき項目として挙げています。

Codexには、サンドボックス、承認、コマンドルールを備えた独自の権限モデルがあります。Claude Codeでプロンプトなしで実行されていたスキルが、Codexでは承認を求める場合があります。より広範なルールを追加して静かにさせる前に、それが望ましい動作かどうかを判断してください。

ワークスペーススキルと共有

ChatGPTでもスキルを使用している場合、OpenAIのスキル制御ドキュメントでは、ChatGPTワークスペーススキル、ローカルファイルシステムスキル、プラグインの3種類を区別しています。そして次のように警告しています。「スキルの移動によって、ChatGPTワークスペースの所有権、共有、ロールの割り当て、プラグインのインストール状態、またはコネクタの認証が転送されることはありません。」

つまり、チームがClaudeで共有していたスキルは、Codexに移行しても共有された状態にはなりません。チームに同じスキルを提供するには、OpenAIのドキュメントでは、CodexとChatGPTの両方で機能するプラグインとしてパッケージ化することを推奨しています。

よくある間違い

スキルを ~/.codex にコピーしてしまう。 Codexはユーザーのスキルを ~/.agents/skills から読み取ります。

インポーターがClaudeアプリのスキルを見つけると期待する。 これらはダウンロードして手動でインストールする必要があります。

Claude Code専用フィールドを残したままにする。 Codexは name と description を必要とし、それ以外は認識しません。

シェル注入行をそのままにする。 これらはClaude Code独自の機能です。

同じスキルをインポートして、さらにコピーもする。 Codexは両方を保持してしまいます。

手動移行の手順

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

Claudeアプリのスキルリスト、~/.claude/skills、および各リポジトリの .claude/skills を確認します。

ステップ 2: Claude Codeスキルのインポーター実行

Codex CLIで /import を使用するか、ChatGPTデスクトップアプリの設定で「Import」を使用します。

ステップ 3: Claudeアプリスキルのダウンロード

各カスタムスキルの詳細ページから保存し、ZIPを解凍します。

ステップ 4: Codexが読み取る場所に各スキルを配置

個人用スキルには ~/.agents/skills を、リポジトリ用スキルには .agents/skills を使用します。

ステップ 5: フロントマターの編集

name と description を保持し、呼び出し設定を agents/openai.yaml に移動します。

ステップ 6: Claude Code専用の本文機能の書き換え

シェル注入やプレースホルダーを、指示またはスクリプトに置き換えます。

ステップ 7: 各スキルのテスト

$ または /skills で呼び出し、一致するリクエストでトリガーされることを確認します。

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

スキルはタスクの実行方法を記録したものです。しかし、なぜリリースノートがその構造に従うのか、どのレビュアーがそのルールを求めたのか、どのエッジケースをそのステップが処理しているのかといった「背後にある理由」は、ファイル内にはないかもしれません。ファイルが新しいツールに移動しても、手順は届きますが、推論プロセスは誰かの記憶の中に残されたままになります。

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

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

ステップ 1: APIキーの作成

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

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

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

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

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

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

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

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

実践で何が変わるか

第一の違いは、編集が容易になることです。ルールの存在理由がわかれば、Codexでの書き換えがその意味を維持しているかどうかを判断できます。

第二に、スキルがよりクリーンになります。頻繁に変わる事実は SKILL.md から切り離され、別途更新するノートに保存されます。

第三に、ツール間での一貫性です。Claude CodeとCodexの両方を使用している間、同じ理由をどちらからでも利用できます。

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

まずはインポーターから始める。 Claude Codeのスキルを処理し、Claudeの設定は変更されません。

アプリのスキルをソースとして扱う。 Claude Code内の同期されたコピーは、元には保存されません。

共有フィールドを使用する。 name と description は両方のツールで機能します。

説明文は前の方に重要な情報を置く。 Codexは説明文を短縮することがあります。

名前の重複を避ける。 Codexはそれらをマージしません。

共有スキルはプラグインとしてパッケージ化する。 共有設定はファイルと一緒に移動しません。

結論

ClaudeとCodexは同じオープンフォーマットに基づいてスキルを構築しているため、SKILL.md ファイルを含むスキルフォルダはほとんどの場合移植可能です。Codexのインポーターは、Claudeの設定を変更することなくClaude Codeのスキルとスラッシュコマンドを取り込みます。一方、Claudeアプリで作成したスキルは、手動でダウンロードして ~/.agents/skills またはリポジトリの .agents/skills に配置する必要があります。

Claudeアプリにアップロードされたスキルは、すでに共有フィールドを使用しています。Claude Code用に作成されたスキルは、フロントマターの整理、呼び出し設定の agents/openai.yaml への移動、およびシェル注入などのClaude Code専用機能の書き換えが必要になる場合があります。共有設定、所有権、コネクタの認証はファイルと一緒に移動しないため、これらは別途計画してください。

よくある質問

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

はい。どちらもオープンなエージェントスキル標準に基づいているため、SKILL.md フォルダは多少の編集で移動可能です。

CodexはClaudeからスキルをインポートしますか?

CodexのインポーターはClaude Codeのスキルを取り込みます。Claudeアプリのスキルはダウンロードして手動で追加する必要があります。

Codexのスキルはどこに置けばよいですか?

個人用スキルは ~/.agents/skills に、リポジトリ用は .agents/skills に配置します。

Claudeからスキルをダウンロードするにはどうすればよいですか?

スキルリストでスキルの詳細を開き、ダウンロードを選択します。

Codexにはどのフロントマターが必要ですか?

name と description が必須です。

Codexがスキルを自動的に使用するのを止めるにはどうすればよいですか?

スキルの agents/openai.yaml で allow_implicit_invocation を false に設定します。

インポートによってClaude Codeの設定は変わりますか?

いいえ。OpenAIは、インポートによって既存の設定が変更されたり削除されたりすることはないと述べています。