Documentación

Documentación

Qoder

La aplicación de escritorio independiente de Qoder acepta cualquier URL base en Provider → Custom. Completa tres campos y escribe manualmente un identificador de modelo, y Qoder se conecta a Claude y GPT con una sola clave, aunque ninguno aparece en su propio catálogo.

Qoder Settings → Models → + Add → Provider → Custom acepta una Base URL compatible con OpenAI, una API Key e IDs de modelo introducidos manualmente — así, la aplicación de escritorio independiente Qoder llega a Claude y GPT, ninguno de los cuales está en su propio catálogo.

Configuración de Qoder → Modelos → + Añadir → Proveedor → Personalizado
Qoder Settings -> Models -> + Add -> Provider -> Custom

Provider              OpenAI Compatible     <- under "Custom", not a preset
API type              Chat Completions API  <- asked only for OpenAI Compatible
Base URL              https://api.kunavo.com/v1
API Key               sk-kn-...
Model ID              claude-sonnet-5       <- typed by hand
  Add Model ID        claude-opus-5
  Add Model ID        claude-haiku-4-5

Next ->
Display name              Kunavo · Sonnet 5
Supported Context Windows pick from what the model supports
Default Context Window    one of the values picked above
Vision                    on for models that take image input
Thinking Mode             on for reasoning models, then pick effort levels

Validate and Add Model
Esta es la aplicación independiente de Qoder, no Qoder IDE. «Qoder» es una familia de productos con documentación independiente, y solo la aplicación de escritorio independiente documenta el uso de un endpoint arbitrario: su página de modelos personalizados ofrece OpenAI Compatible y Anthropic Compatible en Custom, y la nota de la versión 0.1.8 del 5 de septiembre de 2026 lo presentó así: «BYOK ahora admite URL base personalizadas para cualquier servicio de modelos compatible con OpenAI o Anthropic en el plan Personal». La página de modelos personalizados de Qoder IDE solo enumera proveedores específicos y no contiene la cadena Base URL. Si no ves el campo, probablemente estás usando otro producto Qoder.
La URL base debe conservar el sufijo /v1. La página de Qoder indica que se debe «introducir la URL base exacta proporcionada por el servicio de modelos» y muestra https://api.example.com/v1 como formato de ejemplo; por tanto, el campo espera la raíz /v1, no el origen sin más, para un endpoint compatible con OpenAI. Es lo contrario de lo que ocurre con los clientes de estilo Anthropic, que esperan https://api.kunavo.com y añaden la ruta por su cuenta.
Qoder también ofrece el proveedor personalizado Anthropic Compatible, y Kunavo responde también a /v1/messages. Su documentación publica una sola URL base de ejemplo y no especifica qué ruta añade cada protocolo, así que no aclara si ese tipo requiere https://api.kunavo.com o https://api.kunavo.com/v1. La ruta compatible con OpenAI de arriba es la que corresponde al ejemplo de la propia documentación; si eliges el tipo Anthropic, tendrás que probar ambas formas. La lista de solución de problemas de Qoder empieza precisamente por esto: «Si la URL base está completa y el protocolo compatible y el tipo de API seleccionados coinciden con el endpoint».
Kunavo no ha ejecutado ninguna sesión dentro de Qoder. Nada de lo que aparece aquí constituye una prueba del cliente en tiempo de ejecución: los campos se transcribieron de la propia página de Qoder en la fecha indicada abajo, y la información sobre el endpoint procede de la interfaz publicada de Kunavo. El botón Validate and Add Model de Qoder es el paso que realmente comprueba ambos, y la comprobación se ejecuta en tu equipo, no en el nuestro.
¿Aún no tienes una clave? Crea una cuenta de Kunavo, genera una clave (empieza por sk-kn-) y añade crédito desde $10; las llamadas se pagan con ese saldo y las llamadas fallidas no se facturan. El panel se abre entonces en la configuración de Qoder.

Paso a paso

  1. Cree una clave en /app/keys y cópiela: se muestra una sola vez.
  2. Abre Qoder Settings, selecciona Models en el menú de navegación de la izquierda y haz clic en + Add.
  3. Abre Provider y selecciona OpenAI Compatible en Custom; no elijas uno de los proveedores preconfigurados que aparecen arriba. Luego selecciona Chat Completions API como tipo de API.
  4. Introduce la Base URL, la API Key y al menos un Model ID. Qoder no documenta la detección automática de modelos para este campo, así que escribe los identificadores manualmente. Haz clic en Add Model ID por cada modelo adicional del mismo endpoint.
  5. Haz clic en Next y configura las capacidades que Qoder no puede inferir: Display name, Supported Context Windows y un Default Context Window entre esos valores, además de las opciones Vision y Thinking Mode cuando el modelo las admita.
  6. Haz clic en Validate and Add Model. La página del selector de modelos de Qoder indica que, una vez añadido, «el modelo estará disponible en los selectores de modelos de tareas, Agent y automatización».

Comprobado con la página de modelos personalizados de la aplicación independiente de Qoder el 21 de septiembre de 2026. La configuración de terceros puede cambiar; si el nombre de un campo ya no coincide con lo que ves, esa página es la autoridad, no esta.

Esta es la versión breve. El tutorial completo —elección del modelo, coste de una sesión real y modos de fallo— está en Qoder frente a Claude Code: qué Qoder, qué endpoint y qué factura.

Verifica antes de depurar el cliente

Una solicitud determina si el fallo está en el endpoint, la clave o el archivo de configuración. Si devuelve JSON, la misma URL base y la misma clave funcionan en Qoder.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Qué ID de modelo introducir en el campo

Todos los modelos de texto están disponibles mediante un ID de modelo; la lista activa está en GET /v1/models, y el catálogo con precios está en la página de modelos. Las tarifas son USD por 1M de tokens, entrada / salida.

ID de modeloEntrada / salida de KunavoDónde encaja en Qoder
claude-sonnet-5$1.40 / $7.00el modelo de trabajo predeterminado para los selectores de tareas y Agent
claude-opus-5$3.50 / $17.50refactorizaciones grandes, donde un plan equivocado cuesta más que los tokens
claude-haiku-4-5$0.70 / $3.50ejecuciones de automatización de gran volumen, donde el recuento lo determina todo
gpt-5-6-sol$2.00 / $12.00una segunda opinión de otra familia, con la misma clave y el mismo endpoint
La facturación es por token desde un saldo prepago, sin cuota mensual; consulta facturación. Con contexto repetido —que constituye la mayor parte de lo que envía un editor o cliente de chat—, la caché de indicaciones cambia más la factura que la elección del modelo.

Por qué tu versión de Qoder podría no tener un campo para la URL base

Tres interfaces de Qoder documentan el uso de una clave propia, pero solo una documenta un endpoint que puedes elegir. Esto es lo único que determina si puedes realizar la configuración anterior desde la interfaz que estás usando, así que conviene comprobarlo antes de tocar un archivo de configuración; además, la página de CLI indica explícitamente que no debes tocar ninguno.

Superficie¿Se documenta una URL base personalizada?Lo que indica la propia página
Qoder (aplicación independiente)SíOpenAI Compatible y Anthropic Compatible aparecen en Custom, dentro de la lista Provider, junto con los campos Base URL, API Key y Model ID, cuyos valores se introducen manualmente. Esta página.
Qoder IDENoLa página de modelos personalizados indica «Aplicable a: usuarios con planes Individuals» y menciona proveedores: Alibaba Cloud Model Studio, DeepSeek, Z.ai, Kimi, MiniMax y Xiaomi MIMO. La cadena Base URL no aparece.
Qoder CLINo aparece en la página de documentaciónHay una pestaña Custom en /model con Add custom model..., pero la página no documenta una URL base y advierte: «No configures BYOK manualmente en settings.json».

Qoder CLI es lo que más confunde, porque sus propias notas de versión y su documentación se contradicen. La nota de la versión 1.1.50 del 11 de septiembre de 2026 indica: «Los usuarios de la edición Personal ahora pueden configurar y gestionar de forma centralizada modelos BYOK con endpoints de URL personalizada desde la página Custom». En cambio, la página de modelos personalizados que sigue disponible describe un catálogo: «los proveedores, modelos y campos de credenciales disponibles dependen del catálogo BYOK disponible para la cuenta actual». Tanto esas páginas como la de IDE limitan la función a un plan Individual. Por tanto, si no aparece la pestaña Custom o no tiene un campo para el endpoint, comprueba el plan de la cuenta y lo que ofrece su catálogo; no edites un archivo de configuración, ya que la página de CLI indica que no lo hagas manualmente y, de todos modos, el catálogo lo vuelve a generar.

Preguntas frecuentes

¿Cómo añado un proveedor personalizado a Qoder?

En la aplicación de escritorio independiente de Qoder, abre Qoder Settings, selecciona Models en el menú de navegación de la izquierda y haz clic en + Add. Luego abre Provider y elige «OpenAI Compatible» o «Anthropic Compatible» en Custom. Para el tipo OpenAI, también puedes elegir Chat Completions API o Responses API. Introduce la Base URL, la API Key y al menos un Model ID; usa Add Model ID para añadir otros modelos del mismo endpoint. Haz clic en Next para configurar Display name, Supported Context Windows, Default Context Window, Vision y Thinking Mode; por último, haz clic en Validate and Add Model. Qoder valida la conexión antes de guardar.

¿La URL base de Qoder debe terminar en /v1?

Para un endpoint compatible con OpenAI, sí. La página de modelos personalizados de Qoder indica que se introduzca la URL base exacta proporcionada por el servicio de modelos y muestra https://api.example.com/v1 como formato de ejemplo. Por tanto, el campo requiere la raíz /v1, no solo el origen: para Kunavo, https://api.kunavo.com/v1. Para el tipo Anthropic Compatible, la página no incluye otro ejemplo ni especifica qué ruta añade; su documentación no aclara ese caso. Prueba primero la raíz /v1 y, si falla la validación, el origen sin la ruta.

¿Por qué mi Qoder no tiene una pestaña Custom ni un campo para la URL base?

Porque las tres interfaces de Qoder tienen reglas distintas para BYOK. Solo la aplicación de escritorio independiente de Qoder documenta una URL base arbitraria. La página de modelos personalizados de Qoder IDE enumera proveedores específicos y nunca menciona la URL base. La página de Qoder CLI indica que los proveedores, modelos y campos de credenciales disponibles dependen del catálogo BYOK de la cuenta actual. Además, las páginas de IDE y CLI limitan la función a un plan Individual. Si no aparece el campo, comprueba qué producto de Qoder tienes abierto y qué permiten el plan y el catálogo de la cuenta. La página de CLI advierte específicamente que no se debe configurar BYOK manualmente en settings.json.

¿Puede Qoder usar modelos Claude sin una cuenta de Anthropic?

Sí, mediante un proveedor personalizado; el catálogo integrado de Qoder es un tema aparte. La página del selector de modelos enumera modelos de Qwen, DeepSeek, GLM, Kimi y MiniMax, pero no menciona ningún modelo de Claude, GPT o Gemini, así que la opción documentada para usar uno es traer tu propia clave. «OpenAI Compatible» es una opción de protocolo de comunicación, no de proveedor: el Model ID que escribas se resuelve en la URL base que configuraste, por lo que un identificador de Claude funciona siempre que el endpoint lo ofrezca. Las credenciales que necesitas son las de ese endpoint, no las de Anthropic.

¿Un modelo personalizado en Qoder consume Qoder Credits?

La página de modelos personalizados de Qoder indica que las tarifas de los modelos personalizados se cobran directamente a la cuenta de API de tu proveedor y no consumen Qoder Credits. También señala que Repo Wiki es una excepción: utiliza un modelo fijo, se factura por separado y muestra un aviso cuando genera contenido. Por parte de Kunavo, ese costo se calcula por token y se descuenta de un saldo prepago; no hay cuota mensual. Ten en cuenta también que la opción Edit de Qoder para un modelo personalizado guardado solo actualiza la clave de API. Para cambiar la URL base, debes eliminar la entrada y añadirla de nuevo.

¿Kunavo ha probado esta configuración dentro de Qoder?

No. Kunavo no ha ejecutado ninguna sesión en ninguna interfaz de Qoder, y esta página no es un informe de compatibilidad en tiempo de ejecución: los nombres y el orden de los campos se transcribieron de la propia página de modelos personalizados de Qoder en la fecha indicada, y la información sobre el endpoint procede de la API publicada de Kunavo. La comprobación pertinente se ejecuta en tu equipo: el botón Validate and Add Model de Qoder prueba juntos la URL base, la clave y el Model ID antes de guardarlos. Una solicitud curl sencilla a la misma URL base con la misma clave permite determinar si el problema está en el endpoint o en el cliente.