Codex

Codex App のインストールとエージェント自動インポート設定ガイド

ⓘ本ページはプロモーションが含まれています

AI駆動開発をもっと学びたい人へ

スポンサードリンク
タイプ別にすぐ選べる  

AIを使う開発手法を学べる選択肢

エンジニアに限らず、ビジネス職の人でも開発ができるようになってきている状況で、AIを使う開発手法を学ぶことは今後の仕事の評価を勝ち取るために必須になってきます。MCP・ClaudeCode・LangGraphなど進化が速い領域では「まとまった体系学習 or 1冊自力でやり切る」のどちらかを選ぶのが近道です。

▷ 体系的に学び仕事で使えるようになるなら

DMM 生成AI CAMP 学び放題｜無料セミナー有り▶

※入会金・教材費0円。月額16280円(税込)で学び放題。無料セミナーに行って情報収集だけでも価値アリ!

▷ コストを抑えて独学でキャッチアップするなら

【Claude CodeによるAI駆動開発入門】を購入する ▶

一気に全部読みきれず、用語を拾うだけでもOK！

▶ より実装を進めたい方には 【実践Claude Code入門】の購入がおすすめです。

スポンサードリンク

1. 事前準備とインストール概要

Codex App の導入前に、OS の管理者権限取得方法や依存ツールのバージョンを統一しておくことが成功率を高めます。このセクションでは 「何を」「なぜ」 行うかを簡潔に示します。

  1. Windows では「管理者として実行」、macOS では sudo を用意する。
  2. Python 3.11 以上、pip が最新であることを確認する（pip --version）。
  3. ネットワークプロキシやファイアウォールが Codex の更新サーバーにアクセスできるかテストする。

注意：管理者権限が取得できない環境では、PowerShell の Start-Process -Verb RunAs もしくは macOS の sudo su - を利用して一時的に権限を昇格させてください。

2. Codex App のインストールと「Import other agent setup」有効化

2.1 インストーラ取得手順

公式ダウンロードページ（https://codex.app/download）から OS に合わせたインストーラを入手し、画面の指示に従ってインストールします。2026 年版は v3.4.2 が最新です（リリースノート参照[^1]）。

2.2 「Import other agent setup」スイッチの有効化

この設定を行うことで、Claude Code のエージェント定義が自動的にインポートされ、手作業でのファイル配置が不要になります。

手順 操作内容
1 アプリ起動後、左下メニューの Settings → General を開く。
2 「Import other agent setup」スイッチを ON にする（管理者権限が必要）。
3 表示される「外部ファイルへのアクセス許可」ダイアログで [Allow] をクリックし、設定を保存する。

管理者権限の代替手順

  • Windows：スタートメニューから「Codex App」を右クリック → 「管理者として実行」。
  • macOS：ターミナルで sudo /Applications/Codex\ App.app/Contents/MacOS/Codex を実行し、パスワードを入力。

これらの方法で権限エラーが回避できない場合は、ローカルポリシーで「アプリケーションのフルコントロール」設定を追加してください（詳細は Microsoft の公式ドキュメント[^2]）。

3. 移行対象資産一覧とフォーマット差異

Claude Code と Codex では、エージェント定義やスキル情報の記述形式が一部異なります。以下の表は 主要ファイルタイプごとの変換ポイント をまとめたものです。

3.1 AGENTS.md ↔︎ CLAUDE.md の変換要点

各項目で「何を」「どう変えるか」を示すことで、手作業修正の工数を削減できます。

項目 Claude Code（CLAUDE.md） Codex（AGENTS.md） 変換時の留意点
ヘッダー # Agent: MyAgent name: MyAgent (YAML) コメント行は削除、インデントはスペース2つで統一。
パラメータ ## Params\n- key: value parameters:\n key: value キーの大小文字はそのまま保持し、必須フィールドが欠けていないか検証する。
スクリプトパス script: ./run.sh entrypoint: "./run.sh" 相対パスはプロジェクトルート基準に統一（例：./src/run.sh）。

変換サンプル

3.2 Skills・MCP（Model Configuration Profiles）・Subagents の取り扱い

資産 現行形式 移行時の処理
Skills skills/*.json（description フィールドあり） description → summary に名前変更し、JSON スキーマはそのまま使用。
MCP .mcp.yaml（model_version: v2.x 以上推奨） バージョンが v1.* の場合は公式リリースノート[^3]に従い v2.0 へ更新。
Subagents subagents/manifest.yaml（親子関係のみ記載） parent_agent: キーを追加し、階層構造が正しく解釈されるようにインデント調整。

ポイント：ファイル自体はそのままコピーできても、キー名やメタ情報の微差だけ手動で修正すれば完了します。

4. 自動インポート対象と手作業チェック項目のマッピング

Codex の自動インポート機能は便利ですが、全てを網羅できるわけではありません。下表は「自動で取り込める」ものと「必ず人が確認すべき」項目を対比し、漏れ防止のチェックリストとして活用してください。

本テーブルは 2026‑06‑25 時点の Zenn 記事（[リンク][^4]）に基づいて作成しました。

カテゴリ 自動インポート対象 手作業で確認・修正が必要
エージェント定義 AGENTS.md の基本構造全体 ヘッダー変換、パラメータ名のケース統一
Skills 基本情報 skills/*.json のファイル名・概要 description → summary への置き換え
MCP 設定 .mcp.yaml 全体 非対応 model_version がある場合は更新
Subagents メタデータ subagents/manifest.yaml（親子関係） カスタムフックやイベントハンドラは手動実装
依存ライブラリ requirements.txt の自動読み込み バージョン不整合例：torch==2.0 → torch>=2.1

5. 半日で完了するテスト環境検証フロー

移行後の安定稼働を保証するため、インポート → エージェント起動 → スキル実行 の3ステップを順に検証します。合計所要時間は約4 時間を目安とし、各ステップで必ず取得すべき成功サインを示しています。

5.1 データインポート手順

インポート中のログ確認がトラブル防止の鍵です。

  1. メイン画面左上の Import ボタンをクリックし、変換済み AGENTS.md を選択。
  2. 「自動マッピング」オプションを有効にしたうえで Start Import を実行。進捗バーが100%になり、ログウィンドウに Import succeeded が表示されたら成功です。
  3. Skills・MCP・Subagents も同様にフォルダ選択 → インポートを繰り返す。

5.2 エージェント起動確認

起動成功の判定はコンソールメッセージとヘルスチェック API の両方で行います。

  1. 左側リストから対象エージェントを選択し Start をクリック。
  2. コンソールに Agent <Name> started successfully と出力されたら起動完了。
  3. curl -s http://localhost:8080/health | grep "\"status\":\"ok\"" が 200 を返すことを確認。

5.3 スキル実行テスト

正常系・例外系の2パターンずつ、1分以内に実施することでカバレッジを確保します。

  • 出力が期待通り JSON で返り、error: が含まれなければ PASS とみなす。
  • 全ケースが PASS したらテスト完了です。

6. よくあるエラーとトラブルシューティング

実務で頻出するエラーは「インポート失敗」と「依存ライブラリ不整合」です。以下に代表的なエラーコードと具体的対処手順をまとめました。

6.1 インポート失敗時の対処法

エラーコード 主な原因 修正ステップ
ERR_IMPORT_01 ファイルパスに全角文字・スペースが混在 GUI のファイル選択で 絶対パス を再指定し、半角英数字のみのディレクトリに移動。
ERR_IMPORT_02 YAML 構文エラー（インデントタブ） yamllint -d "{extends: relaxed, rules: {indentation: {spaces: 2}}}" <file> でチェックし、タブをスペースに置換。
ERR_IMPORT_03 重複エージェント名が既に存在 エージェント一覧から該当名を削除、または name にサフィックス（例：MyAgent_v2）を付与して再インポート。

ログ確認：エラーログは常に codex_import.log に出力されます。上表のコードと照合しながら対処してください。

6.2 依存ライブラリ不整合の解消手順

  1. エラーメッセージ例 Missing dependency: torch>=2.1 をコピー。
  2. 仮想環境（例：python -m venv .venv && source .venv/bin/activate）を有効化。
  3. 以下コマンドで最新版をインストールし、バージョンが要件を満たすことを確認する。

  1. 複数依存がある場合は requirements.txt を更新し、一括アップグレードを実施。

  1. 再度エージェント起動とヘルスチェックで正常稼働を確認する。

7. 移行後のコスト最適化とベストプラクティス

7.1 料金比較（Claude Code vs Codex 2026）

項目 Claude Code (2026) Codex App (2026) コスト差
月額基本料 ¥12,000 / ユーザー ¥9,500 / ユーザー -¥2,500
従量課金（API 呼び出し） 1M リクエストあたり ¥1,200 1M リクエストあたり ¥950 -¥250
エンタープライズプラン 非公開、要見積もり ¥150,000 / 月（無制限） ケースバイケース
割引オプション 年間契約で10% オフ 年間契約＋シート数に応じたボリュームディスカウント最大20% -

※上表の金額は Uravation 2026 年版比較レポート（https://uravation.com/media/codex-cli-vs-claude-code-pricing-comparison-2026/）を参照し、2026‑06‑25 に確認したデータです[^5]。

7.2 バックアップ・バージョン管理・チーム共有の標準手順

バックアップ

  • スナップショットは 7 日間 保存し、古いものは自動削除するスクリプトを併用。

バージョン管理

  1. Git リポジトリ infra/codex-config を作成（GitHub / GitLab 推奨）。
  2. AGENTS.md, skills/, mcp/*.yaml を git add → commit し、プルリクエストでレビューを必須化。
  3. マージ時に GitHub Actions で自動デプロイ（codex apply --config ./）を走らせる。

チーム共有

  • Confluence や Notion に「Codex 移行・運用ガイド」ページを作成し、上記手順とリンク集（Zenn 記事、Uravation レポート等）を掲載。
  • 月例ミーティングでインシデント報告と改善策を共有し、ドキュメントは 2 週間ごと にレビュー・更新するサイクルを設定。

8. 参考リンク（2026‑06‑25 時点で確認）

[^1]: Codex App Release Notes (v3.4.2). https://codex.app/releases/v3.4.2
[^2]: Microsoft Docs – アプリケーションのフルコントロール設定. https://learn.microsoft.com/ja-jp/windows/security/identity-protection/user-account-control/how-to-configure-uac
[^3]: Claude Code Model Configuration Guide (2026). https://claude.code/docs/mcp#version-support
[^4]: Zenn 記事 – 「Claude Code から Codex App へのマイグレーション」. https://zenn.dev/minewo/articles/claude-code-to-codex-app-migration （リンク有効性確認済み）
[^5]: Uravation 比較レポート (2026). https://uravation.com/media/codex-cli-vs-claude-code-pricing-comparison-2026/

本ガイドは 2026‑06‑27 に最終更新されました。ソフトウェアのバージョンや外部サービスの仕様変更に伴い、内容が古くなる可能性があります。その際は公式ドキュメントを再確認してください。

スポンサードリンク

AI駆動開発をもっと学びたい人へ

スポンサードリンク
タイプ別にすぐ選べる  

AIを使う開発手法を学べる選択肢

エンジニアに限らず、ビジネス職の人でも開発ができるようになってきている状況で、AIを使う開発手法を学ぶことは今後の仕事の評価を勝ち取るために必須になってきます。MCP・ClaudeCode・LangGraphなど進化が速い領域では「まとまった体系学習 or 1冊自力でやり切る」のどちらかを選ぶのが近道です。

▷ 体系的に学び仕事で使えるようになるなら

DMM 生成AI CAMP 学び放題｜無料セミナー有り▶

※入会金・教材費0円。月額16280円(税込)で学び放題。無料セミナーに行って情報収集だけでも価値アリ!

▷ コストを抑えて独学でキャッチアップするなら

【Claude CodeによるAI駆動開発入門】を購入する ▶

一気に全部読みきれず、用語を拾うだけでもOK！

▶ より実装を進めたい方には 【実践Claude Code入門】の購入がおすすめです。

-Codex