Saltar al contenido principal
La configuración administrada por servidor permite a los administradores configurar centralmente Claude Code a través de una interfaz basada en web en Claude.ai. Los clientes de Claude Code reciben automáticamente estas configuraciones cuando los usuarios se autentican con sus credenciales organizacionales. Este enfoque está diseñado para organizaciones que no tienen infraestructura de administración de dispositivos implementada, o que necesitan administrar configuraciones para usuarios en dispositivos no administrados.
La configuración administrada por servidor está en beta pública y disponible para clientes de Claude for Teams y Claude for Enterprise. Las características pueden evolucionar antes de la disponibilidad general.

​
Requisitos

Para usar la configuración administrada por servidor, necesita:
  • Plan Claude for Teams o Claude for Enterprise
  • Claude Code versión 2.1.38 o posterior para Claude for Teams, o versión 2.1.30 o posterior para Claude for Enterprise
  • Acceso de red a api.anthropic.com

​
Elegir entre configuración administrada por servidor y administrada por punto final

Claude Code admite dos enfoques para la configuración centralizada. La configuración administrada por servidor entrega la configuración desde los servidores de Anthropic. La configuración administrada por punto final se implementa directamente en dispositivos a través de políticas nativas del sistema operativo (preferencias administradas de macOS, registro de Windows) o archivos de configuración administrados.
EnfoqueMejor paraModelo de seguridad
Configuración administrada por servidorOrganizaciones sin MDM, o usuarios en dispositivos no administradosConfiguración entregada desde los servidores de Anthropic en el momento de la autenticación
Configuración administrada por punto finalOrganizaciones con MDM o administración de puntos finalesConfiguración implementada en dispositivos a través de perfiles de configuración MDM, políticas de registro o archivos de configuración administrados
Si sus dispositivos están inscritos en una solución MDM o de administración de puntos finales, la configuración administrada por punto final proporciona garantías de seguridad más sólidas porque el archivo de configuración puede protegerse de la modificación del usuario a nivel del sistema operativo.

​
Configurar la configuración administrada por servidor

1

Abrir la consola de administración

En Claude.ai, navegue a Admin Settings > Claude Code > Managed settings.
2

Definir su configuración

Agregue su configuración como JSON. Todas las configuraciones disponibles en settings.json son compatibles, incluidas las configuraciones solo administradas como disableBypassPermissionsMode.Este ejemplo aplica una lista de denegación de permisos e impide que los usuarios omitan permisos:
{
  "permissions": {
    "deny": [
      "Bash(curl *)",
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)"
    ]
  },
  "disableBypassPermissionsMode": "disable"
}
3

Guardar e implementar

Guarde sus cambios. Los clientes de Claude Code reciben la configuración actualizada en su próximo inicio o ciclo de sondeo por hora.

​
Verificar la entrega de configuración

Para confirmar que la configuración se está aplicando, pida a un usuario que reinicie Claude Code. Si la configuración incluye configuraciones que activan el diálogo de aprobación de seguridad, el usuario ve un mensaje que describe la configuración administrada al inicio. También puede verificar que las reglas de permisos administrados estén activas haciendo que un usuario ejecute /permissions para ver sus reglas de permisos efectivas.

​
Control de acceso

Los siguientes roles pueden administrar la configuración administrada por servidor:
  • Propietario principal
  • Propietario
Restrinja el acceso al personal de confianza, ya que los cambios de configuración se aplican a todos los usuarios de la organización.

​
Limitaciones actuales

La configuración administrada por servidor tiene las siguientes limitaciones durante el período beta:
  • La configuración se aplica uniformemente a todos los usuarios de la organización. Las configuraciones por grupo aún no son compatibles.
  • Las configuraciones de servidor MCP no se pueden distribuir a través de la configuración administrada por servidor.

​
Entrega de configuración

​
Precedencia de configuración

La configuración administrada por servidor y la configuración administrada por punto final ocupan el nivel más alto en la jerarquía de configuración de Claude Code. Ningún otro nivel de configuración puede anularlas, incluidos los argumentos de línea de comandos. Cuando ambas están presentes, la configuración administrada por servidor tiene prioridad y la configuración administrada por punto final no se utiliza.

​
Comportamiento de obtención y almacenamiento en caché

Claude Code obtiene la configuración de los servidores de Anthropic al inicio y sondea actualizaciones cada hora durante sesiones activas. Primer lanzamiento sin configuración en caché:
  • Claude Code obtiene la configuración de forma asincrónica
  • Si la obtención falla, Claude Code continúa sin configuración administrada
  • Hay una breve ventana antes de que se cargue la configuración donde las restricciones aún no se aplican
Lanzamientos posteriores con configuración en caché:
  • La configuración en caché se aplica inmediatamente al inicio
  • Claude Code obtiene configuración nueva en segundo plano
  • La configuración en caché persiste a través de fallos de red
Claude Code aplica actualizaciones de configuración automáticamente sin reinicio, excepto para configuraciones avanzadas como la configuración de OpenTelemetry, que requieren un reinicio completo para tomar efecto.

​
Diálogos de aprobación de seguridad

Ciertas configuraciones que podrían presentar riesgos de seguridad requieren aprobación explícita del usuario antes de ser aplicadas:
  • Configuraciones de comandos de shell: configuraciones que ejecutan comandos de shell
  • Variables de entorno personalizadas: variables que no están en la lista de permitidos conocida y segura
  • Configuraciones de hooks: cualquier definición de hook
Cuando estas configuraciones están presentes, los usuarios ven un diálogo de seguridad que explica qué se está configurando. Los usuarios deben aprobar para continuar. Si un usuario rechaza la configuración, Claude Code se cierra.
En modo no interactivo con la bandera -p, Claude Code omite los diálogos de seguridad y aplica la configuración sin aprobación del usuario.

​
Disponibilidad de plataforma

La configuración administrada por servidor requiere una conexión directa a api.anthropic.com y no está disponible cuando se utilizan proveedores de modelos de terceros:
  • Amazon Bedrock
  • Google Vertex AI
  • Microsoft Foundry
  • Puntos finales de API personalizados a través de ANTHROPIC_BASE_URL o puertas de enlace LLM

​
Registro de auditoría

Los eventos del registro de auditoría para cambios de configuración están disponibles a través de la API de cumplimiento o exportación del registro de auditoría. Póngase en contacto con su equipo de cuenta de Anthropic para obtener acceso. Los eventos de auditoría incluyen el tipo de acción realizada, la cuenta y el dispositivo que realizó la acción, y referencias a los valores anteriores y nuevos.

​
Consideraciones de seguridad

La configuración administrada por servidor proporciona aplicación de políticas centralizada, pero funciona como un control del lado del cliente. En dispositivos no administrados, los usuarios con acceso de administrador o sudo pueden modificar el binario de Claude Code, el sistema de archivos o la configuración de red.
EscenarioComportamiento
El usuario edita el archivo de configuración en cachéEl archivo manipulado se aplica al inicio, pero la configuración correcta se restaura en la siguiente obtención del servidor
El usuario elimina el archivo de configuración en cachéOcurre el comportamiento del primer lanzamiento: la configuración se obtiene de forma asincrónica con una breve ventana no aplicada
La API no está disponibleLa configuración en caché se aplica si está disponible, de lo contrario, la configuración administrada no se aplica hasta la siguiente obtención exitosa
El usuario se autentica con una organización diferenteLa configuración no se entrega para cuentas fuera de la organización administrada
El usuario establece un ANTHROPIC_BASE_URL no predeterminadoLa configuración administrada por servidor se omite cuando se utilizan proveedores de API de terceros
Para detectar cambios de configuración en tiempo de ejecución, use hooks ConfigChange para registrar modificaciones o bloquear cambios no autorizados antes de que surtan efecto. Para garantías de aplicación más sólidas, use la configuración administrada por punto final en dispositivos inscritos en una solución MDM.

​
Ver también

Páginas relacionadas para administrar la configuración de Claude Code:
  • Settings: referencia de configuración completa que incluye todas las configuraciones disponibles
  • Endpoint-managed settings: configuración administrada implementada en dispositivos por TI
  • Authentication: configurar el acceso de usuarios a Claude Code
  • Security: salvaguardas de seguridad y mejores prácticas