Codex Cloudの使い方 開発環境とテストと変更確認
AIが変更案を作れても、必要な実行環境や非公開パッケージにアクセスできなければ開発は止まる。Codex Cloudの要点は、準備された環境で仕事を進め、その変更と検査結果を確認できることだ。
本稿は2026年9月30日の公式文書に基づき、DevDay 2026のクラウド開発を具体的な流れとして説明する。障害調査の例は導入案であり、実際のリポジトリで測ったレビューではない。利用可能な設定はアカウントと組織方針に依存する。
環境と個別作業を分ける
環境はリポジトリ、依存関係、ツールとアクセス設定をまとめた再利用可能な構成である。準備して公開すると、新しい仕事がその構成を基に別の作業領域で始まる。
同じ環境を使っても、全作業が同じ変更ファイルを共有するわけではない。既存の仕事は自分の状態を持ち、新しい仕事は公開済みの準備状態から始まる。環境を再公開しても、進行中の仕事が一斉に置き換わるとは限らない。
利用者の端末がスリープ中でもクラウド作業は続けられる。ただし、クラウドに渡していないローカル資料や未許可のサービスが自動的に使えるわけではない。
リポジトリを接続して準備する
ウェブまたはデスクトップアプリでWork inからCloudを選び、環境を指定する。必要な環境がなければ作成し、GitHubのリポジトリを選ぶ。Codexが構成を調べ、ツールと依存関係を準備する。
チームで使うランタイム、パッケージ管理、検査コマンドと必要サービスを伝える。自動準備を使っても、どの状態なら開発できるかという基準は必要だ。
準備報告と失敗した検査を読み、未完了の項目を解決してから保存とPublishを行う。これは新しい仕事に開発環境を提供する操作であり、本番サイトを公開するデプロイではない。
インストールと起動と公開の違い
依存関係を入れることと、サーバーを起動して使える状態にすることは異なる。公式文書はInstall scriptとStart skillを分けて案内する。
構成を変更したら保存、検査と再公開を確認し、重要な更新は新しい仕事で試す。準備済み状態を再利用できても、ソース管理を省略できない。重要な変更はコミットや成果物として残す。
日本の開発チームなら小さなプロジェクトで必要条件を確認してから、複雑な業務に広げる方法が考えられる。これは導入案であり、常にローカルより高速という意味ではない。
接続経路と認証を別々に見る
ドメインを許可する設定は通信経路の許可であり、サービス側のアカウント権限ではない。パッケージ取得が失敗したら、宛先と認証を分けて確認する。
環境変数はプログラムが直接読む値である。ネットワーク用の秘密情報では、許可されたHTTPS宛先に対してプロキシが実値を使用し、プログラムには置換用の値が渡される。現在の文書はHTTPSの443番ポートと許可ドメインの条件を説明する。
環境所有のネットワーク秘密情報の保存は、制限された接続先に宛先を追加する場合がある。個人の値と直接の環境変数は同じ動作ではない。保存後の接続方針を読み直す。
実際のパスワードやトークンを依頼文、ログとコミットに入れない。共有環境で必要な値を定義することと、個人の資格情報を他の人に渡すことも区別する。
完了条件を付けて依頼する
依頼には問題、再現条件、変更可能な範囲と検査方法を含める。注文一覧が特定の絞り込みで空になる問題なら、原因調査、最小変更と関係する検査結果を求める構成が考えられる。
調査、実装と受け入れを分ける。原因説明の依頼は変更の許可ではなく、変更案の作成も自動マージや本番公開の許可ではない。
初期導入では本番データ変更を除外し、確認可能な結果を返してもらう。実行範囲が明確なら、チームの手順に合うかを判断しやすい。
テスト結果と差分を確認する
完了という要約だけでなく、変更ファイルと検査ログを読む。実行したコマンドと、環境不足で省略した検査を区別する。
依頼範囲外のファイル、依存関係の変更と秘密情報を差分で確認する。コミット、PR作成、マージと本番デプロイは別々の段階だ。PR作成機能があっても自動マージを許可したことにはならない。
作業領域が分離されていても、同じコードへの複数変更は統合時に衝突する可能性がある。基準版と適用順序を管理する。
現在の制約を確認する
クラウド環境の文書はコンピューターとブラウザー操作、GitLabと自社ホスト型GitHub Enterprise Serverを未対応としている。Agents APIのホスト型ブラウザー機能とは別に扱う。
リポジトリに含めたSkillsと、個人のローカル環境にあるSkillsも異なる。ローカルの個人設定が自動同期されるとは限らないため、必要な指示を実行環境に準備する。
旧Codex CloudはCode Reviewや一部連携を引き続き支えると案内される。新しい環境作成の流れを、旧設定の全項目にそのまま当てはめない。
問題を層ごとに調べる
ツールがなければ準備時の失敗コマンドと版を確認する。通信失敗なら宛先と認証、環境が見つからなければ未公開状態、更新が見えなければ再公開と新規作業かを調べる。
Codex Cloudの利点は、準備した環境を繰り返し使い、端末から離れても仕事を続けられることだ。準備、実行、検査と公開を分けるほど活用しやすい。権限と人による最終確認は依然として必要である。
資料と権利に関する注記
本稿はOpenAIと提携していない独立した機能解説である。製品名は各権利者の商標を識別目的で使用している。図は説明用のイラストと概念図であり、実際の製品画面やOpenAIの公式画像ではない。
出典: OpenAI ChatGPT Learn — Codex Cloud · Cloud environments · Pricing and account access
