Utilizar o ChatGPT Work e o Codex com o Amazon Bedrock

Configure as superfícies locais do ChatGPT Work e do Codex para utilizarem modelos OpenAI disponíveis através do Amazon Bedrock. Nesta configuração, o cliente local envia pedidos de modelo para o Bedrock utilizando autenticação e controlos de acesso geridos pela AWS.

Como funciona

Quando configura uma superfície local do ChatGPT Work ou do Codex com o Amazon Bedrock como fornecedor de modelos, a Responses API alojada pela OpenAI não faz parte do percurso do pedido. O cliente local envia pedidos de modelo para o Amazon Bedrock, e o Bedrock fornece uma implementação da Responses API compatível com a OpenAI para modelos OpenAI suportados.

Antes de começar

Certifique-se de que dispõe de:

• Acesso a modelos OpenAI suportados no Amazon Bedrock.
• Uma AWS Region onde o modelo selecionado esteja disponível.
• Autenticação configurada para o caminho Amazon Bedrock Mantle na conta AWS.

Configurar o fornecedor

Adicione o fornecedor de modelos amazon-bedrock para o caminho Amazon Bedrock Mantle a ~/.codex/config.toml. A aplicação para computador do ChatGPT, o Codex CLI, a extensão do IDE e o SDK leem as mesmas camadas de configuração local. O fornecimento de um modelo é opcional. Selecione explicitamente um modelo suportado quando necessário.

model_provider = "amazon-bedrock"

Opções de autenticação

As superfícies locais do ChatGPT Work e do Codex suportam dois métodos de autenticação do Bedrock. Estes são verificados pela seguinte ordem:

1. API key do Bedrock.
2. Cadeia de credenciais do AWS SDK.

Opção 1: API key do Bedrock

Defina a API key do Bedrock no ambiente lido pelo cliente local. Tem de especificar uma Region ao utilizar a autenticação por API key.

export AWS_BEARER_TOKEN_BEDROCK=<your-bedrock-api-key>
export AWS_REGION=us-east-2

Opção 2: credenciais do AWS SDK

Utilize este método quando a sua organização gerir o acesso ao Bedrock através da cadeia de credenciais do AWS SDK. O cliente local pode utilizar estas fontes padrão de credenciais do AWS SDK:

Ficheiros de configuração AWS partilhados

Configure os ficheiros AWS config e credentials partilhados:

aws configure

Variáveis de ambiente

Defina as variáveis de ambiente padrão para credenciais do AWS SDK:

export AWS_ACCESS_KEY_ID=<your-access-key-id>
export AWS_SECRET_ACCESS_KEY=<your-secret-access-key>
export AWS_SESSION_TOKEN=<your-session-token>

Credenciais da AWS Management Console

Inicie sessão com credenciais da AWS Management Console:

aws login

AWS SSO ou um perfil com nome

Inicie sessão com o AWS SSO e selecione o perfil com nome:

aws sso login --profile codex-bedrock
export AWS_PROFILE=codex-bedrock

Identidade federada

Para SSO empresarial ou federação OIDC, configure uma identidade federada com credential_process fora do cliente local e permita que o AWS SDK resolva as credenciais. Coloque o início de sessão no navegador, a troca de tokens, a colocação em cache e a atualização no auxiliar credential_process do seu perfil AWS.

Aplicação para computador e extensão do IDE

As aplicações para computador e as extensões do IDE podem não herdar variáveis de ambiente da shell. Coloque os valores necessários em ~/.codex/.env e, em seguida, reinicie a aplicação ou a extensão.

export AWS_BEARER_TOKEN_BEDROCK=<your-bedrock-api-key>
export AWS_REGION=us-east-2

Verificar a configuração

• No Codex CLI, abra /status e confirme que o Codex está a utilizar o fornecedor de modelos amazon-bedrock.
• Na aplicação para computador do ChatGPT, selecione Work ou Codex e inicie uma nova tarefa após reiniciar a aplicação.
• Na extensão do IDE, inicie uma nova sessão após reiniciar a extensão.
• Confirme que o modelo selecionado está disponível na AWS Region configurada e que a identidade AWS tem permissão para lhe aceder.

Modelos suportados

Utilize os IDs de modelo exatos:

openai.gpt-5.6-sol
openai.gpt-5.6-terra
openai.gpt-5.6-luna
openai.gpt-5.5
openai.gpt-5.4

A disponibilidade dos modelos varia consoante a AWS Region. Antes de selecionar um modelo, consulte o suporte de modelos por AWS Region.

Disponibilidade de funcionalidades

Esta configuração suporta fluxos de trabalho locais do ChatGPT Work e do Codex. O ChatGPT Work alojado na Web, o Codex cloud e as funcionalidades que dependem de serviços na cloud alojados pela OpenAI, ferramentas alojadas ou descoberta gerida na cloud não estão atualmente disponíveis.

Resolução de problemas

Se a configuração falhar, verifique o seguinte:

• O ID do modelo corresponde exatamente a um modelo suportado.
• Especificou uma AWS Region onde o modelo está disponível.
• A API key do Bedrock ou as credenciais AWS são válidas e não expiraram.
• A identidade AWS tem permissão para aceder ao modelo Bedrock selecionado.
• AWS_BEARER_TOKEN_BEDROCK não está definido como uma chave expirada ou não pretendida.
• Para utilização na aplicação para computador ou na extensão do IDE, as variáveis de ambiente necessárias estão presentes em ~/.codex/.env.

Limites do suporte

O Suporte da OpenAI pode ajudar com a configuração do cliente do ChatGPT Work e do Codex, a configuração, o comportamento local do CLI, o comportamento da aplicação para computador, o comportamento da extensão do IDE e a experiência local do produto.

Para credenciais AWS, permissões IAM, acesso a modelos do Bedrock, quotas, faturação, disponibilidade regional, falhas de pedidos do Bedrock, registos de serviços AWS ou comportamento do serviço Bedrock, contacte o administrador AWS do cliente ou o Suporte da AWS.