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
- 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.
- 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. - 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ável | Valor |
|---|---|
ANTHROPIC_AUTH_TOKEN | sua chave de API I Code Easy |
ANTHROPIC_BASE_URL | https://api.icodeeasy.cc — URL raiz, sem /v1 ou /v1/messages |
ANTHROPIC_MODEL | grok-4.7 |
ANTHROPIC_DEFAULT_HAIKU_MODEL | grok-4.7 |
ANTHROPIC_DEFAULT_SONNET_MODEL | grok-4.7 |
ANTHROPIC_DEFAULT_OPUS_MODEL | grok-4.7 |
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC | 1 |
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
| Sintoma | O que conferir |
|---|---|
| 401 | Confira a chave do serviço, espaços, rotação e URL. Não compartilhe a chave completa. |
| 403 | Confira o estado da conta e o acesso ao modelo. Guarde o texto do erro e o horário. |
| 404 / URL incorreta | Use apenas a raiz em ANTHROPIC_BASE_URL; remova caminhos duplicados como /v1 ou /messages. |
| 429 | Leia o erro completo, reduza a concorrência e tente novamente. Nem todo 429 significa saldo insuficiente. |
| Modelo errado / configuração antiga | Confira o modelo principal e os três padrões. Encerre o processo antigo e reinicie pelo terminal configurado. |
| Timeout / falha de conexão | Confira 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
- Instalação e configuração do Claude Code
- Configuração GLM
- Configuração Kimi
- Configuração Qwen
- Configuração Doubao
- Configuração DeepSeek
- Preços, saldo e uso
- Variáveis de ambiente Anthropic
- Configuração de modelos Anthropic
Guias relacionados
Instalar o Claude Code, Configurar a API e Resolver Erros no Windows
Instale o Claude Code, configure chave e URL da API, verifique o ambiente e resolva erros de autenticação, limites e conexão no Windows, macOS e Linux.
Configurar Kimi Code: API Key, K3.1 Pro e Claude Code
Configure K3.1 Pro no Kimi Code CLI ou Claude Code. Compare opções persistentes e temporárias, valide a primeira chamada e resolva erros 401, de modelo e URL.
Onde vejo preços em RMB, saldo e detalhes de uso?
Consulte preços RMB ao vivo, saldo, logs, uso de tokens, detalhes de cobrança e disponibilidade atual de pagamento nas superfícies públicas e do painel.