GLM-5.2, GLM-5.3 e GLM-5.3-Flash no Claude Code: configuração e troca de modelo

Configure o GLM no Claude Code usando a APIMaster. Configure o settings.json no Windows, macOS e Linux, inicie o claude, selecione um modelo com /model e comece a conversar.

Configure a APIMaster no settings.json, execute claude e, em seguida, digite /model MODEL_ID na conversa para usar o GLM. Os IDs disponíveis abordados aqui são glm-5.2, glm-5.3, glm-5.3-flash. O Claude Code é o cliente; o GLM é o modelo que responde.

Antes de começar

Conclua a verificação do ambiente e a configuração do Claude Code. Obtenha uma chave de API da APIMaster com saldo suficiente e acesso aos modelos selecionados.

claude --version

A URL base do gateway é https://apimaster.ai, sem /v1. O Claude Code acrescenta /v1/messages por si só.

1. Abra o diretório de configuração

Windows

Pressione Win + R, digite o caminho a seguir e pressione Enter:

%USERPROFILE%\.claude

Crie a pasta, se necessário. Abra ou crie o settings.json. Certifique-se de que o arquivo não se chame settings.json.txt.

macOS / Linux

No macOS, no Finder pressione Command + Shift + G e digite:

~/.claude

No Linux, abra o mesmo diretório com o seu gerenciador de arquivos ou editor. Crie-o, se necessário:

mkdir -p ~/.claude

Abra ou crie o settings.json nesse local. Se você definiu um diretório de configuração personalizado para o Claude Code, use esse diretório.

2. Edite o settings.json

Windows, macOS e Linux usam a mesma configuração. Substitua YOUR_APIMASTER_API_KEY pela sua chave da APIMaster:

{
  "model": "glm-5.3",
  "env": {
    "ANTHROPIC_BASE_URL": "https://apimaster.ai",
    "ANTHROPIC_API_KEY": "YOUR_APIMASTER_API_KEY",
    "ANTHROPIC_AUTH_TOKEN": "",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
  }
}

Se o arquivo já existir, faça um backup e mescle esses campos no objeto JSON existente e no objeto env. Mantenha outras configurações de que precisa. Não acrescente um segundo objeto JSON nem duplique a chave env. JSON não permite comentários nem vírgulas finais.

O guia geral do Claude Code mostra autenticação por token. Este guia usa a autenticação por chave de API exercitada em nossos testes de integração. Mantenha ANTHROPIC_AUTH_TOKEN vazio ao usar ANTHROPIC_API_KEY e remova credenciais conflitantes de outras configurações ou do seu terminal. Use uma chave da APIMaster para este gateway.

O campo model define o modelo inicial. Você pode selecionar outro após o início. Mantenha este arquivo de configurações de usuário privado; não envie chaves reais para um repositório compartilhado. Salve o arquivo e reinicie o Claude Code para carregar a nova configuração.

3. Inicie o Claude Code

Em um terminal aberto no diretório do seu projeto, execute:

claude

Conclua os prompts normais de primeira execução e revise o prompt de confiança do projeto. O modelo inicial deve ser o glm-5.3. Esta é uma sessão interativa normal, com as ferramentas e configurações de projeto habituais.

4. Selecione um modelo e comece a conversar

Na conversa do Claude Code, digite um dos comandos a seguir e pressione Enter:

/model glm-5.2
/model glm-5.3
/model glm-5.3-flash

Execute uma linha por vez, escolhendo o modelo desejado. Depois que o Claude Code confirmar a troca, envie uma mensagem curta:

Reply with exactly OK.

Uma resposta normal em texto confirma a conexão básica. Você pode então continuar conversando ou pedir para ele trabalhar no seu projeto. Para trocar novamente na mesma conversa, digite outro comando /model MODEL_ID.

Digitar apenas /model abre o seletor de modelos. IDs personalizados do gateway podem não aparecer na lista padrão dele. Nesse caso, digite o ID completo, como mostrado acima. O comando de barra pertence ao interior do Claude Code, não ao PowerShell ou ao Bash. Os nomes de modelos descrevem modelos GLM, não o Claude Sonnet ou Opus.

Você também pode escolher um modelo ao iniciar pelo terminal. Execute um comando por vez:

claude --model glm-5.2
claude --model glm-5.3
claude --model glm-5.3-flash

Para definir explicitamente o padrão para sessões futuras, edite o campo model no settings.json. Uma flag de inicialização, a variável de ambiente ANTHROPIC_MODEL ou uma configuração de projeto/gerenciada podem afetar o modelo selecionado; verifique esses pontos se o modelo inicial diferir do valor salvo.

Solução de problemas

Sintoma	Verificação
401 / prompt de login inesperado	Verifique a chave da APIMaster, a URL base e as variáveis de autenticação conflitantes; reinicie a CLI após editar as configurações.
404	Use `https://apimaster.ai`, sem `/v1` ou `/v1/messages`.
As configurações não têm efeito	Verifique o local do arquivo, se o JSON é válido e se há sobreposições de configurações do terminal, do projeto ou gerenciadas.
Modelo ausente no seletor	Digite `/model MODEL_ID` com o ID exato ou inicie com `claude --model MODEL_ID`.
Modelo indisponível / 403	Verifique a ortografia, os modelos permitidos para a chave, o saldo da conta e a disponibilidade atual da rota.
`unrecognized_model`	Observado com IDs personalizados em nossos testes. Verifique a resposta real e o resultado da ferramenta; os padrões nativos de capacidade do Claude não são verificados para o GLM.
Permissão negada para arquivo ou comando	Revise e aprove a operação pretendida pelos prompts de permissão habituais.
429 / 5xx / resposta interrompida	Guarde o erro, o ID do modelo, a versão da CLI, a hora UTC e o ID da requisição, se disponíveis, para o suporte.

Validação e diagnósticos opcionais

Testes de integração registrados: 2026-09-15 UTC, Claude Code 2.1.239, Linux. Todos os modelos listados aqui retornaram o texto esperado e leram um arquivo local por meio de uma ferramenta. Os três também concluíram uma pequena correção em Python e uma execução de testes, verificada de forma independente depois. Windows e macOS não fizeram parte dessas execuções registradas.

As verificações automatizadas anteriores usaram o modo bare para isolar a configuração. O uso diário normal segue o settings.json e as etapas interativas acima. O modo bare e --setting-sources "" ignoram integrações normais ou configurações salvas, portanto não devem ser adicionados ao comando de inicialização cotidiano deste guia.

Para uma verificação rápida não interativa usando sua configuração salva:

claude --model glm-5.3 -p "Reply with exactly OK."

Para uma verificação de ferramenta, crie um probe.txt contendo FILE_PROBE_739182, inicie o Claude Code nesse diretório e peça que ele leia o arquivo usando uma ferramenta e retorne seu conteúdo exato. Confirme que a ferramenta realmente foi executada.

Estas são verificações de integração delimitadas, não uma garantia de todos os recursos do Claude Code, do comportamento em sessões longas ou do contexto máximo. A documentação de gateway da Anthropic não oferece suporte oficial ao roteamento do Claude Code para modelos que não sejam do Claude; este guia descreve a integração da APIMaster.

FAQ

Minha assinatura do Claude paga por essas requisições?

Não. Com esta configuração da APIMaster, as requisições usam sua chave e saldo da APIMaster.

Posso continuar conversando após trocar de modelo?

Sim, use o comando de troca de modelo na conversa aberta e aguarde a confirmação antes de enviar a próxima mensagem. Para uma comparação limpa entre modelos, inicie uma sessão separada com claude --model MODEL_ID.