Tradução de apoio para consulta. Código e identificadores técnicos preservados. Consultar referência original ↗

Qwen Code

Ferramenta oficial de codificação de IA baseada em terminal

Conecte-o a QwenCloud via Token Plan (Personal Edition), Token Plan (Team Edition) ou faturamento pré-pago.

Cenários comuns

Qwen O código oferece suporte aos seguintes cenários:

Codificação assistida por IA: gere, complete e revise código no terminal usando linguagem natural para acelerar o desenvolvimento diário.
Desenvolvimento Web: forneça uma captura de tela de um site de destino e Qwen O código analisa a estrutura da página para gerar código front-end de alta fidelidade.
Produção de vídeo: com um URL de repositório de código aberto, gere um vídeo promocional dedicado em uma única etapa.

Instalar Qwen Code

macOS/Linux

Abra um terminal e execute o seguinte comando para instalar Qwen Código.

```bash
bash -c "$(curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.sh)" -s --source bailian
```

Windows

Tipo `cmd` na caixa de pesquisa da barra de tarefas, selecione **Executar como administrador** e execute o seguinte comando no `cmd` janela para instalar Qwen Código.

```sh
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
```

No Windows, após a conclusão da instalação, feche o atual `cmd` janela para aplicar as variáveis de ambiente. Reabrir `cmd` e execute o seguinte comando para verificar a versão instalada.

```bash
qwen --version
```

Configurar credenciais de acesso

Lançamento Qwen Code e tipo /auth para configuração visual. QwenCloud oferece os seguintes planos de faturamento. Escolha com base em suas necessidades:

Plano de Token (Edição Pessoal): Deduz Créditos pessoais com base no consumo de token.
Token Plan (Team Edition): Assinatura por assento, com consumo de token deduzido dos Créditos.
Pague conforme o uso: pós-pago com base no uso real.

Plano de token (edição pessoal)

Edite ou crie um settings.json arquivar e substituir YOUR_API_KEY com seu Token Plan (Personal Edition) dedicado API Key. Os modelos disponíveis incluem qwen3.8-max, qwen3.8-flash, qwen3.7-max, qwen3.7-plus, qwen3.6-flash, glm-5.3, glm-5.2, deepseek-v4-pro, deepseek-v4-pro-0813e deepseek-v4-flash-0731. Para obter a lista completa, consulte Token Plan (Personal Edition) modelos suportados. O caminho do arquivo é o seguinte:

macOS/Linux: ~/.qwen/settings.json
Janelas: C:\Users\<Username>\.qwen\settings.json

{
  "env": {
    "BAILIAN_TOKEN_PLAN_API_KEY": "YOUR_API_KEY"
  },
  "modelProviders": {
    "openai": [
      {
        "id": "auto",
        "name": "[Token Plan Personal] auto",
        "baseUrl": "https://token-plan.maas.qwencloudapi.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      },
      {
        "id": "qwen3.8-max",
        "name": "[Token Plan Personal] qwen3.8-max",
        "baseUrl": "https://token-plan.maas.qwencloudapi.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "qwen3.8-flash",
        "name": "[Token Plan Personal] qwen3.8-flash",
        "baseUrl": "https://token-plan.maas.qwencloudapi.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.maas.qwencloudapi.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.maas.qwencloudapi.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.maas.qwencloudapi.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "glm-5.3",
        "name": "[Token Plan Personal] glm-5.3",
        "baseUrl": "https://token-plan.maas.qwencloudapi.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      },
      {
        "id": "glm-5.2",
        "name": "[Token Plan Personal] glm-5.2",
        "baseUrl": "https://token-plan.maas.qwencloudapi.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.maas.qwencloudapi.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.maas.qwencloudapi.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.maas.qwencloudapi.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.maas.qwencloudapi.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "tokenPlan": {
    "region": "global"
  },
  "model": {
    "name": "auto"
  },
  "$version": 3
}

**qwen3.8-max modo de pensamento **:

pensando: Suporta habilitado e desabilitado (modo de pensamento híbrido).
temperatura: o padrão é 0,6 no modo de pensamento. Valores abaixo de 0,6 são ajustados automaticamente para 0,6.
reasoning_effort: Controla a profundidade do raciocínio. Opções: xalto, médio, baixo. Padrão: xalto.

Plano de Token (Edição de Equipe)

Lançamento Qwen Code e tipo /auth, selecione Plano de assinatura > Plano de token do Alibaba Cloud Model Studio e insira o Plano de token (Team Edition) dedicado Chave de API para concluir a configuração. Para modelos disponíveis, consulte Token Plan (Team Edition) modelos suportados.

Advanced configuration: via settings.json

Edite ou crie um settings.json arquivar e substituir YOUR_API_KEY com sua chave de API dedicada do Token Plan (Team Edition). O caminho do arquivo é o seguinte:

macOS/Linux: ~/.qwen/settings.json
Janelas: C:\Users\<Windows username>\.qwen\settings.json

{
  "env": {
    "BAILIAN_TOKEN_PLAN_API_KEY": "YOUR_API_KEY"
  },
  "modelProviders": {
    "openai": [
      {
        "id": "auto",
        "name": "[Token Plan Team Edition] auto",
        "baseUrl": "https://token-plan.maas.qwencloudapi.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      },
      {
        "id": "qwen3.8-max",
        "name": "[Token Plan Team Edition] qwen3.8-max",
        "baseUrl": "https://token-plan.maas.qwencloudapi.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "qwen3.8-flash",
        "name": "[Token Plan Team Edition] qwen3.8-flash",
        "baseUrl": "https://token-plan.maas.qwencloudapi.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.maas.qwencloudapi.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.maas.qwencloudapi.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.maas.qwencloudapi.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.maas.qwencloudapi.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.maas.qwencloudapi.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.maas.qwencloudapi.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.maas.qwencloudapi.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      },
      {
        "id": "deepseek-v4.1-flash",
        "name": "[Token Plan Team Edition] deepseek-v4.1-flash",
        "baseUrl": "https://token-plan.maas.qwencloudapi.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.maas.qwencloudapi.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.maas.qwencloudapi.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.maas.qwencloudapi.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      },
      {
        "id": "glm-5.3",
        "name": "[Token Plan Team Edition] glm-5.3",
        "baseUrl": "https://token-plan.maas.qwencloudapi.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.maas.qwencloudapi.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.maas.qwencloudapi.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.maas.qwencloudapi.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.maas.qwencloudapi.com/compatible-mode/v1",
        "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "tokenPlan": {
    "region": "global"
  },
  "model": {
    "name": "qwen3.7-plus"
  },
  "$version": 3
}

**qwen3.8-max modo de pensamento **:

pensando: Suporta habilitado e desabilitado (modo de pensamento híbrido).
temperatura: o padrão é 0,6 no modo de pensamento. Valores abaixo de 0,6 são ajustados automaticamente para 0,6.
reasoning_effort: Controla a profundidade do raciocínio. Opções: xalto, médio, baixo. Padrão: xalto.

Pague conforme o uso

Lançamento Qwen Code e tipo /auth, selecione Usar sua própria chave de API > Chave de API padrão, escolha a região e insira o QwenCloud Chave API para concluir a configuração. Para modelos disponíveis, consulte Compatível com OpenAI - Modelos suportados.

Advanced configuration: via settings.json

Edite ou crie um settings.json arquivar e substituir YOUR_API_KEY com o seu QwenCloud Chave de API. O caminho do arquivo é o seguinte:

macOS/Linux: ~/.qwen/settings.json
Janelas: C:\Users\<Windows username>\.qwen\settings.json

{
  "env": {
    "BAILIAN_API_KEY": "YOUR_API_KEY"
  },
  "modelProviders": {
    "openai": [
      {
        "id": "qwen3.7-plus",
        "name": "[QwenCloud] qwen3.7-plus",
        "baseUrl": "https://maas.qwencloudapi.com/compatible-mode/v1",
        "envKey": "BAILIAN_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3.7-plus"
  },
  "$version": 3
}

Para adicionar outros modelos, anexe-os no mesmo formato dentro modelProviders.openai.

Verifique a configuração

Após a conclusão da configuração, execute o seguinte comando no diretório do projeto para iniciar Qwen Codifique e inicie uma conversa.

qwen

Qwen Plug-ins IDE de código

Qwen Code oferece suporte ao uso como um plug-in no VS Code e JetBrains IDE, fornecendo recursos de codificação de IA dentro do IDE.

Código VS

Certifique-se de que sua versão do VS Code seja 1.85.0 ou superior antes de usar.

Abra o VS Code, pesquise Qwen Code Companion no Extensions Marketplace e instale-o.
O plugin CLI e IDE compartilham o mesmo settings.json. Se você já concluiu a configuração acima, pule esta etapa. Caso contrário, siga as instruções Configurar credenciais de acesso seção acima.
Clique no ícone no canto superior direito para iniciar Qwen Code. Digite ou clique /e selecione Switch model para trocar de modelo.

###JetBrainsIDE

Certifique-se de que seu JetBrains IDE oferece suporte ao Agent Client Protocol (ACP) antes de usar.

Qwen O código IDE depende de Qwen Code CLI. Primeiro, siga o Instalar Qwen Code neste documento para instalar e concluir Configurar credenciais de acesso.
Abra o JetBrains IDE, vá para a página AI Chat e clique em Instalar plug-in. IDEA instalará o plugin JetBrains AI Assistant.
Clique no menu de três pontos no canto superior direito da janela AI Chat, selecione Adicionar agente personalizado e preencha a configuração a seguir. Substituir /path/to/qwen com o Qwen Caminho de instalação do código. Execute o seguinte comando para encontrar o caminho:
- macOS/Linux: which qwen
- Janelas: where qwen (CMD) ou Get-Command qwen (PowerShell)

{
  "agent_servers": {
    "qwen": {
      "command": "/path/to/qwen",
      "args": ["--acp"],
      "env": {}
    }
  }
}

Após a configuração, Qwen O código aparecerá no painel AI Chat. Você pode trocar de modelo no canto inferior direito.

Qwen Área de trabalho de código

Qwen Code Desktop é o aplicativo GUI do Qwen Code com tempo de execução CLI integrado, sem necessidade de instalação adicional de ferramenta de linha de comando. A versão desktop compartilha o mesmo settings.json arquivo de configuração com a CLI. Se você já tiver concluído a configuração por meio da CLI, a versão desktop estará pronta para uso sem configuração adicional.

Visite o Qwen Codificar versões do GitHub para baixar o instalador de desktop para seu sistema operacional (macOS, Windows ou Linux).

Se ainda não configurou, você pode fazer isso através da GUI do desktop:

Abra Qwen Code Desktop, clique em Configurações na barra lateral esquerda e selecione a guia AI.
Na seção Provedor de modelo, clique em + Conectar.
No pop-up, selecione QwenCloud e escolha o plano de faturamento que atende às suas necessidades:
- Token Plan: Para equipes, cobrado pelo consumo de tokens.
- Chave de API padrão: pagamento conforme o uso com uma conta existente QwenCloud Chave de API.
Insira a chave API conforme solicitado para concluir a configuração.

Comandos comuns

Os seguintes comandos se aplicam a Qwen Code CLI. O plugin IDE suporta apenas alguns comandos. Consulte o uso real.

Comando	Descrição	Exemplo
`/model`	Mude o modelo usado na sessão atual.	`/model`
`/auth`	Altere o método de autenticação.	`/auth`
`/init`	Analise o diretório atual e crie um arquivo de contexto inicial (QWEN.md).	`/init`
`/clear`	Limpe a tela do terminal e inicie uma nova conversa.	`/clear`
`/compress`	Substitua o histórico de bate-papo por um resumo para salvar tokens.	`/compress`
`/settings`	Abra o editor de configurações para configurar idioma, tema e muito mais.	`/settings`
`/summary`	Gere um resumo do projeto com base no histórico de conversas.	`/summary`
`/resume`	Retomar uma sessão de conversação anterior.	`/resume`
`/stats`	Exibir estatísticas detalhadas da sessão atual.	`/stats`
`/help`	Exibir informações de ajuda para comandos disponíveis.	`/help` ou `/?`
`/quit`	Sair Qwen Code.	`/quit`

Para recursos mais avançados de Qwen Code, consulte o Qwen Documentação oficial do código.

Saiba mais

Para recursos avançados, como subagentes, MCP e habilidades em Qwen Code, consulte o Qwen Documentação oficial do código.
Para Qwen Casos de uso de código, consulte Casos de uso.

Perguntas frequentes

Códigos de erro

Se você encontrar erros durante a configuração, consulte a documentação de perguntas frequentes do seu plano de faturamento:

Pagamento conforme o uso: Códigos de erro e solução de problemas
Plano de token (edição pessoal): Perguntas frequentes sobre o plano de token
Plano de Token (Edição de Equipe): Perguntas frequentes sobre o Plano de Token (Edição de Equipe)

Como trocar de modelo?

Digite o /model comando diretamente em Qwen Code para selecionar e alternar na lista de modelos configurados em settings.json. Para adicionar um novo modelo, adicione a configuração correspondente em settings.json no modelProviders seção e reinicie Qwen Code.