Como usar Z.ai (GLM): registro, plano e primeiro prompt

Índice

• O que você está ativando, em uma frase
• Passo a passo

  • 1. Crie sua conta na Z.ai
  • 2. Escolha o GLM Coding Plan
  • 3. Crie uma API key
  • 4. Conecte sua ferramenta
  • 5. Envie o primeiro prompt
• Três coisas que não são o onboarding (e por isso não vão aqui)
• Perguntas frequentes

  • A Z.ai é a mesma coisa que o chat de glm.ai?
  • O desconto de 10% se aplica sempre?
  • Qual plano escolho para começar?
  • Preciso usar o Claude Code?
• Em resumo

O que você está ativando, em uma frase

O GLM Coding Plan é uma assinatura da Z.ai que te dá cota para usar modelos GLM dentro de ferramentas de código. Não é um chat com cara bonita. É uma API key que você conecta ao Claude Code, Cline, OpenCode, Roo, Kilo e similares.

Todos os tiers (Lite, Pro, Max) usam os mesmos modelos. O que muda é quanta cota você tem. Por isso o onboarding certo é: conta → Lite mensal → key → uma única ferramenta → um prompt real. Escalar de plano é um problema do mês 2.

Passo a passo

1. Crie sua conta na Z.ai

Entre em z.ai/subscribe com o código de convite e registre-se. Complete o login. O desconto do primeiro pedido fica atrelado a essa conta: não crie uma, olhe os preços com outra e pague com uma terceira.

Se o site pedir região, use a internacional (z.ai), não o portal da China continental, a menos que esse seja o seu caso.

2. Escolha o GLM Coding Plan

Na tela de planos você vai ver Lite / Pro / Max, e ciclos mensal / trimestral / anual.

Regra prática, a mesma que já escrevi na análise:

• Comece no Lite mensal.
• As assinaturas não são reembolsáveis depois de compradas.
• Não se case com o Max anual no primeiro dia. O número grande parece "economia"; é um compromisso.

Os 10% do link se aplicam ao primeiro pagamento, não à vida toda do plano. Confirme o total no checkout antes de pagar: Pro e Max já variaram de valor entre promoções.

3. Crie uma API key

Quando o pagamento passa, entre no painel (API Keys / Billing, o nome exato da aba muda com o redesign, o conceito não):

1. Crie uma key do Coding Plan, não uma key solta de pay-as-you-go se o que você pagou foi a assinatura. A Z.ai avisa que o endpoint errado não desconta a cota do plano.
2. Copie uma vez. Trate como uma senha.
3. Não suba a um repo, não cole em um Discord, não deixe em um screenshot no Twitter.

Se mais tarde você rotacionar a key, atualiza a ferramenta; não precisa pagar o plano de novo.

4. Conecte sua ferramenta

Você tem três caminhos. Escolha um, não os três no mesmo dia.

Atalho oficial: no terminal,

npx @z_ai/coding-helper

O helper da Z.ai te guia para instalar/configurar a ferramenta e o plano.

Se você já usa Claude Code: a Z.ai documenta o endpoint compatível com Anthropic. A ideia é apontar o Claude Code para a Z.ai (base URL https://api.z.ai/api/anthropic) e usar sua API key como token. O detalhe vigente está na doc do Claude Code da Z.ai; se você copiar um tutorial de 2024 com outra URL, vai gastar cota no lugar errado ou não vai gastar nada.

Se você vive no VS Code / Cline: API Provider → OpenAI Compatible (ou o provedor "Z AI" se aparecer), Base URL https://api.z.ai/api/coding/paas/v4, sua API key, modelo GLM (por exemplo o flagship que estiver vigente no seu plano). De novo: a doc do Cline manda sobre qualquer screenshot velho.

OpenCode, Roo e o resto seguem o mesmo padrão: endpoint de coding + key do plano. Se você escolher o endpoint de chat genérico, o sintoma é "funciona mas não desconta o Lite" ou "não funciona e não sei por quê".

5. Envie o primeiro prompt

Abra um repositório real (mesmo que pequeno). Peça algo que você possa verificar em um minuto: "me explique este arquivo", "escreva o teste que falta para esta função". Se a ferramenta responder com o modelo GLM, a fiação está certa.

Não comece por um refactor de 40 arquivos. O primeiro prompt é um ping, não uma migração.

Quando isso funciona, aí sim vale a pena voltar à análise de uso diário e decidir se o Lite te alcança ou se o teto de 5 horas fica curto.

Três coisas que não são o onboarding (e por isso não vão aqui)

• Tabelas de preço e tokens: já estão nos dois posts anteriores.
• "O GLM ganha do Claude?": isso é opinião, não um passo.
• Configurar 20 ferramentas de uma vez: o plano é um; o gargalo é você.

Perguntas frequentes

A Z.ai é a mesma coisa que o chat de glm.ai?

O Coding Plan é a assinatura para ferramentas de código. Este post cobre isso.

O desconto de 10% se aplica sempre?

Só o primeiro pedido, e se você nunca pagou uma assinatura na plataforma.

Qual plano escolho para começar?

Lite mensal. Mesmos modelos, menos cota, menos arrependimento.

Preciso usar o Claude Code?

Não. npx @z_ai/coding-helper, Cline ou OpenCode servem. Uma ferramenta bem conectada ganha de cinco pela metade.

Em resumo

• Conta em z.ai com o link de convite.
• Lite mensal. Nada de Max anual no dia um.
• API key do Coding Plan, endpoint de coding.
• Um prompt em um repo real.
• Os preços e o "para quem sim" estão nos posts de opinião.

👉 Ativar GLM Coding Plan com 10% no primeiro pedido

---

Se você já paga um agente de código e quer testar o GLM sem reescrever seu fluxo, o trabalho não é "aprender outro chat". É colar uma key na ferramenta que você já abre todos os dias.

— Leandro Valencia