Saltar al contenido principal
Usa esta guía para conectar Claude Desktop Cowork en inferencia de terceros a CometAPI. Esta configuración permite que Claude Desktop envíe solicitudes de la API de Claude Messages a CometAPI desde Cowork, Projects y flujos de trabajo de escritorio compatibles. Referencias oficiales:
La inferencia de terceros de Claude Desktop requiere un gateway compatible con Anthropic. CometAPI admite modelos Claude mediante la Anthropic Messages API.
El contenido que envías 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 developer mode

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 inferencia de terceros

Después de habilitar el developer mode, 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 valores de CometAPI indicados abajo:
FieldValue
Inference providerGateway
GatewayAnthropic-compatible
Gateway base URLhttps://api.cometapi.com
Gateway API keyTu API key de CometAPI, como <COMETAPI_KEY>
Gateway auth schemeBearer
Gateway extra headersDéjalo en blanco
Mantén la base URL exactamente como se muestra. Claude Desktop requiere una base URL HTTPS.La siguiente captura de pantalla muestra la sección Connection completada con valores de CometAPI.Configuración de Connection de Claude Desktop con la gateway base URL de CometAPI, el campo de API key y el esquema de autenticación bearer completados
4

Agregar model IDs

En Model list, agrega manualmente estos model IDs:
Model IDRecommended use
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 uso 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 Models 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 de usuario local 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 inferencia de terceros. 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 base URL, la API key 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 inferencia de terceros Para inspeccionar la configuración detectada, abre Help → Troubleshooting → Copy Managed Configuration Report. Los valores secretos se redactan 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 compilación de Claude Desktop que incluya configuración de inferencia de terceros.
Revisa estos elementos:
  • Inference provider está configurado como Gateway.
  • Gateway base URL es https://api.cometapi.com.
  • Gateway API key contiene tu API key de CometAPI sin espacios adicionales.
  • Hiciste clic en Apply locally y reiniciaste Claude Desktop por completo.
Confirma que la base URL comience con https://. Claude Desktop no acepta URLs de gateway con HTTP sin cifrar.Confirma también que tu cuenta de CometAPI tenga acceso a modelos Claude y que la API key no haya sido eliminada ni deshabilitada.
Vuelve a abrir Developer → Configure third-party inference y revisa las entradas de Model list. Los model IDs deben coincidir con los IDs que CometAPI expone.Agrega cada model ID como una entrada separada. No incluyas comillas, comas ni espacios adicionales en los campos de la UI.
La inferencia de terceros de Claude Desktop espera un gateway compatible con Anthropic para este flujo. Usa https://api.cometapi.com y los model IDs de Claude indicados arriba.
La pestaña Code usa el motor Claude Code dentro de Claude Desktop. Es posible que algunas configuraciones de escritorio no se apliquen a las sesiones de Code de la misma forma en que se aplican a Cowork.Para uso independiente en terminal, consulta la guía de integración de Claude Code.