Claude Code a través de Model Gate

Esta guía utiliza un permanente settings.json configuración. ANTHROPIC_BASE_URL debe ser especificado sin /v1.

Valores requeridos

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

ANTHROPIC_AUTH_TOKEN se envía como token al portador. Model Gate también acepta x-api-key, pero el formulario de token de autenticación es apropiado para una puerta de enlace LLM.

1. Instale Claude Code

Instalador nativo de macOS o 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

Cierre y vuelva a abrir la terminal, luego verifique:

claude --version

Utilice las instrucciones de instalación oficiales actuales cuando cambie el instalador: https://docs.anthropic.com/en/docs/claude-code/getting-started.

2. Cree el directorio de configuración.

Linux o 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. Configuración recomendada.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"
}

Reemplace los ID de modelo con ID habilitados devueltos por:

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

4. Anule las ranuras Opus, Sonnet y Haiku

Claude Code expone tres espacios de modelo estándar. Puede asignarlos a los ID de modelo de 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"
  }
}

Estos valores anulan las tres ranuras estándar; no crean nuevos botones GUI ilimitados.

5. Configuraciones opcionales de privacidad y tiempo de espera

Agregue solo configuraciones que comprenda:

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

No habilite la omisión de permisos globalmente a menos que comprenda el impacto en la seguridad. El modelo Gate no requiere bypassPermissions.

6. Comience Claude Code

claude

Usar /model para inspeccionar o cambiar el modelo seleccionado.

7. Prueba única sin settings.json

Linux o 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

Solución de problemas

Problema	Resolución
claude no se encuentra	Cierre y vuelva a abrir la terminal, luego ejecute claude --version. Controlar where.exe claude en Windows o which claude en Unix.
Se solicita autenticación	Verificar ANTHROPIC_AUTH_TOKEN, cierre Claude Code y vuelva a iniciarlo.
No se encuentra el modelo	Utilice una ID canónica o un alias habilitado devuelto por /v1/models.
Las solicitudes van directamente a Anthropic	Confirma que la URL base es exactamente https://api.model-gate.com sin /v1.
401 invalid_api_key	Gire la tecla Model Gate y actualice settings.json.

Referencia oficial de la puerta de enlace: https://docs.anthropic.com/en/docs/claude-code/llm-gateway.