Conecta Cherry Studio a Claude

Cherry Studio es un cliente de escritorio bien organizado para conversar con muchos modelos y admite directamente el formato nativo de Anthropic. Añadir la pasarela de AI Prime Tech como proveedor de tipo Anthropic te permite tener Claude en la misma ventana que todo lo demás que utilizas, con un único host y una única clave.

Abrir Servicios de modelos

Ve a Configuración y abre Servicios de modelos. Aquí Cherry Studio enumera todos los proveedores con los que puede comunicarse y permite añadir otros nuevos. Pulsa el signo más para añadir un proveedor y se te pedirá que indiques su tipo.

Elegir el tipo es importante porque determina el formato de comunicación. Para Claude en la pasarela, debes elegir el tipo Anthropic, que utiliza la interfaz nativa /v1/messages en lugar de un endpoint de estilo OpenAI.

Como Cherry Studio mantiene los proveedores en una lista, la pasarela aparece junto a los demás servicios que hayas configurado, y puedes cambiar entre ellos en cada conversación. Esto lo convierte en un entorno cómodo para una pasarela multimodelo: una sola entrada de proveedor puede incluir varios modelos de Claude que eliges en el menú según tus necesidades. Tratar la pasarela como una entrada más entre varias es lo que convierte a Cherry Studio en un cómodo centro de control multimodelo. Puedes cambiar de proveedor en cada conversación sin salir de la aplicación.

Elegir el tipo Anthropic

Selecciona Anthropic como tipo de proveedor y actívalo. Cherry Studio mostrará entonces dos campos que determinan toda la configuración: Clave de API y Host de la API. Pega la clave de tu pasarela en el campo de la clave.

Como el tipo es Anthropic nativo, Cherry Studio enviará las solicitudes en el formato Messages que la pasarela ofrece para Claude. Una vez establecido el tipo, no hay ningún selector de protocolo adicional del que preocuparse.

Si tu pasarela también ofrece una interfaz compatible con OpenAI para otros modelos, debes añadirlos como un proveedor independiente de tipo OpenAI en lugar de mezclarlos en este. Dedicar la entrada de tipo Anthropic a Claude mantiene claro el formato de comunicación y evita confusiones entre protocolos. Mantener los protocolos en entradas de proveedor separadas es una pequeña práctica que evita mucha confusión más adelante. Así, cada entrada tiene exactamente un formato de comunicación que debes tener en cuenta.

Configurar correctamente el host de la API

El host de la API es el campo en el que se cometen más errores. Introduce solo la raíz del host, sin /v1 al final, porque Cherry Studio añade por sí mismo la ruta de versión. Si añades /v1 manualmente, la ruta se duplica y la solicitud falla.

Por tanto, el valor es únicamente el host de la pasarela. Si has visto errores 404 o de ruta después de añadir un proveedor, casi siempre se deben a un /v1 añadido por error en el host de la API.

Una barra final en el host provoca el mismo tipo de fallo, así que introduce únicamente el host, sin nada después. Cuando falla una solicitud, el diagnóstico más rápido consiste en revisar el campo Host de la API y eliminar todo lo que haya después del nombre del host antes de buscar en otro sitio. Cuando algo falla, revisar primero este único campo resolverá la mayoría de los problemas de configuración en el momento. El objetivo es introducir el host sin ningún sufijo.

Bloqueo mediante almohadilla final

Cherry Studio admite un truco pequeño pero importante: termina el host de la API con un # y el cliente utilizará esa URL exacta sin añadir nada. Así puedes forzar un endpoint preciso cuando la adición automática interfiere.

Con una pasarela estándar, normalmente dejas solo el host y permites que Cherry Studio añada la ruta. Utiliza # únicamente cuando tu pasarela necesite una ruta exacta que la adición automática alteraría.

Conviene recordar el # precisamente porque no resulta evidente: es la vía de escape para cualquier pasarela cuya ruta no coincida con lo que Cherry Studio presupone por defecto. Si alguna vez descubres que el /v1/messages añadido automáticamente no coincide con lo que espera tu pasarela, el # te permite escribir manualmente la URL completa. Recordar ahora el truco del # te permitirá reconocer la solución al instante si alguna vez una ruta no coincide. Es la única opción de anulación que permite gestionar cualquier ruta de pasarela no estándar.

Elegir un modelo y conversar

Añade los modelos de Claude que quieras al proveedor, utilizando los identificadores que ofrece la pasarela, como claude-sonnet-4-5 para conversaciones cotidianas y claude-opus-4-8 para razonamientos más complejos. Después aparecerán en el menú de modelos de Cherry Studio.

Inicia una conversación, elige un modelo de Claude en el menú y estarás hablando con la pasarela. Como el proveedor utiliza Anthropic nativo, las funciones que dependen del formato Messages se comportan como se espera.

Puedes mantener abiertas varias conversaciones con distintos modelos de Claude a la vez, lo que resulta útil para comparar cómo Sonnet y Opus responden al mismo prompt. Como todos funcionan a través del mismo proveedor de pasarela, cambiar de modelo consiste en elegir una opción del menú, sin reconfigurar nada. Comparar modelos en paralelo es uno de los pequeños placeres de utilizarlo todo a través de un único proveedor. Probar el mismo prompt con Sonnet y Opus solo requiere un cambio en el menú.

# Cherry Studio -> Settings -> Model Services -> + Add
# Provider type: Anthropic   (native /v1/messages)
# API Key:  <your gateway key>
# API Host: https://aiprimetech.io        (root only, NO /v1 -- it auto-appends)
#   end with #  ->  https://aiprimetech.io#   to lock the exact URL
# Model: claude-sonnet-4-5

Preguntas frecuentes

AI Prime Tech es una pasarela de API independiente. No está afiliada a Anthropic, no cuenta con su respaldo ni es un distribuidor de Anthropic. Claude y los nombres de los modelos relacionados son marcas comerciales de sus respectivos propietarios.