OpenAI Codex を Google Cloud に接続する

OpenAI Codex CLI と Codex デスクトップ アプリを構成して、Agent Platform の Google Cloud プロジェクトを介してモデル リクエストをルーティングできます。

Codex は、Google Cloud Identity and Access Management（IAM）を介して認証し、承認済みの Marketplace の割り当てを使用して、開発ワークステーションでローカルに実行されます。

始める前に

Gemini Enterprise Agent Platform で OpenAI Codex を使用するには、次の操作を行う必要があります。 Google Cloud プロジェクトで Gemini Enterprise Agent Platform API（aiplatform.googleapis.com）を有効にする必要があります。

  1. Google Cloud アカウントにログインします。 Google Cloudを初めて使用する場合は、アカウントを作成して、実際のシナリオで Google プロダクトのパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  3. Verify that billing is enabled for your Google Cloud project.

  4. Enable the Gemini Enterprise Agent Platform API, if it is not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

  5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  6. Verify that billing is enabled for your Google Cloud project.

  7. Enable the Gemini Enterprise Agent Platform API, if it is not already enabled.

    Roles required to enable APIs

    To enable APIs, you need the serviceusage.services.enable permission. If you created the project, then you likely already have this permission through the Owner role (roles/owner). Otherwise, you can get this permission through the Service Usage Admin role (roles/serviceusage.serviceUsageAdmin). Learn how to grant roles.

    Enable the API

    8.

  8. OpenAI GPT モデルのオンボーディング手順を完了します。これには、Google Cloud Marketplace でプロダクトを購入し、Model Garden でモデルを有効にすることも含まれます。

  9. 組織のポリシーでモデルへのアクセスが制限されている場合は、そのポリシーでモデルを許可します。

  10. Google Cloud CLI をインストールし、アプリケーションのデフォルト認証情報（ADC）を構成します。

    gcloud auth application-default login

  11. ワークステーションに OpenAI Codex CLI または Codex デスクトップ アプリをインストールします。

必要なロール

Codex を OpenAI パートナー モデルに接続するために必要な権限を取得するには、プロジェクトに対するエージェント プラットフォーム ユーザー（roles/aiplatform.user）IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

インタラクティブなセットアップ

組み込みのログインフローを使用して、Codex をインタラクティブに構成できます。

Codex CLI

  1. ターミナルで codex を起動します。

    codex

  2. [Sign in another way] を選択し、[Use Google Cloud]（CLI では [Use Google Cloud Vertex AI] と表示されます）を選択します。

  3. Google Cloud プロジェクト ID を入力します。

  4. 場所を入力するか、Enter キーを押して global を受け入れます。

  5. Enter キーを押して、パソコンでアプリケーションのデフォルト認証情報を使用するか、サービス アカウントの認証情報 JSON ファイルの絶対パスを入力します。

Codex デスクトップ アプリ

  1. Codex デスクトップ アプリを開きます。
  2. [別の方法でログイン] を選択し、[Google Cloud を使用] を選択します。
  3. Google Cloud プロジェクト ID を入力します。
  4. 場所を入力するか、空白のままにして global を受け入れます。
  5. アプリケーションのデフォルト認証情報を使用する場合は、認証情報のパスを空白のままにします。または、サービス アカウント キーの JSON ファイルを選択します。
  6. [続行] を選択し、接続を確認します。

Codex を手動で構成する

インタラクティブなプロンプトなしで Codex を構成するには、プロバイダ設定を ~/.codex/config.toml に追加します。最上位の model_provider 設定は、テーブル ヘッダーの前に配置します。

model_provider = "gcp"

[model_providers.gcp]
project_id = "PROJECT_ID"
location = "global"

次のように置き換えます。

  • <var>PROJECT_ID</var>: Google Cloud プロジェクト ID（例: my-project-123）。

アプリケーションのデフォルト認証情報ではなくサービス アカウント キーファイルを使用する場合は、credential_file を指定します。

credential_file = "CREDENTIAL_FILE_PATH"

次のように置き換えます。

  • <var>CREDENTIAL_FILE_PATH</var>: ダウンロードしたサービス アカウント キーの JSON ファイルの絶対パス（例: /Users/myuser/.config/gcloud/sa-key.json）。

環境変数

Codex ホストマシンの環境変数を使用して、設定を構成またはオーバーライドすることもできます。

  • GOOGLE_CLOUD_PROJECT: Google Cloud プロジェクト ID を設定します。これにより、config.toml から project_id を省略できます。
  • GOOGLE_CLOUD_LOCATION: エンドポイントのロケーションをオーバーライドします（デフォルトは global）。

モデルを選択して確認済みアクセスを確認する

設定後、接続とモデルへのアクセスを確認します。

  1. codex で新しいセッションを開始するか、Codex Desktop で新しいタスクを作成します。
  2. CLI で /model を実行するか、Codex Desktop でモデル選択ツールを開きます。
  3. ワークロードに対して有効なモデルを選択します。
    • gpt-6.1-sol: コーディングとエージェント ワークフロー用のフラッグシップ パートナー モデル。
    • gpt-6-luna: 高速なインタラクティブ アシスタンスを実現する低レイテンシのパートナー モデル。
    • gpt-6-astra: 複雑なマルチステップの推論に対応する、最高性能のパートナー モデル。
    • gpt-6.1-terra: 高スループットの自動化に適したバランスの取れたパートナー モデル。
  4. テスト プロンプト（「現在のディレクトリ内のファイルを一覧表示する」など）を送信して、認証とリクエスト処理が成功することを確認します。

Codex の機能サポート

Agent Platform に接続すると、Codex は OpenAI Responses API を使用します。次の表に、サポートされている機能とサポートされていない機能を示します。

機能 サポート状況 説明
ローカルシェルと bash の実行 サポート対象 Codex は、承認されたターミナル境界内で、開発マシン上でローカルにシェルコマンドを実行します。
ファイルの編集とパッチ適用 サポート対象 Codex は、ワークステーション上のファイルをローカルで読み取り、変更します。
ローカル Model Context Protocol（MCP） サポート対象 ~/.codex/config.toml で構成されたローカル MCP サーバーは、ワークステーションで実行されます。
クライアントサイドの関数呼び出し サポート対象 モデルツールのリクエストは、Codex クライアントによってローカルで評価され、実行されます。
ホスト型ウェブ検索とファイル検索 非対応 限定公開プレビュー期間中、ホスト型の OpenAI 検索ツールは Agent Platform エンドポイントで使用できません。
ホスト型コード インタープリタ 非対応 OpenAI がホストするリモート クラウド サンドボックスは使用できません。コード実行は、ローカルツールを使用してローカルで実行されます。

次のステップ