将 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 User (roles/aiplatform.user) IAM 角色。如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

交互式设置

您可以使用内置登录流程以交互方式配置 Codex。

Codex CLI

1. 在终端中启动 codex：

   codex

2. 选择以其他方式登录，然后选择使用 Google Cloud（在 CLI 中显示为使用 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 Desktop 中创建新任务。
2. 在 CLI 中运行 /model，或在 Codex 桌面版中打开模型选择器。
3. 为工作负载选择已启用的模型：
   • gpt-6.1-sol：用于编码和智能体工作流的旗舰合作伙伴模型。
   • gpt-6-luna：低延迟合作伙伴模型，可提供快速互动辅助。
   • gpt-6-astra：功能最强大的合作伙伴模型，适用于复杂的多步推理。
   • gpt-6.1-terra：适用于高吞吐量自动化流程的平衡合作伙伴模式。
4. 发送测试提示（例如“列出当前目录中的文件”），以确认身份验证和请求处理成功。

Codex 中的功能支持

连接到 Agent Platform 后，Codex 会使用 OpenAI Responses API。下表列出了支持和不支持的功能：

后续步骤

• 探索 Responses API 中的程序化 SDK 集成。
• 在 OpenAI GPT 模型中查看模型功能和规范。
• 了解滥用行为监控和零数据保留。