環境を使うと、クラウドチャット中に Codex がインストールするものや実行するものを制御できます。たとえば、依存関係を追加したり、リンターやフォーマッターなどのツールをインストールしたり、環境変数を設定したりできます。
環境の構成は、Codex の設定 で行います。
Codex のクラウドチャット実行フロー
プロンプトを送信すると、次の処理が行われます：
- Codex はコンテナを作成し、リポジトリを選択したブランチまたはコミット SHA の状態でチェックアウトします。
- Codex はセットアップスクリプトを実行します。キャッシュ済みコンテナを再開する場合は、任意のメンテナンススクリプトも実行します。
- Codex はインターネットアクセスの設定を適用します。セットアップスクリプトは、インターネットアクセスが有効な状態で実行されます。エージェントのインターネットアクセスはデフォルトで無効ですが、必要に応じて制限付きまたは無制限のアクセスを有効にできます。詳しくは、次を参照してください：エージェントのインターネットアクセス。
- エージェントはターミナルコマンドを繰り返し実行します。コードを編集し、チェックを実行して、作業結果の検証を試みます。リポジトリに
AGENTS.mdが含まれている場合、エージェントはそこからプロジェクト固有の lint コマンドとテストコマンドを特定します。 - エージェントの処理が完了すると、回答と、変更したファイルの差分が表示されます。PR を作成したり、追加で質問したりできます。
デフォルトの universal イメージ
Codex エージェントは、一般的な言語、パッケージ、ツールがプリインストールされている universal というデフォルトのコンテナイメージで実行されます。
環境の設定で、パッケージのバージョンを設定 を選択し、Python、Node.js、その他のランタイムのバージョンを固定します。
インストール内容の詳細については、 openai/codex-universal で、参照用の Dockerfile と、ローカルにプルしてテストできるイメージを確認できます。
codex-universal には、高速化と利便性のために各種言語がプリインストールされていますが、セットアップスクリプト を使ってコンテナに追加のパッケージをインストールすることもできます。
環境変数とシークレット
環境変数 は、セットアップスクリプトとエージェントフェーズを含むチャットの全期間にわたって設定されます。
シークレット は環境変数と似ていますが、次の点が異なります：
- 追加の暗号化レイヤーを使用して保存され、タスクの実行時にのみ復号されます。
- セットアップスクリプトでのみ利用できます。セキュリティ上の理由から、シークレットはエージェントフェーズが始まる前に削除されます。
自動セットアップ
一般的なパッケージマネージャー（npm、yarn、pnpm、pip、pipenv、poetry）を使用するプロジェクトでは、Codex が依存関係とツールを自動的にインストールできます。
手動セットアップ
開発環境のセットアップがより複雑な場合は、カスタムセットアップスクリプトを指定することもできます。例：
# Install type checker
pip install pyright
# Install dependencies
poetry install --with test
pnpm installセットアップスクリプトはエージェントとは別の Bash セッションで実行されるため、
export などのコマンドで行った設定は、エージェントフェーズには引き継がれません。環境
変数を永続化するには、~/.bashrc に追加するか、環境の設定で構成します。
コンテナのキャッシュ
新しいチャットやフォローアップを高速化するため、Codex はコンテナの状態を最大 12 時間キャッシュします。
環境をキャッシュする際は、次の処理が行われます：
- Codex はリポジトリをクローンし、デフォルトブランチをチェックアウトします。
- Codex はセットアップスクリプトを実行し、実行後のコンテナ状態をキャッシュします。
キャッシュ済みコンテナを再開する際は、次の処理が行われます：
- Codex はチャットに指定されたブランチをチェックアウトします。
- Codex はメンテナンススクリプト（任意）を実行します。セットアップスクリプトが古いコミットで実行されており、依存関係を更新する必要がある場合に便利です。
Codex は、セットアップスクリプト、メンテナンススクリプト、環境変数、シークレットのいずれかを変更すると、キャッシュを自動的に無効化します。リポジトリの変更によってキャッシュ済み状態との互換性が失われた場合は、環境ページで、キャッシュをリセット を選択します。
Business およびエンタープライズのユーザーの場合、キャッシュは環境への アクセス権を持つすべてのユーザー間で共有されます。キャッシュを無効化すると、ワークスペース内でその 環境を利用するすべてのユーザーに影響します。
インターネットアクセスとネットワークプロキシ
セットアップスクリプトフェーズでは、依存関係のインストールにインターネットアクセスを利用できます。エージェントフェーズでは、インターネットアクセスはデフォルトで無効ですが、制限付きまたは無制限のアクセスを設定できます。詳しくは、次を参照してください：エージェントのインターネットアクセス。
環境は、セキュリティと不正使用の防止のため、HTTP/HTTPS ネットワークプロキシの背後で稼働します。外向きのインターネットトラフィックはすべて、このプロキシを経由します。