本文へ移動
記事一覧

AIコーディングツールの移行計画|依存を減らし、元に戻せる開発環境を作る

公開 2026-10-07更新 2026-10-07読了目安 8分

AIコーディング ツール 移行で先に作るべきものは、設定ファイルの変換手順ではなく、利用を止めても開発を再開できる終了計画です。プロンプトを保存するだけでは、権限、CI、ログ、レビュー規則、端末内の知識が抜け落ちます。構成面ごとに移植性と復旧時間を記録すれば、別製品へ移る場合にも手作業へ戻る場合にも、何を復旧すべきか判断できます。ただし、「移せる」の基準をファイルのコピーで済ませてよいかは、構成面ごとに分けて考える必要があります。

SECTION 01

AIコーディング ツール 移行は製品選びより終了条件から決める

特定製品への依存を減らす目的なら、移行先を先に決める必要はありません。先に決めるのは、現在のツールを停止した翌日に、誰が、どの情報を使い、どこから開発を再開するかです。移行先が別のAIコーディングツールでも手作業でも、この問いは変わりません。

依存はプロンプトの中だけにありません。リポジトリに置いた指示、再利用するワークフロー、外部サービスとの接続、コマンドを許可する仕組み、CIでの呼び出し、テスト、ログ、レビュー規則、担当者だけが知る手順に分散します。一括して「設定」と呼ぶと、コピーできたファイルだけを移行完了と誤認します。

2026-08-31時点の公式文書でも、CodexはAGENTS.mdの指示チェーン、サンドボックスと承認ポリシー、GitHub Actionsからの実行を別の構成面として説明しています。Claude CodeもCLAUDE.md、skills、MCP、hooksを異なる役割として整理しています。したがって、終了計画は製品名の一行ではなく、構成面ごとの行で持つべきです。

SECTION 02

移植性と復旧時間で埋める終了計画の判断表

次の表をリポジトリまたはチームの運用文書に複製し、現状を定性的に記入します。移植性は「そのまま利用可能」「変換が必要」「代替手順が必要」「所在不明」のように記録します。復旧時間は架空の所要値を置かず、「即時に再開可能」「確認後に再開」「担当者の引継ぎ後」「未確認」のように、自組織で検証した状態を書きます。

| 構成面 | 棚卸しする対象 | 移植性の確認 | 復旧時間の確認 | 停止前の完了条件 | |---|---|---|---|---| | 指示 | AGENTS.md、CLAUDE.md、階層ごとの規則 | 読込順と適用範囲を移行先で再現できるか | 新環境で指示の読込を確認するまで | 有効な指示と失効した指示を分離 | | スキル | 再利用する知識、手順、ワークフロー | 固有形式を除いて手順を読めるか | 代表手順を人が再実行できるまで | 入力、処理、期待する確認方法を文書化 | | MCP | 接続先、設定、認証の所在 | 接続方式を移行先が扱えるか | 接続なしの代替手順で再開するまで | 接続先と手動経路を記録 | | 権限 | サンドボックス、承認、拒否規則、hooks | 指示ではなく強制層として再構成できるか | 安全な最小権限を確認するまで | 許可・拒否の根拠と責任者を記録 | | CI | ワークフロー、実行条件、プロンプトファイル | AI実行を外しても検証を継続できるか | 通常のCI経路を再開するまで | AI固有処理と必須検証を分離 | | テスト | 実行コマンド、対象範囲、合格条件 | ツール外から同じ検証を呼べるか | 手動またはCIで再実行できるまで | コマンドと判定基準を明文化 | | ログ | TUI出力、セッション記録、hookの記録 | 保存場所と読取手段を引き継げるか | 障害時の確認経路が使えるまで | 保管対象、閲覧権限、確認手順を記録 | | レビュー契約 | レビュー規則、対象、承認者、例外 | 特定エージェント抜きで運用できるか | 人のレビュー経路へ戻るまで | 必須規則と補助的な指示を分離 | | 担当知識 | 端末内の記憶、個人メモ、暗黙の判断 | 共有文書へ明示的に移せるか | 別担当者が手順をたどれるまで | 所在と引継ぎ方法を記録 |

表の目的は行同士を点数で比較することではありません。「所在不明」や「未確認」が残った行を停止条件に結び付けることです。移植性が低くても、代替手順と復旧確認が明確なら終了経路は作れます。逆に、ファイルをそのまま移せても、適用範囲や強制方法を確認していなければ復旧済みとは判定できません。

SECTION 03

指示ファイルと権限・hooksを別々に復旧する

指示はエージェントに望む行動を伝えますが、実行を技術的に制限する仕組みと同じではありません。2026-08-31時点で、Codexの公式文書は実行制御をサンドボックスモードと承認ポリシーの二層に分けています。Claude Codeの公式文書も、CLAUDE.mdを行動指針、managed settingsをツール、コマンド、ファイルパスの拒否やサンドボックスによる強制として区別し、CLAUDE.md自体を強制層とはしていません。

Claude Codeでは、確実に守るガードレールをprompt指示ではなくhookで強制する例も示され、hooksの用途にはlint、危険なコマンドの遮断、logging、通知が挙げられています。つまり、CLAUDE.mdの内容をAGENTS.mdへ書き換える、またはその逆を行うだけでは、拒否規則や自動処理まで移ったことにはなりません。

復旧確認も分けます。指示は新しい環境での読込と適用範囲、権限は許可・拒否・承認の条件、hookは自動実行していた検証や遮断の移管先を確認します。三つの確認がそろって初めて、行動指針だけでなく強制処理も再開可能と判断できます。

SECTION 04

AGENTS.md・CLAUDE.md・レビュー規則・ログの境界を残す

2026-08-31時点でCodexは、作業前にAGENTS.md系ファイルを読み、グローバル、プロジェクトルート、現在の作業ディレクトリへ向かう順で指示チェーンを構成し、近いディレクトリの指示を後に連結します。コードレビュー規則は対象コードに最も近いAGENTS.mdの「Code Review Rules」に置け、読込確認には平文TUIログまたは有効化したセッションJSONLログを利用できます。

ここで残すべきなのはAGENTS.mdという名前だけではありません。どのディレクトリで、どの規則が、何を上書きまたは補足するかという境界です。レビュー契約も同様で、エージェント向けの文面、必須の確認、例外の承認者を分けます。ログは設定が読まれたことを確かめる経路として扱い、保存されているはずだという前提にしません。

ツールごとの役割を整理したうえで運用差を検討する場合は、CodexとGitHub Copilotの違いを整理するも参照できます。ただし、終了計画の判定は製品同士の優劣ではなく、自分たちの指示とレビュー契約を再現できるかで行います。

SECTION 05

CIとテストはAI実行を外した復旧経路まで確認する

2026-08-31時点の公式文書によると、Codex GitHub ActionはGitHub ActionsのワークフローファイルからCI/CDジョブ、パッチ適用、レビューを実行し、指定された権限の下でcodex execを動かします。プロンプトはインラインまたはリポジトリにコミットしたファイルで指定できます。この構成では、ワークフローファイル、プロンプト、権限、後続のテストを一つの移行対象に見せないことが重要です。

AI固有のステップを停止した状態でも、通常のテストを実行し、合否を判断できる経路を残します。CIの終了条件は別製品の起動ではなく、AI実行を外しても必須検証が動くことです。テストの終了条件は、エージェントの会話履歴がなくてもコマンド、対象範囲、判定基準をたどれることです。

Codexを開発工程へ組み込む際の構成要素は、Codexで進めるAI駆動開発ガイドでも確認できます。導入時に追加した接点を逆順に洗い出すと、CIから外す処理と残す検証を区別しやすくなります。

SECTION 06

端末内の記憶を担当知識として明示的に引き継ぐ

担当者の端末で便利に動いていることは、別環境で復旧できることを意味しません。2026-08-31時点でClaude Codeのauto memoryはプロジェクト別のローカルディレクトリに保存され、同一リポジトリのworktree間では共有されますが、別マシンやクラウド環境には共有されません。

だからこそ、担当知識の行には、端末内の記憶、個人メモ、暗黙の判断条件を含めます。自動記憶をそのまま正式文書とみなすのではなく、現在も有効な内容を確認し、共有先、更新者、失効条件を決めます。終了前の確認は、元の担当者ではない人が共有情報だけで手順をたどれるかです。

MCPについても同じ注意が必要です。Claude Codeの公式文書では、MCPは外部サービスとツールへの接続、skillsは再利用可能な知識やワークフロー、CLAUDE.mdは常時のプロジェクト文脈と役割が分かれています。接続設定を知識の引継ぎで代替したことにせず、接続できない場合の手動経路を別に残します。

SECTION 07

終了判定は「コピー済み」ではなく「再開可能」で行う

終了計画を閉じられるのは、9つの行すべてについて、所在、移植性、復旧時間、代替手順、確認者が記入され、未確認の項目が停止条件として扱われたときです。復旧時間は他組織の値を借りず、自組織で実際に復旧確認した状態を定性的に更新します。この表は効果を推定するためのものではありません。

冒頭の問いに戻ると、「移せる」とはファイルをコピーできることではなく、指示の適用範囲、権限の強制、CIとテスト、ログの確認、レビュー契約、担当知識を、元のツールなしで再開できることです。AGENTS.mdやCLAUDE.mdだけを移して完了にしない。別製品へ移る場合も手作業へ戻る場合も、この終了条件があれば、依存の所在を見失わずに判断できます。

FAQ

よくある質問

Q. AIコーディングツールの移行では、プロンプトを保存すれば十分ですか?

十分ではありません。指示、skills、MCP、権限、CI、テスト、ログ、レビュー契約、担当知識を別々に棚卸しし、それぞれの復旧方法を確認します。

Q. AGENTS.mdとCLAUDE.mdを相互に書き換えれば移行できますか?

指示の内容を検討する出発点にはなりますが、それだけで権限制御やhooks、自動処理まで移行したことにはなりません。読込範囲と強制層を分けて確認します。

Q. 移行先が未定でも終了計画を作れますか?

作れます。構成面ごとに所在、移植性、代替手順、復旧確認の状態を記録すれば、別製品と手作業のどちらを選ぶ場合にも判断材料になります。

公式情報・参考資料