Autenticação

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

• OAuth do Qwen: faça login com sua conta qwen.ai em um navegador. Gratuito, com cota diária.
• Plano de Codificação da Alibaba Cloud: use uma chave de API da Alibaba Cloud. Assinatura paga com diversas opções de modelos e cotas mais altas.
• Chave de API: forneça sua própria chave de API. Flexível conforme suas necessidades — suporta endpoints compatíveis com OpenAI, Anthropic, Gemini e outros.

Opção 1: OAuth do Qwen (Grátis)

Use esta opção se você deseja a configuração mais simples e estiver utilizando modelos Qwen.

• Como funciona: na primeira inicialização, o Qwen Code abre uma página de login no navegador. Após concluir o processo, as credenciais são armazenadas em cache localmente, portanto, normalmente você não precisará fazer login novamente.
• Requisitos: uma conta qwen.ai + acesso à internet (pelo menos para o primeiro login).
• Vantagens: sem gerenciamento de chaves de API, 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

💳 Opção 2: Plano de Codificação da Alibaba Cloud

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

• Como funciona: Assine o Plano de Codificação com uma taxa mensal fixa e, em seguida, configure o Qwen Code para usar o endpoint dedicado e sua chave de API de assinatura.
• Requisitos: Obtenha uma assinatura ativa do Plano de Codificação no Aliyun Bailian  ou na Alibaba Cloud , conforme a 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 variedade de modelos (Qwen, GLM, Kimi, Minimax e outros).
• Custos e cotas: Consulte a documentação do Plano de Codificação da Aliyun Bailian .

O Plano de Codificação da Alibaba Cloud está disponível em duas regiões:

Configuração interativa

Digite qwen no terminal para iniciar o Qwen Code, em seguida execute o comando /auth e selecione Plano de Codificação da Alibaba Cloud. 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 Plano de Codificação da Alibaba Cloud (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 (Plano de Codificação)",
        "baseUrl": "https://coding.dashscope.aliyuncs.com/v1",
        "description": "qwen3-coder-plus do Plano de Codificação da Alibaba Cloud",
        "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: Chave de API (flexível)

Use esta opção se quiser se conectar a provedores de terceiros, como OpenAI, Anthropic, Google, Azure OpenAI, OpenRouter, ModelScope ou um endpoint auto-hospedado. Suporta 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 chave de API é colocar todas as configurações em um único arquivo ~/.qwen/settings.json. Abaixo há 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"
  }
}

O que cada campo faz:

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

O conceito central é o de Provedores de Modelo (modelProviders): o Qwen Code suporta múltiplos protocolos de API, não apenas o OpenAI. Você configura quais provedores e modelos estão disponíveis editando o arquivo ~/.qwen/settings.json e pode alternar entre eles em tempo de execução usando o comando /model.

Protocolos compatíveis

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

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

Edite o arquivo ~/.qwen/settings.json (crie-o caso ainda não exista). É possível misturar vários protocolos em um único arquivo — abaixo há 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 a Referência de Provedores de Modelos.

Etapa 2: Definir variáveis de ambiente

O Qwen Code lê as chaves de API de variáveis de ambiente (especificadas por envKey na configuração do seu modelo). Há 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 encontrar (as variáveis não são mescladas entre múltiplos arquivos). Apenas as variáveis ainda não presentes em process.env são carregadas.

Ordem de busca (a partir do diretório atual, subindo até /):

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

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

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

3. Campo env em settings.json (prioridade mais baixa)

Você também pode definir chaves de API diretamente em ~/.qwen/settings.json, na chave env. Essas variáveis são carregadas como último recurso de fallback, aplicadas apenas quando uma variável ainda não foi definida pelo ambiente do sistema ou pelos arquivos .env.

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

Essa é 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 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 exibirá todos os modelos da sua configuração modelProviders, agrupados pelo respectivo protocolo (por exemplo, openai, anthropic, gemini). A sua seleção é persistida entre sessões.

Você também pode alternar modelos diretamente usando um argumento de linha de comando, o que é conveniente ao trabalhar em vários terminais.

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

Observações sobre segurança

• Não envie chaves de API para controle de versão.
• Prefira o arquivo .qwen/.env para segredos específicos do projeto (e certifique-se de excluí-lo do Git).
• Trate a saída do seu terminal como sensível caso ela imprima credenciais para verificação.