Autenticação

O Qwen Code oferece suporte a três métodos de autenticação. Escolha o que melhor se adapta à forma como você deseja executar a CLI:

• Qwen OAuth: faça login com sua conta qwen.ai em um navegador. Gratuito com uma cota diária.
• Alibaba Cloud Coding Plan: use uma API key da Alibaba Cloud. Assinatura paga com diversas opções de modelos e cotas mais altas.
• API Key: traga sua própria API key. Flexível para suas necessidades — oferece suporte a OpenAI, Anthropic, Gemini e outros endpoints compatíveis.

Opção 1: Qwen OAuth (Gratuito)

Use esta opção se você deseja a configuração mais simples e está usando modelos Qwen.

• Como funciona: na primeira inicialização, o Qwen Code abre uma página de login no navegador. Após concluir, as credenciais são armazenadas em cache localmente, então geralmente você não precisará fazer login novamente.
• Requisitos: uma conta qwen.ai + acesso à internet (pelo menos para o primeiro login).
• Benefícios: sem gerenciamento de API key, atualização automática de credenciais.
• Custo e cota: gratuito, com uma cota de 60 requisições/minuto e 1.000 requisições/dia.

Inicie a CLI e siga o fluxo no navegador:

qwen

Ou autentique-se diretamente sem iniciar uma sessão:

qwen auth qwen-oauth

💳 Opção 2: Alibaba Cloud Coding Plan

Use esta opção se você deseja custos previsíveis com diversas opções de modelos e cotas de uso mais altas.

• Como funciona: assine o Coding Plan com uma taxa mensal fixa e configure o Qwen Code para usar o endpoint dedicado e sua API key de assinatura.
• Requisitos: obtenha uma assinatura ativa do Coding Plan em Alibaba Cloud ModelStudio(Beijing)  ou Alibaba Cloud ModelStudio(intl) , dependendo da região da sua conta.
• Benefícios: diversas opções de modelos, cotas de uso mais altas, custos mensais previsíveis e acesso a uma ampla gama de modelos (Qwen, GLM, Kimi, Minimax e outros).
• Custo e cota: consulte a documentação do Aliyun ModelStudio Coding PlanPequim internacional .

O Alibaba Cloud Coding Plan está disponível em duas regiões:

Configuração interativa

Você pode configurar a autenticação do Coding Plan de duas formas:

Opção A: Pelo terminal (recomendado para a primeira configuração)

# Interativo — solicita região e API key
qwen auth coding-plan
 
# Ou não interativo — passe região e chave diretamente
qwen auth coding-plan --region china --key sk-sp-xxxxxxxxx

Opção B: Dentro de uma sessão do Qwen Code

Digite qwen no terminal para iniciar o Qwen Code, execute o comando /auth e selecione Alibaba Cloud Coding Plan. Escolha sua região e insira sua chave sk-sp-xxxxxxxxx.

Após a autenticação, use o comando /model para alternar entre todos os modelos compatíveis com o Alibaba Cloud Coding Plan (incluindo qwen3.5-plus, qwen3-coder-plus, qwen3-coder-next, qwen3-max, glm-4.7 e kimi-k2.5).

Alternativa: configurar via settings.json

Se preferir pular o fluxo interativo /auth, adicione o seguinte a ~/.qwen/settings.json:

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3-coder-plus",
        "name": "qwen3-coder-plus (Coding Plan)",
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
        "description": "qwen3-coder-plus from Alibaba Cloud Coding Plan",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY"
      }
    ]
  },
  "env": {
    "BAILIAN_CODING_PLAN_API_KEY": "sk-sp-xxxxxxxxx"
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3-coder-plus"
  }
}

🚀 Opção 3: API Key (flexível)

Use esta opção se você deseja se conectar a provedores de terceiros, como OpenAI, Anthropic, Google, Azure OpenAI, OpenRouter, ModelScope ou um endpoint auto-hospedado. Oferece suporte a múltiplos protocolos e provedores.

Recomendado: configuração em um único arquivo via settings.json

A maneira mais simples de começar com a autenticação por API Key é colocar tudo em um único arquivo ~/.qwen/settings.json. Aqui está um exemplo completo e pronto para uso:

{
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3-coder-plus",
        "name": "qwen3-coder-plus",
        "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
        "description": "Qwen3-Coder via Dashscope",
        "envKey": "DASHSCOPE_API_KEY"
      }
    ]
  },
  "env": {
    "DASHSCOPE_API_KEY": "sk-xxxxxxxxxxxxx"
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3-coder-plus"
  }
}

Função de cada campo:

Após salvar o arquivo, basta executar qwen — nenhuma configuração interativa /auth é necessária.

O conceito principal é Model Providers (modelProviders): o Qwen Code oferece suporte a múltiplos protocolos de API, não apenas OpenAI. Você configura quais provedores e modelos estão disponíveis editando ~/.qwen/settings.json e depois alterna entre eles em tempo de execução com o comando /model.

Protocolos compatíveis

Etapa 1: Configurar modelos e provedores em ~/.qwen/settings.json

Defina quais modelos estão disponíveis para cada protocolo. Cada entrada de modelo requer no mínimo um id e um envKey (o nome da variável de ambiente que contém sua API key).

Edite ~/.qwen/settings.json (crie-o se não existir). Você pode misturar múltiplos protocolos em um único arquivo — aqui está um exemplo com múltiplos provedores mostrando apenas a seção modelProviders:

{
  "modelProviders": {
    "openai": [
      {
        "id": "gpt-4o",
        "name": "GPT-4o",
        "envKey": "OPENAI_API_KEY",
        "baseUrl": "https://api.openai.com/v1"
      }
    ],
    "anthropic": [
      {
        "id": "claude-sonnet-4-20250514",
        "name": "Claude Sonnet 4",
        "envKey": "ANTHROPIC_API_KEY"
      }
    ],
    "gemini": [
      {
        "id": "gemini-2.5-pro",
        "name": "Gemini 2.5 Pro",
        "envKey": "GEMINI_API_KEY"
      }
    ]
  }
}

Campos de ModelConfig (cada entrada dentro de modelProviders):

Para o esquema completo de modelProviders e opções avançadas como generationConfig, customHeaders e extra_body, consulte Referência de Model Providers.

Etapa 2: Definir variáveis de ambiente

O Qwen Code lê as API keys das variáveis de ambiente (especificadas por envKey na configuração do seu modelo). Existem várias maneiras de fornecê-las, listadas abaixo da maior para a menor prioridade:

1. Ambiente do shell / export (maior prioridade)

Defina diretamente no perfil do seu shell (~/.zshrc, ~/.bashrc, etc.) ou inline antes de iniciar:

 
# Alibaba Dashscope
export DASHSCOPE_API_KEY="sk-..."
 
# OpenAI / Compatível com OpenAI
export OPENAI_API_KEY="sk-..."
 
# Anthropic
export ANTHROPIC_API_KEY="sk-ant-..."
 
# Google GenAI
export GEMINI_API_KEY="AIza..."

2. Arquivos .env

O Qwen Code carrega automaticamente o primeiro arquivo .env que encontra (as variáveis não são mescladas entre vários arquivos). Apenas variáveis que ainda não estão presentes em process.env são carregadas.

Ordem de busca (a partir do diretório atual, subindo em direção a /):

1. .qwen/.env (recomendado — mantém as variáveis do Qwen Code isoladas de outras ferramentas)
2. .env

Se nada for encontrado, ele recorre ao seu diretório home:

3. ~/.qwen/.env
4. ~/.env

3. settings.json → campo env (menor prioridade)

Você também pode definir API keys diretamente em ~/.qwen/settings.json sob a chave env. Elas são carregadas como o fallback de menor prioridade — aplicadas apenas quando uma variável ainda não está definida pelo ambiente do sistema ou por arquivos .env.

{
  "env": {
    "DASHSCOPE_API_KEY": "sk-...",
    "OPENAI_API_KEY": "sk-...",
    "ANTHROPIC_API_KEY": "sk-ant-..."
  }
}

Esta é a abordagem usada no exemplo de configuração em um único arquivo acima. É conveniente para manter tudo em um só lugar, mas lembre-se de que o settings.json pode ser compartilhado ou sincronizado — prefira arquivos .env para segredos sensíveis.

Resumo de prioridades:

Etapa 3: Alternar modelos com /model

Após iniciar o Qwen Code, use o comando /model para alternar entre todos os modelos configurados. Os modelos são agrupados por protocolo:

/model

O seletor mostrará todos os modelos da sua configuração modelProviders, agrupados por protocolo (por exemplo, openai, anthropic, gemini). Sua seleção é persistida entre sessões.

Você também pode alternar modelos diretamente com um argumento de linha de comando, o que é conveniente ao trabalhar com múltiplos terminais.

# Em um terminal
 
qwen --model "qwen3-coder-plus"
 
# Em outro terminal
 
qwen --model "qwen3.5-plus"

Comando qwen auth da CLI

Além do comando de barra /auth dentro da sessão, o Qwen Code fornece o comando qwen auth da CLI para gerenciar a autenticação diretamente pelo terminal — sem precisar iniciar uma sessão interativa primeiro.

Modo interativo

Execute qwen auth sem argumentos para obter um menu interativo:

qwen auth

Você verá um seletor com navegação por setas:

Select authentication method:

> Qwen OAuth - Free · Up to 1,000 requests/day · Qwen latest models
  Alibaba Cloud Coding Plan - Paid · Up to 6,000 requests/5 hrs · All Alibaba Cloud Coding Plan Models

(Use ↑ ↓ arrows to navigate, Enter to select, Ctrl+C to exit)

Subcomandos

Exemplos:

# Autenticar com Qwen OAuth diretamente
qwen auth qwen-oauth
 
# Configurar Coding Plan interativamente (solicita região e chave)
qwen auth coding-plan
 
# Configurar Coding Plan não interativamente (útil para CI/scripts)
qwen auth coding-plan --region china --key sk-sp-xxxxxxxxx
 
# Verificar sua configuração de autenticação atual
qwen auth status

Notas de segurança

• Não faça commit de API keys no controle de versão.
• Prefira .qwen/.env para segredos locais do projeto (e mantenha-o fora do git).
• Trate a saída do seu terminal como sensível se ela imprimir credenciais para verificação.