Claude Code através do Model Gate

Este guia usa um permanente settings.json configuração. ANTHROPIC_BASE_URL deve ser especificado sem /v1.

Valores obrigatórios

ANTHROPIC_BASE_URL=https://api.model-gate.com
ANTHROPIC_AUTH_TOKEN=mg_live_...

ANTHROPIC_AUTH_TOKEN é enviado como um token ao portador. Model Gate também aceita x-api-key, mas o formulário de token de autenticação é apropriado para um gateway LLM.

1. Instale Claude Code

Instalador nativo do macOS ou Linux

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

alternativa npm

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

Windows PowerShell

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

Feche e reabra o terminal e verifique:

claude --version

Use as instruções de instalação oficiais atuais quando o instalador for alterado: https://docs.anthropic.com/en/docs/claude-code/getting-started.

2. Crie o diretório de configurações

Linux ou macOS

mkdir -p ~/.claude
nano ~/.claude/settings.json

Windows PowerShell

New-Item -ItemType Directory -Force "$HOME\.claude" | Out-Null
notepad "$HOME\.claude\settings.json"

3. Configurações recomendadas.json

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.model-gate.com",
    "ANTHROPIC_AUTH_TOKEN": "mg_live_...",
    "ANTHROPIC_MODEL": "claude-sonnet-4.6",
    "ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-4.5"
  },
  "model": "claude-sonnet-4.6"
}

Substitua os IDs do modelo pelos IDs ativados retornados por:

curl https://api.model-gate.com/v1/models \
  -H "Authorization: Bearer mg_live_..."

4. Substitua os slots Opus, Sonnet e Haiku

Claude Code expõe três slots de modelo padrão. Você pode mapeá-los para IDs de modelo do Model Gate:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.model-gate.com",
    "ANTHROPIC_AUTH_TOKEN": "mg_live_...",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4.7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4.6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5"
  }
}

Esses valores substituem os três slots padrão; eles não criam novos botões GUI ilimitados.

5. Configurações opcionais de privacidade e tempo limite

Adicione apenas configurações que você entende:

{
  "env": {
    "DISABLE_TELEMETRY": "1",
    "DISABLE_ERROR_REPORTING": "1",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "BASH_DEFAULT_TIMEOUT_MS": "120000",
    "BASH_MAX_TIMEOUT_MS": "600000"
  }
}

Não habilite o desvio de permissão globalmente, a menos que você entenda o impacto na segurança. O Modelo Gate não requer bypassPermissions.

6. Início Claude Code

claude

Usar /model para inspecionar ou alterar o modelo selecionado.

7. Teste único sem settings.json

Linux ou macOS

export ANTHROPIC_BASE_URL="https://api.model-gate.com"
export ANTHROPIC_AUTH_TOKEN="mg_live_..."
claude

Windows PowerShell

$env:ANTHROPIC_BASE_URL = "https://api.model-gate.com"
$env:ANTHROPIC_AUTH_TOKEN = "mg_live_..."
claude

Solução de problemas

Problema	Resolução
claude não foi encontrado	Feche e reabra o terminal e execute claude --version. Verificar where.exe claude no Windows ou which claude no Unix.
A autenticação é solicitada	Verificar ANTHROPIC_AUTH_TOKEN, feche Claude Code e inicie novamente.
O modelo não foi encontrado	Use um ID canônico ou um alias habilitado retornado por /v1/models.
Solicitações vão diretamente para a Antrópica	Confirme se o URL base é exatamente https://api.model-gate.com sem /v1.
401 invalid_api_key	Gire a chave Model Gate e atualize settings.json.

Referência oficial do gateway: https://docs.anthropic.com/en/docs/claude-code/llm-gateway.