Como usar o Qwen4-Max agora mesmo: assine o Token Plan da Alibaba e chame o ID de modelo qwen4-max-preview pelo Claude Code, Qwen Code ou qualquer ferramenta compatível com OpenAI ou Anthropic. Se você não programa, a equipe do Qwen da Alibaba informa que o acesso antecipado também está aberto no QwenWork, Qoder, Qwen App e QwenStudio. Ainda não há preço de API pay-as-you-go.
Essa é a versão curta. O Qwen4-Max entrou em preview em 11 de novembro de 2026, e o anúncio no X citou cinco lugares para experimentá-lo. Este guia percorre cada um deles: para quem serve, o que você precisa e quais limitações se aplicam. Em seguida, aborda o caminho para desenvolvedores, em que seu agente de programação roda no Qwen4-Max, constrói uma pequena API e a testa com o Apidog CLI.
Se quiser primeiro entender o modelo em si, leia o que é o Qwen4-Max. Para uma análise detalhada da assinatura, consulte o guia do Qwen4-Max Token Plan.
Todas as formas de acessar o Qwen4-Max: comparação rápida
O Qwen4-Max é um modelo em preview, então o acesso ocorre pelos próprios produtos da Alibaba, não por uma API pública com cobrança por token. Veja como as cinco rotas se comparam em 11 de novembro de 2026.
| Rota | Melhor para | O que você precisa | Custo inicial |
|---|---|---|---|
| Token Plan | Desenvolvedores que usam agentes de programação | Conta no QwenCloud, um plano e uma chave de API do Token Plan | $3 no primeiro mês no Lite (preço promocional; de tabela $8) |
| Qoder | Desenvolvedores que querem uma IDE agêntica | Conta e app do Qoder | Baseado em créditos; confira o seletor |
| QwenWork | Trabalho de conhecimento e tarefas com arquivos | Conta no QwenWork (web ou desktop) | Plano gratuito disponível |
| Qwen App | Testes rápidos no celular | Qwen App e conta | Não publicado para o Qwen4-Max |
| QwenStudio | Chat no navegador e prototipagem | Conta Qwen | Não publicado para o Qwen4-Max |
Duas coisas ainda não foram publicadas, então não conte com elas: benchmarks oficiais e um ID de modelo de API pay-as-you-go com preço. Publicações de terceiros citam uma janela de contexto de 1 milhão de tokens, mas a Alibaba não informou o tamanho do contexto do Qwen4-Max em suas próprias páginas. Trate esse número como não confirmado.
Rota 1: Qwen4-Max no Token Plan (o caminho do desenvolvedor)
O Token Plan é a assinatura do QwenCloud para ferramentas de programação com IA. Você paga mensalmente, recebe um pool de Créditos e os gasta em qualquer modelo listado no plano. Na página de preços do Token Plan, o qwen4-max-preview aparece em segundo lugar na lista de modelos com a etiqueta "80% de desconto por tempo limitado" e três capacidades: geração de texto, raciocínio e compreensão visual.
Preços do Token Plan (verificados em 11 de novembro de 2026)
A página mostra estes preços mensais individuais em dólares norte-americanos. O valor menor é o preço promocional para novos clientes, e a página informa que o preço final é o que aparece no checkout após o login.
| Plano | Preço promocional | Preço de tabela | Créditos por mês | Agentes simultâneos |
|---|---|---|---|---|
| Lite | $3.00 | $8.00 | 20.000 | 1-2 |
| Essential | $5.00 | $16.00 | 45.000 | 2-3 |
| Standard | $18.00 | $25.00 | 80.000 | 3-4 |
| Pro | $43.00 | $51.00 | 200.000 | 6-8 |
A página não informa quantos Créditos uma requisição ao Qwen4-Max consome, então você descobrirá seu uso real na página de consumo do plano após algumas sessões.
Regras para conhecer antes de comprar
O FAQ do Token Plan Individual estabelece alguns limites que merecem ser lidos com atenção:
- Uso apenas interativo. O plano é para "desenvolvimento interativo pessoal por meio de ferramentas designadas". Usar a chave para automação em produção, scripts em lote ou tarefas agendadas em segundo plano não é permitido.
- Proibido compartilhar. Compartilhar contas ou chaves de API é proibido.
- Sem reembolso. O Token Plan Individual não é reembolsável.
- Uma única região. A visão geral informa que o Token Plan só pode ser comprado e usado na região de Singapura, e suas chaves começam com
sb-sp-.
A primeira regra é importante. Seu agente de programação pode usar o Qwen4-Max enquanto você desenvolve. O backend do seu aplicativo em produção não deve chamar a chave do Token Plan.
Conectar o Claude Code ao Qwen4-Max
A página de configuração do Claude Code do QwenCloud mapeia os slots de modelo do Claude Code para modelos do Token Plan, com o Qwen4-Max no slot do Opus. Adicione isto ao ~/.claude/settings.json:
{
"env": {
"ANTHROPIC_AUTH_TOKEN": "YOUR_TOKEN_PLAN_API_KEY",
"ANTHROPIC_BASE_URL": "https://token-plan.maas.qwencloudapi.com/apps/anthropic",
"ANTHROPIC_MODEL": "auto",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.6-flash",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.8-flash",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen4-max-preview",
"CLAUDE_CODE_SUBAGENT_MODEL": "auto",
"CLAUDE_CODE_MAX_CONTEXT_TOKENS": "983616"
}
}
Abra um novo terminal e execute claude -p "Hello" para verificar a conexão. Para forçar o Qwen4-Max em uma sessão inteira em vez de auto, defina ANTHROPIC_MODEL como qwen4-max-preview. Se respostas longas forem cortadas, a mesma página recomenda definir CLAUDE_CODE_MAX_OUTPUT_TOKENS=64000.
Conectar o Qwen Code ou qualquer ferramenta compatível com OpenAI
O guia do Qwen Code usa o endpoint compatível com OpenAI:
Base URL: https://token-plan.maas.qwencloudapi.com/compatible-mode/v1
Model: qwen4-max-preview
Key: QWENCLOUD_TOKEN_PLAN_API_KEY (da sua página de API Keys)
O guia observa que o limite padrão de saída do Qwen4-Max é 32.768 tokens. Para saídas mais longas, defina generationConfig.samplingParams.max_tokens na entrada desse modelo. A página de preços também lista Cline, Cursor, OpenCode, Codex, Kilo CLI e OpenClaw como ferramentas suportadas.
Rota 2: Qwen4-Max no Qoder
O Qoder é a IDE de programação agêntica da Alibaba, e o anúncio o lista como uma superfície de acesso antecipado. O Qoder cobra em Créditos, e sua documentação do seletor de modelos informa que o seletor exibe a taxa de Créditos de cada modelo antes de você enviar um prompt.
Até 11 de novembro, essa documentação lista o Qwen3.8-Max, mas ainda não o Qwen4-Max. Atualize o Qoder para a versão mais recente e procure o Qwen4-Max no seletor de modelos. Verifique a taxa exibida lá, porque o Qoder aplicou uma taxa promocional bem agressiva no último preview do Qwen Max, e a taxa do Qwen4-Max ainda não está documentada.
Escolha o Qoder se quiser uma IDE construída em torno de agentes e não quiser configurar uma base URL manualmente.
Rota 3: Qwen4-Max no QwenWork
O QwenWork é um espaço de trabalho de agentes para trabalho de conhecimento. Você descreve um resultado desejado, e ele planeja os passos, usa seus arquivos e devolve um arquivo pronto. Funciona no navegador ou como aplicativo desktop para Mac e Windows.
O QwenWork tem um plano gratuito de $0 com 500 créditos de bônus no cadastro e 200 créditos diários por login, ambos marcados como por tempo limitado. Os planos pagos começam em $20 por mês no Plus. O site do QwenWork não descreve um seletor de modelos, então verifique dentro do app se o Qwen4-Max está disponível antes de contar com ele.
Escolha o QwenWork para relatórios, resumos e tarefas com arquivos, não para programar.
Rotas 4 e 5: o Qwen App e o QwenStudio
O Qwen App (celular) e o QwenStudio (o espaço de chat do Qwen) são as rotas sem configuração. Faça login, abra o menu de modelos e escolha o Qwen4-Max se ele estiver listado para sua conta. Nenhum deles publicou uma cota para o Qwen4-Max, então espere que os limites de acesso antecipado mudem durante o preview.
Esses dois servem para uma primeira impressão: faça perguntas difíceis de raciocínio, cole uma captura de tela para testar a compreensão visual ou compare as respostas com o Qwen 3.8. Para uma comparação completa, veja Qwen4-Max vs Qwen 3.8.
Qual rota do Qwen4-Max você deve escolher?
Combine a rota com a tarefa:
- Você programa com um agente: Token Plan. É a única rota com ID de modelo, base URL e preço documentados.
- Você quer uma IDE que cuida da configuração: Qoder.
- Você quer documentos prontos, não código: QwenWork.
- Você quer dar uma olhada rápida hoje: QwenStudio ou o Qwen App.
Se você constrói aplicativos em produção, espere por uma listagem de API pay-as-you-go. Os termos do Token Plan excluem uso em backend, e modelos em preview podem mudar sem aviso. Nosso guia da API do Qwen 3.8 cobre a opção de produção atual.
Construa e teste uma API com o Qwen4-Max e o Apidog CLI
Este é o caminho do desenvolvedor na prática. Seu agente de programação roda no Qwen4-Max pelo Token Plan, escreve uma pequena API REST e depois usa o Apidog CLI para testá-la. Você escreve um único prompt. O agente digita tudo.
Configure o Apidog CLI
Instale a CLI, faça login com seu token de acesso pessoal e adicione a skill do Apidog ao seu agente:
npm install -g apidog-cli@latest
apidog login --with-token <YOUR_TOKEN>
npx -y skills add https://apidog.com # escolha Claude Code quando solicitado
Um atalho: diga ao seu agente Read https://apidog.com/apidog-cli-installation-guide.md and set up Apidog CLI. Esse guia foi escrito para agentes. O guia de instalação tem a versão para humanos.
Dê um único prompt ao seu agente
Com o Claude Code apontado para o qwen4-max-preview, envie isto:
Build a small Express API with POST /todos and GET /todos/{id}, plus an
openapi.json for it. Start it on port 3000. Then import the spec into Apidog
project <projectId>, create a test case for POST /todos that asserts a 201
status and a returned id, run it against environment <envId>, and summarize
any failures with the fix you'd make.
Os comandos apidog que o agente executa
Depois de escrever o código e a especificação, o agente importa a spec, lê o esquema para um caso de teste, valida o payload e o executa:
apidog import --project <projectId> --format openapi --file ./openapi.json
apidog cli-schema get test-case-create
apidog cli-schema validate test-case-create --file case.json
apidog test-case create --project <projectId> --file case.json
apidog run --test-case <caseId> --project <projectId> -e <envId> -r cli,json
O reporter cli imprime um resumo de aprovação ou falha no terminal, e o json grava um relatório na pasta apidog-reports, que o agente lê para explicar as falhas. Adicione --upload-report se quiser visualizar a execução no app do Apidog.
Essa também é uma forma justa de avaliar um modelo em preview. Sem benchmarks publicados, uma execução de teste bem-sucedida na sua própria API diz mais do que qualquer leaderboard. Rode o mesmo prompt com o qwen3.8-flash no slot do Sonnet e compare quantos ciclos de correção cada modelo precisa.
O teste em si não precisa do Qwen4-Max, então você pode mover o apidog run ... -r junit para o CI sem tocar na sua chave do Token Plan. O guia de CI/CD do Apidog CLI mostra a configuração, e o Apidog CLI no Claude Code cobre mais prompts para agentes. O plano gratuito do Apidog cobre até 4 usuários.
FAQ
Existe uma API do Qwen4-Max?
Ainda não há uma com cobrança por uso. Até 11 de novembro de 2026, o único acesso via API documentado é o Token Plan, usando o ID de modelo qwen4-max-preview e a base URL do Token Plan. Um ID de modelo público com cobrança por token e seu preço ainda não foram publicados.
Quanto custa o Qwen4-Max?
No Token Plan, os planos individuais vão de $3 (preço promocional do Lite, de tabela $8) a $43 (preço promocional do Pro, de tabela $51) por mês, verificado em 11 de novembro de 2026. A página não informa os Créditos por requisição ao Qwen4-Max.
Posso usar o Qwen4-Max de graça?
O QwenWork tem um plano de $0 com créditos de bônus por tempo limitado. Nenhuma rota documenta ainda acesso gratuito ao Qwen4-Max, então verifique o menu de modelos no QwenWork, no Qwen App ou no QwenStudio antes de contar com ele.
Qual é a janela de contexto do Qwen4-Max?
A Alibaba não publicou esse dado. Relatos de terceiros indicam 1 milhão de tokens, e a configuração do Claude Code do QwenCloud define um limite de contexto no cliente de 983.616 tokens, mas nenhum dos dois é uma especificação oficial do modelo.
Posso usar minha chave do Token Plan em produção?
Não. O FAQ proíbe automação em produção, scripts em lote e tarefas agendadas em segundo plano. Use-a para programação interativa e mantenha o backend do seu produto em uma API pay-as-you-go.
Qual modelo Qwen devo usar até o Qwen4-Max ficar disponível para todos?
Para APIs em produção, use um modelo lançado com preços publicados. Nosso guia dos melhores modelos Qwen e o Qwen 3.8 para programação comparam as opções atuais.