Instalar o Claude Code, Configurar a API e Resolver Erros no Windows

Para usar uma API Key do I Code Easy no Claude Code, instale a CLI, defina ANTHROPIC_AUTH_TOKEN e ANTHROPIC_BASE_URL, abra um novo terminal e execute claude na pasta do projeto. O Claude Desktop usa configurações próprias de Gateway no aplicativo; veja as etapas abaixo.

Antes de começar: conta, chave e modelo

1. Crie uma conta, entre e copie a chave do site em API Keys. Não use a senha de login.
2. Em Seleção de endpoints, escolha e salve um endpoint para a família de modelos desejada. Veja Primeiros passos.
3. Consulte preços, saldo e uso e recursos dos modelos para confirmar IDs, condições e protocolos. Instalar o cliente não fornece créditos de API nem acesso aos modelos.

Guarde a chave apenas na configuração do seu cliente. Não a inclua no Git ou em capturas públicas. Se houver exposição, troque a chave na página API Keys.

Etapa 1: Instalar o Claude Code

Escolha o instalador nativo ou npm. Para preparar o Node.js e o terminal necessários ao npm, veja Configuração do ambiente.

MacOS / Linux / WSL

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell

irm https://claude.ai/install.ps1 | iex

Windows CMD

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

O instalador nativo atualiza o Claude Code automaticamente em segundo plano.

Instalação via npm (após concluir a configuração do ambiente)

npm i -g @anthropic-ai/claude-code

Etapa 2: Configurar a API

As variáveis abaixo se aplicam somente à CLI do Claude Code. O Desktop não lê esse ANTHROPIC_BASE_URL nem o settings.json da CLI; use as configurações separadas abaixo.

Linux / MacOS

Execute estes comandos no shell atual. Para mantê-los nas próximas sessões, adicione-os ao ~/.bashrc ou ~/.zshrc correspondente ao shell. Substitua o texto de exemplo pela sua API Key:

export ANTHROPIC_AUTH_TOKEN="your API Key"
export ANTHROPIC_BASE_URL="https://api.icodeeasy.cc"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

Não defina CLAUDE_CODE_ATTRIBUTION_HEADER=0; alguns canais exclusivos do Claude Code validam os metadados nativos de atribuição do cliente.

Se api.icodeeasy.cc estiver lento na sua rede, altere ANTHROPIC_BASE_URL para https://jp.icodeeasy.cc ou https://sg.icodeeasy.cc.

Salve o arquivo e execute source ~/.bashrc ou source ~/.zshrc.

Windows

Execute no PowerShell:

# Set API key
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "your API Key", "User")

# Set API base URL
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://api.icodeeasy.cc", "User")

# Disable non-essential traffic
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "1", "User")

Se api.icodeeasy.cc estiver lento na sua rede, altere ANTHROPIC_BASE_URL para https://jp.icodeeasy.cc ou https://sg.icodeeasy.cc.

Abra uma nova janela do PowerShell após definir as variáveis de ambiente.

Verifique as variáveis de ambiente do usuário na nova janela:

-not [string]::IsNullOrWhiteSpace([Environment]::GetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "User"))
[Environment]::GetEnvironmentVariable("ANTHROPIC_BASE_URL", "User")
[Environment]::GetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "User")

SetEnvironmentVariable grava variáveis persistentes no nível do usuário. Ele não atualiza a sessão atual do PowerShell. Abra uma nova janela do PowerShell antes de iniciar claude.

Verificar o ambiente que a CLI vai ler

No macOS / Linux / WSL, confira se a chave existe sem exibi-la:

[ -n "$ANTHROPIC_AUTH_TOKEN" ] && echo "Token configured" || echo "Token missing"
printf '%s\n' "$ANTHROPIC_BASE_URL"

No Windows, verifique o ambiente do processo em uma nova janela do PowerShell:

-not [string]::IsNullOrWhiteSpace($env:ANTHROPIC_AUTH_TOKEN)
$env:ANTHROPIC_BASE_URL

O primeiro resultado deve ser True, e o endereço deve ser o domínio escolhido. Se a variável salva no usuário existe, mas o resultado é False, o processo de inicialização ainda não atualizou o ambiente. O terminal de uma IDE pode herdar valores antigos do editor; feche e reabra o editor por completo, se necessário.

O WSL usa um ambiente Linux. Mesmo após salvar as variáveis no PowerShell do Windows, configure-as também no shell do WSL seguindo as etapas de Linux. Use apenas o domínio no Base URL; não acrescente /v1/messages.

Etapa 3: Iniciar o Claude Code

Primeiro confira a versão instalada no terminal:

claude --version

cd your-project-folder
claude

Após iniciar, digite /status para conferir modelo, conta, origem das credenciais e URL do gateway. Isso verifica a configuração; não substitui a validação com uma requisição real.

Envie uma pergunta curta, confirme a resposta e confira modelo, status e uso nos logs de requisições. Instalar o cliente, abrir a CLI ou confirmar a presença da chave, isoladamente, não comprova uma requisição de API bem-sucedida.

Solução de problemas do Claude Code

Os endereços alternativos são https://jp.icodeeasy.cc e https://sg.icodeeasy.cc; mantenha a mesma chave do site. Trocar o domínio é uma medida de recuperação de conexão, não uma troca de conta ou modelo. Veja Conexão e recuperação.

Ao pedir suporte, envie versão do cliente, sistema operacional, horário de Pequim, erro sem dados sensíveis e identificador da requisição. Não envie a API Key ou todas as variáveis de ambiente.

Usar Kimi ou GLM no Claude Code

Cliente, endereço da API e nome do modelo são configurações distintas. Definir somente o Base URL não seleciona Kimi ou GLM. Siga o guia do Kimi ou o guia do GLM para configurar o modelo e verificar a seleção ao iniciar. Consulte esses guias e o catálogo de recursos para as condições atuais.

Configuração do Claude Desktop

O Claude Desktop pode se conectar a um relay de terceiros pelo Developer Mode.

O Desktop usa configurações próprias de third-party inference e não herda as variáveis da CLI acima. A disponibilidade dos menus depende da versão instalada. O uso do modelo também depende do catálogo e das condições do endpoint; informar o nome não comprova a compatibilidade.

Ativar o Developer Mode

Na barra de menu, clique em Help -> Troubleshooting -> Enable Developer mode e reinicie o Claude Desktop.

Configurar o relay

Após reiniciar, clique em Developer -> Configure third-party inference na barra de menu e preencha:

Se api.icodeeasy.cc estiver lento na sua rede, altere o Base URL para https://jp.icodeeasy.cc ou https://sg.icodeeasy.cc.

Definir modelo

Informe o nome do modelo que deseja usar, como claude-opus-5-5 ou claude-sonnet-5-5, salve e reinicie o Claude Desktop. Os modelos Claude podem usar os endpoints Claude.

Para configurar modelos Kimi e GLM, consulte o guia do Kimi e o guia do GLM. Para fixar o Claude Fable 5, consulte o Guia do Claude Fable 5.

Referências oficiais

• Instalação e atualizações
• Variáveis de ambiente
• Configuração de modelos
• Gateways de terceiros e Desktop