Você pode executar o GLM-5.2 no Claude Code hoje, e a configuração leva cerca de dois minutos. O Claude Code se comunica com qualquer endpoint que fale a Messages API da Anthropic, e a Zhipu fornece exatamente isso para o GLM — aponte o Claude Code para z.ai e pronto. Há duas formas de fazer isso: um aplicativo alternador com um clique (o mais fácil, e ele permite que você volte para o Claude a qualquer momento) ou um arquivo de configuração editado manualmente. Este guia aborda ambos, no macOS, Windows e Linux, além de como voltar para o Claude quando você precisar.
A maneira mais rápida: CC Switch
Se você já lida com mais de um provedor, pule a configuração manual e use CC Switch (código aberto, licença MIT, Windows/macOS/Linux). É um aplicativo de desktop que gerencia as configurações de provedores para Claude Code, Codex, Gemini CLI e algumas outras CLIs, então você não precisa editar JSON manualmente.
1. Instale o CC Switch em ccswitch.io ou no seu repositório no GitHub. Clique no botão laranja + no canto superior direito da janela principal para abrir Add Provider e selecione a aba Claude Provider. 2. Digite zhipu na busca de predefinições. Duas predefinições aparecem — Zhipu GLM (endpoint da China continental) e Zhipu GLM en. Fora da China continental, escolha Zhipu GLM en para o endpoint internacional.
3. Role para baixo e cole sua chave de API z.ai no campo API Key. O preset preenche automaticamente o restante: formato Anthropic Messages (Native), o campo de autenticação ANTHROPIC_AUTH_TOKEN e a URL base.
4. Em Model Mapping, defina o modelo solicitado para cada função — Sonnet, Opus, Fable e Haiku — como glm-5.2, para que cada solicitação seja roteada para o GLM independentemente de qual nível o Claude Code tente usar. Marque a caixa 1M em uma função para informar ao Claude Code o contexto de um milhão de tokens. Salve.
5. De volta à lista de provedores, clique em Enable na entrada Zhipu GLM (um provedor existente como Claude Official pode permanecer na lista para alternar de volta depois), então reinicie o Claude Code para garantir que ele reconheça o novo provedor. Execute /status para confirmar que o modelo mostra glm-5.2.
Por que se preocupar com o app em vez de uma configuração estática: ele já vem com presets para a maioria dos provedores que você gostaria de testar — Kimi, MiniMax, MiMo, Qwen, DeepSeek e outros — então cada um vira uma tarefa de preset e chave, em vez de reescrever a configuração, e alternar entre eles (ou voltar para Claude) leva só alguns cliques. Essa é a base prática para o fluxo de trabalho híbrido abaixo.
Configuração manual com settings.json
Prefere configurá-lo você mesmo, ou configurar uma caixa de CI sem GUI? Edite o arquivo diretamente.
1. Obtenha uma chave de API no console de API da Z.AI. Uma chave pay-as-you-go ou uma chave de assinatura do GLM Coding Plan funcionam. 2. Mescle este bloco env no arquivo de configurações do Claude Code (mantenha quaisquer chaves existentes — não substitua o arquivo inteiro). O bloco é idêntico em todas as plataformas; apenas o caminho difere: - 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"
}
}3. Reinicie o Claude Code, depois execute /status. A linha do modelo deve mostrar glm-5.2 (ou glm-5.2[1m] para a variante de um milhão de tokens). Se ainda mostrar um modelo Claude, o arquivo não foi carregado — verifique erros de sintaxe JSON e confirme o caminho.
Dois alternativas baseadas em shell, se você preferir não mexer no arquivo:
macOS / Linux — exporte as variáveis (bash/zsh) para uma sessão única e, em seguida, execute:
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"
claudeFeche o terminal e você voltará à sua configuração normal.
Windows — defina variáveis de ambiente de usuário persistentes no PowerShell e, em seguida, 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 do modelo para os quais o Claude Code direciona — Opus, Sonnet e Haiku (builds mais recentes adicionam um papel Fable, que o CC Switch também expõe). Defini-las todas como glm-5.2 envia todas as solicitações para o GLM; se você preferir manter as tarefas em segundo plano baratas e rápidas, aponte o slot Haiku para glm-4.5-air em vez disso. Use glm-5.2[1m] para a janela completa de um milhão de tokens. O longo API_TIMEOUT_MS importa mais do que parece: as respostas do GLM costumam ser mais lentas do que as do Claude, e o timeout padrão interromperá gerações longas.
Qual caminho: z.ai nativo, um proxy ou o Plano de Coding?
Três maneiras práticas de alimentar o GLM-5.2 no Claude Code, e elas não são intercambiáveis.
endpoint nativo da z.ai (recomendado). A URL https://api.z.ai/api/anthropic acima. Ele fala o protocolo da Anthropic, então o Claude Code se conecta sem middleware — a escolha padrão.
Um proxy de tradução. Outros hosts (Fireworks, NVIDIA NIM, pesos auto-hospedados) disponibilizam o GLM-5.2 por meio de uma API compatível com a OpenAI que o Claude Code não consegue ler diretamente, então eles precisam de um proxy que converta os formatos. claude-code-router faz isso. Só vale a pena se você já tiver créditos ou hardware em uma dessas plataformas.
Assinatura do GLM Coding Plan. Um plano mensal fixo (a partir de US$18/mês, na página de assinatura da z.ai) que usa o mesmo endpoint da z.ai, mas cobra uma taxa fixa em vez de por token. Se você programa no Claude Code todos os dias, uma assinatura costuma ser mais barata e mais previsível do que tokens medidos; faça as contas com seu gasto mensal em tokens para encontrar o ponto de equilíbrio. Se seu uso é irregular, o pagamento conforme o uso vence.
Alternando entre GLM-5.2 e Claude
Claude Code usa um provedor ativo por vez, então você *alterna* em vez de dividir slots: execute GLM-5.2 para volume rotineiro e ative seu provedor Claude Official no CC Switch quando precisar do Claude para arquitetura, código sensível à segurança ou revisão. Qualquer endpoint compatível com Anthropic funciona para o lado do Claude — sua conta Anthropic, ou um relay como AIReiter, uma opção entre várias. Para roteamento automático por solicitação entre provedores, um gateway como claude-code-router cuida da distribuição.
Solução de problemas
Sintoma | Causa provável | Correção |
|---|---|---|
| settings.json não carregado | Verifique se o JSON é válido; confirme que você editou |
erro | ID de modelo incorreto (diferencia maiúsculas de minúsculas) | Use exatamente |
401 / autenticação falhou | Incompatibilidade entre chave e endpoint | Não combine uma chave do OpenRouter com a URL da z.ai; regenere a chave se necessário |
Gerações longas são interrompidas | Timeout muito baixo | Defina |
Chamadas de ferramenta falham ou entram em loop | JSON da ferramenta malformado | Reduza subagentes paralelos; tente novamente; simplifique a instrução |
Perguntas frequentes
O GLM-5.2 é gratuito no Claude Code?
Não de forma ilimitada, embora a z.ai tenha realizado períodos gratuitos por tempo limitado no GLM-5.2, e o Plano de Codificação começa em US$ 18/mês. Mesmo nas tarifas completas de pagamento por uso (US$ 1,40 / US$ 4,40 por milhão), o uso leve custa centavos.
O GLM-5.2 suporta o contexto de 1M tokens no Claude Code?
Sim. Defina o ID do modelo como glm-5.2[1m] em vez de glm-5.2 nas suas variáveis ANTHROPIC_DEFAULT_*, e o Claude Code usará a janela de um milhão de tokens.
O GLM-5.2 ou o Claude é melhor para programar no Claude Code?
Para edições rotineiras e sequenciais, a diferença de preço faz do GLM-5.2 a escolha padrão racional. O Claude tende a se destacar em arquitetura de várias etapas, trabalho sensível à segurança e fluxos de trabalho de subagentes de alta concorrência. A configuração de alternância permite que você use cada um onde ele é 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 da z.ai funcionam com outras CLIs agentic — OpenCode, Cline e Kilo Code aceitam uma URL base personalizada, e o CC Switch gerencia predefinições para várias delas.
Preciso de uma assinatura paga do Claude para usar o GLM-5.2 no Claude Code?
Não. O Claude Code é apenas o cliente; assim que você o aponta para z.ai, a cobrança é feita pela z.ai, não pela Anthropic. Você só precisa de uma conta Claude se mantiver o Claude disponível como um provedor para alternar para ele.
Preciso reiniciar o Claude Code após trocar de provedor no CC Switch?
De acordo com a documentação do CC Switch, o Claude Code suporta a troca dinâmica dos dados do provedor sem reiniciar, enquanto a maioria das outras ferramentas de CLI exige reiniciar o terminal ou o aplicativo. Na prática, reiniciar o Claude Code é a forma confiável de garantir que a troca tenha sido aplicada.
Como faço para voltar para Claude (login oficial) no CC Switch?
Adicione um provedor oficial do Claude a partir da lista predefinida, habilite-o e, em seguida, execute uma vez o fluxo normal de sair / entrar do Claude Code (OAuth). Depois disso, você pode alternar livremente entre seu login oficial do Claude e provedores de terceiros como z.ai.
O CC Switch é gratuito e seguro para usar?
Sim — é open-source sob a licença MIT e gratuito. Suas configurações ficam localmente em um banco de dados SQLite com gravações atômicas e, por design, ele faz alterações mínimas na configuração própria de cada ferramenta, então seus CLIs continuam funcionando normalmente mesmo se você desinstalar o app.