Guias de modelosIniciantesAtualizado em

Como usar Grok 4.7 no Claude Code

Configure o Claude Code com sua chave I Code Easy, a URL raiz https://api.icodeeasy.cc e o modelo grok-4.7 para usar Grok 4.7 pelo serviço. Veja as etapas para macOS, Linux e Windows.

Escolha o modelo de texto Grok

Grok é o modelo; Claude Code é o cliente de programação. Este guia descreve a integração do Claude Code oferecida pelo I Code Easy e exige uma chave do serviço. Uma chave xAI, conta ou assinatura Grok não a substitui. O suporte de interfaces da API direta da xAI é separado do oferecido aqui.

grok-4.7 é um ID de modelo de texto. Os modelos Grok Imagine de imagem e vídeo usam interfaces separadas. Não coloque nomes Imagine nestas variáveis; consulte os guias de imagem ou vídeo.

Antes de começar

  1. Instale o cliente pelo guia do Claude Code. Estas instruções são para o terminal; consulte o mesmo guia para a configuração separada de gateway no Desktop.
  2. Cadastre-se e copie sua chave em API Keys. Confira a disponibilidade e os pontos de acesso selecionáveis no painel; o nome exibido para Claude Code é Grok-4.7.
  3. Confira os preços na página de preços e os recursos no catálogo de capacidades. Cotas e recursos de assinaturas oficiais não descrevem este serviço.

Referência de configuração

VariávelValor
ANTHROPIC_AUTH_TOKENsua chave de API I Code Easy
ANTHROPIC_BASE_URLhttps://api.icodeeasy.cc — URL raiz, sem /v1 ou /v1/messages
ANTHROPIC_MODELgrok-4.7
ANTHROPIC_DEFAULT_HAIKU_MODELgrok-4.7
ANTHROPIC_DEFAULT_SONNET_MODELgrok-4.7
ANTHROPIC_DEFAULT_OPUS_MODELgrok-4.7
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC1

Os aliases Haiku, Sonnet e Opus também apontam para grok-4.7; isso não transforma Grok em Claude. Configurações existentes e argumentos de inicialização podem afetar a seleção. Confira após trocar.

macOS / Linux

Cole no terminal em que iniciará o Claude Code. Substitua o texto da chave sem acrescentar o prefixo Bearer. Os valores valem inicialmente para este terminal:

export ANTHROPIC_AUTH_TOKEN="sua chave de API I Code Easy"
export ANTHROPIC_BASE_URL="https://api.icodeeasy.cc"
export ANTHROPIC_MODEL="grok-4.7"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="grok-4.7"
export ANTHROPIC_DEFAULT_SONNET_MODEL="grok-4.7"
export ANTHROPIC_DEFAULT_OPUS_MODEL="grok-4.7"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

Para persistir, salve as mesmas linhas export no ~/.zshrc ou ~/.bashrc do shell utilizado e abra outro terminal. Não envie arquivos com chaves para repositórios. Veja os detalhes em preparação do ambiente.

Windows PowerShell

Execute na mesma janela do PowerShell em que iniciará o Claude Code:

$env:ANTHROPIC_AUTH_TOKEN = "sua chave de API I Code Easy"
$env:ANTHROPIC_BASE_URL = "https://api.icodeeasy.cc"
$env:ANTHROPIC_MODEL = "grok-4.7"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = "grok-4.7"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL = "grok-4.7"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL = "grok-4.7"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC = "1"

Os valores valem para esta janela e seus processos filhos. Para salvar no ambiente do usuário, siga as etapas Windows do GLM usando os valores atuais destas sete variáveis. Depois reabra o PowerShell e reinicie a IDE caso use o terminal integrado.

Verifique a configuração e a primeira requisição

Confira a versão e a presença da chave. Estes comandos não fazem requisições ao modelo nem exibem a chave:

claude --version

macOS / Linux:

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

PowerShell:

[bool]$env:ANTHROPIC_AUTH_TOKEN

Execute claude neste terminal e use /status para conferir modelo, URL e origem da credencial. Depois envie você mesmo “Responda apenas OK” e confira sucesso, modelo e cobrança nos logs de requisições. Requisições reais seguem a cobrança vigente.

/status informa a configuração local, sem comprovar sucesso da inferência. Os nomes Claude, Haiku, Sonnet ou Opus na interface, assim como a identificação que o modelo dá na resposta, não substituem a consulta aos logs.

Solução de problemas

SintomaO que conferir
401Confira a chave do serviço, espaços, rotação e URL. Não compartilhe a chave completa.
403Confira o estado da conta e o acesso ao modelo. Guarde o texto do erro e o horário.
404 / URL incorretaUse apenas a raiz em ANTHROPIC_BASE_URL; remova caminhos duplicados como /v1 ou /messages.
429Leia o erro completo, reduza a concorrência e tente novamente. Nem todo 429 significa saldo insuficiente.
Modelo errado / configuração antigaConfira o modelo principal e os três padrões. Encerre o processo antigo e reinicie pelo terminal configurado.
Timeout / falha de conexãoConfira proxy e rede; tente as URLs alternativas e o guia abaixo.

Se a URL principal estiver lenta, troque apenas ANTHROPIC_BASE_URL, mantendo a chave e as variáveis de modelo:

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

Reinicie o Claude Code após trocar. Se precisar de ajuda, siga o guia de conexão e envie código do erro, horário com fuso e logs sem dados sensíveis. Não inclua a chave completa.

Guias e referências