Como usar o Qwen Code: instalação, /auth, localização em japonês e configuração da API

O Qwen Code é um agente de codificação de IA de código aberto (Apache-2.0), publicado pela equipe Qwen da Alibaba. O fluxo de uso tem quatro etapas: “instalar → iniciar qwen no projeto → configurar o destino da conexão com /auth → solicitar uma tarefa”. No entanto, como a cota gratuita do Qwen OAuth terminou em 15 de abril de 2026, fazer login conforme as explicações anteriores não fará o programa funcionar gratuitamente.Nesta página, explicamos em sequência como começar seguindo o menu /auth atual, mudar para a interface em japonês, configurar um provedor personalizado para usar Claude ou GPT e usar os comandos mais comuns. A versão mais recente é a v0.24.7, publicada no npm em 29 de setembro de 2026, e os lançamentos ocorrem pelo menos uma vez por semana; confirme sua versão local com qwen --version.

Instalação

Estas são as instruções do README oficial. Com o instalador autônomo, você não precisa preparar o Node.js por conta própria. O Node.js 22 ou superior só é necessário ao usar 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

Após a instalação, reabra o terminal para aplicar as variáveis de ambiente. O Qwen Code originalmente era baseado no Google Gemini CLI v0.8.2, mas deixou de sincronizar com o upstream e passou a ser desenvolvido de forma independente a partir da v0.1. As configurações e cotas gratuitas do Gemini CLI não se aplicam diretamente.

Primeira inicialização e mudança para japonês

cd /path/to/your-project
qwen

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

Com /language ui ja-JP, a interface fica em japonês, e as telas seguintes exibem textos próprios do Qwen Code, como “Selecionar método de autenticação” e “Modo de aprovação de ferramentas”. Usamos a mesma terminologia nesta página. O idioma das respostas é separado do idioma da interface e é definido com /language output Japanese.

Além do terminal, estão disponíveis um aplicativo para desktop, uma interface Web aberta no navegador (qwen serve --open, recurso experimental), integrações para VS Code, Zed e JetBrains e execução headless para scripts ou CI (qwen -p "..."). Todos estão incluídos no mesmo repositório gratuito; os custos de inferência são separados.

Escolher o destino da conexão em /auth

Ao abrir /auth (também chamado de /login), aparece a tela “Selecionar método de autenticação”, com três opções de nível superior. Ao tentar escolher Qwen OAuth, é exibido “Encerrado — mude para Coding Plan ou API Key”.

As três opções do ModelStudio não são apenas formas diferentes de pagar a mesma cobrança. A documentação atribui um endpoint e uma chave diferentes a cada uma, e elas não funcionam quando o tipo de chave não corresponde a baseUrl. Em 1º de outubro de 2026, o Coding Plan exibia “quantidade limitada, por ordem de chegada; reposição diária à 0h (UTC+8)”, portanto há dias em que é possível assinar e dias em que não é. Cada solicitação do Coding Plan se transforma internamente em várias chamadas de modelo; segundo a Alibaba, consome de 5 a 10 chamadas em tarefas simples e de 10 a 30 ou mais em tarefas complexas. A comparação de preços é abordada em detalhes na versão em inglês de Qwen Code pricing.

Usar Claude ou GPT: configurar um Custom Provider em settings.json

A documentação de autenticação do Qwen Code recomenda ~/.qwen/settings.json de modelProviders para conectar-se a serviços de terceiros, como OpenAI, Anthropic, Google, OpenRouter e endpoints próprios. Para a Kunavo, é o seguinte.

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

Há quatro pontos importantes.

• baseUrl deve chegar somente até /v1.A referência de provedores de modelos afirma explicitamente: “especifique a rota /v1 da API, não /v1/chat/completions. O SDK acrescenta o caminho da solicitação”. Incluir o caminho resulta em 404, e não em um erro de autenticação.
• Onde colocar a chave.O Qwen Code lê a chave do ambiente usando o nome da variável especificado em envKey. A ordem de prioridade é export do shell, .env (.qwen/.env recomendado; somente o primeiro arquivo encontrado) e env de settings.json; a última opção armazena a chave em texto simples e, por isso, não é recomendada.
• O arquivo de configuração prevalece sobre as flags da CLI.A ordem de resolução é o valor inserido em /auth → o modelProviders selecionado → argumentos da CLI → variáveis de ambiente → settings.json. É por isso que --openai-base-url pode parecer ser ignorado. security.auth.apiKey e security.auth.baseUrl das explicações antigas estão obsoletos.
• Comece com Chat Completions.Se wireApi for omitido, será usado o formato Chat Completions. Com "responses", não há detecção automática nem fallback do endpoint. As alterações em modelProviders também são aplicadas imediatamente à sessão em execução (aparecem ao reabrir /model).

O catálogo da Kunavo não contém modelos de texto Qwen.Este não é um método barato de usar Qwen, mas uma forma de usar Claude ou GPT dentro do Qwen Code com um único saldo pré-pago. Além disso, a Kunavo não verificou o funcionamento efetivo do Qwen Code com seu endpoint. A configuração foi criada a partir da documentação oficial, assim como na página de configuração do Qwen Code em inglês. Mantenha a rota que está funcionando atualmente e faça o teste separadamente.

Primeira tarefa e comandos mais usados

Conforme o exemplo do README, comece com uma solicitação como “explique este repositório e diga por onde devo começar a ler” para verificar se a leitura de arquivos e as chamadas de ferramentas funcionam de ponta a ponta. Uma simples saudação não encontra problemas de conexão.

Modos de aprovação automática como yolo são acompanhados do aviso da própria documentação: “use somente em ambientes confiáveis, em sandbox ou descartáveis”. O custo estimado de /stats model é calculado pelo Qwen Code, não é o valor cobrado. Confirme o valor real nos registros de uso do destino da conexão.

Limitações importantes

• O web_search integrado é determinado pelo destino da conexão. Como usa a pesquisa no lado do servidor do DashScope, ele fica disponível com Standard API Key e Token Plan do ModelStudio e em entradas que apontam para um host DashScope reconhecido; fica desativado no Coding Plan (por não ter sido verificado nesse endpoint) e em endpoints personalizados de terceiros ou de outros hosts (documentação do web_search). Se necessário, adicione um servidor de pesquisa via MCP.
• A rota da Kunavo é somente para chat.A Kunavo não oferece modelos de incorporação, síntese de fala ou reconhecimento de fala. O Live Voice do Qwen Code exige um endpoint do DashScope, portanto, independentemente de para onde você aponte o modelo de chat, a voz continua usando outra chave.

Pagamento ao testar a Kunavo

A Kunavo usa recargas pré-pagas, sem mensalidade, e desconta do saldo por token. A recarga mínima é de $10; no checkout do Stripe, é possível usar cartões (Visa, Mastercard, American Express, JCB), Apple Pay, Google Pay e Link. Consulte a explicação sobre cobrança, depois crie uma conta e emita sua chave. Após a primeira solicitação, a forma mais segura de confirmar o valor efetivamente cobrado é consultar o histórico de uso.

Perguntas frequentes

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