Contents
1. 機能比較（Claude Code v1.x ↔ Codex App v2.x）
本セクションでは、2026 年 4 月にリリースされた Claude Code v1.4 と、2026 年 5 月に登場した Codex App v2.7 の代表的な機能を対比します。両製品は同一ベンダーが提供する開発プラットフォームですが、UI・認証方式・データスキーマの変更点が多く、移行時に注意すべきポイントが散在しています。以下の表は「何が変わったか」だけでなく、「移行後に必ず確認すべき項目」も併記しているので、チェックリストとして活用してください。
| 項目 | Claude Code v1.4 の特徴（※要確認） | Codex App v2.7 の特徴（※要確認） | 移行時の留意点 |
|---|---|---|---|
| コード編集・実行環境 | Web エディタは Monaco 0.34、ローカルコンテナで実行。デバッグはブレークポイントのみ対応。 | デスクトップアプリ（Electron 28）＋クラウドランタイム。ステップ実行と変数ウォッチが追加。 | デバッグスクリプトは Codex の API 形式に合わせて書き換える必要があります。 |
| CI/CD 連携 | GitHub Actions 用テンプレートを同梱し、手動でパイプラインを構築。 | 内蔵 CI エンジン（Codex Pipelines）と Azure DevOps 連携オプションを提供。 | 既存の Actions はインポート可能だが、Pipelines に移行するとビルド時間が約15‑20%短縮されます（ベンチマークは公式発表）。 |
| ルール設定とフック | rules.json と hooks.yaml を使用。削除禁止は rule.type: "no-delete" で定義。 |
スキーマが v2 に刷新。削除禁止は policy: "protect-delete" に変更。 |
JSON/YAML のスキーマ差分により、インポート後の手動レビューが必須です。 |
| MCP（Meta‑Control‑Panel）連携 | 環境変数 MCP_TOKEN に API キーを保存して利用。 |
OAuth2 ベースの認証プロバイダーへ置き換え、トークン管理が必須。 | 環境変数から OAuth 設定へのマイグレーションスクリプトを作成してください。 |
| Knowledge‑base | ローカル JSON (kb/*.json) で記事・プロンプトを管理。 |
GraphQL ベースのクラウド Knowledge Graph に統一。自動変換ウィザードあり。 | パス表記が kb:// → knowledge:// に変わるため、コード内のハードコーディング箇所は置換が必要です。 |
| 権限管理 | プロジェクト単位の ACL。削除禁止は個別ルールで設定。 | 組織レベルの RBAC と「保護ポリシー」機能を追加。 | 既存 ACL はインポートできるが、保護ポリシーは手動で再定義する必要があります（例：protect-delete）。 |
| 拡張機能 | VS Code 拡張とブラウザプラグインのみ提供。 | プラグインマーケットプレイス統合、CLI からのインストールが可能。 | 必要な拡張は Codex Marketplace で再取得し、バージョン互換性を確認してください。 |
ポイント：多くの差分は「データ形式」や「認証方式」の変更に起因します。自動インポートだけでは解決できないスキーマ変換・認証リプレイスは必ず手動でレビューし、テスト環境で検証してから本番へ適用してください。
2. 移行前の資産可視化とバックアップ戦略
2‑1. 資産一覧化の重要性
移行作業は「見える化」なしに始めると、設定漏れやデータロスが顕在化した際に復旧コストが膨らみます。そこでまずは 全プロジェクト・ルール・フック・MCP 設定・Knowledge‑base を API 経由で抽出し、暗号化したうえで「ローカル＋クラウド」の二重保存を徹底します。
2‑2. 全リポジトリ・設定項目の抽出手順（CLI）
以下は公式 API（2026 年版）に準拠したサンプルです。$CLAUDE_TOKEN は管理者権限を持つアクセストークンで、期限切れにならないよう定期的に更新してください。
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 |
# 1. プロジェクト一覧取得 curl -s -H "Authorization: Bearer $CLAUDE_TOKEN" \ https://api.anthropic.com/v1/claude-code/projects > projects.json # 2. 各プロジェクトのルール・フックをエクスポート for pid in $(jq -r '.[].id' projects.json); do curl -s -H "Authorization: Bearer $CLAUDE_TOKEN" \ https://api.anthropic.com/v1/claude-code/projects/$pid/rules > rules_${pid}.json curl -s -H "Authorization: Bearer $CLAUDE_TOKEN" \ https://api.anthropic.com/v1/claude-code/projects/$pid/hooks > hooks_${pid}.yaml done # 3. MCP 設定と Knowledge‑base の取得 curl -s -H "Authorization: Bearer $CLAUDE_TOKEN" \ https://api.anthropic.com/v1/claude-code/mcp > mcp_config.json curl -s -H "Authorization: Bearer $CLAUDE_TOKEN" \ https://api.anthropic.com/v1/claude-code/kb/export > knowledge_base.zip |
ポイント：取得したファイルは必ず
gpgで対称暗号化し、復元時にパスフレーズを別途安全な場所に保管してください。
2‑3. 二重保存（ローカル＋クラウド）手順
| 手順 | 実施内容 | 推奨ツール |
|---|---|---|
| 1. ローカル暗号化 | tar でまとめた後、AES‑256 で暗号化。 |
gpg --symmetric --cipher-algo AES256 backup.tar.gz |
| 2. クラウドへアップロード | 暗号化ファイルを S3（または Azure Blob）に転送し、バージョニングとライフサイクルポリシーを有効化。 | aws s3 cp backup.tar.gz.gpg s3://my-backup-bucket/claude-code/ --storage-class STANDARD_IA |
| 3. 保持期間設定 | 法的要件に合わせて最低 90 日保持し、以降は自動削除ルールを適用。 | S3 Lifecycle Policy (Expiration: Days=90) |
ポイント：ファイル名に
YYYYMMDD_HHMMタイムスタンプを付与すると、復元時のバージョン特定が容易です。
3. Codex App の自動インポート機能活用ガイド
3‑1. インポートウィザードの概要
Codex App（2026/05/03 発表）は 「Import other agent setup」 機能を提供しており、Claude Code の設定を自動検出・変換します。GUI と CLI の両方で起動できるため、スクリプト化したい場合は CLI が便利です。
3‑2. GUI 版インポート手順
- Codex App を起動し、左メニューの Settings → General に移動。
- 「Import」ボタンをクリックし、ダイアログで「Claude Code」→「v1.x」を選択。
- Claude の API キー（
$CLAUDE_TOKEN）を入力すると、対象資産がスキャンされます。
ポイント：GUI はインタラクティブなので、初回は手順確認に最適です。ただし大量プロジェクトの一括移行には CLI が推奨されます。
3‑3. CLI 版インポートコマンドとオプション
|
1 2 3 4 5 6 7 |
codex-cli import \ --source claude-code \ --version 1.x \ --token $CLAUDE_TOKEN \ --target org=my-org \ --dry-run # 本番適用前に対象項目を確認 |
--dry-run：実際のインポートは行わず、変換結果のみレポートします。--skip-mcp：MCP の認証情報は自動移行できないため除外できます。
ポイント：CI パイプライン内で
codex-cli import --dry-runを実行し、差分が期待通りかを GitHub Actions などで自動検証すると安全です。
3‑4. インポート対象リソース一覧
| リソース種別 | 自動検出可否 | 補足 |
|---|---|---|
| コードベース（Git URL） | ✅ | ブランチ情報も取得 |
ルール (rules.json) |
✅ | 非互換項目は警告表示 |
フック (hooks.yaml) |
✅ | 必須フィールドが不足している場合は手動追加 |
| MCP 設定 | ⚠️ | API キーはインポートされず、OAuth2 への切り替えが必要 |
| Knowledge‑base エントリ | ✅ | ローカル JSON → GraphQL ミューテーションへ自動変換 |
| CI/CD テンプレート | ⚠️ | GitHub Actions はインポート対象外。Codex Pipelines 用テンプレートは別途作成 |
ポイント：
⚠️が付く項目は、インポート後に必ず手動レビューを実施してください。
4. 自動インポート後の手動レビューチェックリスト
4‑1. ルール・フックの整合性確認
rules_*.jsonにpolicy: "protect-delete"が正しく設定されているかjqで検索。- フック YAML の必須フィールド（例：
trigger.onFailure）が欠落していないか目視確認。
|
1 2 3 4 5 6 |
for f in rules_*.json; do if ! jq -e '.policy=="protect-delete"' "$f" >/dev/null; then echo "⚠️ $f に削除保護ポリシーが未設定" fi done |
4‑2. MCP 認証設定の再検証
- Codex Dashboard の Integrations → MCP ページで、OAuth クライアント ID/Secret が正しく登録されているか確認。
- テストエンドポイントに対して
curl -H "Authorization: Bearer $CODEx_TOKEN"を実行し、200 OK が返ることをチェック。
4‑3. Knowledge‑base パス置換の徹底
- ソースコード中の
kb/プレフィックスはすべてknowledge://に置換。VS Code の検索・置換例： -
Find:
kb\/([^"]+)→ Replace:knowledge://\1 -
置換後に全テストケースを CI 上で実行し、参照エラーが無いことを確認。
4‑4. 非互換要素の代替策と再構築手順
| 非互換項目 | 推奨代替策 | 再構築手順 |
|---|---|---|
rule.type: "no-delete" |
policy: "protect-delete" に置換 |
上記スクリプトで自動変換後、Codex UI の「保護ポリシー」画面で有効化 |
| MCP API キー方式 | OAuth2 認証フローへ移行 | Dashboard → Integrations → MCP → 「新規 OAuth アプリ」を作成し、クレデンシャルを保存 |
| ローカル Knowledge‑base JSON | GraphQL ミューテーションでインポート | codex-cli kb import knowledge_base.zip --format graphql を実行 |
ポイント：手動レビューの結果は必ず Git リポジトリにコミットし、チーム全体で共有できる形にしておきましょう。
5. 移行後の検証フローとリスク回避策
5‑1. テストケース実行と合格基準
- ユニットテスト：
npm test（またはcargo test）を Codex の CI に登録し、全テストが 0 エラーで完走すること。 - 統合テスト：MCP 連携や Knowledge‑base 参照を含むシナリオを自動化（例：
cypress run --spec integration/mcp_spec.js）。 - レポート作成：JUnit XML を Codex の「Test Dashboard」にアップロードし、失敗率が 1 % 未満であることを目標にします。
5‑2. パフォーマンス測定基準と手順
| 指標 | 合格ライン（Codex v2.7） | 測定コマンド例 |
|---|---|---|
| 起動時間 | ≤ 3 秒 | time codex-cli start |
| コード実行レイテンシ | 平均 120 ms 以下 | ab -n 1000 -c 10 http://localhost:8080/run |
| メモリ使用量 | 最大 800 MB 未満 | top -b -p $(pgrep codex) |
ポイント：本番環境と同等の負荷（同時ユーザー数）で測定し、閾値を超える場合は段階的ロールバックまたはリソース増強を検討してください。
5‑3. ロールバック手順と失敗事例対策
- スナップショット取得（移行前）
bash
aws ec2 create-snapshot \
--volume-id vol-0123456789abcdef0 \
--description "Claude Code 移行前スナップショット" - ロールバック実施
- スナップショットからボリュームを復元し、旧環境の Docker コンテナを再起動。
- DNS エイリアス（例：
app.example.com）を旧サーバーに切り替えるだけで即座に復帰可能。
主な失敗シナリオと回避策
| シナリオ | 原因 | 回避策 |
|---|---|---|
| インポート漏れ（フック未移行） | --dry-run を実施せず直接インポート |
必ず codex-cli import --dry-run で対象一覧を確認 |
| MCP 認証エラー | OAuth 設定忘れ | 移行後すぐに curl -H "Authorization: Bearer $CODEx_TOKEN" でテスト |
| サービス停止リスク（同時デプロイ） | 全体切り替えを一括実施 | Canary デプロイとフェイルオーバー用スナップショットを必ず作成 |
ポイント：リスクは「事前検証」＋「段階的ロールアウト」で最小化できます。特に本番切替は業務時間外に実施し、緊急対応フローを全員が把握していることが重要です。
まとめ
- 比較表で機能差と留意点を俯瞰的に確認できるようにしました。
- 資産の可視化・二重バックアップは、万が一のロールバックを迅速に行うための必須作業です。
- Codex の自動インポートは便利ですが、スキーマ変換や認証リプレイスは手動レビューが不可欠です。
- 移行後のテスト・パフォーマンス測定・ロールバック手順を体系化することで、予期せぬ障害発生時にも安全に復旧できます。
本ガイドを踏襲しつつ、必ず公式ドキュメントで最新情報を確認したうえで作業を進めてください。安全かつスムーズなプラットフォーム移行が実現できることを願っています。