Configurar Qwen Code: instalación, proveedores, interfaz alemana y API

Qwen Code es el agente de programación de IA de código abierto (Apache-2.0) del equipo Qwen de Alibaba. Su configuración consta de cuatro pasos: instalarlo, iniciar qwen en el proyecto, elegir el proveedor con /auth y plantear una tarea. Importante: la cuota gratuita de Qwen OAuth terminó el 15 de abril de 2026; si sigue una guía antigua, ya no podrá continuar gratis. Esta página sigue el menú actual de /auth, muestra cómo cambiar al alemán, cómo configurar un endpoint propio para Claude o GPT y los comandos más importantes. La versión más reciente es v0.24.7, publicada en npm el 29 de septiembre de 2026; se lanzan versiones al menos semanalmente. Compruebe su versión con qwen --version.

Instalación

Los comandos proceden del README oficial. Con el instalador independiente no necesita proporcionar Node.js; solo npm requiere obligatoriamente Node.js 22 o posterior.

# macOS / Linux (offizieller Standalone-Installer)
curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash

# Windows (PowerShell)
irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex

# npm (benötigt Node.js 22 oder neuer)
npm install -g @qwen-code/qwen-code@latest

# Homebrew (macOS / Linux)
brew install qwen-code

Después, vuelva a abrir el terminal para que se apliquen las variables de entorno. Qwen Code se basó originalmente en Google Gemini CLI v0.8.2, pero se desarrolla de forma independiente desde v0.1 y ya no se sincroniza con el original. La configuración y las cuotas de Gemini CLI no se aplican aquí.

Primer inicio e interfaz en alemán

cd /pfad/zu/ihrem-projekt
qwen

# in der Sitzung:
/language ui de-DE        # Oberfläche auf Deutsch
/language output German   # Antworten des Modells auf Deutsch
/auth                     # Anbieter und API-Key einrichten

Después de /language ui de-DE, Qwen Code muestra sus propias denominaciones alemanas, como „Authentifizierungsmethode auswählen“ o „Werkzeug-Genehmigungsmodus“; esta página utiliza los mismos términos. El idioma de respuesta es independiente y se establece con /language output German.

Además del terminal, hay una aplicación de escritorio, una interfaz web en el navegador (qwen serve --open, experimental), integraciones para VS Code, Zed y JetBrains, y un modo sin interfaz para scripts y CI (qwen -p "..."). Todo se encuentra en el mismo repositorio gratuito; la inferencia se paga por separado.

Elegir el proveedor con /auth

/auth (alias /login) abre „Authentifizierungsmethode auswählen“ con tres opciones de nivel superior. Si todavía quiere elegir Qwen OAuth, verá: „Eingestellt — wechseln Sie zu Coding Plan oder API Key“.

Las tres vías de ModelStudio no son tres métodos de pago de la misma factura: la documentación asigna a cada una su propio endpoint y su propia clave, y el tipo de clave y baseUrl deben coincidir. El 1 de octubre de 2026, el Coding Plan figuraba como „begrenzt verfügbar, wer zuerst kommt, täglich um 0 Uhr (UTC+8) aufgefüllt“; por tanto, es posible que no pueda contratarse un día determinado. Una tarea consume varias llamadas al modelo en el Coding Plan; Alibaba indica normalmente entre 5 y 10 para tareas sencillas, y entre 10 y 30 o más para tareas complejas. La página inglesa Precios de Qwen Code trata la comparación de costes en detalle.

Usar Claude o GPT: proveedor personalizado en settings.json

La documentación de autenticación recomienda para proveedores externos como OpenAI, Anthropic, Google, OpenRouter o un endpoint propio el bloque modelProviders en ~/.qwen/settings.json. Para Kunavo, se ve así:

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

# Den Key nicht in settings.json schreiben, sondern in .qwen/.env oder die Umgebung
echo 'KUNAVO_API_KEY=sk-kn-...' >> ~/.qwen/.env

Cuatro puntos que ahorran tiempo en la resolución de problemas:

• baseUrl termina en /v1. La Referencia de proveedores de modelos indica expresamente que se debe establecer la raíz /v1 de la API, no /v1/chat/completions; el SDK añade la ruta por sí mismo. Con la ruta se produce un 404, no un error de autenticación.
• Dónde se encuentra la clave. Qwen Code la lee de la variable de entorno que indica envKey. Orden de prioridad: export del shell, después un archivo .env (se recomienda .qwen/.env; solo cuenta el primer archivo encontrado) y, por último, env en settings.json; allí la clave aparece en texto plano.
• El archivo prevalece sobre la opción de la CLI. Orden: valores de /auth → entrada de modelProviders seleccionada → argumentos de la CLI → variables de entorno → settings.json. Por eso --openai-base-url a veces parece no tener efecto. security.auth.apiKey y security.auth.baseUrl de las guías antiguas están obsoletos.
• Empiece con Chat Completions. Sin wireApi, se utiliza Chat Completions. Con "responses" no hay detección de endpoints ni fallback automático. Los cambios en modelProviders también se aplican en una sesión activa (/model debe volver a abrirse).

El catálogo de Kunavo no incluye ningún modelo de texto Qwen. Por tanto, no es una vía más barata para usar Qwen, sino una forma de utilizar Claude o GPT en Qwen Code mediante un saldo prepago. Kunavo tampoco ejecutó Qwen Code contra su propio endpoint; al igual que la Página de configuración de Qwen Code en inglés, la configuración procede de la documentación oficial. Mantenga una ruta funcional mientras lo prueba.

Primera tarea y comandos importantes

El README propone como primer encargo, en esencia: „Explica este repositorio y muéstrame por dónde empezar“. Esto comprueba a la vez el acceso a los archivos y las llamadas a herramientas; un simple „Hola“ no detecta problemas de conexión.

Para yolo y los demás modos automáticos, la propia documentación advierte: úselos únicamente en entornos de confianza, aislados o desechables. Qwen Code calcula por sí mismo los costes estimados en /stats model; el importe real figura en el registro de uso de su proveedor.

Límites que debe conocer

• La búsqueda web integrada depende del host. Utiliza la búsqueda del servidor de DashScope: está activada para ModelStudio Standard API Key y Token Plan, así como para entradas en un host de DashScope reconocido; está desactivada para el Coding Plan (no verificado allí) y para proveedores externos y endpoints propios en otros hosts (documentación de web_search). Alternativa: un servidor de búsqueda MCP.
• Kunavo solo ofrece chat. Kunavo no ofrece modelos de embeddings, síntesis de voz ni reconocimiento de voz. Live Voice de Qwen Code requiere de todos modos un endpoint de DashScope y mantiene su propia clave, independientemente de adónde apunte el modelo de chat.

Pagar al probar Kunavo

Kunavo funciona con saldo prepago sin suscripción y cobra por token. La recarga mínima es de $10; en el checkout de Stripe están disponibles las tarjetas (Visa, Mastercard, American Express), Apple Pay, Google Pay y Link, y en Austria también EPS; actualmente no se ofrece el adeudo directo SEPA. Stripe ofrece Pay by Bank únicamente a compradores del Reino Unido, Irlanda y Finlandia; en Alemania, por ahora, solo está disponible como vista previa cerrada (documentación de Stripe, a fecha del 3 de octubre de 2026). Consulta los detalles en Billing; crea la clave con una cuenta. Después de la primera tarea, el registro de uso muestra el importe real.

Preguntas frecuentes

Comprobado el 1 de octubre de 2026: el README de Qwen Code, la documentación sobre autenticación, proveedores de modelos, comandos y web_search (rama main), los textos de la interfaz alemana (packages/cli/src/i18n/locales/de.js), @qwen-code/qwen-code 0.24.7 en npm y las páginas de Alibaba Cloud sobre Coding Plan y Token Plan. Kunavo no ejecutó Qwen Code contra su endpoint.