Skip to Content
Guia do UsuárioInício rápido

Início rápido

👏 Bem-vindo ao Qwen Code!

Este guia de início rápido fará com que você utilize 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 conta Qwen Code 

Passo 1: Instale o Qwen Code

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

NPM (recomendado)

Requer Node.js 20+ , você pode usar node -v para verificar a versão. Se não estiver instalado, utilize o seguinte comando para instalá-lo.

Se você já tem o Node.js ou uma versão mais recente instalada :

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

Homebrew (macOS, Linux)

brew install qwen-code

Passo 2: Faça login na sua conta

O Qwen Code requer uma conta para ser utilizado. Quando você iniciar uma sessão interativa com o comando qwen, será necessário fazer login:

 
# Você será solicitado a fazer login na primeira utilização
qwen
 
# Siga as instruções para fazer login com sua conta
/auth

Selecione Qwen OAuth, faça login em sua conta e siga as instruções para confirmar. Após o login, suas credenciais serão armazenadas e você não precisará fazer login novamente.

Note

Quando você autenticar pela primeira vez o Qwen Code com sua conta Qwen, um espaço de trabalho chamado “.qwen” é criado automaticamente para você. Este espaço de trabalho fornece rastreamento centralizado de custos e gerenciamento para todos os usos do Qwen Code em sua organização.

Tip

Se você precisar fazer login novamente ou trocar de conta, utilize o comando /auth dentro do Qwen Code.

Passo 3: Inicie sua primeira sessão

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

 
# opcional
cd /caminho/para/seu/projeto
 
# iniciar qwen
qwen

Você verá a tela de boas-vindas do Qwen Code com as informações da sua sessão, conversas recentes e últimas atualizações. Digite /help para ver os 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 à 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 com que o Qwen Code realize alguma codificação real. Tente uma tarefa simples:

adicione uma função hello world ao arquivo principal

O Qwen Code irá:

  1. Encontrar o arquivo apropriado
  2. Mostrar as alterações propostas
  3. Solicitar sua aprovação
  4. Fazer a edição
Note

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

Use Git com Qwen Code

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

quais arquivos eu mudei?
faça commit das minhas alterações com uma mensagem descritiva

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

crie um novo branch chamado feature/quickstart
mostre os últimos 5 commits
ajude-me a resolver conflitos de merge

Corrigir um bug ou adicionar uma funcionalidade

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

Descreva o que você deseja em linguagem natural:

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

Ou corrija problemas existentes:

existe um bug onde os usuários podem enviar formulários vazios - corrija isso

O Qwen Code irá:

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

Experimente outros fluxos de trabalho comuns

Existem 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. Fale com ele como faria com um colega útil - descreva o que deseja alcançar, e ele ajudará você a chegar lá.

Comandos essenciais

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

ComandoO que fazExemplo
qweniniciar o Qwen Codeqwen
/authAlterar método de autenticação/auth
/helpExibir informações de ajuda para comandos disponíveis/help ou /?
/compressSubstituir histórico de conversa por resumo para economizar Tokens/compress
/clearLimpar conteúdo da tela do terminal/clear (atalho: Ctrl+L)
/themeAlterar tema visual do Qwen Code/theme
/languageVisualizar ou alterar configurações de idioma/language
→ ui [idioma]Definir idioma da interface do usuário/language ui pt-BR
→ output [idioma]Definir idioma de saída do LLM/language output Portuguese
/quitSair imediatamente do Qwen Code/quit ou /exit

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

Dicas profissionais para iniciantes

Seja específico com 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. crie uma nova tabela de banco de dados para perfis de usuário
2. crie um endpoint de API para obter e atualizar perfis de usuário
3. construa uma página da 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 painel mostrando produtos que são mais frequentemente devolvidos por nossos clientes do Reino Unido

Economize tempo com atalhos

  • Pressione ? para ver todos os atalhos de teclado disponíveis
  • Use Tab para preenchimento automático de comandos
  • Pressione ↑ para histórico de comandos
  • Digite / para ver todos os comandos com barra

Obtendo ajuda

  • No Qwen Code: Digite /help ou pergunte “como faço…”
  • Documentação: Você está aqui! Navegue por outros guias
  • Comunidade: Junte-se ao nosso GitHub Discussion  para dicas e suporte
Last updated on
Visão geralFluxos de comando comuns