Usar 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 de modelos 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 de modelos, la Responses API alojada por OpenAI no forma parte de la ruta de solicitud. El cliente local envía las solicitudes de modelos 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 modelos de OpenAI compatibles en Amazon Bedrock.
• Una región de AWS donde esté disponible el modelo seleccionado.
• Autenticación para la ruta de Amazon Bedrock Mantle configurada para la cuenta de AWS.

Configurar el proveedor

Agrega el proveedor de modelos amazon-bedrock para la ruta de Amazon Bedrock Mantle a ~/.codex/config.toml. La aplicación de escritorio de ChatGPT, Codex CLI, la extensión para 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. Clave de API de Bedrock.
2. Cadena de credenciales del SDK de AWS.

Opción 1: clave de API de Bedrock

Configura la clave de API de Bedrock en el entorno que lee el cliente local. Debes especificar una región cuando uses la autenticación mediante clave de API.

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

Opción 2: credenciales del SDK de AWS

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

Archivos de configuración compartidos de AWS

Configura los archivos compartidos config y credentials de AWS:

aws configure

Variables de entorno

Configura las variables de entorno estándar para las credenciales del SDK de AWS:

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 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 el SSO corporativo o la federación OIDC, configura una identidad federada con credential_process fuera del cliente local y permite que el SDK de AWS resuelva las credenciales. Incluye el inicio de sesión en el navegador, el intercambio de tokens, el almacenamiento en caché y la renovación en la utilidad auxiliar credential_process de tu perfil de AWS.

App de escritorio y extensión para IDE

Es posible que las aplicaciones de escritorio y las extensiones para IDE no hereden las variables de entorno del shell. Coloca los valores necesarios en ~/.codex/.env y, luego, 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 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 para 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 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 por 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 descubrimiento administrado en la nube no están disponibles actualmente.

Solución de problemas

Si la configuración falla, verifica lo siguiente:

• El ID del modelo coincide exactamente con un modelo compatible.
• Especificas una región de AWS donde el modelo está disponible.
• La clave de API 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á configurado con una clave caducada o incorrecta.
• Para usar la app de escritorio o la extensión para IDE, las variables de entorno necesarias están presentes en ~/.codex/.env.

Alcance del soporte

El Soporte de OpenAI puede ayudar con la puesta en marcha y la configuración del cliente de ChatGPT Work y Codex, el funcionamiento local de la CLI, el funcionamiento de la app de escritorio y de la extensión para IDE, y la experiencia local del producto.

Para consultas sobre credenciales de AWS, permisos de IAM, acceso a modelos de Bedrock, cuotas, facturación, disponibilidad regional, errores en las solicitudes de Bedrock, registros de servicios de AWS o el funcionamiento del servicio de Bedrock, comunícate con el administrador de AWS del cliente o con AWS Support.