# Conecta Claude Code a MandAPI

Configura el endpoint compatible con Anthropic, elige un modelo admitido y comprueba tu primera sesión de programación.

## Qué vas a configurar

Claude Code se ejecuta en tu equipo y envía las solicitudes del modelo mediante MandAPI. Esta guía corresponde a la herramienta de terminal. La aplicación de escritorio de Claude utiliza otra configuración de gateway. Para una instalación gestionada en Windows, puedes usar [MandAPI Connect](/es/connect).

Instala Claude Code siguiendo su guía oficial vigente. Crea una clave de MandAPI desde tu [panel](https://app.mandapi.com/console) y elige un modelo visible para tu cuenta que admita el formato Anthropic Messages y las funciones de programación que necesitas. Sustituye `MODEL_ID` por su identificador exacto. Que un modelo aparezca en el catálogo no confirma todas sus capacidades de herramientas.

## Configura una sesión de terminal

La dirección base compatible con Anthropic es `https://api.mandapi.com`. Claude Code añade la ruta de Messages. Empieza con variables que duren solo esta sesión para comprobar la conexión antes de guardarla de forma permanente.

Bash:

```bash
export ANTHROPIC_BASE_URL="https://api.mandapi.com"
read -rsp "Clave de MandAPI: " ANTHROPIC_AUTH_TOKEN
printf '\n'
export ANTHROPIC_AUTH_TOKEN
unset ANTHROPIC_API_KEY
claude --model MODEL_ID
```

PowerShell:

```powershell
$env:ANTHROPIC_BASE_URL = 'https://api.mandapi.com'
$env:ANTHROPIC_AUTH_TOKEN = [Net.NetworkCredential]::new('', (Read-Host 'Clave de MandAPI' -AsSecureString)).Password
Remove-Item Env:ANTHROPIC_API_KEY -ErrorAction SilentlyContinue
claude --model MODEL_ID
```

Guarda la credencial en tu entorno personal o gestor de secretos. Un archivo compartido del proyecto debe contener instrucciones, no tu clave real. Las variables de sesión desaparecen al cerrar esa terminal.

## Comprueba la primera sesión

Abre un proyecto pequeño, inicia Claude Code y ejecuta `/status` para revisar la conexión activa. Pide: “Lee el README y resume este proyecto en tres frases. No cambies archivos”. Comprueba que llega una respuesta normal y revisa el consumo correspondiente en el panel de MandAPI. Esto prueba una tarea breve de texto; comprueba por separado las acciones con herramientas que necesites antes de usar un proyecto grande.

## Resuelve problemas de conexión

Si falla la autenticación, comprueba que la terminal del proceso recibió `ANTHROPIC_AUTH_TOKEN` y que la clave sigue activa. Comprueba su presencia sin mostrar su valor. Si falta el modelo o la ruta, revisa el identificador exacto y la dirección: esta configuración de Claude Code utiliza el host sin el sufijo `/v1`. Reinicia la herramienta después de cambiar su entorno. Conserva las confirmaciones normales de permisos.

## Termina o restaura la sesión anterior

Cierra la terminal configurada para descartar estas variables. Si continúas en la misma sesión de Bash, elimina las dos variables `ANTHROPIC_`; en PowerShell, elimínalas de `Env:`. Tu inicio de sesión personal de Claude es independiente de la clave de MandAPI. Abre tu terminal habitual para volver a su configuración normal.

## Referencias

- [https://code.claude.com/docs/en/llm-gateway-connect](https://code.claude.com/docs/en/llm-gateway-connect)
- [https://mandapi.com/en/connect](https://mandapi.com/en/connect)
- [https://mandapi.com/es/connect](https://mandapi.com/es/connect)