# Como Instalar o Qwen Code CLI: Tutorial Passo a Passo para o Agente de Codificação IA no Terminal

Aprenda como instalar o Qwen Code CLI, o agente de codificação IA de código aberto para o seu terminal. Instruções passo a passo para npm, script de instalação rápida, Homebrew e solução de problemas no Windows, macOS e Linux.

Canonical URL: https://a2a-mcp.org/blog/qwen-cli-install-pt

Language: pt

Published: 2026-04-07

Updated: 2026-04-07

## 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](https://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**:

```bash
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
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)**:

```cmd
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:

```bash
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):

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

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

```bash
brew install qwen-code
```

## Passo 4: Verifique a Instalação

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

```bash
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:

```bash
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:

```bash
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:

```bash
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!