Skip to main content
Cowork se conecta a un endpoint de terceros a través del modo de pasarela. La pasarela debe implementar la API de mensajes de Anthropic, que ejecutamos en POST /v1/messages. Cowork no ofrece un lugar para configurar start_within, por lo que el plazo se establece en la clave. Primero, cree una (consulte claves de agente). Una duración compite con el nivel más económico de Claude en claves administradas, sin streaming, dentro de una ventana de tres a diez minutos. Una sesión interactiva utiliza streaming, así que elija un nivel aquí en lugar de Flex race. Consulte Las duraciones de Claude necesitan una ventana más larga. Su organización debe poder ejecutar Anthropic antes de comenzar. Con sus propias claves, esto significa una clave de proveedor de Anthropic en la pestaña Provider keys, ya que no revendemos inferencia. En Managed Keys, significa que Anthropic está activado y financiado. Cowork mantiene estas configuraciones detrás de menús, por lo que esta página no tiene un aviso de configuración de agente. Utilice Export a continuación para aplicar la misma configuración a una flota.

Habilitar el modo de desarrollador

El menú Developer permanece oculto hasta que lo activa.
  1. Abra Claude Desktop.
  2. Vaya a Help, luego a Troubleshooting.
  3. Presione Enable Developer Mode.
Developer aparecerá entonces en la barra de menú.

Configurar Cowork

  1. Vaya a Developer, luego a Configure Third-Party Inference….
  2. Establezca Inference provider en Gateway.
  3. Establezca Gateway base URL en el router, sin el sufijo /v1.
  1. Pegue su clave de agente en Gateway API key.
  2. Deje Credential kind en Static API key.
  3. Deje Gateway auth scheme en Bearer. Rechazamos x-api-key.
  4. Elija un modelo claude-* en el selector de modelos.
Cowork lee nuestra respuesta GET /v1/models para llenar el selector. Solo lista los modelos que reconoce como Claude, que es lo que desea aquí.

Implementar en una flota

Haga clic en Export en la misma ventana para obtener un archivo .mobileconfig en macOS o un .reg en Windows, y luego impúlsalo con su MDM. Tres claves mantienen la integración. Establezca inferenceModels en una lista explícita solo si el selector omite un modelo que espera.

Deje las funciones beta desactivadas

Cowork desactiva las funciones beta experimentales de Claude Code por defecto, porque las pasarelas estrictas rechazan los encabezados anthropic-beta y los campos de solicitud que añaden. Somos una de esas pasarelas y no reenviamos esos encabezados. Deje toolSearchEnabled sin establecer por la misma razón. Activarlo envía encabezados beta que no reenviamos, y las solicitudes fallan.

Confirmar que la clave se aplicó

Cada respuesta viene con x-flexinference-defaults-applied. Cowork no muestra los encabezados de respuesta, así que lea la solicitud en el dashboard bajo Logs en su lugar.

Solución de problemas

No hay menú Developer. El modo de desarrollador está desactivado y oculta el menú por completo. Actívelo en Help, luego Troubleshooting, luego Enable Developer Mode. 401 missing_api_key. Gateway auth scheme está configurado en x-api-key, que no leemos. Cámbielo a Bearer. El selector de modelos está vacío. Cowork filtra GET /v1/models para mostrar solo los IDs que reconoce como Claude. Confirme que su organización puede ejecutar modelos claude-*, o configure inferenceModels usted mismo. 400 en cada solicitud después de habilitar la búsqueda de herramientas. toolSearchEnabled hace que Cowork envíe encabezados y campos anthropic-beta experimentales que no reenviamos. Déjelo sin establecer. 400 unsupported_parameter nombrando output_config. El selector eligió un modelo que no es Claude, y Cowork envía campos nativos de Anthropic que nos negamos a traducir incorrectamente. Elija un modelo claude-*. Consulte errors para ver cada rechazo que devolvemos, agent keys para los que no son específicos de Cowork, y Claude Code para el cliente de terminal.