Skip to main content
Claude Code aplica la política de la organización a través de configuraciones administradas que tienen prioridad sobre la configuración local del desarrollador. Usted entrega esa configuración desde la consola de administración de Claude, su sistema de gestión de dispositivos móviles (MDM), o un archivo en disco. La configuración controla qué herramientas, comandos, servidores y destinos de red puede alcanzar Claude. Esta página lo guía a través de las decisiones de implementación en orden. Cada fila se vincula a la sección a continuación y a la página de referencia para esa área.
SSO, aprovisionamiento SCIM y asignación de asientos se configuran a nivel de cuenta de Claude. Consulte la Guía del administrador empresarial de Claude y asignación de asientos para esos pasos.

Elegir su proveedor de API

Claude Code se conecta a Claude a través de uno de varios proveedores de API. Su elección afecta la facturación, la autenticación, qué postura de cumplimiento hereda y qué características de Claude Code pueden usar sus desarrolladores. Algunas características de Claude Code requieren una cuenta de claude.ai. Las sesiones en la nube, las tareas programadas en la nube, Code Review, Remote Control y la extensión de Chrome no están disponibles solo con claves de API de Console o credenciales de proveedores en la nube. Si despliegas a través de Amazon Bedrock, Google Cloud’s Agent Platform o Microsoft Foundry, planifica si los desarrolladores también necesitan asientos de Claude for Teams o Enterprise. Cada página de características indica sus requisitos de plan. Para la comparación completa del proveedor que cubre autenticación, regiones y paridad de características, consulte la descripción general de implementación empresarial. La configuración de autenticación de cada proveedor está en Authentication. Los requisitos de proxy y firewall en Network configuration se aplican independientemente del proveedor. Si desea un único punto final frente a múltiples proveedores o registro de solicitudes centralizado, consulte LLM gateway.

Decidir cómo llega la configuración a los dispositivos

La configuración administrada define la política de la organización. Claude Code comprueba las cuatro fuentes en la tabla siguiente en orden de prioridad. Cómo Claude Code combina fuentes administradas indica cuáles de ellas se aplican, qué cambia un asistente de política y cómo componer cada fuente. La tabla es el mapa de decisión. Claude Code obtiene la configuración administrada por servidor al inicio y la actualiza cada hora durante la sesión, sin infraestructura de endpoints que desplegar. La entrega a través de la consola de administración de claude.ai requiere un plan Claude for Teams o Enterprise. Los despliegues en Amazon Bedrock, Google Cloud’s Agent Platform o Microsoft Foundry pueden obtener la misma entrega remota ejecutando un Claude apps gateway, o usar en su lugar uno de los mecanismos basados en archivos o a nivel del SO. Si tu organización mezcla proveedores, configura server-managed settings para usuarios de claude.ai más un respaldo basado en archivos o plist/registry para que otros usuarios aún reciban política administrada. Las ubicaciones de plist y registro HKLM funcionan con cualquier proveedor y resisten la manipulación porque requieren privilegios de administrador para escribir. El registro de usuario de Windows en HKCU se puede escribir sin elevación, así que trátalo como un valor predeterminado de conveniencia en lugar de un canal de aplicación. Por defecto, WSL lee solo la ruta de archivo de Linux en /etc/claude-code. Para extender tu política de registro de Windows y C:\Program Files\ClaudeCode a WSL en la misma máquina, establece wslInheritsWindowsSettings: true en cualquiera de esas fuentes de Windows de solo administrador. Cualquiera que sea el mecanismo que elijas, los valores administrados tienen prioridad sobre la configuración de usuario y proyecto, aparte de algunas excepciones sensibles a la seguridad. Los ajustes de matriz como permissions.allow y permissions.deny combinan entradas de todas las fuentes, por lo que los desarrolladores pueden extender listas administradas pero no eliminar elementos de ellas. Para fallbackModel, availableModels y modelPicker, el valor administrado reemplaza las capas inferiores en lugar de combinarse.

Sesiones de WSL en Claude Code Desktop

En Windows, Claude Code Desktop puede ejecutar sesiones de Code dentro de una distribución de WSL 2. El proceso de Claude Code de la sesión se ejecuta dentro de la distribución, por lo que resuelve la configuración administrada a través de la ruta de descubrimiento de WSL anterior: las fuentes solo de Windows no la alcanzan a menos que wslInheritsWindowsSettings: true esté desplegado. Claude Desktop desactiva las sesiones de WSL de forma predeterminada en dispositivos que detecta como administrados por la organización, por ejemplo cuando existe C:\Program Files\ClaudeCode\managed-settings.json. Para activarlas, despliega una política de registro de Windows, que requiere Claude Desktop v1.19367.0 o posterior:
  • Crea un valor denominado disableWslSessions bajo HKLM\SOFTWARE\Policies\Claude y establécelo en la cadena REG_SZ false o en REG_DWORD 0. Este valor se encuentra bajo la clave de política de Claude Desktop, separado de la clave ClaudeCode que lleva la configuración administrada. Despliega el valor bajo HKLM, que requiere privilegios de administrador para escribir. Un valor bajo HKCU no habilita las sesiones de WSL.
  • Deja C:\Program Files\ClaudeCode\managed-settings.json en su lugar si lo despliegas. Una vez que disableWslSessions es false bajo HKLM, Desktop permite sesiones de WSL aunque ese archivo esté presente.
Desktop lee la política cada vez que se inicia una sesión de WSL, por lo que no necesitas reiniciar la aplicación después de desplegarla. Si un dispositivo aún rechaza las sesiones de WSL, abre Help > Troubleshooting > Show Logs in File Explorer en Claude Desktop en ese dispositivo, lo que guarda una copia de su carpeta de registros en Descargas. Busca [wslPolicyGate] denying WSL session en el main.log de esa copia. La razón de la denegación aparece a continuación entre paréntesis, como (cli-file-present). Después de que las sesiones de WSL estén habilitadas, extiende tu configuración administrada a ellas:
  • Despliega wslInheritsWindowsSettings: true a través del registro HKLM o del archivo C:\Program Files\ClaudeCode para que las sesiones de WSL hereden la misma política que las sesiones del host.
  • Verifica ejecutando /status dentro de una sesión de WSL y leyendo la línea Setting sources. Para interpretar lo que enumera, consulta Leer la fuente en /status.
Los procesos dentro de la máquina virtual de utilidad de WSL 2 no son visibles para los sensores de detección de endpoints del lado de Windows. Para observar la actividad de procesos y archivos dentro de la distribución, consulta la guía de WSL de tu proveedor de detección de endpoints para encontrar un sensor de Linux que puedas ejecutar dentro de la distribución y las exclusiones que necesita. La telemetría de ejecución de herramientas de OpenTelemetry de Claude Code se emite de forma idéntica para sesiones de WSL y nativas.

Decidir qué aplicar

La configuración administrada puede bloquear herramientas, ejecución de sandbox, restringir servidores MCP y fuentes de plugins, y controlar qué hooks se ejecutan. Cada fila es una superficie de control con las claves de configuración que la impulsan. Si los miembros inician sesión a través de claude.ai o la API de Anthropic y está en un plan Claude Enterprise, también puede gobernar modelos desde la configuración de administración de su organización sin implementar nada: Ninguno de estos controles llega a sesiones en Amazon Bedrock, Google Cloud’s Agent Platform, Microsoft Foundry, o Claude Platform on AWS. En esos proveedores, use configuración administrada en su lugar: availableModels para restricciones, model para un predeterminado, y maxEffortLevel para un límite de esfuerzo. Las sesiones en la nube tienen sus propias superficies de administración en claude.ai: Las reglas de permisos y el sandboxing cubren diferentes capas. Denegar WebFetch bloquea la herramienta de búsqueda de Claude, pero si Bash está permitido, curl y wget aún pueden alcanzar cualquier URL. El sandboxing cierra esa brecha con una lista de permitidos de dominio de red aplicada a nivel del SO. Para el modelo de amenaza que estos controles defienden, consulte Security.

Cuentas de GitHub conectadas

En los planes Team y Enterprise, la sección de GitHub de Organization settings > Git providers enumera las organizaciones de GitHub y las cuentas personales vinculadas a tu organización de Claude a través de la Claude GitHub App. Claude Code, Claude Tag y Claude Security comparten la lista. Abrir la página requiere un rol de administrador en tu organización de Claude. Un administrador o un miembro puede vincular una cuenta:
  • Conexión de administrador: un administrador hace clic en Connect en esa sección, o en Add organization una vez que hay una cuenta conectada, e instala la Claude GitHub App en una organización de GitHub. Vincular una organización de esta manera requiere a alguien que sea a la vez propietario de la organización de GitHub y administrador de tu organización de Claude.
  • Conexión de miembro: cuando un miembro conecta su cuenta de GitHub a Claude, por ejemplo al configurar sesiones en la nube, Claude vincula las cuentas de GitHub de las que ese miembro es propietario y en las que la Claude GitHub App ya está instalada. Eso puede incluir su cuenta personal y las organizaciones de GitHub de las que es propietario.
Una fila marcada como Not linked proviene de tu propio inicio de sesión en GitHub. Es una cuenta que puedes ver en GitHub en la que está instalada la Claude GitHub App. Para desvincular una cuenta de tu organización de Claude, abre el menú de su fila y selecciona Unlink from this workspace. Desvincularla deja la Claude GitHub App instalada en GitHub, y la cuenta se vuelve a vincular la próxima vez que uno de sus propietarios conecte GitHub a Claude. Para evitar que se vuelva a vincular, desinstala la Claude GitHub App de esa cuenta en GitHub. En los planes Enterprise, los tipos de actividad de la Compliance API para vincular y desvincular son github_app_installation_linked y github_app_installation_unlinked.

Configurar visibilidad de uso

Elija monitoreo basado en lo que necesita reportar. Los paneles, las API y los controles de gasto difieren entre los planes Claude for Teams o Enterprise y las organizaciones de Claude Console, así que verifique la columna Disponibilidad antes de planificar su reporte alrededor de una capacidad. En Teams y Enterprise, los números de uso y gasto por usuario provienen del informe de gasto en la configuración de análisis de su organización, no del panel de análisis. Los proveedores de nube exponen el gasto a través de AWS Cost Explorer, GCP Billing o Azure Cost Management. Para planificar presupuestos empresariales en Claude chat, Claude Code y Cowork, consulte la guía de consumo de Claude Enterprise.

Revisar el manejo de datos

En planes de Team, Enterprise, Claude API y proveedores de nube, Anthropic no entrena modelos con tu código o prompts. Tu proveedor de API determina la retención y la postura de cumplimiento. Si necesitas registro de auditoría a nivel de solicitud o enrutar tráfico por sensibilidad de datos, te recomendamos colocar un gateway entre los desarrolladores y tu proveedor: un Claude apps gateway autohospedado guarda un registro de auditoría por solicitud con la identidad del IdP, o puedes usar otro LLM gateway. Las sesiones que pasan por un gateway no son elegibles para la configuración de HIPAA. Verificar cómo los desarrolladores inician sesión y se conectan enumera qué métodos de inicio de sesión y de conexión sí son elegibles. Para requisitos regulatorios y certificaciones, consulta Legal and compliance.

Verificar e incorporar

Después de configurar la configuración administrada, haga que un desarrollador ejecute /status dentro de Claude Code. En la pestaña Status, la línea Setting sources muestra Enterprise managed settings seguida de la fuente entre paréntesis; Verificar cumplimiento enumera las etiquetas. Comparta estos recursos para ayudar a los desarrolladores a comenzar: Para problemas de inicio de sesión, dirija a los desarrolladores a solución de problemas de autenticación. Las correcciones más comunes son:
  • Ejecutar /logout luego /login para cambiar de cuenta
  • Ejecutar claude update si falta la opción de autenticación empresarial
  • Reiniciar la terminal después de actualizar
Si un desarrollador ve “You haven’t been added to your organization yet,” su asiento no incluye acceso a Claude Code y debe actualizarse en la consola de administración.

Próximos pasos

Con el proveedor y el mecanismo de entrega elegidos, continúe con la configuración detallada: