Como usar o GLM-5.3 no Claude Code

Configure sua API Key da I Code Easy, a URL raiz https://api.icodeeasy.cc e o modelo glm-5.3 no Claude Code para usar o GLM-5.3 por este serviço. Este guia cobre macOS, Linux, Windows, verificação e erros comuns.

Modelo e cliente são coisas diferentes

GLM-5.3 é o modelo; Claude Code é o cliente de programação da Anthropic. Usar o Claude Code não significa que um modelo Claude processará a solicitação: esta configuração seleciona o GLM-5.3. Use a Key e a URL da I Code Easy, que são diferentes da Key, da assinatura Coding Plan e do endereço oficial da Zhipu.

Antes de começar

1. Se ainda não instalou o cliente, siga o guia de instalação do Claude Code e volte aqui. No Windows, siga as instruções atuais da Anthropic para terminais e requisitos de Git Bash.
2. Cadastre-se e copie a Key deste serviço em API Keys. Escolha um ponto de acesso adequado conforme o guia inicial.
3. Consulte os preços atuais na página de preços e os recursos disponíveis no catálogo de capacidades dos modelos. Preços e cotas do Coding Plan oficial não se aplicam a este serviço.
4. Guarde a Key na sua configuração local. Não a inclua em repositórios, capturas de tela, conversas ou chamados de suporte.

Referência de configuração

As três variáveis de modelo padrão mantêm os aliases Haiku, Sonnet e Opus do Claude Code apontados para GLM-5.3. Elas não transformam o GLM em um modelo Claude. A variável antiga ANTHROPIC_SMALL_FAST_MODEL foi retirada do modelo de configuração recomendado; use as três variáveis padrão acima.

Linux / MacOS

Cole esta configuração no terminal em que executará o Claude Code e substitua o texto de exemplo pela sua Key deste serviço. Os valores se aplicam inicialmente à sessão atual do terminal:

export ANTHROPIC_AUTH_TOKEN="sua API Key da I Code Easy"
export ANTHROPIC_BASE_URL="https://api.icodeeasy.cc"
export ANTHROPIC_MODEL="glm-5.3"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="glm-5.3"
export ANTHROPIC_DEFAULT_SONNET_MODEL="glm-5.3"
export ANTHROPIC_DEFAULT_OPUS_MODEL="glm-5.3"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

Para persistir a configuração, adicione as mesmas linhas export ao arquivo de inicialização do seu shell: ~/.zshrc para zsh ou ~/.bashrc para bash. Execute somente a linha correspondente ao shell utilizado:

source ~/.zshrc

source ~/.bashrc

Você também pode abrir outro terminal. Um processo do Claude Code já em execução não recebe as novas variáveis; encerre-o e inicie-o novamente pelo terminal configurado.

Windows

Para configurar apenas a sessão atual do PowerShell, execute:

$env:ANTHROPIC_AUTH_TOKEN = "sua API Key da I Code Easy"
$env:ANTHROPIC_BASE_URL = "https://api.icodeeasy.cc"
$env:ANTHROPIC_MODEL = "glm-5.3"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "glm-5.3"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "glm-5.3"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "glm-5.3"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"

Para salvar no ambiente do usuário, execute este código na mesma janela após definir as variáveis acima. Ele salva esses sete valores no ambiente do usuário:

$names = @(
  "ANTHROPIC_AUTH_TOKEN",
  "ANTHROPIC_BASE_URL",
  "ANTHROPIC_MODEL",
  "ANTHROPIC_DEFAULT_HAIKU_MODEL",
  "ANTHROPIC_DEFAULT_SONNET_MODEL",
  "ANTHROPIC_DEFAULT_OPUS_MODEL",
  "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC"
)
foreach ($name in $names) {
  $value = [Environment]::GetEnvironmentVariable($name, "Process")
  [Environment]::SetEnvironmentVariable($name, $value, "User")
}

As variáveis do usuário são lidas por processos iniciados depois. Abra uma nova janela do PowerShell após salvar. Se usar VS Code ou outro terminal integrado, reinicie também o aplicativo que o hospeda e só então inicie o Claude Code.

Verifique localmente e envie uma solicitação real

Primeiro, confirme a instalação do cliente. Este comando mostra a versão sem fazer uma solicitação ao modelo:

claude --version

Verifique a existência da Key com um resultado booleano, sem mostrar seu conteúdo:

macOS / Linux:

test -n "$ANTHROPIC_AUTH_TOKEN" && echo true || echo false

PowerShell:

[bool]$env:ANTHROPIC_AUTH_TOKEN

Execute claude no terminal configurado e digite /status no cliente para conferir o modelo e a conexão. A tela de status ajuda a verificar a configuração. Ver Claude Code, Haiku, Sonnet ou Opus na interface, por si só, não comprova que um modelo Claude processou a solicitação.

Em seguida, envie você mesmo uma instrução curta no Claude Code, como “Responda apenas OK”. Isso gera uma solicitação real, cobrada conforme as regras atuais. Confira o sucesso, o modelo registrado e o custo nos logs de solicitações. Não use apenas o nome que o modelo informa na resposta como prova.

Problemas comuns e diagnóstico

Se o domínio principal estiver lento, altere apenas ANTHROPIC_BASE_URL e mantenha as outras variáveis. As URLs alternativas também não incluem /v1:

https://jp.icodeeasy.cc
https://sg.icodeeasy.cc

Reinicie o Claude Code após a troca e repita a verificação. Para diagnóstico, compartilhe código do erro, horário e logs sem dados sensíveis, nunca o conteúdo da Key.

Ao trocar de modelo ou terminal

Se já configurou Claude ou Kimi, confira as variáveis de modelo existentes nesse terminal antes de aplicar estes valores. Não misture valores de guias diferentes. Para voltar, restaure a URL, a Key e as variáveis de modelo conforme o guia correspondente.

O terminal do sistema, o terminal integrado de uma IDE e um cliente já aberto podem herdar ambientes diferentes. Configure e verifique no mesmo terminal usado para iniciar o Claude Code.

Guias relacionados e referências oficiais

• Instalação e configuração geral do Claude Code
• Guia de configuração do Kimi: use as instruções dessa página ao escolher Kimi; não misture nomes de modelos.
• Preços, saldo e uso
• Variáveis de ambiente da Anthropic
• Configuração de modelos da Anthropic
• Guia Claude Code da Zhipu: explica os aliases de modelos; a URL, as Keys e as assinaturas oficiais são diferentes das deste serviço.