Ir al contenido principal

Instalar y configurar Claude Cowork con plataformas de terceros

Actualizado hoy

Esta guía acompaña a los administradores de TI en la implementación de Claude Cowork en Amazon Bedrock, Google Cloud Vertex AI, Azure AI Foundry o una puerta de enlace LLM. Cubre descarga, configuración MDM para macOS y Windows, configuración específica del proveedor y la referencia completa de claves MDM.

Si está evaluando si esta implementación es adecuada para su organización, comience con Claude Cowork con plataformas de terceros.

Antes de comenzar

Asegúrese de tener:

  • Acceso a la plataforma — macOS 13.0 (Ventura) o posterior, o Windows 10 u 11. En Windows, la función Plataforma de máquina virtual debe estar habilitada, lo que requiere un reinicio del sistema de una sola vez.

  • Un proveedor de inferencia — Amazon Bedrock, Google Cloud Vertex AI, Azure AI Foundry o una puerta de enlace LLM que exponga /v1/messages.

  • Credenciales para ese proveedor — una clave API, token de portador, JSON de cuenta de servicio o clave de Foundry, según el proveedor que esté utilizando.

  • Acceso MDM — Jamf, Kandji, Mosyle o similar para macOS. Intune o Directiva de grupo para Windows.


Descargar el instalador

Descargue Claude Desktop para su plataforma desde la página de descarga. El mismo binario se envía para Claude Cowork estándar e implementaciones de terceros: el perfil de configuración MDM determina en qué modo se ejecuta la aplicación.

macOS

  1. Descargue el instalador de macOS desde la página de descarga.

  2. Abra el archivo .dmg.

  3. Arrastre Claude.app a su carpeta Aplicaciones.

  4. Configure la inferencia de terceros usando la interfaz de configuración (siguiente sección).

  5. Aplique la configuración MDM (debajo de la sección Configuración).

Windows

  1. Descargue el instalador de Windows desde la página de descarga.

  2. Ejecute el instalador .msix. Está diseñado para implementaciones empresariales y se puede insertar a través de Intune o Directiva de grupo.

  3. Siga las indicaciones en pantalla.

  4. Configure la inferencia de terceros usando la interfaz de configuración (siguiente sección).

  5. Aplique la configuración MDM (debajo de la sección Configuración).

Configurar inferencia de terceros a través de la interfaz de configuración

Abra la aplicación Claude Desktop descargada (no necesita iniciar sesión). Navegue a la Barra de menú y seleccione Ayuda → Solución de problemas → Habilitar modo de desarrollador. Con el modo de desarrollador habilitado, vaya a Desarrollador → Configurar inferencia de terceros. Esto activa una interfaz de configuración para configurar los campos requeridos. Puede encontrar más información sobre cada campo aquí: Referencia de configuración.


Aplicar la configuración MDM

Después de instalar, aplique un perfil de configuración administrado para activar el modo de plataforma de terceros y apunte la aplicación a su proveedor de inferencia.

macOS

Desde la interfaz de configuración, seleccione Exportar para descargar un archivo .mobileconfig para distribución.

Implemente un archivo de configuración .mobileconfig a través de su solución MDM.

  • Dominio: com.anthropic.claudefordesktop

  • Entrega: Jamf, Kandji, Mosyle, Intune para Mac o cualquier MDM que admita Configuración de aplicaciones

Windows

Desde la interfaz de configuración, seleccione Exportar para descargar un archivo .reg para distribución.

  • Ruta del registro: HKCU\SOFTWARE\Policies\Claude

  • Entrega: Directiva de grupo, Intune o cualquier MDM que admita archivos .reg

Implementaciones VDI

En entornos VDI, se aplican las mismas claves MDM. Establézcalas en su imagen dorada (para que cada sesión clonada las herede) o insértelas en tiempo de ejecución a través del sistema de políticas del agente VDI.


Configurar complementos

Los complementos amplían las capacidades de Claude con paquetes de habilidades, comandos y servidores MCP específicos de roles. Con plataformas de terceros, los complementos se distribuyen a través de un montaje de directorio local en cada máquina.

Coloque sus carpetas de complementos en:

  • macOS: /Library/Application Support/Claude/org-plugins/

  • Windows: C:\ProgramData\Claude\org-plugins\

Para obtener detalles sobre la estructura y gestión de complementos, consulte Ampliar Claude Cowork con plataformas de terceros.

Verificar la instalación

Inicie Claude Desktop en una máquina de prueba. Debería ver:

  • Pestañas Cowork y Code en la navegación izquierda

  • Sin pestaña Chat (el chat no está disponible en esta implementación)

  • La opción de iniciar sesión a través de Gateway o su proveedor de inferencia

Si los usuarios ven un error al iniciar, verifica que la clave inferenceProvider esté configurada y que las credenciales del proveedor sean válidas. Usa registros de consola en macOS o Visor de eventos en Windows para depuración más profunda.


Referencia de clave de configuración

Las tablas a continuación cubren todas las claves MDM disponibles a partir de abril de 2026. Todas las claves son opcionales a menos que se indique lo contrario. Para la lista actual y cualquier adición, contacta a tu representante de cuenta.

Configuración de inferencia

Clave

Tipo

Descripción

inferenceProvider

cadena

Selecciona el backend de inferencia. Configurar esta clave activa el modo de plataforma de terceros. Valores: bedrock, vertex, foundry, gateway.

inferenceGatewayBaseUrl

cadena

URL base de la puerta de enlace. Requerida cuando proveedor = gateway.

inferenceGatewayApiKey

cadena

Clave API para la puerta de enlace. Requerida cuando proveedor = gateway.

inferenceGatewayAuthScheme

cadena

Cómo se envía la credencial de la puerta de enlace (auto / x-api-key / bearer).

inferenceGatewayHeaders

cadena (matriz JSON de cadenas "Nombre: Valor")

Encabezados HTTP adicionales opcionales enviados a tu puerta de enlace en cada solicitud de inferencia.

inferenceVertexProjectId

cadena

ID de proyecto de GCP. Requerida cuando proveedor = vertex.

inferenceVertexRegion

cadena

Región de GCP. Requerida cuando proveedor = vertex.

inferenceVertexCredentialsFile

cadena

Ruta absoluta a un archivo JSON de cuenta de servicio o archivo ADC. Sin expansión de tilde o variable de entorno. Requerida cuando proveedor = vertex.

inferenceVertexBaseUrl

cadena

Anula el punto de conexión de Vertex AI (por ejemplo, Conexión de servicio privado). Déjalo sin configurar para usar el punto de conexión regional público.

inferenceVertexOAuthClientId

cadena

ID de cliente de OAuth para un inicio de sesión interactivo de Google por usuario, como alternativa a un archivo de cuenta de servicio compartida.

inferenceVertexOAuthClientSecret

cadena

Secreto de cliente de OAuth emparejado con el ID de cliente anterior.

inferenceVertexOAuthScopes

cadena (matriz JSON de cadena de alcance)

Matriz de cadenas JSON de alcances de OAuth a solicitar. Por defecto, el alcance requerido para la predicción de Vertex.

inferenceBedrockRegion

cadena

Región de AWS. Requerida cuando proveedor = bedrock.

inferenceBedrockBearerToken

cadena

Token portador de AWS. Requerida cuando proveedor = bedrock.

inferenceBedrockBaseUrl

cadena

Anula el punto de conexión de Bedrock (por ejemplo, punto de conexión de interfaz de VPC o puerta de enlace LLM). Déjalo sin establecer para usar el punto de conexión regional público.

inferenceBedrockProfile

cadena

Perfil con nombre de AWS desde ~/.aws/config. Úsalo cuando las credenciales se administren mediante AWS CLI, SSO o un proceso de credenciales empresarial.

inferenceBedrockAwsDir

cadena

Ruta absoluta al directorio que contiene los archivos de configuración/credenciales de AWS, si no es el predeterminado ~/.aws. Se copia en el sandbox para que el perfil con nombre se resuelva allí.

inferenceFoundryResource

cadena

Nombre del recurso de Azure AI Foundry. Requerido cuando provider = foundry.

inferenceFoundryApiKey

cadena

Clave API de Azure AI Foundry. Requerida cuando provider = foundry.

inferenceModels

cadena

Matriz JSON de ID de modelos o alias (sonnet, opus, haiku). La primera entrada es el valor predeterminado del selector. Requerido para Vertex, Bedrock y Foundry.

inferenceCredentialHelper

cadena

Ruta absoluta a un ejecutable cuya salida estándar es la credencial de inferencia. Se ejecuta en el host al inicio de la sesión.

inferenceCredentialHelperTtlSec

entero

Cuánto tiempo (en segundos) almacenar en caché la salida del asistente. Predeterminado: 3600.

Implementación y actualización automática

Clave

Tipo

Descripción

deploymentOrganizationUuid

cadena

UUID estable que identifica esta implementación. Define el alcance del almacenamiento local y la telemetría.

autoUpdaterEnforcementHours

entero

Cuando se establece, fuerza la instalación de una actualización pendiente después de este número de horas independientemente de la actividad del usuario. Cuando no se establece, la aplicación usa una ventana de 72 horas pero se difiere mientras el usuario está activo.

disableAutoUpdates

booleano

Impide que la aplicación busque y descargue actualizaciones. La aplicación permanece en su versión instalada hasta que se actualice por otros medios.

Telemetría

Clave

Tipo

Descripción

disableEssentialTelemetry

booleano

Bloquea los informes de fallos y errores y los datos de tiempo de rendimiento enviados a Anthropic.

disableNonessentialTelemetry

booleano

Bloquea la analítica de uso del producto: uso de funciones, patrones de navegación, acciones de la interfaz de usuario.

disableNonessentialServices

booleano

Bloquea los favicons del conector (que filtran nombres de host de MCP) y el sandbox de vista previa de artefactos. Los conectores recurren a iconos de letras; los artefactos no se renderizan.

otlpEndpoint

cadena

URL base de tu recopilador OTLP. Cuando se establece, las sesiones exportan registros y métricas (indicaciones, llamadas de herramientas, conteos de tokens). El host del punto final se añade automáticamente a la lista de permitidos de la red sandbox.

otlpProtocol

cadena

http/protobuf (predeterminado), http/json o grpc.

otlpHeaders

cadena

Pares clave=valor separados por comas enviados en cada solicitud OTLP (formato estándar OTEL_EXPORTER_OTLP_HEADERS).

MCP, complementos y herramientas

Clave

Tipo

Descripción

isDesktopExtensionEnabled

booleano

Permitir que los usuarios instalen extensiones de escritorio locales (.dxt o .mcpb).

isDesktopExtensionDirectoryEnabled

booleano

Mostrar el directorio de extensiones de Anthropic en la interfaz de conectores.

isDesktopExtensionSignatureRequired

booleano

Rechazar extensiones de escritorio que no estén firmadas por un editor de confianza.

isLocalDevMcpEnabled

booleano

Permitir que los usuarios añadan sus propios servidores MCP locales. Cuando es falso, solo están disponibles los servidores de la lista administrada.

isClaudeCodeForDesktopEnabled

booleano

Mostrar la pestaña Código (sesiones de codificación basadas en terminal). Las sesiones se ejecutan en el host, no dentro de la máquina virtual.

managedMcpServers

cadena

Matriz JSON de configuraciones de servidor MCP remoto. Cada entrada requiere nombre y url. Opcional: transporte (http o sse), encabezados, oauth, toolPolicy.

disabledBuiltinTools

cadena

Matriz JSON de nombres de herramientas a eliminar de la lista de herramientas del agente. Consulta el artículo MCP para la lista completa de herramientas.

coworkEgressAllowedHosts

Cadena (matriz JSON de nombres de host)

Rutas absolutas que los usuarios pueden adjuntar como carpetas de espacio de trabajo. El ~ inicial se expande al directorio de inicio del usuario. Cuando se establece, cualquier ruta fuera de esta lista se rechaza.

Límites de espacio de trabajo y uso

Clave

Tipo

Descripción

allowedWorkspaceFolders

cadena

Matriz JSON de rutas absolutas que el usuario puede adjuntar como carpetas de espacio de trabajo. El ~ inicial se expande al directorio de inicio por usuario. Sin establecer = sin restricciones.

inferenceMaxTokensPerWindow

entero

Total de tokens de entrada+salida permitidos por ventana deslizante antes de que se rechace sendMessage. Aplicado en el proceso principal de escritorio. Sin establecer = sin límite.

inferenceTokenWindowHours

entero

Longitud de la ventana deslizante para el límite de tokens. Máximo 720h (30 días). El contador se reinicia cuando ahora >= windowStartMs + windowHours×3600×1000.


Próximos pasos

¿Ha quedado contestada tu pregunta?