> ## Documentation Index
> Fetch the complete documentation index at: https://evolink.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Integración de Claude Desktop

> Conecta Claude Desktop con EvoLink.AI

## Resumen

<img src="https://mintcdn.com/muyutechnology/0Hyr7GcmyR64C_At/images/integration-guide/claude-desktop-overview.png?fit=max&auto=format&n=0Hyr7GcmyR64C_At&q=85&s=0b5b1ccfcee67ceae546cd4054afd004" alt="Claude Desktop" width="2382" height="1586" data-path="images/integration-guide/claude-desktop-overview.png" />

Claude Desktop es la aplicación oficial de Anthropic para usar Claude en local.

Esta guía explica cómo conectar Claude Desktop con **EvoLink API** y usar EvoLink para acceder a modelos compatibles con la Anthropic Messages API.

**Esta guía incluye:**

* Instalar Claude Desktop
* Activar el modo desarrollador
* Configurar la conexión con EvoLink
* Reiniciar y seleccionar un modelo

## Requisitos previos

Antes de empezar, prepara tu EvoLink API Key.

### Obtener una EvoLink API Key

* Inicia sesión en la [Consola de EvoLink](https://evolink.ai/dashboard)
* Busca API Keys en la consola, haz clic en **Create New Key** y copia la clave generada
* Las API Keys suelen empezar por `sk-`; guárdalas en un lugar seguro

## Paso 1: Descargar Claude Desktop

Visita la [página de descarga de Claude Desktop](https://claude.com/download) e instala la versión correspondiente a tu sistema operativo.

<Note>
  **Consejo:** Si todavía no tienes Claude Desktop instalado, completa la instalación antes de continuar.
</Note>

<Frame>
  <img src="https://mintcdn.com/muyutechnology/0Hyr7GcmyR64C_At/images/integration-guide/claude-desktop-download-page.png?fit=max&auto=format&n=0Hyr7GcmyR64C_At&q=85&s=4fb80c3046fd68f5df3408815d111dca" alt="Página de descarga de Claude Desktop" width="4118" height="2188" data-path="images/integration-guide/claude-desktop-download-page.png" />
</Frame>

### Después de la instalación

Después de instalarlo, confirma que Claude Desktop se inicia con normalidad.

## Paso 2: Activar el modo desarrollador

<Tabs>
  <Tab title="macOS">
    Tras abrir Claude Desktop, haz clic en **Help → Troubleshooting** y activa el modo desarrollador en el cuadro de diálogo.

    Cuando esté activado, aparecerá la opción **Developer** para configurar la inferencia de terceros.

    <Note>
      **Nota:** Si no ves la opción Developer, confirma que tu versión de Claude Desktop admite el modo desarrollador y la configuración de inferencia de terceros.
    </Note>

    <Frame>
      <img src="https://mintcdn.com/muyutechnology/0Hyr7GcmyR64C_At/images/integration-guide/claude-desktop-help-menu.png?fit=max&auto=format&n=0Hyr7GcmyR64C_At&q=85&s=dfc9f20aae993d1b3d25fdf2eae212dd" alt="Menú Help de Claude Desktop con Troubleshooting" width="1912" height="928" data-path="images/integration-guide/claude-desktop-help-menu.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/muyutechnology/0Hyr7GcmyR64C_At/images/integration-guide/claude-desktop-developer-menu.png?fit=max&auto=format&n=0Hyr7GcmyR64C_At&q=85&s=5001a483c077264fd4deeea6c36aa293" alt="Menú Developer de Claude Desktop" width="1188" height="812" data-path="images/integration-guide/claude-desktop-developer-menu.png" />
    </Frame>
  </Tab>

  <Tab title="Windows">
    Antes de usar el modo Gateway / Cowork, activa la característica de plataforma de máquina virtual de Windows:

    1. Pulsa `Win + R`
    2. Escribe `optionalfeatures` y pulsa `Enter`
    3. En **Windows Features**, marca **Virtual Machine Platform**
    4. Haz clic en **OK**
    5. Reinicia el equipo si Windows te lo pide

    <Frame>
      <img src="https://mintcdn.com/muyutechnology/lVQENoE4lWLkT7sb/images/integration-guide/windows-run-optionalfeatures-en.png?fit=max&auto=format&n=lVQENoE4lWLkT7sb&q=85&s=f84e0afd143886773ca61125c157c3e3" alt="Windows Run optionalfeatures" width="568" height="334" data-path="images/integration-guide/windows-run-optionalfeatures-en.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/muyutechnology/lVQENoE4lWLkT7sb/images/integration-guide/windows-features-virtual-machine-platform-en.png?fit=max&auto=format&n=lVQENoE4lWLkT7sb&q=85&s=59ef055e4cc91217eba1be0bdb820d0c" alt="Windows Features Virtual Machine Platform" width="692" height="612" data-path="images/integration-guide/windows-features-virtual-machine-platform-en.png" />
    </Frame>

    Después, abre Claude Desktop, haz clic en **Help → Troubleshooting** y activa el modo desarrollador en el cuadro de diálogo.

    Cuando esté activado, aparecerá la opción **Developer** para configurar la inferencia de terceros.

    <Note>
      **Nota:** Si no ves la opción Developer, confirma que tu versión de Claude Desktop admite el modo desarrollador y la configuración de inferencia de terceros.
    </Note>

    <Frame>
      <img src="https://mintcdn.com/muyutechnology/lVQENoE4lWLkT7sb/images/integration-guide/claude-desktop-windows-enable-developer-mode.png?fit=max&auto=format&n=lVQENoE4lWLkT7sb&q=85&s=6f2de48dfc8f1f77bc7c81ce8931cbb2" alt="Activar Developer Mode en Claude Desktop para Windows" width="1513" height="905" data-path="images/integration-guide/claude-desktop-windows-enable-developer-mode.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/muyutechnology/lVQENoE4lWLkT7sb/images/integration-guide/claude-desktop-windows-configure-third-party-inference.png?fit=max&auto=format&n=lVQENoE4lWLkT7sb&q=85&s=5a80699e3978a79ea6e92eda23a4a35f" alt="Menú Developer de Claude Desktop para Windows" width="1799" height="901" data-path="images/integration-guide/claude-desktop-windows-configure-third-party-inference.png" />
    </Frame>
  </Tab>
</Tabs>

## Paso 3: Abrir la configuración de inferencia de terceros

En el menú Developer, abre el panel de inferencia de terceros y rellénalo como se indica a continuación:

| Campo               | Descripción                                                                                                                                                                                            |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Gateway base URL    | Dirección del gateway de EvoLink, valor recomendado: `https://direct.evolink.ai`                                                                                                                       |
| Gateway API key     | Introduce directamente tu EvoLink API Key, sin el prefijo `Bearer`                                                                                                                                     |
| Gateway auth scheme | `bearer`                                                                                                                                                                                               |
| Model list          | Recomendado. Añade solo IDs de modelos de texto/chat compatibles con la Anthropic Messages API. También puedes ir directamente a la tabla de [modelos compatibles](#supported-claude-models) más abajo |

<Note>
  **Nota:** Si los nombres de los campos son ligeramente distintos en tu versión de Claude Desktop, usa las etiquetas reales de la interfaz, pero conserva el mismo significado.
</Note>

<Frame>
  <img src="https://mintcdn.com/muyutechnology/0Hyr7GcmyR64C_At/images/integration-guide/claude-desktop-third-party-inference.png?fit=max&auto=format&n=0Hyr7GcmyR64C_At&q=85&s=fd9e8fcaaa514b926d340353b673341c" alt="Panel de inferencia de terceros de Claude Desktop" width="1824" height="2190" data-path="images/integration-guide/claude-desktop-third-party-inference.png" />
</Frame>

## Paso 4: Guardar y reiniciar

Después de guardar la configuración, cierra Claude Desktop por completo y vuelve a abrirlo.

<Frame>
  <img src="https://mintcdn.com/muyutechnology/0Hyr7GcmyR64C_At/images/integration-guide/claude-desktop-relaunch-dialog.png?fit=max&auto=format&n=0Hyr7GcmyR64C_At&q=85&s=0914bfb563206dfe93ba0f1ffc53c8cd" alt="Diálogo de reinicio de Claude Desktop" width="1980" height="1680" data-path="images/integration-guide/claude-desktop-relaunch-dialog.png" />
</Frame>

Después de reiniciarlo, Claude Desktop debería usar la nueva configuración de inferencia de terceros.

**Resultado esperado:** Al abrirlo, deberías ver la lista de modelos disponibles y las solicitudes deberían pasar por EvoLink.

## Paso 5: Elegir un modelo

Después de reiniciar, revisa el selector de modelos para confirmar que los modelos disponibles aparecen correctamente.

## Cómo funciona

Claude Desktop se comunica con EvoLink mediante un gateway compatible con Anthropic:

1. Claude Desktop envía las solicitudes a la dirección del gateway que configuraste.
2. EvoLink recibe la solicitud y la reenvía al servicio de modelo correspondiente.
3. Cuando llega la respuesta, Claude Desktop sigue mostrando la conversación en local.

No hace falta instalar ningún proxy local adicional.

## Modelos compatibles

<a id="supported-claude-models" />

Si quieres limitar los modelos visibles en `Model list`, puedes usar los siguientes IDs de modelo.

| ID de modelo                 |
| ---------------------------- |
| `claude-haiku-4-5-20251001`  |
| `claude-sonnet-4-5-20250929` |
| `claude-opus-4-5-20251101`   |
| `claude-sonnet-4-6`          |
| `claude-sonnet-5`            |
| `claude-opus-4-6`            |
| `claude-fable-5`             |
| `claude-opus-4-8`            |
| `claude-opus-4-7`            |
| `deepseek-v4-flash`          |
| `deepseek-v4-pro`            |

## Preguntas frecuentes

### No aparece el menú Developer

Confirma que el modo desarrollador esté activado y que Claude Desktop se haya reiniciado por completo.

### No puedo conectarme después de configurarlo

Revisa lo siguiente:

* Que la base URL sea correcta
* Que la API Key sea válida
* Que el esquema de autenticación sea `bearer`
* Que Claude Desktop se haya cerrado y abierto de nuevo por completo

### No veo ningún modelo

Confirma que tu cuenta y tu red funcionan correctamente y revisa si la configuración de inferencia de terceros se guardó bien.

### ¿Tengo que rellenar `Model list`?

Sí, es recomendable. Añade solo IDs de modelos de texto/chat compatibles con la Anthropic Messages API.

### ¿Qué debo poner si quiero especificar modelos manualmente?

Usa los IDs de modelo de la tabla "Modelos compatibles" anterior y escríbelos en el formato que Claude Desktop espera.
