Skip to main content

Qwen Code

Use os modelos do Alibaba Cloud Model Studio no Qwen Code.

Início Rápido

Escolha seu cliente e conclua a configuração.
  • CLI
  • Desktop
  • IDE plugin
  1. 1

    Connect the provider

    Execute qwen, selecione Alibaba ModelStudio no primeiro uso e, em seguida, selecione um plano de cobrança quando solicitado.
  2. 2

    Select a region

    Selecione Singapore como região.
  3. 3

    Enter the API key

    • Token Plan
    • Pay-as-you-go
    • Coding Plan
    Use uma chave de API do Token Plan:
  4. 4

    Verify

    qwen -p "Hello"
    

Arquivo de configuração

Além das opções acima, você também pode se conectar usando um arquivo de configuração.
  1. 1

    Abra ou crie o arquivo de configuração

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

    Grave a configuração

    • Token Plan Personal Edition
    • Token Plan Team Edition
    • Pay-as-you-go
    • Coding Plan
    Obtenha uma chave de API do Token Plan no console e substitua YOUR_API_KEY.
    {
      "$version": 4,
      "env": {
        "BAILIAN_TOKEN_PLAN_API_KEY": "YOUR_API_KEY"
      },
      "modelProviders": {
        "openai": [
          {
            "id": "auto",
            "name": "Token Plan auto",
            "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
            "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
          },
          {
            "id": "qwen4-max-preview",
            "name": "Qwen4.0 Max Preview",
            "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
            "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
          },
          {
            "id": "qwen4-max",
            "name": "Qwen4 Max",
            "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
            "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
          },
          {
            "id": "qwen3.8-max",
            "name": "Qwen3.8 Max",
            "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
            "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
          },
          {
            "id": "qwen3.8-flash",
            "name": "Qwen3.8 Flash",
            "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
            "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
          },
          {
            "id": "qwen3.7-max",
            "name": "Qwen3.7 Max",
            "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
            "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
          },
          {
            "id": "qwen3.7-plus",
            "name": "Qwen3.7 Plus",
            "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
            "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
          },
          {
            "id": "qwen3.6-flash",
            "name": "Qwen3.6 Flash",
            "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
            "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
          },
          {
            "id": "qwen-image-3.0-pro",
            "name": "Qwen Image 3.0 Pro",
            "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
            "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
          },
          {
            "id": "qwen-audio-3.0-tts-plus",
            "name": "Qwen Audio 3.0 TTS Plus",
            "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
            "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
          },
          {
            "id": "qwen-audio-3.0-realtime-plus",
            "name": "Qwen Audio 3.0 Realtime Plus",
            "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
            "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
          },
          {
            "id": "qwen-audio-3.0-asr-flash",
            "name": "Qwen Audio 3.0 ASR Flash",
            "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
            "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
          },
          {
            "id": "wan2.7-image",
            "name": "Wan2.7 Image",
            "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
            "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
          },
          {
            "id": "wan2.7-image-pro",
            "name": "Wan2.7 Image Pro",
            "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
            "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
          },
          {
            "id": "wan3.0-video",
            "name": "Wan3.0 Video",
            "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": "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.1-flash-1017",
            "name": "DeepSeek V4.1 Flash 1017",
            "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
            "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
          },
          {
            "id": "deepseek-v4-pro",
            "name": "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": "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": "DeepSeek V4 Flash 0731",
            "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
            "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
          },
          {
            "id": "glm-5.3",
            "name": "GLM-5.3",
            "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
            "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
          },
          {
            "id": "glm-5.2",
            "name": "GLM-5.2",
            "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
            "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
          },
          {
            "id": "happyhorse-1.1-i2v",
            "name": "HappyHorse 1.1 I2V",
            "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
            "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
          },
          {
            "id": "happyhorse-1.1-t2v",
            "name": "HappyHorse 1.1 T2V",
            "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
            "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
          },
          {
            "id": "happyhorse-1.1-r2v",
            "name": "HappyHorse 1.1 R2V",
            "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
            "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
          },
          {
            "id": "decision-model-preview",
            "name": "Decision Model Preview",
            "baseUrl": "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
            "envKey": "BAILIAN_TOKEN_PLAN_API_KEY"
          }
        ]
      },
      "security": {
        "auth": {
          "selectedType": "openai"
        }
      },
      "model": {
        "name": "auto"
      }
    }
    
    Ao usar qwen4-max-preview, o limite de saída padrão é 32768; para saídas mais longas, defina generationConfig.samplingParams.max_tokens na entrada do modelo.
    Ao usar qwen4-max, o limite de saída padrão é 32768. Para saídas mais longas, defina generationConfig.samplingParams.max_tokens na entrada do modelo. qwen4-max tem contexto de 1 M de tokens. A saída máxima é de 131.072 tokens no modo sem pensamento e de 262.144 tokens para pensamento e resposta final combinados. Os padrões são reasoning_effort=high e thinking_budget=131072.
O nome da variável em env deve corresponder ao envKey da entrada do modelo. Mantenha security.auth.selectedType definido como openai e $version definido como 4.

Integrar o Bailian CLI

O Bailian CLI registra um Skill em ~/.qwen/skills/bailian-cli/ durante a instalação, permitindo que o Qwen Code invoque recursos do Bailian por meio de conversa. Instale o Node.js 18+ antes de usar.
  1. 1

    Install Bailian CLI

    Please install the Alibaba Cloud Bailian CLI globally: npm install -g bailian-cli
    
  2. 2

    Configure the API Key

    Obtenha uma API Key (Obter no console) e, em seguida, informe ao Qwen Code:
    My API Key is: sk-xxxxxxxxxxxxx
    
    Uma API Key é uma credencial sensível. Não a divulgue. Uma API Key em texto simples colada na conversa pode ser retida nos logs da sessão. Use settings.json ou uma variável de ambiente.
  3. 3

    Start using it

    Generate 6 Amazon e-commerce hero images for a white wireless Bluetooth headset.
    

Saiba mais

Para mais comandos, subagentes, MCP, Skills e exemplos, consulte a documentação do Qwen Code e os exemplos.

Códigos de erro

Se você encontrar erros durante a configuração, consulte a documentação de FAQ do seu plano de cobrança:

Perguntas frequentes

A configuração de pagamento conforme o uso permanece a mesma: use a chave de API geral do Model Studio e a Base URL. Após comprar um plano de economia, ele entra em vigor automaticamente e o uso elegível é deduzido automaticamente. Consulte Planos de economia.
Tente os procedimentos a seguir, nesta ordem:
  1. Atualize o Qwen Code para a versão mais recente.
  2. Se o modelo ainda não aparecer, adicione-o manualmente em modelProviders.openai no ~/.qwen/settings.json e reinicie o Qwen Code. Consulte Arquivo de configuração para obter detalhes.
Feche e reabra o cmd para que a variável de ambiente entre em vigor e execute qwen --version para confirmar a instalação.