Claude Code

Este guia conecta Claude Code ao Modelflare e envia a primeira solicitação bem-sucedida. Use a Opção A para configuração automatizada. Use a Opção B para instalar o Claude Code primeiro e, em seguida, crie você mesmo as configurações do usuário.

1. Crie uma chave API

Crie uma chave de API Modelflare cujo grupo não padrão possa acessar claude-opus-4-8 e claude-sonnet-5. Mantenha a chave completa em mãos; o instalador pede isso uma vez.

2. Escolha um método de configuração

Opção A: execute o instalador

Ainda não está confortável com o terminal? Comece com o guia interativo de primeira execução. É apenas um ensaio visual e não altera o seu computador.

macOS ou Linux

Execute este comando como seu usuário normal:

bash

curl -fsSL https://modelflare.dev/install/claude.sh | sh

Quando você já estiver logado como root em um VPS ou container, use:

bash

curl -fsSL https://modelflare.dev/install/claude.sh | MODELFLARE_ALLOW_ROOT=1 sh

Não adicione sudo em um computador pessoal.

Windows PowerShell

Abra o PowerShell como usuário normal do Windows e execute:

PowerShell

irm https://modelflare.dev/install/claude.ps1 | iex

O instalador solicita que você escolha chinês simplificado, japonês ou inglês, instala a CLI oficial do Claude Code quando necessário, solicita a chave da API Modelflare uma vez, faz backup e mescla as configurações de usuário existentes e verifica os dois modelos configurados. Ele não inicia o Claude Code automaticamente.

Opção B: configurar Claude Code manualmente

Siga cada etapa na ordem e execute apenas o comando do seu sistema operacional.

Etapa 1: instalar o Claude Code

Windows PowerShell

PowerShell

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

Linux

bash

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

macOS

bash

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

Passo 2: crie e entre no diretório de configurações do usuário

Windows PowerShell

PowerShell

New-Item -ItemType Directory -Force "$HOME\.claude" | Out-Null
Set-Location "$HOME\.claude"

Linux

bash

mkdir -p ~/.claude
cd ~/.claude

macOS

bash

mkdir -p ~/.claude
cd ~/.claude

Etapa 3: criar settings.json

Antes de executar o comando para o seu sistema, substitua YOUR_MODELFLARE_API_KEY pela sua chave API Modelflare completa.

Windows PowerShell

PowerShell

$settings = @'
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://modelflare.dev",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_MODELFLARE_API_KEY",
    "ANTHROPIC_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-5"
  }
}
'@
$utf8NoBom = New-Object System.Text.UTF8Encoding -ArgumentList $false
[System.IO.File]::WriteAllText(
  (Join-Path (Get-Location) "settings.json"),
  $settings,
  $utf8NoBom
)

Linux

bash

cat > settings.json << 'EOF'
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://modelflare.dev",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_MODELFLARE_API_KEY",
    "ANTHROPIC_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-5"
  }
}
EOF
chmod 600 settings.json

macOS

bash

cat > settings.json << 'EOF'
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://modelflare.dev",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_MODELFLARE_API_KEY",
    "ANTHROPIC_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-5",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-5"
  }
}
EOF
chmod 600 settings.json

Passo 4: iniciar Claude Code

Windows PowerShell

PowerShell

Set-Location $HOME
New-Item -ItemType Directory -Force "my-claude-project" | Out-Null
Set-Location "my-claude-project"
claude

Linux

bash

cd ~
mkdir -p my-claude-project
cd my-claude-project
claude

macOS

bash

cd ~
mkdir -p my-claude-project
cd my-claude-project
claude

3. Envie a primeira solicitação

Após a conclusão da Opção A, insira um diretório de projeto em que você confia e inicie você mesmo o Claude Code:

bash

claude

Com qualquer um dos métodos, envie:

Text

Reply with one sentence confirming the active model.

Uma resposta normal significa que a configuração foi concluída.