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

Qwen Code

Fonte: https://docs.qwencloud.com/coding-plan/tools/qwen-code - extraído do HTML público arquivado.

Ferramenta oficial de codificação de IA baseada em terminais Conectar a QwenCloud via Token Plan (Edição Pessoal), Token Plan (Edição da Equipe), ou faturamento pago como você vai.

Cenários comuns

Qwen O código suporta os seguintes cenários:

Gerar, completar e revisar código do terminal usando linguagem natural para acelerar o desenvolvimento diário.
** Desenvolvimento web**: Fornecer uma imagem de um site alvo, e Qwen O código analisa a estrutura da página para gerar código de frente de alta fidelidade.
** Produção de vídeo**: Dado um URL de repositório de código aberto, gerar um vídeo promocional dedicado em um passo.

Instalar Qwen Code

macOS/Linux

Janelas Abra um terminal e execute o seguinte comando para instalar Qwen Code. Entendido.

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

Tipo cmd na caixa de pesquisa da barra de tarefas, selecione Fuja como administrador, e execute o seguinte comando no cmd janela para instalar Qwen Code. Entendido.

curl -fsSL -o %TEMP%\i nstall-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 instalação estar completa, feche a corrente. cmd janela para aplicar as variáveis de ambiente. Reabrir cmd e execute o seguinte comando para verificar a versão instalada. Entendido.

qwen --version

Configure credenciais de acesso.

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

Token Plan (Edição Pessoal)**: Deduz créditos pessoais baseados no consumo de fichas.
"Token Plan" (Edição da Equipe)**: assinatura por assento, com consumo de fichas deduzidas dos créditos.
Pago como você vai, pago com base no uso real.

Token Plan (Edição Pessoal)

Edita ou cria um settings.json Arquivar e substituir YOUR_API_KEY com seu plano Token (Edição Pessoal) dedicado [API Key] (https://home.qwencloud.com/api-keys). 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-0813, e deepseek-v4-flash-0731. Para a lista completa, veja o Token Plan (Edição Pessoal)https://www.qwencloud.com/token-plan/personal/token-plan-personal-overview#supported-models). O caminho do arquivo é o seguinte:

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

{
  "env": {
    "QWENCLOUD_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": "QWENCLOUD_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": "QWENCLOUD_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": "QWENCLOUD_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": "QWENCLOUD_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": "QWENCLOUD_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": "QWENCLOUD_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": "QWENCLOUD_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": "QWENCLOUD_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": "QWENCLOUD_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": "QWENCLOUD_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": "QWENCLOUD_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": "QWENCLOUD_TOKEN_PLAN_API_KEY"
      },
      {
        "id": "deepseek-v4.1-flash-1017",
        "name": "[Token Plan Personal] deepseek-v4.1-flash-1017",
        "baseUrl": "https://token-plan.maas.qwencloudapi.com/compatible-mode/v1",
        "envKey": "QWENCLOUD_TOKEN_PLAN_API_KEY"
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "tokenPlan": {
    "region": "global"
  },
  "model": {
    "name": "auto"
  },
  "$version": 3
}

qwen3.8-max Modo de pensamento:

Suporta tanto habilitado quanto desativado (modo de pensamento híbrido).
Temperatura: por padrão de 0,6 no modo de pensar. Valores abaixo de 0,6 são ajustados automaticamente para 0,6.
Controla a profundidade do raciocínio. Opções: Xhigh, médio, baixo. Padrão: Xhigh.

Token Plan (Edição da Equipe)

Lançar Qwen Code e tipo /auth, em seguida, selecione ** Plano de assinatura** > ** Alibaba Cloud Model Studio Token Plan**, e insira o Token Plan (Edição de Equipe) dedicado [API Key] (https://home.qwencloud.com/api-keys) para completar a configuração. Para modelos disponíveis, veja Token Plan (Edição de equipe) [modelos suportados] (https://www.qwencloud.com/token-plan/team/token-plan-team-overview#supported-models). Configuração avançada: via settings.json Edita ou cria um settings.json Arquivar e substituir YOUR_API_KEY com sua chave de API dedicada ao Token Plan (Edição da Equipe). O caminho do arquivo é o seguinte:

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

{
  "env": {
    "QWENCLOUD_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": "QWENCLOUD_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": "QWENCLOUD_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": "QWENCLOUD_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": "QWENCLOUD_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": "QWENCLOUD_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": "QWENCLOUD_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": "QWENCLOUD_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": "QWENCLOUD_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": "QWENCLOUD_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": "QWENCLOUD_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": "QWENCLOUD_TOKEN_PLAN_API_KEY"
      },
      {
        "id": "deepseek-v4.1-flash-1017",
        "name": "[Token Plan Team Edition] deepseek-v4.1-flash-1017",
        "baseUrl": "https://token-plan.maas.qwencloudapi.com/compatible-mode/v1",
        "envKey": "QWENCLOUD_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": "QWENCLOUD_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": "QWENCLOUD_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": "QWENCLOUD_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": "QWENCLOUD_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": "QWENCLOUD_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": "QWENCLOUD_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": "QWENCLOUD_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": "QWENCLOUD_TOKEN_PLAN_API_KEY"
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "tokenPlan": {
    "region": "global"
  },
  "model": {
    "name": "qwen3.7-plus"
  },
  "$version": 3
}

qwen3.8-max Modo de pensamento:

Suporta tanto habilitado quanto desativado (modo de pensamento híbrido).
Temperatura: por padrão de 0,6 no modo de pensar. Valores abaixo de 0,6 são ajustados automaticamente para 0,6.
Controla a profundidade do raciocínio. Opções: Xhigh, médio, baixo. Padrão: Xhigh.

Pagar como você vai

Lançar Qwen Code e tipo /auth, selecione Use sua própria API Key > Standard API Key, em seguida, escolha a região e digite o [QwenCloud API Key] (https://home.qwencloud.com/api-keys) para completar a configuração. Para os modelos disponíveis, veja [OpenAI compatível - modelos suportados] (https://www.qwencloud.com/api-reference/chat/openai-chat). Configuração avançada: via settings.json Edita ou cria um settings.json Arquivar e substituir YOUR_API_KEY com o seu QwenCloud Chave API. O caminho do arquivo é o seguinte:

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

{
  "env": {
    "DASHSCOPE_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": "DASHSCOPE_API_KEY",
        "generationConfig": {
          "extra_body": {
            "enable_thinking": true
          }
        }
      }
    ]
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3.7-plus"
  },
  "$version": 3
}

Para adicionar [outros modelos] (https://www.qwencloud.com/api-reference/chat/openai-chat), anexá-los no mesmo formato dentro modelProviders.openai.

Verificar configuração

Após a configuração estar completa, execute o seguinte comando no diretório do projeto para lançar Qwen Code e começar uma conversa. Entendido.

qwen

Qwen Plugins de código IDE

Qwen O código suporta o uso como plugin 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 VS Code seja 1.85.0 ou superior antes de usar.

Abra o código VS, procure por Qwen Code Companion no mercado de extensões e instale-o.
O plugin CLI e IDE compartilham o mesmo settings.json. Se já completou a configuração acima, pule este passo. Caso contrário, siga a seção de Configurações de acesso acima.
Clique no ícone no canto superior direito para lançar. Qwen Code. Digite ou clique. /, então selecione Switch model Para trocar de modelo.

JetBrains IDE

Certifique-se de que seu JetBrains IDE suporte o Protocolo de Cliente Agente (ACP) antes de usar.

Qwen O código de IDE depende de Qwen Code CLI. Primeiro, siga a instalação. Qwen Seção de código neste documento para instalar e completar as credenciais de acesso.
Abra o IDE JetBrains, vá para a página do Chat AI, e clique em Plugin install. IDEA instalará o plugin Assistente de IA JetBrains.
Clique no menu de três pontos no canto superior direito da janela AI Chat, selecione Adicionar Agente Personalizado, e preencha a seguinte configuração. Substituir /path/to/qwen com o Qwen Caminho de instalação de código. Execute o seguinte comando para encontrar o caminho:

MacOS/Linux: which qwen
Janelas: where qwen (CMD) ou Get-Command qwen (PowerShell) Entendido.

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

Depois da configuração, Qwen O código aparecerá no painel de bate-papo. Você pode trocar de modelo no canto inferior direito.

Qwen Área de trabalho de código

Qwen Code Desktop é a aplicação da GUI Qwen Code com tempo de execução CLI embutido, não requer nenhuma instalação adicional de linha de comando. A versão desktop compartilha a mesma coisa. settings.json Arquivo de configuração com o CLI. Se você já completou a configuração através do CLI, a versão desktop está pronta para usar sem configuração adicional. Visite o [Qwen Code GitHub libera] (https://github.com/QwenLM/qwen-code/releases) página para baixar o instalador desktop para o seu sistema operacional (macOS, Windows ou Linux). Se você ainda não configurou, você pode fazer isso através da interface de desktop:

Abra. Qwen Code Desktop, clique em Settings na barra lateral esquerda, e selecione a aba AI.
Na seção de Modelo Provider, clique em "Conectar".
No popup, selecione o **QwenCloudA conta e o plano de faturamento que se adequam às suas necessidades.

Token Plan**: para equipes, faturadas por consumo de fichas.
Pague como quiser com uma chave de API existente. QwenCloud Chave API.

Digite a chave API como solicitado para completar a configuração.

Comandos comuns.

Os seguintes comandos se aplicam a Qwen Code CLI. O plugin IDE só suporta alguns comandos. Por favor, consulte o uso real.

Comando	Descrição	Exemplo
`/model`	Mude o modelo usado na sessão atual.	`/model`
`/auth`	Mude 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 comece uma nova conversa.	`/clear`
`/compress`	Substitua o histórico de bate-papo por um resumo para salvar fichas.	`/compress`
`/settings`	Abra o editor de configurações para configurar linguagem, tema e muito mais.	`/settings`
`/summary`	Gere um resumo do projeto baseado no histórico de conversa.	`/summary`
`/resume`	Retomar uma sessão de conversa anterior.	`/resume`
`/stats`	Mostre estatísticas detalhadas para a sessão atual.	`/stats`
`/help`	Mostre informações de ajuda para os comandos disponíveis.	`/help`or`/?`
`/quit`	Sai. Qwen Code.	`/quit`

Para características mais avançadas de Qwen Code, veja o Qwen Documentação oficial do código.

Saiba mais.

Para recursos avançados, como subagentes, MCP, e Habilidades em Qwen Code, veja o Qwen Documentação oficial do código.
Por Qwen Casos de uso de código, veja [Casos de uso] (https://qwenlm.github.io/qwen-code-docs/en/showcase/).

FAQ

Códigos de erro.

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

Pague-como-você-vai:https://www.qwencloud.com/api-reference/preparation/error-messages)
(Plano de Token (Edição Pessoal):https://www.qwencloud.com/token-plan/personal/token-plan-personal-faq)
(Edição de Equipe): (Plano de Equipe)https://www.qwencloud.com/token-plan/team/token-plan-team-faq)

Como trocar de modelo?

Digite o /model Comando diretamente dentro Qwen Code para selecionar e mudar da lista de modelos configurada em settings.json. Para adicionar um novo modelo, adicione a configuração correspondente sob settings.json na modelProviders Seção, então reinicie. Qwen Code. [Anterior] (https://www.qwencloud.com/developer-guides/clients-and-developer-tools/codex)[DeepSeek Harness. DeepSeek Harness é um agente de IA de código aberto. DeepSeek, apoiando tanto a interface da Web quanto os modos CLI. Conectar a QwenCloud usando o pagamento como você vai, Token Plan Edição pessoal, ou Token Plan Team Edition. Próximo.https://www.qwencloud.com/developer-guides/clients-and-developer-tools/deepseek-harness)