Como usar o GLM-5.2 no Claude Code (guia completo de configuração)

Já dá para usar o GLM-5.2 no Claude Code, e a configuração leva cerca de dois minutos. Como o Claude Code se comunica com qualquer endpoint compatível com a Messages API da Anthropic, basta apontá-lo para o z.ai, que oferece exatamente essa compatibilidade para o GLM. Há dois caminhos: usar um app para alternar provedores com um clique — o mais simples e prático para voltar ao Claude depois — ou editar a configuração manualmente. Abaixo, mostro os dois métodos no macOS, Windows e Linux, além de como retornar ao Claude quando fizer sentido.

Jeito mais rápido: CC Switch

Se você já alterna entre mais de um provedor, vale pular a configuração manual e usar o CC Switch (open source, licenciado sob MIT e disponível para Windows/macOS/Linux). O app desktop gerencia as configurações de provedores para Claude Code, Codex, Gemini CLI e alguns outros CLIs, sem exigir edição manual de JSON.

1. Instale o CC Switch em ccswitch.io ou pelo repositório no GitHub. Na janela principal, clique no botão laranja +, no canto superior direito, para abrir Add Provider, então selecione a aba Claude Provider.
2. Digite zhipu na busca de presets. Serão exibidos dois: Zhipu GLM (endpoint da China continental) e Zhipu GLM en. Fora da China continental, escolha Zhipu GLM en, que usa o endpoint internacional.

1. Role a página e cole sua chave de API do z.ai no campo API Key. O preset preenche automaticamente o restante: formato Anthropic Messages (Native), campo de autenticação ANTHROPIC_AUTH_TOKEN e URL base.
2. Em Model Mapping, defina o modelo solicitado em todas as funções — Sonnet, Opus, Fable e Haiku — como glm-5.2. Assim, toda requisição vai para o GLM, independentemente da camada que o Claude Code tentar usar. Marque a caixa 1M em uma função para informar ao Claude Code o contexto de um milhão de tokens. Salve as alterações.

1. De volta à lista de provedores, clique em Enable na entrada do Zhipu GLM. Um provedor existente, como Claude Official, pode continuar na lista para você voltar a ele depois. Em seguida, reinicie o Claude Code para garantir que o novo provedor foi carregado. Execute /status e confirme que o modelo exibido é glm-5.2.

O ganho em relação a uma configuração fixa está nos presets para a maioria dos provedores que você talvez queira testar — Kimi, MiniMax, MiMo, Qwen, DeepSeek e outros. Em vez de reescrever configurações, basta selecionar o preset e adicionar a chave; trocar entre eles ou voltar ao Claude leva poucos cliques. É isso que viabiliza o fluxo híbrido descrito mais adiante.

Configuração manual pelo settings.json

Prefere ajustar tudo por conta própria ou está configurando uma máquina de CI sem interface gráfica? Edite o arquivo diretamente.

1. Obtenha uma chave de API no console de API da Z.AI. Tanto uma chave pay-as-you-go quanto uma chave de assinatura do GLM Coding Plan funcionam.
2. Mescle este bloco env ao arquivo de configurações do Claude Code — mantenha quaisquer chaves existentes; não sobrescreva o arquivo inteiro. O bloco é igual em todas as plataformas; o que muda é apenas o caminho:

- macOS / Linux: ~/.claude/settings.json - Windows: %USERPROFILE%\.claude\settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.z.ai/api/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "your_zai_api_key",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-5.2",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-5.2",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-5.2",
    "API_TIMEOUT_MS": "3000000"
  }
}

1. Reinicie o Claude Code e execute /status. A linha do modelo deve mostrar glm-5.2 — ou glm-5.2[1m], na variante com um milhão de tokens. Se ainda aparecer um modelo Claude, o arquivo não foi carregado: verifique erros de sintaxe no JSON e confirme o caminho.

Se preferir não mexer no arquivo, há duas alternativas via shell:

• macOS / Linux — exporte as variáveis no bash/zsh para uma sessão pontual e inicie o Claude Code:

export ANTHROPIC_BASE_URL="https://api.z.ai/api/anthropic"
export ANTHROPIC_AUTH_TOKEN="your_zai_api_key"
export ANTHROPIC_DEFAULT_OPUS_MODEL="glm-5.2"
export ANTHROPIC_DEFAULT_SONNET_MODEL="glm-5.2"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="glm-5.2"
claude

Ao fechar o terminal, você volta à configuração normal.

• Windows — defina variáveis de ambiente persistentes de usuário no PowerShell e reinicie o terminal:

setx ANTHROPIC_BASE_URL "https://api.z.ai/api/anthropic"
setx ANTHROPIC_AUTH_TOKEN "your_zai_api_key"
setx ANTHROPIC_DEFAULT_OPUS_MODEL "glm-5.2"
setx ANTHROPIC_DEFAULT_SONNET_MODEL "glm-5.2"
setx ANTHROPIC_DEFAULT_HAIKU_MODEL "glm-5.2"

As variáveis ANTHROPIC_DEFAULT_* remapeiam os papéis de modelo usados pelo Claude Code: Opus, Sonnet e Haiku. Builds mais recentes incluem também o papel Fable, que o CC Switch já expõe. Ao apontar todas para glm-5.2, cada requisição segue para o GLM. Se preferir manter tarefas de segundo plano rápidas e baratas, use glm-4.5-air no slot do Haiku. Para a janela completa de um milhão de tokens, use glm-5.2[1m]. O valor alto de API_TIMEOUT_MS é mais importante do que parece: respostas do GLM costumam ser mais lentas que as do Claude, e o timeout padrão pode interromper gerações longas.

Endpoint nativo, proxy ou Coding Plan: qual escolher?

Há três formas práticas de usar o GLM-5.2 no Claude Code, e elas não são equivalentes.

Endpoint nativo do z.ai (recomendado). É a URL https://api.z.ai/api/anthropic usada acima. Ela fala o protocolo da Anthropic, então o Claude Code se conecta sem middleware. É a opção padrão.

Proxy de tradução. Outros hosts, como Fireworks, NVIDIA NIM ou pesos hospedados por você, servem o GLM-5.2 por uma API compatível com OpenAI, que o Claude Code não entende diretamente. Nesse cenário, é necessário um proxy que converta os formatos. O claude-code-router faz esse trabalho. Só vale a pena se você já tiver créditos ou hardware em uma dessas plataformas.

Assinatura GLM Coding Plan. É um plano mensal fixo, a partir de US$ 18/mês, segundo a página de assinatura do z.ai. Ele usa o mesmo endpoint do z.ai, mas cobra uma mensalidade fixa em vez de cobrar por token. Para quem programa diariamente no Claude Code, a assinatura costuma ser mais barata e previsível que o consumo medido; compare com seu gasto mensal de tokens para encontrar o ponto de equilíbrio. Se seu uso for irregular, o pay-as-you-go tende a compensar mais.

Como alternar entre GLM-5.2 e Claude

O Claude Code usa um provedor ativo por vez. Portanto, você alterna entre eles, em vez de dividir funções: rode o GLM-5.2 no volume rotineiro e habilite seu provedor Claude Official no CC Switch quando precisar do Claude para arquitetura, código sensível em segurança ou revisão. Qualquer endpoint compatível com Anthropic serve no lado do Claude: sua conta Anthropic ou um relay como o AIReiter, uma entre várias opções. Para roteamento automático por requisição entre provedores, um gateway como o claude-code-router faz a distribuição.

Solução de problemas

Perguntas frequentes

O GLM-5.2 é grátis no Claude Code?

Não de forma ilimitada, embora o z.ai já tenha oferecido janelas gratuitas por tempo limitado para o GLM-5.2, e o Coding Plan comece em US$ 18/mês. Mesmo nas tarifas integrais pay-as-you-go — US$ 1,40 / US$ 4,40 por milhão — um uso leve custa centavos.

O GLM-5.2 oferece contexto de 1M de tokens no Claude Code?

Sim. Troque o ID do modelo para glm-5.2[1m], em vez de glm-5.2, nas variáveis ANTHROPIC_DEFAULT_*. Assim, o Claude Code usará a janela de um milhão de tokens.

Para programar no Claude Code, GLM-5.2 ou Claude é melhor?

Para edições rotineiras e sequenciais, a diferença de preço torna o GLM-5.2 a escolha racional como padrão. O Claude costuma levar vantagem em arquitetura com múltiplas etapas, trabalhos sensíveis à segurança e fluxos de subagentes com alta concorrência. A configuração de alternância permite usar cada um onde é mais forte, em vez de escolher apenas um.

Posso usar o GLM-5.2 em ferramentas além do Claude Code?

Sim. O mesmo endpoint e as mesmas chaves do z.ai funcionam com outros CLIs agentivos: OpenCode, Cline e Kilo Code aceitam uma URL base personalizada, e o CC Switch gerencia presets para vários deles.

Preciso de uma assinatura paga do Claude para usar o GLM-5.2 no Claude Code?

Não. O Claude Code é apenas o cliente; depois de apontá-lo para o z.ai, a cobrança é feita pelo z.ai, não pela Anthropic. Você só precisa de uma conta Claude se quiser mantê-lo disponível como provedor para alternar depois.

Preciso reiniciar o Claude Code após trocar de provedor no CC Switch?

Segundo a documentação do CC Switch, o Claude Code aceita a troca dinâmica dos dados de provedor sem reinicialização, enquanto a maioria dos outros CLIs exige reiniciar o terminal ou aplicativo. Na prática, reiniciar o Claude Code é a forma confiável de garantir que a troca entrou em vigor.

Como voltar ao Claude com login oficial no CC Switch?

Adicione um provedor Claude Official pela lista de presets, habilite-o e execute uma vez o fluxo normal de logout/login do Claude Code via OAuth. Depois disso, você poderá alternar livremente entre seu login oficial do Claude e provedores de terceiros, como o z.ai.

O CC Switch é gratuito e seguro?

Sim. Ele é gratuito, open source e licenciado sob MIT. Suas configurações ficam localmente em um banco de dados SQLite com gravações atômicas e, por projeto, o app faz alterações mínimas nos arquivos de configuração das próprias ferramentas. Assim, seus CLIs continuam funcionando normalmente mesmo se você desinstalar o aplicativo.

Leituras relacionadas

• API do GLM-5.2: acesso e preços
• GLM-5.2 vs Opus 4.6 para programação
• Codex vs Claude Code