Cherry Studio + JoinGonka Gateway — cliente de IA de escritorio

Instalación. Las compilaciones para todos los sistemas se encuentran en la página de lanzamientos del proyecto: instalador y versión portable para Windows, imagen dmg para macOS, AppImage, deb y rpm para Linux (para x64 y ARM). El historial de diálogos y los ajustes se almacenan localmente en su máquina.

V1 o V2. En agosto de 2026 se lanzó la línea V2 con una nueva estructura de datos y ajustes rediseñados; la última compilación de la línea anterior es la 1.9.13. Ambas tienen un proveedor propio, pero difieren en el formulario de adición y algunas etiquetas; a continuación se marcan dichos lugares. Al pasar de V1, los ajustes de proveedores y modelos se transfieren automáticamente; los datos originales de V1 se conservan, pero los nuevos datos no se sincronizan hacia atrás, y las copias de seguridad de ambas líneas son incompatibles. Antes de actualizar, lea la sección sobre migración en la documentación de Cherry Studio.

Clave JoinGonka. Regístrese en el gateway, abra la sección «API-keys» en su panel y haga clic en «Crear clave». La clave comienza con jg- y solo se muestra una vez; guárdela inmediatamente. Es conveniente crear una clave separada para Cherry Studio: en la sección «Uso», su consumo aparecerá como una línea separada.

1. Haz clic en el icono de engranaje para abrir la configuración. Selecciona la sección Model Provider (en la documentación en inglés aparece como Model Services).
2. Debajo de la lista de proveedores, pulsa Add Provider.
3. En V2, se abrirá el diálogo Add Custom Provider. Escribe el Provider Name, por ejemplo, JoinGonka. En el bloque Endpoint settings, rellena la línea de OpenAI con la dirección https://gate.joingonka.ai/v1: debajo del campo aparecerá la línea Request path con la ruta final, que debe terminar en /v1/chat/completions. En el campo API Key, pega jg-your-key y pulsa Add.
4. En V1, el diálogo es más corto: el nombre del proveedor y el Provider Type, elige OpenAI. La clave y la dirección se introducen ya en la página del proveedor, en los campos API Key y API Host.
5. Comprueba que el proveedor esté activado: el interruptor está en la esquina superior derecha de su página. En V2, los proveedores nuevos se añaden desactivados, y los modelos de un proveedor desactivado no aparecen en las listas de selección.

Cómo construye Cherry Studio la dirección. El campo API Host acepta la dirección base, y la ruta la añade la propia aplicación y muestra el resultado en la línea Preview debajo del campo. Las reglas son las mismas en ambas versiones:

En instrucciones antiguas aparece otra regla: al parecer, una barra al final de la dirección desactiva /v1. Estuvo vigente en versiones tempranas, hasta la línea 1.6 inclusive, y se eliminó en la 1.7: en las versiones actuales, solo # desactiva la autocompletación.

El proveedor está agregado, pero aún no es visible en el chat: solo los modelos que usted agrega explícitamente aparecen en las listas de selección de Cherry Studio. Hay dos formas.

Lista del servidor. En la página del proveedor, haga clic en Sync models (en la V1, Manage, luego Fetch model list). Cherry Studio solicitará GET /v1/models a la pasarela y mostrará la composición activa de la red; añada los modelos necesarios con el botón +. Manualmente. El botón Add Model abre un formulario donde un campo es obligatorio: Model ID: el identificador debe escribirse carácter por carácter.

El precio de los modelos de la red es el mismo, así que agréguelos todos; tendrá que elegir entre ellos según el comportamiento, no por presupuesto:

Tipos de modelo. Cada modelo en la lista tiene un botón de configuración donde se marcan sus capacidades: Vision, Reasoning, Tool y otras. Cherry Studio marca algunas automáticamente, pero para los modelos de la pasarela conviene verificarlas. Vision debe estar desmarcado: los modelos de la red son de texto. Tool es necesario si conecta herramientas MCP; todos los modelos de la tabla soportan la llamada nativa a herramientas. Reasoning es apropiado para GLM-5.3 Flash, ya que es un modelo de razonamiento de la red.

Modelo predeterminado. En la sección de configuración Default Model se definen los modelos para roles de utilidad. Como modelo principal del asistente, configure DeepSeek V4 Flash. Para un modelo rápido que inventa nombres para los diálogos y prepara consultas de búsqueda, la documentación de Cherry Studio sugiere un modelo ligero y rápido, no de razonamiento; de los modelos de la red, MiniMax M2.7 es el que mejor se adapta a este rol, y no configure aquí GLM-5.3 Flash con sus razonamientos obligatorios. Para traducción, cualquiera de los dos primeros servirá.

En la página del proveedor, dentro del bloque de la clave, hay un botón Model Check (en V1, Check junto al campo de la clave). Seleccione un modelo: Cherry Studio enviará una breve consulta de prueba y mostrará el resultado junto con la latencia de respuesta. Si la prueba es exitosa, vaya al chat, seleccione el modelo del gateway en el selector de modelos y haga cualquier pregunta.

Para asegurarse de que las consultas pasan específicamente a través del gateway, abra su panel, sección «Uso»: en el bloque «Por claves», la clave de Cherry Studio mostrará las consultas y la hora de la última solicitud; en el bloque «Por modelos», aparecerá el modelo seleccionado. En la V2 también hay estadísticas propias del cliente, en la sección de configuración Usage: tokens y consultas por proveedores, modelos y claves. El costo que aparece allí es solo informativo: Cherry Studio lo estima según las tarifas públicas de los modelos, no según el precio de la red Gonka, así que para ver las cantidades exactas, consulte el panel del gateway.

Si algo sale mal, el motivo casi siempre se puede deducir de la respuesta:

El cliente en sí se distribuye libremente, solo paga por la inferencia. A través de JoinGonka Gateway, los tokens cuestan $0.0069 por millón en la entrada y $0.021 por millón en la salida; el precio es igual para todos los modelos de la red y se completa en esta página desde una fuente en tiempo real. El chat consume tokens de forma notablemente más moderada que las herramientas de agentes, por lo que el orden de magnitud de los precios a septiembre de 2026 es el siguiente:

Una aclaración importante sobre los diálogos largos: con cada réplica, el cliente envía al modelo toda la historia de nuevo, por lo que la centésima réplica cuesta más que la primera. La solución: un nuevo diálogo para una nueva tarea; en Cherry Studio esto es solo un botón.

Comparación de modelos en un solo diálogo. Cherry Studio permite hacer una misma pregunta a varios modelos a la vez: selecciónelos en el selector de modelos y cada uno responderá con una solicitud independiente. Con un precio único para todos los modelos de la red, esta es la forma más rápida de entender en sus propias tareas dónde es suficiente MiniMax M2.7, dónde se necesita la respuesta larga de DeepSeek V4 Flash y dónde valen la pena los razonamientos de GLM-5.3 Flash; sus configuraciones se analizan en la reseña del modelo.

Segundo protocolo con la misma clave. La puerta de enlace también responde en formato Anthropic. En el diálogo V2 hay una línea Anthropic separada en el bloque Endpoint settings: escriba allí https://gate.joingonka.ai, y en la línea Request path debería quedar la ruta /v1/messages. En V1, el mismo resultado se obtiene con un proveedor independiente con Provider Type Anthropic y la misma dirección. Debajo del botón More options en V2 también hay una línea OpenAI Responses; la puerta de enlace también la atiende, con la misma dirección que la línea principal de OpenAI.

Ejecución de agentes de terminal. En la página Code CLI (en la documentación, Coding Companion), Cherry Studio instala y ejecuta agentes de consola, proporcionándoles el proveedor y el modelo de sus configuraciones; la lista de proveedores se filtra según el protocolo que requiere cada herramienta específica. Por lo tanto, debe completar la dirección Anthropic con antelación si planea ejecutar Claude Code desde aquí. Cómo configurar el mismo agente sin intermediarios se explica en la guía Claude Code + Gonka.

Base de conocimientos. En V2 funciona incluso sin un modelo de embedding, basándose en la búsqueda de texto BM25, y con un modelo de embedding se activa la búsqueda híbrida. Los modelos de la red Gonka son generativos, por lo que para el modo híbrido utilice un modelo de embedding de otro proveedor, por ejemplo, uno local a través de Ollama; el modelo de la puerta de enlace responderá basándose en los fragmentos encontrados.

¿Necesita un chat compartido para el equipo en el navegador? Cherry Studio es un cliente de escritorio personal. Para una interfaz web compartida con cuentas de usuario, consulte Open WebUI: se conecta a la puerta de enlace con la misma dirección y clave.