HopBase DocsClaude Desktop
Conecte Chat, Cowork y Code de Claude Desktop a HopBase con su modo de inferencia de terceros.
Claude Desktop es la app de escritorio de Anthropic. Su modo de inferencia de terceros (Claude Desktop on 3P) puede enviar las solicitudes a cualquier gateway que implemente la API Messages de Anthropic, y HopBase se conecta como ese gateway.
| Ajuste | Valor |
|---|---|
| Inference provider | Gateway |
| Gateway base URL | https://api.hop-base.com (sin /v1) |
| Gateway API key | Una clave de un grupo Claude |
| Credential kind | Static API key (predeterminado) |
| Gateway auth scheme | Bearer (predeterminado) |
Antes de empezar
Instale Claude Desktop desde claude.com/download. Los requisitos oficiales son macOS 14 o posterior, o Windows 10 versión 2004 o posterior. En Windows, use el instalador .msix; el instalador .exe antiguo no incluye Cowork.
En la página Claves API de la consola, prepare una clave del grupo Claude Max (oficial, cuota completa). El grupo Claude Max (ccmax) solo admite el cliente Claude Code, así que no lo use en Claude Desktop.
El modo de inferencia de terceros no inicia sesión en una cuenta de Anthropic y las conversaciones se guardan en su equipo. claude.ai en la web, las apps móviles y el modo de voz no están disponibles en este modo.
Configuración
Active el modo de desarrollador
Abra la app y quédese en la pantalla de inicio de sesión sin iniciar sesión. Desde la barra de menús de macOS, o el menú ☰ arriba a la izquierda de la pantalla de inicio de sesión en Windows, elija Help → Troubleshooting → Enable Developer Mode.
Abra la ventana de inferencia de terceros
Elija Developer → Configure Third-Party Inference….
Complete la conexión
En Connection, ponga Inference provider en Gateway e introduzca la base URL y la clave de la tabla anterior. Deje los otros dos campos con sus valores predeterminados.
Aplique y reinicie
Haga clic en Apply Changes y luego en Save & Restart. Tras el reinicio, elija iniciar en el modo de inferencia de terceros en la pantalla de inicio de sesión.
Envíe un mensaje de prueba
Inicie una conversación nueva y pida una respuesta de una sola palabra. Si funciona, la solicitud aparece en el registro de uso de la consola.
Elegir modelos
Puede dejar la lista de modelos vacía: al iniciarse, la app llama a GET /v1/models para rellenarla. Si el selector está vacío o muestra modelos que fallan, introduzca los ID de modelo a mano en Models dentro de la ventana de configuración. El primero es el modelo predeterminado.
claude-opus-5
claude-sonnet-5Introduzca solo los ID que devuelve GET /v1/models para su clave. Distinguen mayúsculas y minúsculas.
Qué funciones funcionan
Según la tabla oficial de funciones, en el modo de inferencia de terceros Chat, Cowork y Code llaman a los modelos a través del gateway, así que todos funcionan con HopBase. Los proyectos, los Artifacts, MCP local y remoto, y las skills y plugins también funcionan.
Más detalles
Cierre la sesión en la app para volver a la pantalla de inicio de sesión y siga los pasos anteriores. Para volver al modo normal, elija el inicio de sesión de Anthropic en esa pantalla; la configuración de inferencia de terceros se conserva.
Según la documentación oficial, si un gateway no reenvía las herramientas de servidor de Anthropic, la búsqueda web necesita antes un proveedor de búsqueda configurado en la ventana de configuración. Si no necesita búsqueda web, puede omitirlo.
- Tras reiniciar sigue apareciendo la pantalla de inicio de sesión de claude.ai: la configuración no se leyó. Cierre la app por completo, ábrala de nuevo y compruebe que Inference provider es Gateway.
- Para ver lo que la app leyó realmente, elija Help → Troubleshooting → Generate Diagnostic Report, expórtelo y revise
managed-config.txtyprovider-status.txt. - Si su empresa instaló en el equipo una configuración administrada de Claude, la ventana es de solo lectura. Contacte con su administrador.
- 401: la clave es incorrecta o no pertenece a un grupo Claude.
- 404: la base URL incluye
/v1, así que las solicitudes van a/v1/v1/messages.
Para otros errores, consulte Solución de problemas.
Próximos pasos
- Claude Code: use los mismos modelos Claude en una terminal
- Anthropic SDK: llame a Claude desde su propio código
- Solución de problemas: busque un mensaje de error