Skip to main content
Clientes e Ferramentas de Desenvolvedor

Qwen Code

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.
bash -c "$(curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.sh)" -s --source bailian
  • Windows: Digite cmd na caixa de pesquisa da barra de tarefas, selecione Run as administrator e execute o comando a seguir na janela do cmd para instalar o Qwen Code.
curl -fsSL -o %TEMP%\install-qwen.bat https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.bat && %TEMP%\install-qwen.bat --source bailian
  • Feche e reabra a janela docmd No Windows, após concluir a instalação, feche a janela atual do cmd para aplicar as variáveis de ambiente. Reabra o cmd e execute o comando a seguir para verificar a versão instalada.
qwen --version

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
{
  "env": {
    "BAILIAN_TOKEN_PLAN_API_KEY": "YOUR_API_KEY"
  },
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.8-max",
        "name": "[Token Plan Personal] qwen3.8-max",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },      {
        "id": "qwen3.7-max",
        "name": "[Token Plan Personal] qwen3.7-max",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "qwen3.7-plus",
        "name": "[Token Plan Personal] qwen3.7-plus",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "qwen3.6-flash",
        "name": "[Token Plan Personal] qwen3.6-flash",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "glm-5.2",
        "name": "[Token Plan Personal] glm-5.2",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      },
      {
        "id": "deepseek-v4.1-flash",
        "name": "[Token Plan Personal] deepseek-v4.1-flash",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      },
      {
        "id": "deepseek-v4-pro",
        "name": "[Token Plan Personal] deepseek-v4-pro",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      },
      {
        "id": "deepseek-v4-pro-0813",
        "name": "[Token Plan Personal] deepseek-v4-pro-0813",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      },
      {
        "id": "deepseek-v4-flash-0731",
        "name": "[Token Plan Personal] deepseek-v4-flash-0731",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      },

    ]
  }
}

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.
Edite ou crie um arquivo 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
{
  "env": {
    "BAILIAN_TOKEN_PLAN_API_KEY": "YOUR_API_KEY"
  },
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.8-max",
        "name": "[Token Plan Team Edition] qwen3.8-max",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },      {
        "id": "qwen3.7-max",
        "name": "[Token Plan Team Edition] qwen3.7-max",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "qwen3.7-plus",
        "name": "[Token Plan Team Edition] qwen3.7-plus",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "qwen3.6-plus",
        "name": "[Token Plan Team Edition] qwen3.6-plus",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "qwen3.6-flash",
        "name": "[Token Plan Team Edition] qwen3.6-flash",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "deepseek-v4.1-flash",
        "name": "[Token Plan Team Edition] deepseek-v4.1-flash",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      },
      {
        "id": "deepseek-v4-pro",
        "name": "[Token Plan Team Edition] deepseek-v4-pro",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      },
      {
        "id": "deepseek-v4-pro-0813",
        "name": "[Token Plan Team Edition] deepseek-v4-pro-0813",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      },
      {
        "id": "deepseek-v4-flash",
        "name": "[Token Plan Team Edition] deepseek-v4-flash",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      },
      {
        "id": "deepseek-v4-flash-0731",
        "name": "[Token Plan Team Edition] deepseek-v4-flash-0731",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      },
      {
        "id": "deepseek-v3.2",
        "name": "[Token Plan Team Edition] deepseek-v3.2",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      },

      {
        "id": "kimi-k2.7-code",
        "name": "[Token Plan Team Edition] kimi-k2.7-code",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "kimi-k2.6",
        "name": "[Token Plan Team Edition] kimi-k2.6",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "kimi-k2.5",
        "name": "[Token Plan Team Edition] kimi-k2.5",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "glm-5.2",
        "name": "[Token Plan Team Edition] glm-5.2",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "glm-5.1",
        "name": "[Token Plan Team Edition] glm-5.1",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "glm-5",
        "name": "[Token Plan Team Edition] glm-5",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "MiniMax-M2.5",
        "name": "[Token Plan Team Edition] MiniMax-M2.5",
        "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "tokenPlan": {
    "region": "global"
  },
  "model": {
    "name": "qwen3.8-max"
  },
  "$version": 3
}

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.
Edite ou crie um arquivo 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
{
  "env": {
    "BAILIAN_CODING_PLAN_API_KEY": "YOUR_API_KEY"
  },
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.7-plus",
        "name": "[Bailian Coding Plan] qwen3.7-plus",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "qwen3.6-plus",
        "name": "[Bailian Coding Plan] qwen3.6-plus",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "qwen3.5-plus",
        "name": "[Bailian Coding Plan] qwen3.5-plus",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "qwen3-max-2026-01-23",
        "name": "[Bailian Coding Plan] qwen3-max-2026-01-23",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY"
      },
      {
        "id": "qwen3-coder-next",
        "name": "[Bailian Coding Plan] qwen3-coder-next",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY"
      },
      {
        "id": "qwen3-coder-plus",
        "name": "[Bailian Coding Plan] qwen3-coder-plus",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY"
      },
      {
        "id": "MiniMax-M2.5",
        "name": "[Bailian Coding Plan] MiniMax-M2.5",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY"
      },
      {
        "id": "glm-5",
        "name": "[Bailian Coding Plan] glm-5",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "glm-4.7",
        "name": "[Bailian Coding Plan] glm-4.7",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY"
      },
      {
        "id": "kimi-k2.5",
        "name": "[Bailian Coding Plan] kimi-k2.5",
        "baseUrl": "https://coding-intl.dashscope.aliyuncs.com/v1",
        "envKey": "BAILIAN_CODING_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "codingPlan": {
    "region": "global"
  },
  "model": {
    "name": "qwen3.7-plus"
  },
  "$version": 3
}

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.
Edite ou crie um arquivo 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
Defina o 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
{
  "env": {
    "BAILIAN_API_KEY": "YOUR_API_KEY"
  },
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.6-plus",
        "name": "[Bailian] qwen3.6-plus",
        "baseUrl": "https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
        "envKey": "BAILIAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3.6-plus"
  },
  "$version": 3
}
Para adicionar other models, acrescente-os no mesmo formato dentro de 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.
qwen

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.
  1. Abra o VS Code, pesquise por Qwen Code Companion no Extensions Marketplace e instale-o.
  2. 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.
  3. Clique em no ícone no canto superior direito para iniciar o Qwen Code. Digite ou clique em / e selecione Switch model para alternar entre modelos.

JetBrains IDE

Verifique se a sua IDE JetBrains suporta o Agent Client Protocol (ACP) antes de prosseguir.
  1. 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.
  2. Abra a IDE JetBrains, acesse a página AI Chat e clique em Install Plugin. O IDEA instalará o plugin JetBrains AI Assistant.
  3. 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/qwen pelo caminho de instalação do Qwen Code. Execute o comando a seguir para localizar o caminho:
    • macOS/Linux: which qwen
    • Windows: where qwen (CMD) ou Get-Command qwen (PowerShell)
{
  "agent_servers": {
    "qwen": {
      "command": "/path/to/qwen",
      "args": ["--acp"],
      "env": {}
    }
  }
}
  1. 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:
  1. Abra o Qwen Code Desktop, clique em Settings na barra lateral esquerda e selecione a aba AI.
  2. Na seção Model Provider, clique em + Connect.
  3. 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.
  4. Insira a API Key conforme solicitado para concluir a configuração.

Comandos comuns

Os comandos a seguir aplicam-se ao Qwen Code CLI. O plugin da IDE suporta apenas alguns desses comandos. Consulte o uso real na prática.

Comando

Descrição

Exemplo

/model

Alterna o modelo usado na sessão atual.

/model

/auth

Altera o método de autenticação.

/auth

/init

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.

/init

/clear

Limpa a tela do terminal e inicia uma nova conversa.

/clear

/compress

Substitui o histórico de chat por um resumo para economizar tokens.

/compress

/settings

Abre o editor de configurações para ajustar idioma, tema e outras opções.

/settings

/summary

Gera um resumo do projeto com base no histórico de conversas.

/summary

/resume

Retoma uma sessão de conversa anterior.

/resume

/stats

Exibe estatísticas detalhadas da sessão atual.

/stats

/help

Mostra informações de ajuda sobre os comandos disponíveis.

/help ou /?

/quit

Encerra o Qwen Code.

/quit

Para conhecer recursos mais avançados do Qwen Code, consulte a documentação oficial do Qwen Code.

Saiba mais

FAQ

Códigos de erro

Se encontrar erros durante a configuração, consulte a documentação de FAQ correspondente ao seu plano de faturamento:

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.
Plano de Tokens
Playground de Modelos
  • Music generation
Inferência do Modelo
Avaliação
Compressão de Modelos
Estatísticas e Monitoramento
Suporte