Guia de início rápido

👏 Bem-vindo ao Qwen Code!

Este guia de início rápido fará você usar assistência de codificação com IA em apenas alguns minutos. Ao final, você entenderá como usar o Qwen Code para tarefas comuns de desenvolvimento.

Antes de começar

Certifique-se de ter:

Um terminal ou prompt de comando aberto
Um projeto de código para trabalhar
Uma chave de API do Alibaba Cloud ModelStudio (Beijing / intl ), ou uma assinatura do Alibaba Cloud Coding Plan (Beijing / intl )

Passo 1: Instalar o Qwen Code

Para instalar o Qwen Code, use um dos seguintes métodos:

Instalação rápida (Recomendado)

Linux / macOS


curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash

Windows


irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex

Note

É recomendado reiniciar o terminal após a instalação para garantir que as variáveis de ambiente entrem em vigor.

Instalação manual

Pré-requisitos

Certifique-se de ter o Node.js 22 ou superior instalado. Baixe-o em nodejs.org .

NPM


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

Homebrew (macOS, Linux)


brew install qwen-code

Passo 2: Configurar autenticação

Quando você iniciar uma sessão interativa com o comando qwen, será solicitado a configurar a autenticação:


# Você será solicitado a configurar a autenticação no primeiro uso
qwen


# Ou execute /auth a qualquer momento para alterar o método de autenticação
/auth

O menu de primeira execução permite conectar um provedor de modelo. Escolha um dos seguintes:

Alibaba ModelStudio — a configuração recomendada. Abre um submenu:
- Coding Plan: para desenvolvedores individuais, com uma cota semanal inclusa e diversas opções de modelos. Veja o guia do Coding Plan (intl ) para instruções de configuração.
- Token Plan: faturamento baseado em uso com um endpoint dedicado, voltado para equipes e empresas.
- Standard API Key: conecte-se com uma chave de API existente do Alibaba Cloud ModelStudio (Beijing / intl ). Veja o guia de configuração de API (Beijing / intl ) para detalhes.
Provedores de terceiros — escolha um provedor embutido (DeepSeek, MiniMax, Z.AI, ModelScope, OpenRouter, Requesty e outros) e conecte-se com uma chave de API.
Provedor personalizado — conecte manualmente um servidor local, proxy ou provedor não suportado.

⚠️ Nota: O Qwen OAuth foi descontinuado em 15 de abril de 2026. Se você estava usando o Qwen OAuth anteriormente, alterne para um dos métodos acima.

Note

Quando você autenticar o Qwen Code pela primeira vez com sua conta Qwen, um workspace chamado “.qwen” é criado automaticamente para você. Este workspace oferece rastreamento e gerenciamento centralizado de custos para todo o uso do Qwen Code em sua organização.

Tip

Para configurar a autenticação, inicie o Qwen Code e execute /auth. Use /doctor para verificar sua configuração atual a qualquer momento. Veja a página Autenticação para detalhes.

Passo 3: Iniciar sua primeira sessão

Abra seu terminal em qualquer diretório de projeto e inicie o Qwen Code:


# opcional
cd /caminho/para/seu/projeto
# inicia o qwen
qwen

Você verá a tela de boas-vindas do Qwen Code com informações da sessão, conversas recentes e últimas atualizações. Digite /help para comandos disponíveis.

Converse com o Qwen Code

Faça sua primeira pergunta

O Qwen Code analisará seus arquivos e fornecerá um resumo. Você também pode fazer perguntas mais específicas:


explique a estrutura de pastas

Você também pode perguntar ao Qwen Code sobre suas próprias capacidades:


o que o Qwen Code pode fazer?

Note

O Qwen Code lê seus arquivos conforme necessário — você não precisa adicionar contexto manualmente. O Qwen Code também tem acesso à sua própria documentação e pode responder perguntas sobre seus recursos e capacidades.

Faça sua primeira alteração de código

Agora vamos fazer o Qwen Code codificar de verdade. Tente uma tarefa simples:


adicione uma função hello world ao arquivo principal

O Qwen Code irá:

Encontrar o arquivo apropriado
Mostrar a você as alterações propostas
Pedir sua aprovação
Fazer a edição

Note

O Qwen Code sempre pede permissão antes de modificar arquivos. Você pode aprovar alterações individuais ou ativar o modo “Aceitar tudo” para uma sessão.

Use Git com o Qwen Code

O Qwen Code torna as operações Git conversacionais:


quais arquivos eu alterei?


commite minhas alterações com uma mensagem descritiva

Você também pode solicitar operações Git mais complexas:


crie uma nova branch chamada feature/quickstart


mostre os últimos 5 commits


ajude-me a resolver conflitos de merge

Corrigir um bug ou adicionar um recurso

O Qwen Code é proficiente em depuração e implementação de recursos.

Descreva o que você deseja em linguagem natural:


adicione validação de entrada ao formulário de registro de usuário

Ou corrija problemas existentes:


há um bug onde os usuários podem enviar formulários vazios — corrija isso

O Qwen Code irá:

Localizar o código relevante
Entender o contexto
Implementar uma solução
Executar testes se disponíveis

Teste outros fluxos de trabalho comuns

Há várias maneiras de trabalhar com o Qwen Code:

Refatorar código


refatore o módulo de autenticação para usar async/await em vez de callbacks

Escrever testes


escreva testes unitários para as funções da calculadora

Atualizar documentação


atualize o README com instruções de instalação

Revisão de código


revise minhas alterações e sugira melhorias

Tip

Lembre-se: O Qwen Code é seu programador parceiro de IA. Converse com ele como faria com um colega útil — descreva o que deseja alcançar, e ele o ajudará a chegar lá.

Comandos essenciais

Aqui estão os comandos mais importantes para uso diário:

Comando	O que faz	Exemplo
`qwen`	iniciar o Qwen Code	`qwen`
`/auth`	Alterar método de autenticação (na sessão)	`/auth`
`/doctor`	Verificar autenticação e ambiente atuais	`/doctor`
`/help`	Exibir ajuda para comandos disponíveis	`/help` ou `/?`
`/compress`	Substituir histórico de chat por resumo para economizar Tokens	`/compress`
`/clear`	Limpar conteúdo da tela do terminal	`/clear` (atalho: `Ctrl+L`)
`/theme`	Alterar tema visual do Qwen Code	`/theme`
`/language`	Visualizar ou alterar configurações de idioma	`/language`
→ `ui [idioma]`	Definir idioma da interface	`/language ui zh-CN`
→ `output [idioma]`	Definir idioma de saída do LLM	`/language output Chinese`
`/quit`	Sair do Qwen Code imediatamente	`/quit` ou `/exit`

Veja a referência da CLI para uma lista completa de comandos.

Dicas profissionais para iniciantes

Seja específico em suas solicitações

Em vez de: “corrigir o bug”
Tente: “corrigir o bug de login onde os usuários veem uma tela em branco após inserir credenciais erradas”

Use instruções passo a passo

Divida tarefas complexas em etapas:


1. criar uma nova tabela de banco de dados para perfis de usuário
2. criar um endpoint de API para obter e atualizar perfis de usuário
3. construir uma página web que permita aos usuários ver e editar suas informações

Deixe o Qwen Code explorar primeiro

Antes de fazer alterações, deixe o Qwen Code entender seu código:


analise o esquema do banco de dados


crie um dashboard mostrando produtos que são mais frequentemente devolvidos por nossos clientes no Reino Unido

Economize tempo com atalhos

Pressione ? para ver todos os atalhos de teclado disponíveis
Use Tab para completar comandos
Pressione ↑ para histórico de comandos
Digite / para ver todos os comandos de barra

Obtendo ajuda

No Qwen Code: Digite /help ou pergunte “como faço para…”
Documentação: Você está aqui! Navegue por outros guias
Comunidade: Junte-se à nossa Discussão no GitHub para dicas e suporte