Aloja la configuración de Codex para tu equipo
Proporciona a Codex valores de configuración predeterminados y ajustes obligatorios desde un endpoint HTTPS que administras.
Si tus usuarios no inician sesión en Codex con ChatGPT, puedes distribuir la configuración a Codex CLI y a la aplicación de escritorio desde un servidor HTTPS que administras. Codex carga tus ajustes al iniciarse, tanto si los usuarios se conectan directamente a su proveedor de modelos como si lo hacen a través de una puerta de enlace.
Limitaciones del cliente
La aplicación de escritorio no puede solicitarte que inicies sesión en el servidor de configuración. Si tu servidor requiere un nuevo inicio de sesión, ejecuta codex login en una terminal del mismo equipo y vuelve a abrir la aplicación. Si la aplicación no puede cargar los ajustes obligatorios, el inicio se pausa.
Configura Codex para usar el servidor
En un equipo de prueba, crea o actualiza el archivo requirements.toml del sistema. Añade una tabla [config_server] con la URL base de tu servidor de configuración. Usa /etc/codex/requirements.toml en Linux y macOS, o %ProgramData%\OpenAI\Codex\requirements.toml en Windows. En macOS, también puedes distribuir la tabla mediante preferencias administradas.
[config_server]
base_url = "https://codex-config.example.com/team"Solo los requisitos locales controlados por el administrador pueden seleccionar el servidor. Mantén esta tabla en el equipo cuando traslades el resto de tu política al endpoint.
Autentícate en el servidor de configuración (opcional)
De forma predeterminada, Codex intenta obtener la configuración sin credenciales. Si tu servidor requiere iniciar sesión, añade [config_server.oauth] al mismo archivo requirements.toml. Codex usa el flujo de código de autorización de OAuth con Proof Key for Code Exchange (PKCE).
[config_server.oauth]
authorization_url = "https://login.example.com/oauth/authorize"
token_url = "https://login.example.com/oauth/token"
client_id = "codex-policy"
redirect_port = 43127El URI de redirección de este ejemplo es http://127.0.0.1:43127/callback. Puedes omitir redirect_port si tu proveedor acepta una devolución de llamada de bucle invertido en cualquier puerto disponible. Codex envía el token de acceso en el encabezado Authorization. Tu servidor debe verificarlo antes de devolver el paquete.
Proporciona la configuración de Codex
Aloja tu configuración administrada en un endpoint HTTPS. Cuando Codex CLI obtiene el paquete, envía una solicitud GET usando la URL base del archivo requirements.toml local:
GET {config_server.base_url}/codex/config/bundleCon el valor de base_url del ejemplo de configuración inicial anterior, Codex envía esta solicitud:
GET https://codex-config.example.com/team/codex/config/bundleResponde con 200 OK y un paquete de configuración JSON en el cuerpo de la respuesta.
Formato del paquete de configuración
El paquete agrupa las entradas TOML en dos arrays:
config_toml.enterprise_managedcontiene los valores predeterminados que se aplicarán. El campocontentsde cada entrada es texto deconfig.toml.requirements_toml.enterprise_managedcontiene los requisitos que se harán cumplir. El campocontentsde cada entrada es texto derequirements.toml.
Cada entrada del array tiene tres campos de cadena: id, name (un nombre para mostrar) y contents. Usa un array vacío para una categoría que no necesites.
Este ejemplo establece el valor predeterminado de búsqueda web en disabled y exige ese valor mediante allowed_web_search_modes.
{
"config_toml": {
"enterprise_managed": [
{
"id": "search-default",
"name": "Default web search",
"contents": "web_search = 'disabled'"
}
]
},
"requirements_toml": {
"enterprise_managed": [
{
"id": "search-policy",
"name": "Allowed web search modes",
"contents": "allowed_web_search_modes = ['disabled']"
}
]
}
}Verifica la configuración en Codex
- En un equipo de prueba, abre una terminal en el directorio de tu proyecto y ejecuta
codex. Completa el inicio de sesión de la empresa si se te solicita. - En el prompt interactivo de Codex CLI, escribe
/debug-configy pulsa Intro. - Si proporcionas valores predeterminados, busca sus nombres e identificadores en Pila de capas de configuración. Con el ejemplo anterior, busca
enterprise-managed (Default web search, search-default) (enabled). - Si proporcionas requisitos, busca un ajuste que exijas en Requisitos y comprueba el origen de la política que aparece junto a él.
Codex puede iniciarse con ajustes almacenados en caché y actualizarlos en segundo plano. Después de cambiar una política en el servidor, espera a que Codex la actualice, inicia una nueva sesión y repite la comprobación antes de implementarla en otros equipos.