如需查看完整的文档索引,请参阅 llms.txt。在文档页面的 URL 末尾加上 .md 即可查看该页面的 Markdown 版本。
主导航
主题

将 Codex 连接到 Google Cloud Vertex AI

配置 Codex,以通过您的 Google Cloud 项目发送模型请求。

Google Cloud 上的 OpenAI 模型目前处于私有预览阶段。要在您的项目中使用这些模型,请申请访问权限。

开始之前

请向管理员确认在 Codex 中使用的项目 ID、模型名称和 Vertex AI 位置。您的用户账号或服务账号必须有权调用该项目中的模型。有关设置结算、接受市场私有报价和启用模型的说明,请参阅 Google Cloud 的前提条件。

使用默认位置 global 时,Google Cloud 可能会在多个区域处理模型请求。如果您的组织要求在指定区域处理请求,请在发送请求前向管理员确认应使用哪个受支持的位置。

在 Codex 主机上进行身份验证

在运行 Codex 的计算机上安装 Google Cloud CLI。进行本地开发时,请运行以下命令登录并设置应用默认凭据(ADC)。

gcloud auth application-default login

如果管理员已提供 ADC 文件,请跳过交互式登录,在设置时使用该文件。Codex 会运行 gcloud auth application-default print-access-token 来获取访问令牌。

在 Codex 中设置 Google Cloud

请使用 Codex CLI 0.167.0 或更高版本,或 Codex 桌面应用 26.1103.32239 或更高版本。

如果您已登录 Codex,或登录选项中没有 Google Cloud,请先在 Codex 主机上进行身份验证,然后手动配置提供方。启动新的 CLI 会话或在桌面应用中启动新任务,然后验证模型请求。

按客户端查看 Google Cloud 设置步骤
  1. 启动 codex。选择 使用其他方式登录,然后选择 使用 Google Cloud Vertex AI。

Codex CLI 的提供方选择界面,已选中“使用 Google Cloud Vertex AI”。

  1. 输入管理员提供的 Google Cloud 项目 ID。

Codex CLI 的 Google Cloud 设置界面提示输入项目 ID。

  1. 输入 Vertex AI 位置,或按 Enter 键使用 global。
  2. 输入凭据 JSON 文件的绝对路径,或按 Enter 键使用此计算机上的 ADC。Codex 会先确认能够获取访问令牌,再保存设置。
  3. 验证模型请求。

手动配置提供方

在 ~/.codex/config.toml 中,在所有表头之前将 model_provider 设为 "gcp"。在 [model_providers.gcp] 下设置项目 ID 和位置。

model_provider = "gcp"

[model_providers.gcp]
project_id = "my-project"
location = "global"

如果您使用 ADC 文件,请在 [model_providers.gcp] 下添加 credential_file = "/absolute/path/to/credentials.json"。Codex 会为身份验证命令设置 GOOGLE_APPLICATION_CREDENTIALS。

如果已在 Codex 主机上设置 GOOGLE_CLOUD_PROJECT,则可省略 project_id。如果省略 location,Codex 会使用 GOOGLE_CLOUD_LOCATION 的值。如果该变量也未设置,则使用 global。

验证模型请求

  1. 用 codex 启动新会话并输入 /model,或在桌面应用中启动新任务并打开模型选择器。
  2. 选择管理员已为您的项目启用的模型,请它回复一句简短的问候语。收到回复即表明 Codex 能够完成身份验证并调用该模型。

如果凭据验证失败,请确认运行 Codex 的计算机能够执行 gcloud。如果指定了凭据文件,还请确认该计算机能够读取该文件。要使用本地用户凭据重新登录,请在该计算机上运行 gcloud auth application-default login。

如果身份验证成功但模型请求失败,请检查项目 ID 和位置是否与模型部署一致。请管理员确认您的用户账号或所属群组有权访问该项目,并确认运行 Codex 的账号有权调用该模型。