Usa ChatGPT Work y Codex con Amazon Bedrock

Configura las interfaces locales de ChatGPT Work y Codex para usar los modelos de OpenAI disponibles a través de Amazon Bedrock. En esta configuración, el cliente local envía solicitudes al modelo a Bedrock mediante la autenticación y los controles de acceso administrados por AWS.

Cómo funciona

Cuando configuras una interfaz local de ChatGPT Work o Codex con Amazon Bedrock como proveedor del modelo, la Responses API alojada por OpenAI no forma parte de la ruta de la solicitud. El cliente local envía las solicitudes al modelo a Amazon Bedrock, y Bedrock proporciona una implementación de Responses API compatible con OpenAI para los modelos de OpenAI admitidos.

Antes de comenzar

Asegúrate de tener:

• Acceso a los modelos de OpenAI admitidos en Amazon Bedrock.
• Una región de AWS donde esté disponible el modelo seleccionado.
• La autenticación para la ruta Mantle de Amazon Bedrock configurada para la cuenta de AWS.

Configura el proveedor

Añade el proveedor de modelos amazon-bedrock para la ruta Mantle de Amazon Bedrock a ~/.codex/config.toml. La aplicación de escritorio de ChatGPT, Codex CLI, la extensión de IDE y el SDK leen las mismas capas de configuración local. Especificar un modelo es opcional. Selecciona explícitamente un modelo compatible cuando sea necesario.

model_provider = "amazon-bedrock"

Opciones de autenticación

Las interfaces locales de ChatGPT Work y Codex admiten dos métodos de autenticación de Bedrock. Los comprueban en este orden:

1. API key de Bedrock.
2. Cadena de credenciales del AWS SDK.

Opción 1: API key de Bedrock

Define la API key de Bedrock en el entorno que lee el cliente local. Debes especificar una región al usar la autenticación mediante API key.

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

Opción 2: credenciales del AWS SDK

Usa este método cuando tu organización administre el acceso a Bedrock mediante la cadena de credenciales del AWS SDK. El cliente local puede usar estas fuentes de credenciales estándar del AWS SDK:

Archivos de configuración compartidos de AWS

Configura los archivos compartidos de AWS config y credentials:

aws configure

Variables de entorno

Define las variables de entorno estándar de credenciales del 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>

Credenciales de AWS Management Console

Inicia sesión con las credenciales de AWS Management Console:

aws login

AWS SSO o un perfil con nombre

Inicia sesión con AWS SSO y selecciona el perfil con nombre:

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

Identidad federada

Para SSO corporativo o federación OIDC, configura una identidad federada con credential_process fuera del cliente local y permite que el AWS SDK resuelva las credenciales. Configura el inicio de sesión en el navegador, el intercambio de tokens, el almacenamiento en caché y la renovación en el asistente credential_process de tu perfil de AWS.

Aplicación de escritorio y extensión de IDE

Es posible que las aplicaciones de escritorio y las extensiones de IDE no hereden las variables de entorno del shell. Incluye los valores necesarios en ~/.codex/.env y, a continuación, reinicia la aplicación o la extensión.

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

Verifica la configuración

• En Codex CLI, abre /status y confirma que Codex usa el proveedor de modelos amazon-bedrock.
• En la aplicación de escritorio de ChatGPT, selecciona Work o Codex e inicia una tarea nueva después de reiniciar la aplicación.
• En la extensión de IDE, inicia una sesión nueva después de reiniciar la extensión.
• Confirma que el modelo seleccionado esté disponible en la región de AWS configurada y que la identidad de AWS tenga permiso para acceder a él.

Modelos compatibles

Usa los ID de modelo exactos:

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

La disponibilidad de los modelos varía según la región de AWS. Antes de seleccionar un modelo, consulta la compatibilidad de modelos por región de AWS.

Disponibilidad de las funciones

Esta configuración admite flujos de trabajo locales de ChatGPT Work y Codex. ChatGPT Work alojado en la web, Codex cloud y las funciones que dependen de servicios en la nube alojados por OpenAI, herramientas alojadas o detección administrada en la nube no están disponibles actualmente.

Solución de problemas

Si la configuración falla, comprueba lo siguiente:

• El ID del modelo coincide exactamente con un modelo compatible.
• Especificas una región de AWS en la que el modelo está disponible.
• La API key de Bedrock o las credenciales de AWS son válidas y no han caducado.
• La identidad de AWS tiene permiso para acceder al modelo de Bedrock seleccionado.
• AWS_BEARER_TOKEN_BEDROCK no está configurada con una clave caducada o no deseada.
• Para usar la aplicación de escritorio o la extensión de IDE, las variables de entorno necesarias están presentes en ~/.codex/.env.

Límites del soporte

El soporte de OpenAI puede ayudar con la configuración de ChatGPT Work y del cliente de Codex, la configuración general, el comportamiento local de la CLI, el comportamiento de la aplicación de escritorio, el comportamiento de la extensión de IDE y la experiencia local del producto.

Para cuestiones relacionadas con las credenciales de AWS, los permisos de IAM, el acceso a modelos de Bedrock, las cuotas, la facturación, la disponibilidad regional, los errores de solicitudes de Bedrock, los registros de servicios de AWS o el comportamiento del servicio Bedrock, ponte en contacto con el administrador de AWS del cliente o con el soporte de AWS.