Início rápido

👏 Bem-vindo ao Qwen Code!

Este guia de início rápido permitirá que você use a assistência de programaçã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 API key do Alibaba Cloud Model Studio (Beijing / intl ) ou uma assinatura do Alibaba Cloud Coding Plan (Beijing / intl )

Etapa 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.sh | bash

Windows (Executar como Administrador)


powershell -Command "Invoke-WebRequest 'https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.bat' -OutFile (Join-Path $env:TEMP 'install-qwen.bat'); & (Join-Path $env:TEMP 'install-qwen.bat')"

Note

Recomenda-se 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 20 ou superior instalado. Baixe-o em nodejs.org .

NPM


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

Homebrew (macOS, Linux)


brew install qwen-code

Etapa 2: Configurar a autenticação

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


# You'll be prompted to set up authentication on first use
qwen


# Or run /auth anytime to change authentication method
/auth

Escolha seu método de autenticação preferido:

Alibaba Cloud Coding Plan: Selecione Alibaba Cloud Coding Plan para uma taxa mensal fixa com diversas opções de modelos. Consulte o guia do Coding Plan (intl ) para instruções de configuração.
API Key: Selecione API Key e insira sua API key do Alibaba Cloud Model Studio (Beijing / intl ). Consulte o guia de configuração da API (Beijing / intl ) para mais detalhes.

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

Note

Na primeira vez que você autenticar o Qwen Code com sua conta Qwen, um workspace chamado “.qwen” será criado automaticamente para você. Esse workspace oferece rastreamento e gerenciamento centralizados de custos para todo o uso do Qwen Code na sua organização.

Tip

Você também pode configurar a autenticação diretamente pelo terminal, sem iniciar uma sessão, executando qwen auth. Use qwen auth status para verificar sua configuração atual a qualquer momento. Consulte a página Autenticação para mais detalhes.

Etapa 3: Iniciar sua primeira sessão

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


# optiona
cd /path/to/your/project
# start qwen
qwen

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

Conversar 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:


explain the folder structure

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


what can Qwen Code do?

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 a perguntas sobre seus recursos e capacidades.

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

Agora, vamos fazer o Qwen Code escrever código de verdade. Tente uma tarefa simples:


add a hello world function to the main file

O Qwen Code irá:

Encontrar o arquivo adequado
Mostrar as alterações propostas
Solicitar sua aprovação
Aplicar a edição

Note

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

Usar Git com o Qwen Code

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


what files have I changed?


commit my changes with a descriptive message

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


create a new branch called feature/quickstart


show me the last 5 commits


help me resolve merge conflicts

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:


add input validation to the user registration form

Ou corrija problemas existentes:


there's a bug where users can submit empty forms - fix it

O Qwen Code irá:

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

Testar outros fluxos de trabalho comuns

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

Refatorar código


refactor the authentication module to use async/await instead of callbacks

Escrever testes


write unit tests for the calculator functions

Atualizar documentação


update the README with installation instructions

Revisão de código


review my changes and suggest improvements

Tip

Lembre-se: O Qwen Code é seu pair programmer com IA. Converse com ele como faria com um colega prestativo - descreva o que deseja alcançar e ele ajudará você a chegar lá.

Comandos essenciais

Aqui estão os comandos mais importantes para o 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`
`qwen auth`	Configurar autenticação pelo terminal	`qwen auth`
`qwen auth api-key`	Configurar autenticação por API key	`qwen auth api-key`
`qwen auth status`	Verificar status atual da autenticação	`qwen auth status`
`/help`	Exibir informações de 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 [language]`	Definir idioma da interface	`/language ui zh-CN`
→ `output [language]`	Definir idioma de saída do LLM	`/language output Chinese`
`/quit`	Sair do Qwen Code imediatamente	`/quit` ou `/exit`

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

Dicas avançadas para iniciantes

Seja específico nas suas solicitações

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

Use instruções passo a passo

Divida tarefas complexas em etapas:


1. create a new database table for user profiles
2. create an API endpoint to get and update user profiles
3. build a webpage that allows users to see and edit their information

Deixe o Qwen Code explorar primeiro

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


analyze the database schema


build a dashboard showing products that are most frequently returned by our UK customers

Economize tempo com atalhos

Pressione ? para ver todos os atalhos de teclado disponíveis
Use Tab para autocompletar comandos
Pressione ↑ para acessar o histórico de comandos
Digite / para ver todos os slash commands

Obter ajuda

No Qwen Code: Digite /help ou pergunte “como faço para…”
Documentação: Você está aqui! Navegue por outros guias
Comunidade: Participe do nosso GitHub Discussion para dicas e suporte