O Qwen Code é uma ferramenta de codificação com IA baseada em terminal que se conecta ao Alibaba Cloud Model Studio por meio das modalidades pagamento conforme o uso, Coding Plan, Token Plan (Personal Edition) ou Token Plan (Team Edition).
Cenários comuns
O Qwen Code oferece suporte aos seguintes cenários:
- Codificação assistida por IA: gere, complete e revise código diretamente do terminal usando linguagem natural para acelerar o desenvolvimento diário.
- Desenvolvimento web: forneça uma captura de tela do site desejado e o Qwen Code analisará a estrutura da página para gerar código front-end de alta fidelidade.
- Produção de vídeo: a partir da URL de um repositório open-source, gere um vídeo promocional dedicado em uma única etapa.
Instale o Qwen Code
-
Execute o comando de instalação
- macOS/Linux: Abra um terminal e execute o comando a seguir para instalar o Qwen Code.
-
Windows:
Digite
cmdna caixa de pesquisa da barra de tarefas, selecione Run as administrator e execute o comando a seguir na janela docmdpara instalar o Qwen Code.
-
Feche e reabra a janela docmd
No Windows, após concluir a instalação, feche a janela atual do
cmdpara aplicar as variáveis de ambiente. Reabra ocmde execute o comando a seguir para verificar a versão instalada.
Configure credenciais de acesso
Inicie o Qwen Code e digite /auth para acessar a configuração visual. O Alibaba Cloud Model Studio oferece os seguintes planos de faturamento. Escolha conforme sua necessidade:
- Token Plan (Personal Edition): deduz créditos pessoais com base no consumo de tokens.
- Token Plan (Team Edition): assinatura por seat, com o consumo de tokens deduzido dos créditos.
- Coding Plan: assinatura mensal fixa, medida pela quantidade de invocações do modelo.
- Pagamento conforme o uso: pós-pago com base no uso real.
Token Plan (Personal Edition)
Edite ou crie um arquivo settings.json e substitua YOUR_API_KEY pela sua API Key dedicada do Token Plan (Personal Edition). Os modelos disponíveis incluem qwen3.8-max, qwen3.7-max, qwen3.7-plus, qwen3.6-flash, glm-5.2, deepseek-v4-pro, deepseek-v4-pro-0813 e deepseek-v4-flash-0731. Para a lista completa, consulte Token Plan (Personal Edition) supported models. O caminho do arquivo é o seguinte:
- macOS/Linux:
~/.qwen/settings.json - Windows:
C:\Users\<Username>\.qwen\settings.json
Token Plan (Team Edition)
Inicie o Qwen Code e digite /auth, selecione Subscription Plan > Alibaba Cloud Model Studio Token Plan e insira a API Key dedicada do Token Plan (Team Edition) para concluir a configuração. Para ver os modelos disponíveis, consulte Token Plan (Team Edition) supported models.
Configuração avançada: via settings.json
Configuração avançada: via settings.json
settings.json e substitua YOUR_API_KEY pela sua API Key dedicada do Token Plan (Team Edition). O caminho do arquivo é o seguinte:- macOS/Linux:
~/.qwen/settings.json - Windows:
C:\Users\<Windows username>\.qwen\settings.json
Coding Plan
Inicie o Qwen Code e digite /auth, selecione Subscription Plan > Alibaba Cloud Model Studio Coding Plan, escolha a região do Coding Plan (global) e insira a API Key dedicada do Coding Plan para concluir a configuração. Para ver os modelos disponíveis, consulte Coding Plan supported models.
Configuração avançada: via settings.json
Configuração avançada: via settings.json
settings.json e substitua YOUR_API_KEY pela sua API Key dedicada do Coding Plan. O caminho do arquivo é o seguinte:- macOS/Linux:
~/.qwen/settings.json - Windows:
C:\Users\<Windows username>\.qwen\settings.json
Pagamento conforme o uso
Inicie o Qwen Code e digite /auth, selecione Use your own API Key > Standard API Key, escolha a região e insira a Alibaba Cloud Model Studio API Key para concluir a configuração. Para ver os modelos disponíveis, consulte OpenAI-compatible - Supported Models.
Configuração avançada: via settings.json
Configuração avançada: via settings.json
settings.json e substitua YOUR_API_KEY pela sua API Key do Alibaba Cloud Model Studio. O caminho do arquivo é o seguinte:- macOS/Linux:
~/.qwen/settings.json - Windows:
C:\Users\<Windows username>\.qwen\settings.json
baseUrl de acordo com a região. A API Key deve corresponder à região selecionada; substitua {WorkspaceId} na URL pelo seu Workspace ID real:- China(Beijing):
https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1 - Singapore:
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 - US (Virginia):
https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/compatible-mode/v1
modelProviders.openai.Verifique a configuração
Após concluir a configuração, execute o comando a seguir no diretório do seu projeto para iniciar o Qwen Code e começar uma conversa.
Plugins do Qwen Code para IDE
O Qwen Code pode ser usado como plugin no VS Code e em IDEs JetBrains, oferecendo recursos de codificação com IA diretamente na IDE.
VS Code
Certifique-se de que a versão do seu VS Code seja 1.85.0 ou superior antes de prosseguir.
- Abra o VS Code, pesquise por
Qwen Code Companionno Extensions Marketplace e instale-o. - O CLI e o plugin da IDE compartilham o mesmo arquivo
settings.json. Se você já concluiu a configuração acima, pule esta etapa. Caso contrário, siga a seção Configurar credenciais de acesso acima. - Clique em no ícone no canto superior direito para iniciar o Qwen Code. Digite ou clique em
/e selecioneSwitch modelpara alternar entre modelos.
JetBrains IDE
Verifique se a sua IDE JetBrains suporta o Agent Client Protocol (ACP) antes de prosseguir.
- O Qwen Code IDE depende do Qwen Code CLI. Primeiro, siga a seção Instalar o Qwen Code neste documento para instalar e concluir a Configuração de credenciais de acesso.
- Abra a IDE JetBrains, acesse a página AI Chat e clique em Install Plugin. O IDEA instalará o plugin JetBrains AI Assistant.
-
Clique em no menu de três pontos no canto superior direito da janela AI Chat, selecione Add Custom Agent e preencha a configuração a seguir. Substitua
/path/to/qwenpelo caminho de instalação do Qwen Code. Execute o comando a seguir para localizar o caminho:- macOS/Linux:
which qwen - Windows:
where qwen(CMD) ouGet-Command qwen(PowerShell)
- macOS/Linux:
- Após a configuração, o Qwen Code aparecerá no painel AI Chat. É possível alternar modelos no canto inferior direito.
Qwen Code Desktop
O Qwen Code Desktop é a aplicação GUI do Qwen Code com runtime CLI integrado, eliminando a necessidade de instalar ferramentas de linha de comando adicionais. A versão desktop compartilha o mesmo arquivo de configuração settings.json com o CLI. Se você já concluiu a configuração via CLI, a versão desktop estará pronta para uso sem etapas adicionais.
Caso ainda não tenha configurado, faça isso pela interface gráfica do desktop:
- Abra o Qwen Code Desktop, clique em Settings na barra lateral esquerda e selecione a aba AI.
- Na seção Model Provider, clique em + Connect.
-
Na janela pop-up, selecione a aba Alibaba ModelStudio e escolha o plano de faturamento adequado às suas necessidades:
- Coding Plan: para desenvolvedores individuais, medido por invocações.
- Token Plan: para equipes, faturado pelo consumo de tokens.
- Standard API Key: pagamento conforme o uso com uma API Key existente do ModelStudio.
- Insira a API Key conforme solicitado para concluir a configuração.
Comandos comuns
Comando | Descrição | Exemplo |
|---|---|---|
| Alterna o modelo usado na sessão atual. |
|
| Altera o método de autenticação. |
|
| Analisa o diretório atual e cria um arquivo de contexto inicial (QWEN.md) para definir instruções e contexto no nível do projeto. |
|
| Limpa a tela do terminal e inicia uma nova conversa. |
|
| Substitui o histórico de chat por um resumo para economizar tokens. |
|
| Abre o editor de configurações para ajustar idioma, tema e outras opções. |
|
| Gera um resumo do projeto com base no histórico de conversas. |
|
| Retoma uma sessão de conversa anterior. |
|
| Exibe estatísticas detalhadas da sessão atual. |
|
| Mostra informações de ajuda sobre os comandos disponíveis. |
|
| Encerra o Qwen Code. |
|
Saiba mais
- Para recursos avançados como sub-agentes, MCP e Skills no Qwen Code, consulte a documentação oficial do Qwen Code.
- Para casos de uso do Qwen Code, consulte Casos de uso.
FAQ
Códigos de erro
Se encontrar erros durante a configuração, consulte a documentação de FAQ correspondente ao seu plano de faturamento:
- Pagamento conforme o uso: Error codes
- Coding Plan: Coding Plan FAQ
- Token Plan (Personal Edition): Token Plan FAQ
- Token Plan (Team Edition): Token Plan (Team Edition) FAQ
Como alternar modelos?
Digite o comando /model diretamente no Qwen Code para selecionar e alternar entre os modelos configurados no arquivo settings.json. Para adicionar um novo modelo, inclua a configuração correspondente na seção settings.json dentro de modelProviders e reinicie o Qwen Code.