Claude Code hasta Model Gate

esta guía muestrala instalación recomendada y la configuración persistente utilizando settings.json, en lugar de variables de entorno temporales.

ANTHROPIC_BASE_URL no debe incluir /v1. Usar https://api.model-gate.com.

Valores requeridos

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

1. Instalar el código Claude

WindowsPowerShell

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

Cierre y vuelva a abrir PowerShell, luego verifique:

claude --version

Linux/macOS

Instale Claude Code usando el método oficial para su sistema, luego verifique:

claude --version

2. Configurar ajustes persistentes.json

Linux/macOS

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

WindowsPowerShell

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

3. Ejemplo de configuración.json

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.model-gate.com",
    "ANTHROPIC_API_KEY": "mg_live_...",
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1",
    "CLAUDE_CODE_EFFORT_LEVEL": "high",
    "ANTHROPIC_MODEL": "gpt-5.4",
    "ANTHROPIC_SMALL_FAST_MODEL": "claude-haiku-4.5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4.7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4.6",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4.5",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "180000",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "64000",
    "CLAUDE_CODE_FILE_READ_MAX_OUTPUT_TOKENS": "100000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "DISABLE_TELEMETRY": "1",
    "DISABLE_ERROR_REPORTING": "1",
    "DISABLE_AUTOUPDATER": "1",
    "DISABLE_BUG_COMMAND": "1",
    "DISABLE_COST_WARNINGS": "1",
    "DISABLE_NON_ESSENTIAL_MODEL_CALLS": "1",
    "CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY": "1",
    "BASH_DEFAULT_TIMEOUT_MS": "120000",
    "BASH_MAX_TIMEOUT_MS": "600000",
    "BASH_MAX_OUTPUT_LENGTH": "100000",
    "MAX_THINKING_TOKENS": "31999"
  },
  "permissions": {
    "allow": ["Read", "Write", "MultiEdit", "WebFetch(domain:*)", "Bash", "WebSearch"],
    "deny": [],
    "defaultMode": "bypassPermissions",
    "additionalDirectories": []
  },
  "skipDangerousModePermissionPrompt": true,
  "effortLevel": "max",
  "model": "gpt-5.4"
}

4. Configuración explicada

Conexión a la puerta modelo

ANTHROPIC_BASE_URL y ANTHROPIC_API_KEY enrutar todas las solicitudes a través de Model Gate.

Modelo predeterminado

ANTHROPIC_MODEL y el nivel superior model Seleccione el modelo principal. Utilice cualquier ID de modelo habilitado.

modelo rápido

ANTHROPIC_SMALL_FAST_MODEL selecciona un modelo más rápido para tareas ligeras en segundo plano.

Anular los botones del modelo GUI

ANTHROPIC_DEFAULT_OPUS_MODEL, ANTHROPIC_DEFAULT_SONNET_MODEL, y ANTHROPIC_DEFAULT_HAIKU_MODEL reemplace las tres ranuras del modelo estándar que se muestran en la GUI y /model menú.

5. Lanzamiento

claude

6. Lanzamiento temporal sin settings.json

Linux/macOS

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

WindowsPowerShell

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

7. Windows 11: comando claude no encontrado

que hacer

Cierre y vuelva a abrir PowerShell, luego ejecute claude --version. Si aún no está disponible, ejecute where.exe claude y reinstale con el script oficial si es necesario.

Importante

La solución más común es simplemente reiniciar PowerShell para que se cargue la RUTA actualizada.

8. Si Claude Code solicita autorización

Complete el inicio de sesión de Anthropic una vez, cierre Claude Code y ejecútelo nuevamente con la configuración de Model Gate. Cree su clave API en la sección Claves API y cópiela inmediatamente.