Aloja la configuración de Codex para tu equipo en tu propio servidor

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 los 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 pedirte que inicies sesión en el servidor de configuración. Si el servidor requiere que vuelvas a iniciar sesión, ejecuta codex login en una terminal de la misma computadora y vuelve a abrir la aplicación. Si la aplicación no puede cargar los ajustes obligatorios, el inicio se pausa.

Configurar Codex para que use el servidor

En una computadora de prueba, crea o actualiza el archivo requirements.toml del sistema. Agrega 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 las preferencias administradas.

[config_server]
base_url = "https://codex-config.example.com/team"

Solo se puede especificar el servidor en los requisitos locales que controla el administrador. Conserva esta tabla en la computadora cuando traslades el resto de la política al punto de acceso.

Autenticarse 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, agrega [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 llamada de retorno a la interfaz de loopback en cualquier puerto disponible. Codex envía el token de acceso en el encabezado Authorization. Tu servidor debe verificar el token antes de devolver el paquete.

Distribuir la configuración de Codex

Aloja la configuración administrada en un punto de acceso HTTPS. Cuando Codex CLI obtiene el paquete, envía una solicitud GET con la URL base del archivo local requirements.toml:

GET {config_server.base_url}/codex/config/bundle

Con la base_url del ejemplo de configuración inicial, Codex envía esta solicitud:

GET https://codex-config.example.com/team/codex/config/bundle

Responde con 200 OK e incluye un paquete de configuración en formato JSON en el cuerpo de la respuesta.

Formato del paquete de configuración

El paquete agrupa las entradas TOML en dos arreglos:

• config_toml.enterprise_managed contiene los valores predeterminados que se aplicarán. El campo contents de cada entrada contiene texto en formato config.toml.
• requirements_toml.enterprise_managed contiene los requisitos que se deben hacer cumplir. El campo contents de cada entrada contiene texto en formato requirements.toml.

Cada entrada de un arreglo tiene tres campos de texto: id, name (el nombre que se muestra) y contents. Usa un arreglo vacío para cualquier categoría que no necesites.

En este ejemplo, el valor predeterminado de la búsqueda web se establece en disabled y se hace obligatorio 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']"
      }
    ]
  }
}

Verificar la configuración en Codex

1. En una computadora de prueba, abre una terminal en el directorio de tu proyecto y ejecuta codex. Si se te solicita, inicia sesión con tu cuenta de la empresa.
2. En la línea de comandos interactiva de Codex CLI, escribe /debug-config y presiona Enter.
3. Si distribuyes valores predeterminados, busca sus nombres e identificadores en Config layer stack. Para el ejemplo anterior, busca enterprise-managed (Default web search, search-default) (enabled).
4. Si distribuyes requisitos, busca uno de los ajustes obligatorios en Requirements y verifica el origen de la política que aparece junto al ajuste.

Codex puede iniciarse con los ajustes guardados en caché y actualizarlos en segundo plano. Después de cambiar una política en el servidor, espera a que Codex la actualice. Luego, inicia una nueva sesión y repite la verificación antes de aplicar la política en otras computadoras.