Usar ChatGPT Work y Codex con Amazon Bedrock

Configura las interfaces locales de ChatGPT Work y Codex para usar los modelos de OpenAI disponibles mediante Amazon Bedrock. En esta configuración, el cliente local envía solicitudes del 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 solicitudes del modelo a Amazon Bedrock, y Bedrock proporciona una implementación compatible con la Responses API de OpenAI para los modelos de OpenAI compatibles.

Antes de comenzar

Asegúrate de tener:

• Acceso a modelos de OpenAI compatibles en Amazon Bedrock.
• Una región de AWS en la que esté disponible el modelo seleccionado.
• Autenticación configurada para la ruta Mantle de Amazon Bedrock en la cuenta de AWS.

Configurar 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. Proporcionar 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 rutas de autenticación de Bedrock. Las comprueban en este orden:

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

Opción 1: Bedrock API key

Configura la Bedrock API key en el entorno que lee el cliente local. Debes especificar una región cuando uses 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 de AWS SDK

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

Archivos de configuración compartidos de AWS

Configura los archivos compartidos de AWS config y credentials:

aws configure

Variables de entorno

Configura las variables de entorno estándar de credenciales de 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 AWS SDK resuelva las credenciales. Coloca el inicio de sesión en el navegador, el intercambio de tokens, el almacenamiento en caché y la actualizació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. Coloca los valores necesarios en ~/.codex/.env y, después, reinicia la aplicación o la extensión.

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

Verificar la configuración

• En Codex CLI, abre /status y confirma que Codex esté usando 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 identificadores exactos de los modelos:

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 los modelos según la región de AWS.

Disponibilidad de 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.
• Especificaste una región de AWS en la que el modelo está disponible.
• La Bedrock API key o las credenciales de AWS son válidas y no han vencido.
• La identidad de AWS tiene permiso para acceder al modelo de Bedrock seleccionado.
• AWS_BEARER_TOKEN_BEDROCK no está configurado con una clave vencida 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 del cliente de ChatGPT Work y Codex, la configuración, el comportamiento local de CLI, el comportamiento de la aplicación de escritorio, el comportamiento de la extensión de IDE y la experiencia local del producto.

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