Cómo usar Qwen Code: instalación, elección de cuenta y modelo, configuración de la API

Qwen Code es un agente de programación de IA de código abierto (Apache-2.0) publicado por el equipo Qwen de Alibaba. Su uso consta de cuatro pasos: «instalar → ejecutar qwen en el proyecto → configurar el destino con /auth → solicitar una tarea». Sin embargo, el nivel gratuito de Qwen OAuth terminó el 15 de abril de 2026, así que iniciar sesión siguiendo las instrucciones anteriores ya no permite usarlo gratis. Y un punto importante para los usuarios de coreano: Qwen Code no tiene interfaz en coreano. Esta página explica en orden cómo empezar según el menú /auth actual, configurar respuestas en coreano, usar Claude y GPT con una configuración personalizada y emplear los comandos más frecuentes. La versión más reciente es v0.24.7, publicada en npm el 29 de septiembre de 2026, y como se publican versiones al menos semanalmente, comprueba la versión instalada con qwen --version.

Instalación

Son los comandos del README oficial. Con el script de instalación independiente no necesitas preparar Node.js manualmente; solo necesitas Node.js 22 o posterior al instalar con npm.

# macOS / Linux (공식 단독 설치 스크립트)
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 (Node.js 22 이상 필요)
npm install -g @qwen-code/qwen-code@latest

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

Vuelve a abrir el terminal después de la instalación para que se apliquen las variables de entorno. Qwen Code se basó originalmente en Google Gemini CLI v0.8.2, pero desde v0.1 se desarrolla de forma independiente sin sincronizarse con el original. La configuración o la cuota gratuita de Gemini CLI no se aplican automáticamente.

Primera ejecución y respuestas en coreano

cd /path/to/your-project
qwen

# 세션 안에서:
/language output Korean   # 모델 답변을 한국어로 (UI는 한국어 미지원)
/auth                     # 공급자와 API 키 설정

Los idiomas de interfaz integrados son únicamente chino simplificado, inglés, ruso, alemán, japonés, portugués brasileño, francés y catalán, y tampoco hay coreano en los archivos de traducción de interfaz del repositorio (comprobado el 1 de octubre de 2026). Por eso los menús aparecen en inglés y esta página cita literalmente los textos ingleses visibles en pantalla. El idioma de las respuestas del modelo es independiente de la interfaz, así que puedes fijarlo en coreano con /language output Korean.

Además del terminal, hay una aplicación de escritorio, una interfaz web que se abre en el navegador (qwen serve --open, función experimental), integración con VS Code, Zed y JetBrains, y ejecución sin interfaz para scripts y CI (qwen -p "..."). Todo está incluido en el mismo repositorio gratuito, pero los costes de inferencia se cobran aparte.

Elegir el destino de conexión con /auth

Al abrir /auth(alias /login), aparece la pantalla «Select authentication method:» y hay tres opciones principales de nivel superior. Si intentas elegir Qwen OAuth, aparece el aviso «Discontinued — switch to Coding Plan or API Key».

Las tres opciones de ModelStudio no son tres métodos que compartan la misma factura. La documentación establece un endpoint y una clave distintos para cada una, y no funcionarán si el tipo de clave y baseUrl no coinciden. A 1 de octubre de 2026, Coding Plan aparece como «cantidad limitada, por orden de llegada; reposición diaria a las 0:00 (UTC+8)», por lo que puede que no puedas registrarte dependiendo del día. En Coding Plan, una tarea se calcula como varias llamadas al modelo; Alibaba explica que lo habitual son 5–10 llamadas para una tarea sencilla y 10–30 o más para una compleja. La comparación de precios se trata con más detalle en la página en inglés Qwen Code pricing.

Usar Claude o GPT: Custom Provider en settings.json

La documentación de autenticación de Qwen Code recomienda ~/.qwen/settings.json modelProviders para conexiones de terceros como OpenAI, Anthropic, Google, OpenRouter y endpoints propios. Para Kunavo, es lo siguiente.

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

# 키는 settings.json에 직접 쓰지 말고 .qwen/.env 나 환경 변수로
echo 'KUNAVO_API_KEY=sk-kn-...' >> ~/.qwen/.env

Cuatro puntos que ahorran tiempo de depuración:

• baseUrl solo llega hasta /v1. La documentación de referencia del proveedor del modelo especifica que debes indicar la raíz /v1 de la API, «no la ruta completa de /v1/chat/completions, porque el SDK añade la ruta de solicitud». Si incluyes la ruta completa, obtendrás un 404, no un error de autenticación.
• Dónde colocar la clave. Qwen Code lee la clave de la variable de entorno cuyo nombre escribas en envKey. El orden de prioridad es el shell export, el archivo .env (.qwen/.env recomendado; solo se usa el primer archivo encontrado), settings.json y env; la última opción guarda la clave en texto plano, por lo que no se recomienda.
• El archivo de configuración prevalece sobre las opciones de la CLI. El orden de decisión es valor introducido en /auth → elemento seleccionado de modelProviders → argumentos de la CLI → variables de entorno → settings.json. Esa es la razón por la que --openai-base-url parece ignorarse. security.auth.apiKey y security.auth.baseUrl de las explicaciones antiguas están previstas para quedar obsoletas.
• Empieza con Chat Completions. Si omites wireApi, se usa el formato Chat Completions. Si cambias a "responses", no habrá detección automática del endpoint ni cambio automático en caso de fallo. Los cambios en modelProviders se reflejan inmediatamente incluso en las sesiones en ejecución (se hacen visibles al volver a abrir /model).

El catálogo de Kunavo no contiene modelos de texto Qwen. No se trata de una forma barata de usar Qwen, sino de usar Claude y GPT dentro de Qwen Code con un único saldo prepagado. Además, Kunavo no ha verificado ejecutando Qwen Code realmente contra su propio endpoint. La configuración se redactó consultando la documentación oficial, igual que en la página en inglés Qwen Code settings. Prueba manteniendo disponible la ruta que utilizas actualmente.

Primera tarea y comandos frecuentes

La primera solicitud que pone como ejemplo el README es algo como «explica este repositorio y dime por dónde empezar». Así puedes comprobar de una vez la lectura de archivos y las llamadas a herramientas. Un simple saludo no permite detectar problemas de conexión.

Los modos de aprobación automática como yolo advierten explícitamente que solo deben usarse «en entornos de confianza, aislados o desechables». El coste estimado de /stats model es un cálculo de Qwen Code, no un importe facturado. Consulta el historial de uso del proveedor conectado para conocer el importe real.

Limitaciones que conviene conocer

• web_search integrado se activa o desactiva según el destino de conexión. Usa la búsqueda del lado del servidor de DashScope, por lo que se activa con ModelStudio Standard API Key, Token Plan y un elemento que apunte a un host de DashScope reconocido; se desactiva con Coding Plan (no verificado en ese endpoint) y también en endpoints personalizados de terceros u otros hosts (documentación de web_search). Si lo necesitas, conecta un servidor de búsqueda MCP.
• La ruta de Kunavo es solo para chat. Kunavo no tiene modelos de embeddings, síntesis de voz ni reconocimiento de voz. Live Voice de Qwen Code requiere un endpoint de DashScope, por lo que usa la clave independiente aunque redirijas el modelo de chat a otro destino.

Pagos al probar con Kunavo

Kunavo utiliza un sistema prepago sin cuota mensual y descuenta el consumo del saldo por tokens. La recarga mínima es de $10; en el checkout de Stripe puedes usar tarjetas (Visa, Mastercard, American Express, JCB, UnionPay), Apple Pay, Google Pay y Link. Si el checkout aparece en wones, también puedes elegir KakaoPay, Naver Pay, PAYCO, Samsung Pay y tarjetas nacionales que no admiten pagos internacionales (la conversión a wones incluye una comisión de cambio de Stripe del 2–4 %, que puedes evitar pagando en dólares). No se admite Toss Pay. Consulta Información de pago, crea una cuenta y genera una clave. Después de la primera solicitud, lo más fiable es comprobar el importe real en Historial de uso.

Preguntas frecuentes

Verificado el 1 de octubre de 2026: README de Qwen Code; documentación de autenticación, proveedores de modelos, comandos y web_search (rama main); lista de archivos de traducción de la interfaz del repositorio; @qwen-code/qwen-code 0.24.7 de npm; y páginas de Coding Plan y Token Plan de Alibaba Cloud. Kunavo no ha ejecutado Qwen Code en su propio endpoint.