Trae + JoinGonka Gateway — modelos de la red Gonka en AI-IDE

Compilación y versión. Trae tiene dos ramas: la internacional (documentación en docs.trae.ai) y la china (docs.trae.cn). La opción Custom Model está en ambas y funciona igual; lo que cambia son los modelos integrados y el conjunto de presets en los ajustes adicionales. La dirección de consulta personalizada para tu propio modelo es compatible desde la versión 3.5.51 del 14 de abril de 2026: si tu compilación es más antigua, actualiza. La compilación internacional no está disponible en todos los países: antes de instalar, consulta la lista de países y regiones compatibles.

Sistema. macOS 12 o superior, Windows 10 u 11 (x64), Linux en paquetes .deb y .rpm. En el primer arranque, Trae te propondrá elegir tema e idioma, importar los ajustes de VS Code o Cursor e iniciar sesión en tu cuenta.

Clave de JoinGonka. Regístrate en el gateway, abre en tu panel la sección «Claves API» y pulsa «Crear clave». La clave empieza por jg- y se muestra una sola vez: guárdala de inmediato. Conviene crear una clave aparte para Trae: en la sección «Uso» su consumo aparecerá en una línea propia.

Plan de Trae. Tu propio modelo hay que seleccionarlo manualmente en la lista de modelos, y en la tabla de planes de Trae el plan gratuito solo contempla el modo Auto en la fila de selección de modelo, y en ese modo no se usan modelos propios. La documentación no dice claramente si esta limitación se aplica a los modelos añadidos con tu propia clave. La regla práctica es sencilla: si en tu plan el Auto Mode se puede desactivar en la lista de modelos, todo listo; si no, hará falta un plan de pago.

1. Abre Settings → Models, el panel de control de modelos.
2. Haz clic en Add Model. En la ventana que aparece, elige la opción Custom Model en lugar de un proveedor de la lista predefinida.
3. Rellena los campos con los valores de la tabla. Hay dos columnas, una por cada formato de API; elige una.
4. Haz clic en Add Model. Trae hará una llamada de prueba a la API y verificará la clave: si tiene éxito, el modelo aparecerá en la lista; si falla, la ventana mostrará un mensaje de error y el log de respuesta del proveedor.

El resto de los campos no dependen del formato:

Qué formato elegir. Empieza con OpenAI Chat Completions: es la vía principal de la pasarela y con ella funcionan la mayoría de las herramientas. Anthropic Messages resulta útil si ya estás acostumbrado a este formato en otras herramientas o quieres comparar el comportamiento del agente en dos protocolos: la clave y el saldo son los mismos.

Cómo funciona Full URL. El interruptor decide quién añade la ruta. Desactivado: tú das la dirección base y Trae añade la ruta según el formato elegido: /chat/completions a la dirección con /v1 para OpenAI y /v1/messages a la raíz para Anthropic. Activado: la dirección se usa tal cual y la ruta debe estar completa en ella. El error más frecuente es mezclar los modos: escribir la ruta completa con el interruptor desactivado o la dirección base con el interruptor activado.

Un registro, un modelo. Repite los pasos para el resto de modelos de la red y así cambiar entre ellos sin volver a los ajustes: deepseek-ai/DeepSeek-V4-Flash-0731, MiniMaxAI/MiniMax-M2.7 y zai-org/GLM-5.3-Flash. La lista actualizada la devuelve GET https://gate.joingonka.ai/v1/models. El modelo añadido se puede editar después, desactivar (seguirá en el panel, pero desaparecerá de la lista del chat) o eliminar.

Debajo de los campos principales hay una lista desplegable llamada Advanced Settings. Puede dejarla tal cual, Trae utilizará los valores predeterminados, pero vale la pena configurar conscientemente dos ajustes: la serie del modelo y la ventana de contexto.

El precio de los modelos de la red es el mismo, por lo que la elección depende del comportamiento. Todos los modelos de la tabla admiten tool calling nativo, que es la base del funcionamiento de los agentes de Trae.

El funcionamiento del presupuesto de razonamiento y por qué no se debe reducir el límite de salida en los modelos de razonamiento se detalla en el análisis de GLM-5.3 Flash; la comparación de modelos para tareas de programación, en el artículo sobre las mejores modelos para código.

Tus modelos residen en una lista general: haz clic en el nombre del modelo actual en la esquina inferior derecha del campo de entrada del chat y selecciona el que has añadido. Allí también encontrarás el interruptor Auto Mode; debe estar desactivado: en modo Auto, Trae elige por sí mismo un modelo de los integrados y no utiliza los que tú has añadido.

Dale al agente una tarea que requiera una herramienta, por ejemplo: «Lee package.json y enumera los scripts de compilación». El agente debe abrir el archivo y responder correctamente; eso significa que el ciclo «solicitud - llamada a la herramienta - respuesta» a través de la pasarela se está completando. Luego, abre el panel de la pasarela, sección «Uso»: en el bloque «Por claves», la clave Trae mostrará las solicitudes y la hora del último acceso, y en el bloque «Por modelos», aparecerá el modelo seleccionado.

Si algo salió mal, observa el texto del error. Trae no oculta la respuesta de tu modelo: muestra el error del proveedor tal cual, con su propio código 4028.

Un agente en la IDE consume tokens más rápido que un chat: cada solicitud incluye instrucciones del sistema, descripciones de herramientas, archivos abiertos e historial de pasos. Por lo tanto, el precio por token determina si puedes ejecutar al agente para cada pequeño detalle o si debes ahorrar.

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 el mismo para todos los modelos de la red y se completa en esta página desde una fuente en tiempo real. El orden de magnitud de los precios a septiembre de 2026 es:

La comparación con Trae es ilustrativa, porque existen modelos abiertos entre los integrados y Trae publica su lista de precios por millón de tokens. DeepSeek-V4-Flash y MiniMax-M2.7 cuestan allí $0.30 en la entrada y $1.20 en la salida, mientras que el GLM-5.3 Flash no está en la lista integrada de la versión internacional. A través de la pasarela, la diferencia en los mismos modelos es aproximadamente ×43 en la entrada y ×58 en la salida.

Su propio modelo funciona donde hay una lista de modelos. Se trata de chats y agentes, tanto en modo IDE como en SOLO (los modelos propios son compatibles desde la versión 3.3.0). El autocompletado y la predicción de ediciones son un mecanismo independiente, CUE, con su propio panel de ajustes: no existe la opción de seleccionar un modelo en él, y sus límites los establece la tarifa de Trae.

Herramientas y MCP. Los agentes de Trae actúan como clientes MCP, y los servidores que conecte permanecen disponibles para el agente en su propio modelo: todos los modelos de la red admiten la invocación nativa de herramientas. Si Trae informa que el esquema de argumentos de la herramienta es incompatible con el modelo (código 4027), intente con un modelo de red adyacente o con otro servidor MCP.

TraeWork. En la aplicación independiente TraeWork, el formulario para añadir su propio modelo es el mismo, pero, según la documentación, solo funciona en TraeWork Desktop y solo para tareas en un entorno local.

Plugin para otros editores. En la documentación del plugin TraeCode para VS Code y JetBrains no hay una sección sobre modelos propios: esta guía se refiere al IDE de escritorio. Si usted permanece en VS Code, el mismo gateway se conecta a través de extensiones de agente, como Cline.

Privacidad. El ajuste Privacy Mode (Settings → Account) controla lo que Trae hace con sus diálogos y fragmentos de código: con este ajuste, no se envían a analítica ni a entrenamiento. Por parte del gateway, los diálogos no se almacenan: las peticiones (prompts) y respuestas no permanecen en él después de la respuesta; en el panel solo se ven los contadores de solicitudes y tokens.

Si necesita trabajar con imágenes (maquetas, capturas de pantalla de errores), asigne esa tarea a un modelo integrado con visión, y deje el código, comandos y archivos para el modelo de red: el cambio toma un solo clic en la lista de modelos.