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 = 43127

El 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/bundle

Con 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/bundle

Responde 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_managed contiene los valores predeterminados que se aplicarán. El campo contents de cada entrada es texto de config.toml.
  • requirements_toml.enterprise_managed contiene los requisitos que se harán cumplir. El campo contents de cada entrada es texto de requirements.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

  1. 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.
  2. En el prompt interactivo de Codex CLI, escribe /debug-config y pulsa Intro.
  3. 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).
  4. 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.