Z.ai Coding Plan: base URL, API key e configuração
Publicado em:
Tempo de leitura: 5 min
Tema: Tecnologia
Autor: Leandro Valencia
Os endpoints exatos do GLM Coding Plan: base URL para Claude Code e para Cline, qual chave usar e por que o endpoint errado nunca consome sua cota.
Índice
- Os endpoints, sem preâmbulo
- O atalho oficial
- Claude Code, passo a passo
- Cline, Roo e clientes compatíveis com OpenAI
- O erro que ninguém diagnostica: "funciona, mas nada é debitado"
- Qual chave criar, exatamente
- Lite, Pro e Max: o que realmente muda
- Checklist de configuração
- Continue lendo
Os endpoints, sem preâmbulo
| Ferramenta | Base URL |
|---|---|
| Claude Code (endpoint compatível com Anthropic) | https://api.z.ai/api/anthropic |
| Cline, Roo, Kilo, VS Code (compatível com OpenAI) | https://api.z.ai/api/coding/paas/v4 |
| Configuração guiada | npx @z_ai/coding-helper |
Em ambos os casos, o token é a sua API key do GLM Coding Plan.
E aqui está o detalhe que custa dinheiro: eles não são intercambiáveis. O endpoint /api/anthropic é o que o Claude Code entende. O /api/coding/paas/v4 é compatível com OpenAI. Se você colar um onde pertence o outro, ou funciona sem nunca debitar sua cota, ou falha sem que a mensagem de erro diga por quê.
O atalho oficial
Antes de configurar qualquer coisa à mão:
npx @z_ai/coding-helper
O helper da Z.ai guia você pela instalação e configuração da ferramenta e do plano. Se você não tem certeza de qual endpoint se aplica a você, esse caminho elimina o problema por completo: ele escreve a config para você.
A configuração manual faz sentido quando você já sabe o que quer, quando está automatizando a instalação em várias máquinas, ou quando o helper não cobre o seu cliente.
Claude Code, passo a passo
A ideia é apontar o Claude Code para a Z.ai em vez da Anthropic:
- Base URL:
https://api.z.ai/api/anthropic - Token: sua API key do Coding Plan
Os detalhes atuais estão na documentação do Claude Code da Z.ai. Reforço o "atuais": se você copiar um tutorial de 2024 com uma URL diferente, vai gastar cota no lugar errado ou não gastar nada.
Cline, Roo e clientes compatíveis com OpenAI
No VS Code com Cline:
- API Provider →
OpenAI Compatible(ou o provedor "Z AI" se aparecer na lista). - Base URL →
https://api.z.ai/api/coding/paas/v4 - API Key → sua chave do Coding Plan.
- Model → o GLM que estiver ativo no seu plano.
A documentação do Cline da Z.ai ganha de qualquer print antigo que você ache num fórum.
OpenCode, Roo e os demais seguem o mesmo padrão: endpoint de coding + chave do plano.
O erro que ninguém diagnostica: "funciona, mas nada é debitado"
Esta é a falha mais cara e a mais silenciosa, então merece uma seção própria.
Há dois jeitos de errar, e ambos produzem o mesmo sintoma:
1. Endpoint errado. Se você colar o endpoint genérico de chat em vez do de coding, a requisição pode funcionar, mas não sai da cota da sua assinatura. A Z.ai diz isso explicitamente na documentação.
2. Chave errada. Se você pagou a assinatura mas criou uma chave pay-as-you-go em vez de uma chave do Coding Plan, seu uso é cobrado à parte. Você paga duas vezes: pela assinatura que não usa, e pelo uso que usa.
Como pegar isso: envie um prompt real — não um "olá" — e observe o uso no console. Se o número não se mover, você tem um dos dois problemas.
Qual chave criar, exatamente
Depois que o pagamento cair, entre no console (a aba se chama algo como API Keys ou Billing; o nome exato muda a cada redesign, o conceito não):
- Crie uma chave do Coding Plan. Não uma chave avulsa pay-as-you-go.
- Copie-a uma vez. Trate-a como uma senha.
- Não mande para um repo, não cole num Discord, não deixe num print.
Se você rotacionar a chave depois, atualiza a ferramenta; não precisa pagar o plano de novo.
Lite, Pro e Max: o que realmente muda
Os três níveis usam os mesmos modelos. A única coisa que muda é quanto de cota você recebe.
Isso torna a decisão mais simples do que parece: comece no Lite mensal e escale quando faltar de verdade. Dois avisos concretos:
- As assinaturas da Z.ai não são reembolsáveis depois da compra.
- Não se case com o Max anual no primeiro dia. O número grande parece "economia"; é um compromisso.
Se você está pesando este plano contra a assinatura do OpenCode, destrinchamos isso em Z.ai GLM vs OpenCode Go: comparação de preços e planos.
Checklist de configuração
- Chave do Coding Plan criada (não pay-as-you-go).
- Endpoint correto para a sua ferramenta:
/api/anthropicpara Claude Code,/api/coding/paas/v4para clientes OpenAI. - Um prompt real enviado.
- Uso verificado no console: se não cair, algo está errado.
- Uma ferramenta configurada antes de você adicionar a segunda.
Continue lendo
- O onboarding completo: Como usar Z.ai (GLM): registro, plano e primeiro prompt
- Comparação de preços: Z.ai GLM vs OpenCode Go: comparação de preços e planos
- Se o seu cliente é o OpenCode: OpenCode não instala? Os erros comuns e as correções
Step-by-step guide
Crie a chave do Coding Plan
No console da Z.ai, crie uma chave de plano, não uma pay-as-you-go. A errada nunca debita sua cota.
Escolha o endpoint da sua ferramenta
Claude Code usa `/api/anthropic`. Cline, Roo e clientes OpenAI usam `/api/coding/paas/v4`.
Cole a base URL e o token
O token é a sua API key do Coding Plan. No Claude Code vai como o token do endpoint compatível com Anthropic.
Verifique se a cota cai
Envie um prompt real e confira o uso no console. Se não se mover, o endpoint ou a chave está errado.
Deixe o resto para depois
Uma ferramenta, um endpoint, um prompt. Configurar três clientes no mesmo dia é o caminho mais rápido para não saber o que quebrou.
Frequently asked questions
Qual é a base URL do Z.ai Coding Plan?
Depende da ferramenta. Para Claude Code, o endpoint compatível com Anthropic: `https://api.z.ai/api/anthropic`. Para Cline, Roo, Kilo e qualquer cliente compatível com OpenAI: `https://api.z.ai/api/coding/paas/v4`. Eles não são intercambiáveis.
O que o npx @z_ai/coding-helper faz?
É o atalho oficial da Z.ai: um assistente de terminal que guia você pela instalação e configuração da ferramenta e do plano, sem colar endpoints à mão. Se você não tem certeza da configuração manual, comece por ali.
Por que a cota do meu plano nunca cai, embora funcione?
Porque você está batendo num endpoint genérico de chat em vez do endpoint de coding, ou usando uma chave pay-as-you-go em vez da chave do Coding Plan. A Z.ai avisa sobre isso: o endpoint errado não debita a cota do plano. O sintoma clássico é 'funciona, mas não consome meu Lite'.
Qual chave uso, a do plano ou uma avulsa?
A chave do Coding Plan. Se você pagou a assinatura e cria uma chave pay-as-you-go, seu uso é cobrado à parte em vez de sair da sua cota. No console da Z.ai elas são criadas em lugares diferentes, mesmo que a tela mude de nome a cada redesign.
Lite, Pro e Max usam modelos diferentes?
Não. Os três níveis usam os mesmos modelos GLM. A única coisa que muda é quanto de cota você recebe. Por isso faz sentido começar no Lite mensal e escalar só quando faltar de verdade.
Posso pedir reembolso do GLM Coding Plan?
Não. As assinaturas da Z.ai não são reembolsáveis depois da compra. Esse é o argumento mais forte para começar no Lite mensal em vez de se comprometer com o Max anual no primeiro dia.
Posts Relacionados
Continue explorando conteúdo similar que pode te interessar
Como usar Z.ai (GLM): registro, plano e primeiro prompt
Guia para se registrar na Z.ai, ativar o GLM Coding Plan, criar sua API key e conectar Claude Code, Cline ou OpenCode. Onboarding, não uma análise de preços.
Z.ai e seus modelos GLM: qual é qual e quando usar cada um
Catálogo prático dos modelos da Z.ai —GLM-5.3, Flash, 4.6V, OCR, GLM-Image, CogVideoX e o Coding Plan—: o que cada um faz, quanto custa e como escolher o certo para cada tarefa.
IDEs e agentes de código que valem a pena em 2026
Guia completo dos melhores IDEs e agentes de código em 2026: opencode, Claude Code, Cursor, Cline, Kilo Code, Crush, Droid e mais. Análise comparativa, preços e recomendações por perfil de desenvolvedor.
Alianças
Ferramentas que uso todos os dias, com melhores condições para a comunidade.