Início rápido do Claude Code

Este guia conecta Claude Code a 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 de 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

macOS ou Linux

Execute este comando como seu usuário normal:

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

Quando você já estiver conectado como root em um VPS ou contêiner, use:

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

Não adicione sudo em um computador pessoal.

Windows PowerShell

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

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 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 Claude Code

Windows PowerShell

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

Linux

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

macOS

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

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

Windows PowerShell

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

Linux

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

macOS

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

Etapa 3: criar settings.json

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

Windows 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

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

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

Etapa 4: iniciar Claude Code

Windows PowerShell

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

Linux

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

macOS

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 Claude Code você mesmo:

claude

Com qualquer método, envie:

Responda com uma frase confirmando o modelo ativo.

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