Qwen Code - Alibaba Cloud Model Studio: Central de Documentação do Alibaba Cloud

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 abaixo 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 do cmd

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 configurar visualmente. O Alibaba Cloud Model Studio oferece três planos de faturamento. Escolha conforme sua necessidade:

Token Plan (Team Edition): Assinatura por usuário, com consumo de tokens deduzido dos Créditos.
Coding Plan: Assinatura mensal fixa, mensurada pela quantidade de invocações do modelo.
Pagamento conforme o uso: Pós-pago com base no uso real.

Token Plan (Team Edition)

Inicie o Qwen Code, 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 consultar os modelos disponíveis, veja os modelos compatíveis do Token Plan (Team Edition).

Configuração avançada: via settings.json

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

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.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-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-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-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.7-plus"
  },
  "$version": 3
}

Coding Plan

Inicie o Qwen Code, 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 consultar os modelos disponíveis, veja os modelos compatíveis do Coding Plan.

Configuração avançada: via settings.json

Edite ou crie um arquivo settings.json e substitua YOUR_API_KEY pela sua API Key dedicada do Coding Plan. O caminho do arquivo é:

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, digite /auth, selecione Use your own API Key > Standard API Key, escolha a região e insira a API Key do Alibaba Cloud Model Studio para concluir a configuração. Para consultar os modelos disponíveis, veja a seção Compatível com OpenAI - Modelos suportados.

Configuração avançada: via settings.json

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

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:

China North 2 (Beijing): https://dashscope.aliyuncs.com/compatible-mode/v1
Singapura: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1. Substitua WorkspaceId pelo seu ID do Workspace real.
EUA (Virgínia): https://dashscope-us.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 outros modelos, 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 de IDE do Qwen Code

O Qwen Code funciona como plugin no VS Code e em IDEs JetBrains, oferecendo recursos de codificação com IA diretamente no ambiente de desenvolvimento.

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 Companion no Marketplace de Extensões e instale-o.
A CLI e o plugin de IDE compartilham o mesmo arquivo settings.json. Caso já tenha concluído a configuração acima, pule esta etapa. Caso contrário, siga a seção Configure credenciais de acesso acima.
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 o seu JetBrains IDE suporta o Agent Client Protocol (ACP) antes de utilizar.

O plugin de IDE do Qwen Code depende da CLI do Qwen Code. Primeiro, siga a seção Instale o Qwen Code neste documento para instalar e concluir a Configuração das credenciais de acesso.
Abra o JetBrains IDE, 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/qwen pelo caminho de instalação do Qwen Code. Execute o comando abaixo 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": {}
    }
  }
}
```
Após a configuração, o Qwen Code aparecerá no painel AI Chat. É possível alternar os modelos no canto inferior direito.

Comandos comuns

Nota

Os comandos a seguir aplicam-se à CLI do Qwen Code. O plugin de IDE suporta apenas alguns desses comandos. Consulte o comportamento real durante o uso.

Comando	Descrição	Exemplo
`/model`	Alterna o modelo utilizado na sessão atual.	`/model`
`/auth`	Modifica 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, entre outros.	`/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

Para recursos avançados como sub-agentes, MCP e Skills no Qwen Code, consulte a documentação oficial do Qwen Code.
Para explorar casos de uso do Qwen Code, veja Casos de uso.

Perguntas frequentes

Códigos de erro

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

Pagamento conforme o uso: Códigos de erro
Coding Plan: Perguntas frequentes do Coding Plan
Token Plan (Team Edition): Perguntas frequentes do Token Plan (Team Edition)

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.