Configuração do Claude Code / Claude Desktop

A ferramenta CLI oficial e o cliente desktop da Anthropic podem se conectar pelo serviço de relay.

No MacOS, recomendamos usar o iTerm2 para uma experiência melhor no terminal.

Etapa 1: Instalar o Claude Code

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

Linux / MacOS

Adicione o seguinte ao ~/.bashrc ou ~/.zshrc (modelo recomendado por padrão: kimi-k2.7):

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

Se api.icodeeasy.cc estiver lento na sua rede, altere ANTHROPIC_BASE_URL para https://jp.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 relay 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")

# Disable attribution header
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_ATTRIBUTION_HEADER", "0", "User")

Se api.icodeeasy.cc estiver lento na sua rede, altere ANTHROPIC_BASE_URL para https://jp.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:

[Environment]::GetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "User")
[Environment]::GetEnvironmentVariable("ANTHROPIC_BASE_URL", "User")
[Environment]::GetEnvironmentVariable("CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC", "User")
[Environment]::GetEnvironmentVariable("CLAUDE_CODE_ATTRIBUTION_HEADER", "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.

Etapa 3: Iniciar o Claude Code

cd your-project-folder
claude

Configuração do Claude Desktop

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

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.

Definir modelo

Informe o nome do modelo que deseja usar, como claude-sonnet-4-6, kimi-k2.7 ou glm-5.2, salve e reinicie o Claude Desktop.