Saltar al contenido principal
Usa esta guía para conectar Claude Desktop Cowork sobre inferencia de terceros con CometAPI. Esta configuración permite que Claude Desktop envíe solicitudes de Claude Messages API a CometAPI desde Cowork, Projects y los flujos de trabajo de escritorio compatibles. Referencias oficiales:
La inferencia de terceros de Claude Desktop requiere un gateway compatible con Anthropic. CometAPI es compatible con modelos Claude a través de la Anthropic Messages API.
El contenido que envíes desde Claude Desktop es procesado por CometAPI y el proveedor del modelo seleccionado. No envíes datos confidenciales a menos que tu organización permita ese flujo de trabajo.

​
Requisitos previos

  • Claude Desktop instalado desde claude.com/download
  • Una compilación de Claude Desktop que incluya Developer mode y Configure third-party inference
  • Una cuenta de CometAPI con una API key activa
  • Acceso a modelos Claude en CometAPI
  • Una ruta de red que pueda alcanzar https://api.cometapi.com
Comienza desde la pantalla de inicio de sesión de Claude Desktop. Si ya iniciaste sesión con una cuenta de Anthropic, cierra sesión antes de configurar la inferencia de terceros.

​
Configuración

1

Habilitar el modo desarrollador

Abre Claude Desktop y permanece en la pantalla de inicio de sesión. En el menú de la aplicación, abre Help → Troubleshooting y luego selecciona Enable Developer Mode.En Windows, puede ser difícil acceder al menú antes de iniciar sesión. Enfoca el campo de correo electrónico, presiona Tab hasta que el menú tenga el foco y luego presiona Enter.
2

Abrir la configuración de Inference de terceros

Después de habilitar el modo desarrollador, abre Developer → Configure third-party inference.La ventana de configuración se abre con varias secciones en la barra lateral izquierda. Usa la sección Connection para la configuración de CometAPI.
3

Configurar el gateway

En la sección Connection, introduce los siguientes valores de CometAPI:
CampoValor
Proveedor de InferenceGateway
GatewayAnthropic-compatible
URL base del gatewayhttps://api.cometapi.com
Clave API del gatewayTu clave API de CometAPI, como $COMETAPI_KEY
Esquema de autenticación del gatewayBearer
Encabezados extra del gatewayDéjalo en blanco
Mantén la URL base exactamente como se muestra. Claude Desktop requiere una URL base HTTPS.La siguiente captura de pantalla muestra la sección Connection completada con los valores de CometAPI.Configuración de Connection de Claude Desktop con la URL base del gateway de CometAPI, el campo de clave API y el esquema de autenticación bearer completos
4

Añadir model IDs

En Model list, añade manualmente estos model IDs:
Model IDUso recomendado
claude-opus-4-7Planificación compleja y tareas de agentes
claude-sonnet-4-6Uso general en escritorio
claude-haiku-4-5-20251001Prompts ligeros y borradores rápidos
El primer modelo de la lista se convierte en el modelo predeterminado. Coloca claude-sonnet-4-6 primero si quieres un valor predeterminado de propósito general.
La disponibilidad de los modelos puede cambiar. Si un modelo no aparece en Claude Desktop después de la configuración, verifica el acceso en la página de modelos de CometAPI.
La siguiente captura de pantalla muestra la lista de modelos con los tres model IDs de Claude configurados para CometAPI.Lista de modelos de Claude Desktop que muestra claude-opus-4-7, claude-sonnet-4-6 y claude-haiku-4-5-20251001 para CometAPI
5

Aplicar la configuración localmente

Haz clic en Apply locally. Claude Desktop escribe la configuración seleccionada en el perfil local del usuario y reinicia la aplicación.Si la aplicación no se reinicia, cierra Claude Desktop por completo y ábrelo de nuevo.
6

Iniciar una sesión de Cowork

En la pantalla de inicio de sesión, elige la opción de Cowork en third-party inference. Abre Cowork o Projects, selecciona uno de los modelos Claude configurados y envía un Prompt de prueba corto.Una respuesta correcta confirma que Claude Desktop está usando CometAPI para las llamadas al modelo.

​
Verificar la configuración

Usa un Prompt corto que no requiera herramientas externas: 
Reply with one sentence: Claude Desktop is connected through CometAPI.
Si Claude Desktop devuelve una respuesta, entonces la URL base, la clave API y la lista de modelos están configuradas correctamente. La siguiente captura de pantalla muestra una respuesta correcta de Cowork a través de CometAPI. Respuesta de Cowork de Claude Desktop usando CometAPI después de la configuración de third-party inference Para inspeccionar la configuración detectada, abre Help → Troubleshooting → Copy Managed Configuration Report. Los valores secretos se ocultan en el informe copiado.

​
Solución de problemas

Confirma que seleccionaste Help → Troubleshooting → Enable Developer Mode. Luego cierra Claude Desktop por completo y ábrelo de nuevo.Si falta la opción, instala una versión de Claude Desktop que incluya configuración de inference de terceros.
Revisa estos elementos:
  • Inference provider está configurado en Gateway.
  • Gateway base URL es https://api.cometapi.com.
  • Gateway API key contiene tu clave API de CometAPI sin espacios extra.
  • Hiciste clic en Apply locally y reiniciaste Claude Desktop por completo.
Confirma que la base URL comienza con https://. Claude Desktop no acepta URLs de gateway HTTP sin cifrar.También confirma que tu cuenta de CometAPI tiene acceso a los modelos de Claude y que la clave API no ha sido eliminada ni deshabilitada.
Vuelve a abrir Developer → Configure third-party inference y revisa las entradas de Model list. Los model ID deben coincidir con los IDs que expone CometAPI.Añade cada model ID como una entrada separada. No incluyas comillas, comas ni espacios extra en los campos de la UI.
El inference de terceros de Claude Desktop espera un gateway compatible con Anthropic para este flujo. Usa https://api.cometapi.com y los IDs de modelo de Claude enumerados arriba.
La pestaña Code usa el motor Claude Code dentro de Claude Desktop. Es posible que algunos ajustes de escritorio no se apliquen a las sesiones de Code de la misma manera en que se aplican a Cowork.Para el uso independiente en terminal, consulta la guía de integración de Claude Code.