將 OpenAI Codex 連結至 Cloud de Confiance by S3NS

您可以設定 OpenAI Codex CLI 和 Codex 電腦版應用程式，透過 Agent Platform 上的 Cloud de Confiance 專案轉送模型要求。

Codex 會在本機開發工作站上執行，並透過Cloud de Confiance Identity and Access Management (IAM) 進行驗證，以及使用您核准的 Marketplace 配額。

事前準備

如要搭配使用 OpenAI Codex 和 Gemini Enterprise Agent Platform，請務必完成下列步驟。您的 Cloud de Confiance 專案必須啟用 Gemini Enterprise Agent Platform API (aiplatform.googleapis.com)。

1. In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance 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

2. Verify that billing is enabled for your Cloud de Confiance project.

3. 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

4. 完成 OpenAI GPT 模型的新手上路步驟，包括透過 Google Cloud Marketplace 購買產品，以及在 Model Garden 啟用模型。

5. 如果貴組織的政策限制模型存取權，請在政策中允許模型。

6. 安裝 Cloud de Confiance CLI 並設定應用程式預設憑證 (ADC)：

   gcloud auth application-default login

7. 在工作站上安裝 OpenAI Codex CLI 或 Codex 電腦版應用程式。

必要的角色

如要取得將 Codex 連結至 OpenAI 合作夥伴模型所需的權限，請要求管理員授予您專案的 Agent Platform 使用者 (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. 輸入 Cloud de Confiance 專案 ID。

4. 輸入位置，或按下 Enter 鍵接受 global。

5. 按下 Enter 鍵，在電腦上使用應用程式預設憑證，或輸入服務帳戶憑證 JSON 檔案的絕對路徑。

Codex 電腦版應用程式

1. 開啟 Codex 電腦版應用程式。
2. 選取「以其他方式登入」，然後選擇「使用 Google Cloud」。
3. 輸入 Cloud de Confiance 專案 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>：您的 Cloud de Confiance 專案 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：設定 Cloud de Confiance 專案 ID，以便從 config.toml 省略 project_id。
• GOOGLE_CLOUD_LOCATION：覆寫端點位置 (預設為 global)。

選取模型並驗證存取權

設定完成後，請驗證連線和模型存取權：

1. 與 codex 展開新的對話，或在 Codex 桌面版中建立新工作。
2. 在 CLI 中執行 /model，或在 Codex 桌面版中開啟模型挑選器。
3. 為工作負載選取已啟用的模型：
   • gpt-6.1-sol：旗艦級合作夥伴模型，適用於程式設計和代理工作流程。
   • gpt-6-luna：低延遲合作夥伴模型，可快速提供互動式協助。
   • gpt-6-astra：最強大的合作夥伴模型，可進行複雜的多步驟推論。
   • gpt-6.1-terra：平衡的合作夥伴模型，適用於高處理量自動化作業。
4. 傳送測試提示 (例如「List the files in the current directory」)，確認驗證和要求處理作業成功。

Codex 支援的功能

Codex 連線至 Agent Platform 時，會使用 OpenAI Responses API。下表列出支援和不支援的功能：

後續步驟

• 請參閱 Responses API，瞭解如何以程式輔助方式整合 SDK。
• 如要查看模型功能和規格，請參閱「OpenAI GPT 模型」。
• 瞭解濫用監控和零資料保留。