Como configurar o Qwen Code: instalação, provedores, interface em alemão e API

Qwen Code é o agente de programação com IA de código aberto (Apache-2.0) da equipe Qwen da Alibaba. A configuração ocorre em quatro etapas: instalar, iniciar qwen no projeto, escolher o provedor com /auth e fazer uma solicitação. Importante: a cota gratuita do Qwen OAuth terminou em 15 de abril de 2026 — quem seguir um guia antigo não conseguirá mais continuar gratuitamente dessa forma. Esta página acompanha o menu /auth atual, mostra como mudar para alemão, configurar um endpoint próprio para Claude ou GPT e usar os comandos mais importantes. A versão mais recente é a v0.24.7, publicada no npm em 29 de setembro de 2026; há releases pelo menos semanalmente. Verifique sua versão com qwen --version.

Instalação

Os comandos vêm do README oficial. Com o instalador autônomo, você não precisa fornecer o Node.js por conta própria; apenas o npm exige Node.js 22 ou mais recente.

# 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

Reabra o terminal depois disso para que as variáveis de ambiente sejam aplicadas. O Qwen Code originalmente se baseava no Google Gemini CLI v0.8.2, mas é desenvolvido de forma independente desde a v0.1 e não é mais sincronizado com o original. As configurações e cotas do Gemini CLI não se aplicam aqui.

Primeiro início e interface em alemão

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

Após /language ui de-DE, o Qwen Code mostra seus próprios termos em alemão, como „Authentifizierungsmethode auswählen“ ou „Werkzeug-Genehmigungsmodus“; esta página usa os mesmos termos. O idioma das respostas é separado disso e é definido com /language output German.

Além do terminal, há um aplicativo para desktop, uma interface web no navegador (qwen serve --open, experimental), integrações para VS Code, Zed e JetBrains e um modo headless para scripts e CI (qwen -p "..."). Tudo fica no mesmo repositório gratuito; a inferência é paga separadamente.

Escolher o provedor com /auth

/auth (alias /login) abre „Authentifizierungsmethode auswählen“ com três opções no nível superior. Quem ainda quiser escolher o Qwen OAuth verá: „Eingestellt — wechseln Sie zu Coding Plan oder API Key“.

As três opções do ModelStudio não são três formas de pagamento da mesma cobrança: a documentação fornece a cada uma um endpoint próprio e uma chave própria, e o tipo de chave e baseUrl precisam ser compatíveis. Em 1º de outubro de 2026, o Coding Plan estava indicado como „disponibilidade limitada, por ordem de chegada, recarregado diariamente à 0h (UTC+8)“ — portanto, pode não ser possível adquiri-lo em determinado dia. Uma tarefa consome várias chamadas de modelo no Coding Plan; a Alibaba cita normalmente 5–10 para tarefas simples e 10–30 ou mais para tarefas complexas. A página em inglês Preços do Qwen Code trata da comparação de custos em detalhes.

Usar Claude ou GPT: provedor personalizado em settings.json

A documentação de autenticação recomenda, para provedores terceirizados como OpenAI, Anthropic, Google, OpenRouter ou um endpoint próprio, o bloco modelProviders em ~/.qwen/settings.json. Para a Kunavo, fica assim:

{
  "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

Quatro pontos que economizam tempo na depuração:

• baseUrl termina em /v1. A Referência de provedores de modelos afirma expressamente: definir a raiz /v1 da API, não /v1/chat/completions — o SDK acrescenta o caminho sozinho. Com o caminho, ocorre um 404, não um erro de autenticação.
• Onde fica a chave. O Qwen Code a lê da variável de ambiente indicada por envKey. Ordem de prioridade: export do shell, depois um arquivo .env (recomenda-se .qwen/.env; apenas o primeiro arquivo encontrado conta) e, por último, env em settings.json — ali a chave fica em texto simples.
• O arquivo prevalece sobre a opção da CLI. Ordem: valores de /auth → entrada de modelProviders selecionada → argumentos da CLI → variáveis de ambiente → settings.json. Por isso, --openai-base-url às vezes parece não ter efeito. security.auth.apiKey e security.auth.baseUrl de guias antigos estão obsoletos.
• Comece com Chat Completions. Sem wireApi, Chat Completions é usado. Com "responses", não há detecção de endpoint nem fallback automático. Alterações em modelProviders também têm efeito em uma sessão em andamento (/model para reabrir).

O catálogo da Kunavo não contém um modelo de texto Qwen. Portanto, este não é um caminho mais barato para Qwen, mas uma forma de usar Claude ou GPT no Qwen Code por meio de um saldo pré-pago. A Kunavo também não executou o Qwen Code contra seu endpoint; assim como a página em inglês Configuração do Qwen Code, a configuração vem da documentação oficial. Mantenha uma rota funcional enquanto experimenta.

Primeira tarefa e comandos importantes

O README sugere, em essência, como primeira solicitação: „Explique este repositório e mostre-me por onde começar.“ Isso testa o acesso aos arquivos e as chamadas de ferramentas ao mesmo tempo — um simples „Olá“ não revela problemas de conexão.

Para yolo e os outros modos automáticos, a própria documentação alerta: use apenas em ambientes confiáveis, isolados ou descartáveis. Os custos estimados em /stats model são calculados pelo próprio Qwen Code; o valor efetivo aparece no registro de uso do seu provedor.

Limitações que você deve conhecer

• A pesquisa web integrada depende do host. Ela usa a pesquisa do lado do servidor do DashScope: ativada para a Standard API Key e o Token Plan do ModelStudio, bem como para entradas em um host DashScope reconhecido; desativada para o Coding Plan (não verificado nesse caso) e para provedores terceirizados e endpoints próprios em outros hosts (documentação de web_search). Alternativa: um servidor de pesquisa MCP.
• A Kunavo oferece apenas chat. A Kunavo não oferece modelos de embeddings, síntese de voz ou reconhecimento de fala. O Live Voice do Qwen Code exige de qualquer forma um endpoint DashScope e continua usando sua própria chave, independentemente de para onde o modelo de chat aponta.

Pagar ao testar a Kunavo

A Kunavo trabalha com saldo pré-pago sem assinatura e cobra por token. A recarga mínima é de $10; no checkout da Stripe, estão disponíveis cartões (Visa, Mastercard, American Express), Apple Pay, Google Pay e Link; na Áustria, também EPS — o débito SEPA não é oferecido atualmente. A Stripe oferece Pay by Bank apenas a compradores no Reino Unido, Irlanda e Finlândia; na Alemanha, ele ainda funciona apenas como uma prévia fechada (documentação da Stripe, em 3 de outubro de 2026). Mais detalhes em Billing; crie a chave com uma conta. Após a primeira tarefa, o registro de uso mostra o valor real.

Perguntas frequentes

Verificado em 1º de outubro de 2026: README do Qwen Code; documentação sobre autenticação, provedores de modelos, comandos e web_search (branch main); textos da interface em alemão (packages/cli/src/i18n/locales/de.js); @qwen-code/qwen-code 0.24.7 no npm; e páginas da Alibaba Cloud sobre Coding Plan e Token Plan. A Kunavo não executou o Qwen Code contra seu endpoint.