Guia de Instalação do Qwen Code CLI: Configuração Rápida no Windows, macOS e Linux (2026)

Pré-requisitos

Antes de instalar o Qwen Code CLI (o agente oficial de codificação com IA baseado em terminal, alimentado pelos modelos Qwen), certifique-se de ter o seguinte:

Node.js versão 20 ou superior (recomendado: a última versão LTS). Baixe em nodejs.org.
Um terminal ou prompt de comando com privilégios administrativos no Windows.
Conexão com a internet para baixar pacotes e modelos.
Opcional, mas recomendado: Git (para instalação manual a partir do código-fonte) e Homebrew no macOS/Linux.

Verifique a instalação do Node.js:

node --version
npm --version

A saída esperada deve mostrar versões como v20.x.x ou superior.

Passo对这个: Escolha Seu Método de Instalação

O Qwen Code CLI oferece múltiplos caminhos de instalação. O script de instalação rápida é recomendado para a maioria dos usuários, pois trata as dependências automaticamente.

Instalação Rápida (Recomendado)

Linux / macOS:

bash -c "$(curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.sh)"

Windows (Execute o Prompt de Comando como Administrador):

curl -fsSL -o %TEMP%\install-qwen.bat https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.bat && %TEMP%\install-qwen.bat

Após executar, reinicie seu terminal para atualizar o PATH.

Passo 2: Instalação Manual via npm

Se você prefere controle manual:

npm install -g @qwen-code/qwen-code@latest

Isso instala o comando qwen globalmente.

No macOS/Linux com sudo (se ocorrerem problemas de permissão):

sudo npm install -g @qwen-code/qwen-code@latest

Passo 3: Instalação via Homebrew (macOS & Linux)

brew install qwen-code

Passo 4: Verifique a Instalação

Execute o seguinte comando para confirmar uma instalação bem-sucedida:

qwen --version

Você deve ver uma saída semelhante a:

Qwen Code CLI v0.x.x

Passo 5: Primeira Execução e Autenticação

Inicie o CLI interativo:

qwen

Na primeira execução, o CLI solicitará que você se autentique com sua conta Qwen (abrirá o navegador para um login com um clique). Após fazer o login, ele aplica as configurações padrão e entra na interface de terminal interativa.

Para obter os melhores resultados, navegue primeiro até o diretório do seu projeto:

cd /path/to/your/project
qwen

Dentro da sessão, use comandos como /help, /model para trocar de modelos, ou referencie arquivos com @filename.

Passo 6: Instalação Manual a partir do Código-fonte (Avançado)

Para desenvolvedores que desejam as últimas alterações não lançadas:

git clone https://github.com/QwenLM/qwen-code.git
cd qwen-code
npm install
npm install -g .

Em seguida, verifique com qwen --version.

Problemas Comuns e Solução de Problemas

Comando 'qwen' não encontrado: Reinicie seu terminal ou execute hash -r (Linux/macOS). No Windows, feche e reabra o Prompt de Comando. Certifique-se de que o diretório global bin do Node.js está no seu PATH.
Erros de permissão durante o npm install: Use sudo no Linux/macOS ou execute o Prompt de Comando como Administrador no Windows.
Versão do Node.js muito antiga: Atualize para Node 20+ usando nvm ou o instalador oficial.
Problemas de rede com recursos da Aliyun: Tente o método npm como alternativa.
Instalação falha no Termux ou em certas distribuições Linux: Use a flag --ignore-scripts: npm install -g @qwen-code/qwen-code@latest --ignore-scripts.
Autenticação não está funcionando: Certifique-se de que seu navegador permite pop-ups e que você tem uma conta Qwen válida.

Para problemas persistentes, consulte o repositório oficial no GitHub: https://github.com/QwenLM/qwen-code.

Próximos Passos

Explore a interface interativa: Digite /help para ver os comandos slash disponíveis.
Experimente a codificação com agentes: Peça ao CLI para refatorar código, explicar arquivos ou automatizar tarefas usando linguagem natural.
Configure modelos: Use /model para selecionar o Qwen3-Coder ou outros backends suportados (incluindo Ollama local).
Integre com o VS Code: Instale a extensão Qwen Code Companion para uma integração perfeita com o editor.
Personalize configurações: Edite ~/.qwen/settings.json para temas, modelos padrão e opções avançadas.

Agora você está pronto para usar o Qwen Code CLI como um poderoso programador pareado de IA diretamente no seu terminal. Comece com prompts simples como "Explique este repositório de código" ou "Refatore esta função para melhor desempenho" dentro da pasta do seu projeto.

Feliz codificação!