Qwen Code

Qwen Code lee sus endpoints desde modelProviders en ~/.qwen/settings.json — una entrada con baseUrl y envKey coloca Claude y GPT en su selector /model.

{
  "modelProviders": {
    "openai": [
      {
        "id": "claude-sonnet-5",
        "name": "Claude Sonnet 5 (Kunavo)",
        "baseUrl": "https://api.kunavo.com/v1",
        "description": "Kunavo, OpenAI-compatible",
        "envKey": "KUNAVO_API_KEY"
      }
    ]
  },
  "env": {
    "KUNAVO_API_KEY": "sk-kn-..."
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "claude-sonnet-5"
  }
}

Paso a paso

1. Cree una clave en /app/keys y cópiela: se muestra una sola vez.
2. Abra ~/.qwen/settings.json (créelo si no existe) e incorpore los cuatro bloques anteriores. La documentación recomienda declarar modelProviders en el archivo de ámbito de usuario «para evitar conflictos de combinación entre la configuración del proyecto y la del usuario».
3. Si puede, guárdela en un lugar más seguro que env. Qwen Code la lee desde process.env[envKey], y la documentación ordena las fuentes de mayor a menor prioridad: una export de shell, luego un archivo .env, y después el bloque env en settings.json, que identifica como almacenamiento en texto sin formato. El bloque env anterior es lo mínimo para que funcione, no el mejor lugar para guardarla.
4. Ejecute qwen. Con security.auth.selectedType establecido en openai y model.name coincidiendo con un id que haya declarado, no se necesita ningún paso interactivo de /auth; la documentación lo dice explícitamente después del ejemplo de un solo archivo.
5. Asígnele una tarea que lea y edite un archivo, no un saludo. Qwen Code es un agente: la llamada a herramientas y la transmisión en flujo son lo que debería probar una primera ejecución, y son precisamente lo primero que fallaría ante un endpoint solo parcialmente compatible.
6. Añada más entradas en modelProviders.openai para cambiar de modelo durante la ejecución con /model. Esos cambios se recargan en caliente en una sesión activa; providerProtocol se lee una sola vez al inicio y requiere reiniciar.

Comprobado con Página de autenticación de Qwen Code, opción 4: clave de API (flexible) 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.

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 Qwen Code.

# 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.

Tres aspectos que la documentación aclara y que suelen suponerse mal

Estos datos provienen de la página de autenticación y de la referencia de proveedores de modelos enlazadas arriba; dar algo por sentado en vez de leerlo cuesta tiempo real de depuración.

1. Una entrada modelProviders tiene prioridad sobre las opciones de la CLI. El orden documentado, de mayor a menor prioridad, es: las anulaciones realizadas mediante /auth en la sesión activa, luego el envKey del proveedor de modelos seleccionado, después argumentos de CLI como --openai-api-key, luego las variables de entorno y, por último, security.auth.apiKey en la configuración. La mayoría espera que prevalezca la opción de línea de comandos. No es así, y por eso --openai-base-url puede parecer que se ignora.
2. security.auth.apiKey y security.auth.baseUrl están obsoletos. La referencia así lo indica y recomienda migrar a modelProviders. Si un tutorial antiguo le indica editar esas dos claves, le está haciendo modificar la ruta que está a punto de desaparecer.
3. wireApi determina el formato de la solicitud, y nada detecta una incompatibilidad. Si se omite, se usa Chat Completions, que es lo que utiliza el bloque anterior. Establecer "wireApi": "responses" requiere un endpoint realmente compatible con Responses, y la documentación afirma claramente que no se detectan endpoints ni se recurre automáticamente a otra opción cuando falla una solicitud. Kunavo responde tanto a /v1/responses como a /v1/chat/completions, pero esta página no ha probado ninguna de las dos combinaciones, así que empiece con la predeterminada.

Si llegó aquí buscando el nivel gratuito

Gran parte de lo que aún se escribe sobre Qwen Code describe un inicio de sesión OAuth de Qwen con una asignación gratuita diaria. Esa opción ya no existe: la documentación registra la interrupción de su nivel gratuito el 15 de abril de 2026 e indica que Qwen OAuth ya no aparece como opción seleccionable en el cuadro de diálogo /auth. Ahora enumera estas tres: Alibaba ModelStudio, con Coding Plan, Token Plan y Standard API Key en su submenú; Third-party Providers; y Custom Provider, descrito como conexión con «un servidor local, un proxy o un proveedor no compatible». Kunavo es la tercera opción. Tenga en cuenta también que las opciones del submenú de ModelStudio no son tres maneras de pagar una misma factura: cada una tiene su propio host y su propia clave, y una clave de Coding Plan no funcionará con un host de Token Plan.