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
- Abra https://ai2save.com/keys.
- Haga clic en «Crear clave», ingrese un nombre y seleccione el grupo que contiene el modelo Claude.
- 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:
- Introduce una pregunta corta, por ejemplo "Hola, presenta un poco sobre ti".
- Si se devuelve contenido normalmente, significa que la dirección, la clave y el grupo de modelos están conectados.
- 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_TOKENoANTHROPIC_API_KEYantiguos 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/v1ocurrirá un error; Claude Code debe llenarse conhttps://ai2save.com. - Todavía solicita la dirección oficial: Verifique si quedan direcciones antiguas en
~/.claude/settings.json, en el proyecto.claude/settings.local.jsony 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.