Claude Desktop (Chat, Cowork, Code)

Conecta la aplicación oficial Claude Desktop a GetVibe API mediante Third-Party Inference: Developer Mode, URL base de Gateway y una clave sk-pv- con el esquema x-api-key. Chatea, usa Cowork y Code sin una cuenta de Anthropic.

El camino más simple, sobre todo si no trabajas en una terminal. Una app, unos pasos y tu clave. Si algo no funciona, mira «Problemas frecuentes» abajo; la variante de terminal está en la página Claude Code CLI.

Si ves «App unavailable in region», estás en la app, no en el sitio web. El menú Help → Troubleshooting está dentro de Claude Desktop: la barra de menús de macOS o el botón ☰ en la esquina superior izquierda de la pantalla de inicio de sesión de Windows. No inicies sesión en una cuenta de Anthropic: activa el Developer Mode y configura la puerta de enlace como se indica abajo. Si tu versión no muestra ese menú, usa la Claude Code CLI.

La app oficial Claude Desktop (macOS y Windows) puede funcionar a través de una puerta de enlace de terceros: la función Third-Party Inference. GetVibe API habla el formato nativo de Anthropic (/v1/messages con la cabecera x-api-key), así que la app se conecta directamente, sin proxy traductor. Las tres pestañas funcionan: Chat, Cowork y Code. No hace falta una cuenta de Anthropic: no inicies sesión. La documentación de Anthropic dice que la app detecta el modo de terceros (3P) al iniciarse según el proveedor configurado; cuando hay proveedor y credenciales, la pantalla de inicio de sesión ofrece el inicio de terceros sin cuenta de Anthropic, y la documentación no describe una comprobación de región en modo 3P. Consulta la descripción general de 3P y la guía de instalación.

Para quién es

Windows 10/11 o macOS. No hay nada más que instalar: ni Node.js ni terminal.
Solo necesitas tu clave sk-pv-… de Panel → Claves API.

1. Instala la aplicación

Descarga Claude Desktop desde el sitio oficial, instálalo e inícialo. En la pantalla de inicio de sesión, no inicies sesión con una cuenta de Anthropic.

Si Windows indica «Esta aplicación no se puede ejecutar en tu equipo», el instalador no corresponde a tu procesador o la descarga se interrumpió. Comprueba Configuración → Sistema → Acerca de → Tipo de sistema (x64 o ARM64), vuelve a descargar el instalador para esa arquitectura y ejecútalo.

2. Activa el modo de desarrollador

En el menú de la propia app (barra de menús de macOS; en Windows ☰ en la esquina superior izquierda de la pantalla de inicio de sesión) abre Help → Troubleshooting → Enable Developer Mode. Aparecerá un elemento Developer en el menú.

3. Configura la puerta de enlace de GetVibe API

En el nuevo menú Developer, selecciona Configure Third-Party Inference….
En Connection, cambia el tipo a Gateway.
URL base de Gateway: https://getvibeapi.com; no incluyas /v1, la aplicación añade /v1/messages por sí sola.
Tipo de credencial: clave de API estática; esquema de autenticación: x-api-key.
Clave de API de Gateway: tu clave sk-pv-… de Dashboard → API keys.
En la pestaña Modelos, añade los modelos manualmente antes de probar la conexión: claude-sonnet-5.5, claude-opus-5.5, claude-haiku-5.5. La prueba de conexión no se completa correctamente sin al menos un modelo, y no todas las versiones de la aplicación rellenan la lista desde /v1/models por su cuenta.

4. Reinicia la app por completo

Haz clic en Apply Changes, cierra la app por completo (Quit en el menú, no solo cerrar la ventana) y vuelve a abrirla. En la pantalla de inicio de sesión elige el inicio de terceros que aparece después de guardar la configuración; no inicies sesión en Anthropic. Si la configuración establece deploymentMode: "3p" (Claude Desktop 4.16336.0+), la opción de inicio de sesión de claude.ai está oculta.

5. Comprueba la conexión

Envía cualquier mensaje y abre Panel → Uso: debería aparecer una entrada nueva con el modelo y el gasto. Si no aparece, mira «Problemas frecuentes» abajo: no hace falta terminal para comprobar.

Limitaciones

Cowork en Windows requiere el instalador .msix y la virtualización de hardware habilitada (un requisito de la aplicación).
Anthropic desactiva algunas funciones beta (por ejemplo, la búsqueda de herramientas) para gateways de terceros; es una limitación de la aplicación, no un problema con tu clave.

Problemas comunes

Parámetro	Tipo	Descripción
`App unavailable in region`	screen	Esta es la primera pantalla de inicio de sesión de la app, no nuestra puerta de enlace. El menú Help/☰ está en la app, no en el sitio web. Configura el Gateway; si falta el menú, usa la CLI.
`401`	error	Comprueba la clave y que Auth scheme sea x-api-key, no Bearer.
`404`	error	La dirección del gateway no debe contener /v1: usa la dirección raíz que se muestra arriba.
`Models did not appear / “The connection test needs at least one model”`	config	Añade los ids manualmente en la pestaña Models: claude-sonnet-5.5, claude-opus-5.5, claude-haiku-5.5.
`“Couldn’t load your organization’s model list”, “Gateway /v1/models was unreachable”, “Can’t reach … provider didn’t respond”`	network	The request never reached us — Usage shows no new record. On the same computer open https://getvibeapi.com/v1/models in a browser: it must return a JSON error (the browser sends no key, that is expected). If the page does not open, a VPN, proxy, antivirus or corporate network is cutting the connection. Add the models by hand on the Models tab as well.
`Changes not applied`	config	Cierra por completo la aplicación mediante Quit/Exit y vuelve a abrirla; cerrar la ventana no es suficiente.

← AnteriorClaude Code Siguiente →Cline