Cómo usar Qwen Code: instalación, /auth, interfaz en japonés y configuración de la API

Qwen Code es un agente de programación con IA de código abierto (Apache-2.0), publicado por el equipo Qwen de Alibaba. El flujo de uso consta de cuatro etapas: «instalar → iniciar qwen en el proyecto → configurar el destino de conexión con /auth → pedir una tarea». Sin embargo, como el cupo gratuito de Qwen OAuth terminó el 15 de abril de 2026, iniciar sesión según las guías anteriores ya no permite usarlo gratis. Esta página explica paso a paso cómo empezar siguiendo el menú /auth actual, cambiar a la interfaz japonesa, configurar un proveedor personalizado para usar Claude o GPT y utilizar los comandos más habituales. 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 una vez por semana, comprueba tu versión con qwen --version.

Instalación

Estos son los pasos del README oficial. Con el instalador independiente no necesitas preparar Node.js por tu cuenta. Node.js 22 o posterior solo es necesario si usas 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

Después de instalarlo, vuelve a abrir el terminal para aplicar las variables de entorno. Qwen Code se basaba originalmente en Google Gemini CLI v0.8.2, pero desde v0.1 se desarrolla de forma independiente y dejó de sincronizarse con el proyecto original. La configuración y los cupos gratuitos de Gemini CLI no se aplican aquí.

Primer inicio y cambio al japonés

cd /path/to/your-project
qwen

# セッション内で：
/language ui ja-JP          # 画面表示を日本語に
/language output Japanese   # モデルの回答を日本語に
/auth                       # 接続先と API キーを設定

/language ui ja-JP pone la interfaz en japonés, y a partir de entonces aparecen en pantalla textos propios de Qwen Code, como «Seleccionar método de autenticación» y «Modo de aprobación de herramientas». En esta página usamos la misma terminología. El idioma de las respuestas es independiente del idioma de la interfaz y se especifica con /language output Japanese.

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), integraciones para VS Code, Zed y JetBrains, y ejecución sin interfaz para scripts o CI (qwen -p "..."). Todas están incluidas en el mismo repositorio gratuito; el coste de inferencia es independiente.

Elegir el destino de conexión en /auth

Al abrir /auth (también llamado /login) aparece la pantalla «Seleccionar método de autenticación», con tres opciones de nivel superior. Si intentas elegir Qwen OAuth, aparece «Terminado — cambia a Coding Plan o API Key».

Las tres opciones de ModelStudio no son simplemente tres formas de pagar la misma factura. La documentación asigna un endpoint y una clave distintos a cada una, y no funcionarán si el tipo de clave no coincide con baseUrl. A fecha del 1 de octubre de 2026, Coding Plan aparece como «cantidad limitada, por orden de llegada; reposición diaria a las 00:00 (UTC+8)», por lo que hay días en los que se puede solicitar y días en los que no. Una solicitud de Coding Plan se convierte internamente en varias llamadas al modelo; según Alibaba, consume entre 5 y 10 llamadas para tareas sencillas y entre 10 y 30 o más para tareas complejas. La versión inglesa de Qwen Code pricing explica con más detalle cómo comparar los precios.

Usar Claude o GPT: configurar Custom Provider en settings.json

La documentación de autenticación de Qwen Code recomienda ~/.qwen/settings.json de modelProviders para conectarse a terceros como OpenAI, Anthropic, Google, OpenRouter o endpoints propios. En Kunavo, la configuración es la 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

Hay cuatro puntos que debes tener presentes.

• baseUrl solo hasta /v1. La referencia de proveedores de modelos indica explícitamente: «especifica la ruta raíz de la /v1 de la API, no /v1/chat/completions. El SDK añade la ruta de solicitud». Si incluyes la ruta, obtendrás un 404, no un error de autenticación.
• Dónde colocar la clave. Qwen Code la lee del entorno usando el nombre de variable especificado en envKey. El orden de prioridad es export del shell, .env (.qwen/.env recomendado; solo se consulta el primer archivo encontrado) y env dentro de settings.json, y esta última opción no se recomienda porque guarda la clave en texto plano.
• El archivo de configuración prevalece sobre las opciones de la CLI. El orden de resolución es el valor introducido en /auth → modelProviders seleccionado → argumentos de la CLI → variables de entorno → settings.json. Por eso parece que --openai-base-url se ignora. security.auth.apiKey y security.auth.baseUrl de las guías antiguas están obsoletos.
• Empieza con Chat Completions. Si omites wireApi, se utiliza el formato Chat Completions. Con "responses" no hay detección automática del endpoint ni fallback. Los cambios en modelProviders se aplican inmediatamente incluso a las sesiones activas (aparecen al volver a abrir /model).

El catálogo de Kunavo no contiene modelos de texto de Qwen. Esto no es una forma de usar Qwen más barato, sino una forma de usar Claude o GPT dentro de Qwen Code con un único saldo prepago. Además, Kunavo no ha verificado ejecutando Qwen Code contra su propio endpoint. La configuración se creó a partir de la documentación oficial, igual que la página de configuración de Qwen Code en inglés. Prueba manteniendo intacta la ruta que funciona actualmente.

Primera tarea y comandos habituales

Como en el ejemplo del README, empieza con una solicitud como «explica este repositorio y dime por dónde debería empezar a leer» para comprobar que funcionan la lectura de archivos y las llamadas a herramientas. Un simple saludo no detectará problemas de conexión.

Los modos de aprobación automática, como yolo, vienen acompañados de una advertencia de la propia documentación: «úsalos solo en entornos de confianza, aislados o desechables». El coste estimado de /stats model es un cálculo de Qwen Code, no el importe facturado. Comprueba el importe real en los registros de uso del destino de conexión.

Limitaciones que conviene conocer

• La búsqueda web integrada web_search depende del destino de conexión. Como utiliza la búsqueda del lado del servidor de DashScope, está habilitada para Standard API Key y Token Plan de ModelStudio y para entradas que apunten a un host de DashScope reconocido; está deshabilitada en Coding Plan (porque no se ha verificado en ese endpoint) y en proveedores externos o endpoints personalizados de otros hosts (documentación de web_search). Si es necesario, añade un servidor de búsqueda MCP.
• La ruta de Kunavo solo admite 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, independientemente de dónde dirijas el modelo de chat, seguirá necesitando otra clave.

Pagos al probar Kunavo

Kunavo funciona con recargas prepago, sin cuota mensual, y descuenta el uso por token del saldo. La recarga mínima es de $10; en el checkout de Stripe se aceptan tarjetas (Visa, Mastercard, American Express y JCB), Apple Pay, Google Pay y Link. Consulte Información de facturación, después cree una cuenta y emita una clave. Tras la primera solicitud, lo más fiable es comprobar el importe facturado real en Registro de uso.

Preguntas frecuentes

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