Conectar o OpenAI Codex ao Google Cloud

Pré-lançamento particular

Este produto ou recurso está sujeito aos Termos das Soluções Pré-GA na seção Termos Gerais de Serviço dos Termos Específicos de Serviço e aos Termos Adicionais para Produtos Pré-lançamento de IA Generativa. Os produtos e recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições das fases de lançamento.

É possível configurar a CLI do OpenAI Codex e o app para computador do Codex para rotear solicitações de modelo pelo projeto do Google Cloud na Agent Platform.

O Codex é executado localmente na estação de trabalho de desenvolvimento durante a autenticação pelo Google Cloud Identity and Access Management (IAM) e usa as cotas aprovadas do Marketplace.

Antes de começar

Para usar o OpenAI Codex com a Gemini Enterprise Agent Platform, siga as etapas abaixo. A API Gemini Enterprise Agent Platform (aiplatform.googleapis.com) precisa estar ativada no seu projeto do Google Cloud .

Faça login na sua conta do Google Cloud . Se você começou a usar o Google Cloudagora, crie uma conta para avaliar o desempenho dos nossos produtos em situações reais. Clientes novos também recebem US $300 em créditos para executar, testar e implantar cargas de trabalho sem custos financeiros.

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

Verify that billing is enabled for your Google Cloud project.

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

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

Verify that billing is enabled for your Google Cloud project.

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

1. Conclua as etapas de integração em Modelos GPT da OpenAI, incluindo a compra do produto pelo Google Cloud Marketplace e a ativação do modelo no Model Garden.

2. Se a política da sua organização restringir o acesso ao modelo, permita o modelo nessa política.

3. Instale a CLI da Google Cloud e configure o Application Default Credentials (ADC):

   gcloud auth application-default login

4. Instale a CLI do OpenAI Codex ou o app para computador do Codex na sua estação de trabalho.

Funções exigidas

Para receber as permissões necessárias para conectar o Codex aos modelos de parceiros da OpenAI, peça ao administrador para conceder a você o papel do IAM de Usuário da plataforma de agentes (roles/aiplatform.user) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Configuração interativa

É possível configurar o Codex de forma interativa usando o fluxo de login integrado.

CLI do Codex

1. Inicie o codex no terminal:

   codex

2. Selecione Fazer login de outra forma e escolha Usar o Google Cloud (exibido como Usar a Vertex AI do Google Cloud na CLI).

3. Insira o ID do projeto do Google Cloud .

4. Insira o local ou pressione Enter para aceitar global.

5. Pressione Enter para usar o Application Default Credentials no computador ou insira um caminho absoluto para um arquivo JSON de credencial da conta de serviço.

App para computador do Codex

1. Abra o app Codex para computador.
2. Selecione Fazer login de outra forma e escolha Usar o Google Cloud.
3. Insira o ID do projeto do Google Cloud .
4. Insira o local ou deixe em branco para aceitar global.
5. Deixe o caminho da credencial em branco para usar o Application Default Credentials ou selecione um arquivo JSON de chave da conta de serviço.
6. Selecione Continuar e verifique a conexão.

Configurar o Codex manualmente

Para configurar o Codex sem o prompt interativo, adicione as configurações do provedor a ~/.codex/config.toml. Coloque a configuração model_provider de nível superior antes de qualquer cabeçalho de tabela:

model_provider = "gcp"

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

Substitua:

• <var>PROJECT_ID</var>: o ID do projeto do Google Cloud (por exemplo, my-project-123).

Se você usar um arquivo de chave de conta de serviço em vez do Application Default Credentials, especifique credential_file:

credential_file = "CREDENTIAL_FILE_PATH"

Substitua:

• <var>CREDENTIAL_FILE_PATH</var>: o caminho absoluto para o arquivo JSON da chave da conta de serviço que você baixou (por exemplo, /Users/myuser/.config/gcloud/sa-key.json).

Atenção: as chaves de conta de serviço podem representar riscos de segurança se forem comprometidas. Sempre que possível, use o Application Default Credentials ou tokens de curta duração em vez de armazenar chaves de conta de serviço na estação de trabalho local. Para mais informações, consulte as práticas recomendadas para gerenciar conta de serviço de serviço.

Variáveis de ambiente

Também é possível usar variáveis de ambiente na máquina host do Codex para definir ou substituir as configurações:

• GOOGLE_CLOUD_PROJECT: define o ID do projeto do Google Cloud , permitindo que você omita project_id de config.toml.
• GOOGLE_CLOUD_LOCATION: substitui o local do endpoint (o padrão é global).

Selecionar modelos e verificar o acesso verificado

Após a configuração, verifique sua conexão e o acesso ao modelo:

1. Inicie uma nova sessão com codex ou crie uma tarefa no Codex para computador.
2. Execute /model na CLI ou abra o seletor de modelos no Codex Desktop.
3. Selecione um modelo ativado para sua carga de trabalho:
   • gpt-6.1-sol: modelo de parceiro principal para programação e fluxos de trabalho agênticos.
   • gpt-6-luna: modelo de parceiro de baixa latência para assistência interativa rápida.
   • gpt-6-astra: modelo de parceiro com maior capacidade para raciocínio em várias etapas complexo.
   • gpt-6.1-terra: modelo de parceiro equilibrado para automação de alta capacidade de processamento.
4. Envie um comando de teste (como "Listar os arquivos no diretório atual") para confirmar se a autenticação e o processamento da solicitação foram bem-sucedidos.

Suporte a recursos no Codex

Quando conectado à Agent Platform, o Codex usa a API OpenAI Responses. A tabela a seguir descreve os recursos compatíveis e incompatíveis:

Recurso	Status de compatibilidade	Descrição
Execução de shell e bash local	Com suporte	O Codex executa comandos do shell localmente na sua máquina de desenvolvimento dentro dos limites aprovados do terminal.
Edição e aplicação de patches em arquivos	Com suporte	O Codex lê e modifica arquivos localmente na sua estação de trabalho.
Protocolo de Contexto de Modelo (MCP) local	Com suporte	Os servidores MCP locais configurados em ~/.codex/config.toml são executados na sua estação de trabalho.
Chamada de função do lado do cliente	Com suporte	As solicitações de ferramentas de modelo são avaliadas e executadas localmente pelo cliente do Codex.
Pesquisa hospedada na Web e de arquivos	Sem suporte	As ferramentas de pesquisa hospedadas da OpenAI não estão disponíveis nos endpoints da Plataforma de Agentes durante o pré-lançamento particular.
Interpretador de código hospedado	Sem suporte	Os sandboxes de nuvem remotos hospedados pela OpenAI não estão disponíveis. A execução de código é feita localmente usando ferramentas locais.

A seguir

• Conheça a integração programática do SDK na API Responses.
• Revise os recursos e as especificações do modelo em Modelos GPT da OpenAI.
• Saiba mais sobre o monitoramento de abuso e a retenção de dados zero.