ai2saveai2save

Tutorial de configuración de Claude Code

Claude Code utiliza el protocolo Anthropic Messages. Al conectarse a ai2save, ingrese la dirección raíz del sitio https://ai2save.com, no agregue manualmente /v1; la clave se utiliza con la sk-... creada en la consola de ai2save.

1. Preparar API Key

  1. Abra https://ai2save.com/keys.
  2. Haga clic en «Crear clave», ingrese un nombre y seleccione el grupo que contiene el modelo Claude.
  3. Copie inmediatamente la Key completa después de crearla. La Key completa solo se muestra una vez.

2. Instalar Claude Code

Primero complete la instalación del entorno Node.js, luego ejecute:

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

Si la versión es inferior a la requerida por el gateway, actualice según las indicaciones:

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

3. Activación temporal en el terminal actual

macOS / Linux / WSL:

export ANTHROPIC_BASE_URL="https://ai2save.com"
export ANTHROPIC_AUTH_TOKEN="sk-tu-api-key"
claude

Windows PowerShell:

$env:ANTHROPIC_BASE_URL="https://ai2save.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-tu-api-key"
claude

ANTHROPIC_AUTH_TOKEN es una variable exclusiva para la clave de estación de tránsito. No configure ANTHROPIC_API_KEY como otra clave oficial al mismo tiempo, para evitar que Claude Code lea credenciales incorrectas.

4. Escribir en el archivo de configuración de Claude Code (recomendado)

Edite ~/.claude/settings.json (en Windows generalmente en %USERPROFILE%\.claude\settings.json):

{
  "$schema": "https://json.schemastore.org/claude-code-settings.json",
  "env": {
    "ANTHROPIC_BASE_URL": "https://ai2save.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-tu-api-key"
  }
}

Después de guardar, vuelve a abrir la terminal e inicia claude. Si solo quieres que surta efecto en un proyecto, escribe el mismo contenido en .claude/settings.local.json dentro del proyecto, no envíes la clave real a Git.

5. Seleccionar modelo y verificar

claude --model claude-sonnet-4-6

Después de ingresar a la interfaz interactiva:

  1. Introduce una pregunta corta, por ejemplo "Hola, presenta un poco sobre ti".
  2. Si se devuelve contenido normalmente, significa que la dirección, la clave y el grupo de modelos están conectados.
  3. Cuando necesites cambiar de modelo, usa /model; el ID del modelo debe coincidir con el ID abierto en la consola.

También puedes usar primero Claude Code para diagnosticar internamente y revisar el estado de la configuración:

/status
/doctor

6. Múltiples configuraciones y limpieza de configuraciones antiguas

Si anteriormente iniciaste sesión en Claude oficial u otro intermediario:

  • Prioriza el uso de CC Switch para gestionar múltiples proveedores, evitando errores al modificar configuraciones manualmente.
  • Al configurar manualmente, asegúrate de que no existan ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN o ANTHROPIC_API_KEY antiguos que sobrescriban los valores actuales.
  • WSL y Windows son dos entornos separados; después de configurar en la terminal de Windows, también es necesario configurar WSL por separado.

Limpieza temporal en macOS / Linux:

unset ANTHROPIC_API_KEY

Errores comunes

  • 401 / invalid_api_key: La clave no se copió completamente, ha sido revocada, o el grupo no contiene el modelo actual.
  • 404 / model not found: El ID del modelo es incorrecto, o el grupo de la clave no tiene acceso a este modelo.
  • Fallo de conexión: Escribiendo Base URL como https://ai2save.com/v1 ocurrirá un error; Claude Code debe llenarse con https://ai2save.com.
  • Todavía solicita la dirección oficial: Verifique si quedan direcciones antiguas en ~/.claude/settings.json, en el proyecto .claude/settings.local.json y en las variables de entorno del terminal.
  • No funciona después de abrir en Windows: Salga completamente del terminal, VS Code o Claude Desktop y vuelva a abrir.