# Usa Codex CLI con MandAPI

Añade un proveedor personalizado de Responses con una clave en el entorno y conserva la configuración del proyecto.

## Antes de empezar

Instala Codex CLI siguiendo las instrucciones oficiales vigentes de OpenAI. Esta receta configura un proveedor personalizado para el cliente de terminal; es independiente del inicio de sesión con una suscripción de ChatGPT. Necesitas una clave activa de MandAPI y el identificador exacto de un modelo disponible para tu cuenta que funcione con la API Responses y tu flujo de programación.

MandAPI Connect ya gestiona la configuración de su Codex incluido para Windows. Si utilizas Connect, sigue la [guía de Connect](/es/connect) en lugar de editar los archivos privados de la aplicación.

## Añade la configuración del proveedor

En una instalación independiente, Codex normalmente lee `~/.codex/config.toml`. En Windows corresponde a `%USERPROFILE%\.codex\config.toml`. Guarda una copia del archivo existente, combina estos ajustes y conserva las demás secciones. Los ajustes de nivel raíz deben ir antes de la tabla del proveedor. Sustituye `MODEL_ID` por el modelo exacto que elegiste.

```toml
model_provider = "mandapi"
model = "MODEL_ID"

[model_providers.mandapi]
name = "MandAPI"
base_url = "https://api.mandapi.com/v1"
env_key = "MANDAPI_API_KEY"
wire_api = "responses"
```

`env_key` indica el nombre de una variable de entorno; no contiene la clave. Utiliza un solo mecanismo de autenticación para este proveedor. No lo combines con un bloque de autenticación mediante comandos ni copies los archivos de credenciales privados de Connect a tu instalación normal de Codex.

## Proporciona la clave de forma privada

En Bash, configura la terminal actual sin incluir el valor en el historial de comandos:

```bash
read -rsp "Clave de MandAPI: " MANDAPI_API_KEY
printf '\n'
export MANDAPI_API_KEY
codex
```

En PowerShell:

```powershell
$env:MANDAPI_API_KEY = [Net.NetworkCredential]::new('', (Read-Host 'Clave de MandAPI' -AsSecureString)).Password
codex
```

Inicia Codex desde esa misma terminal. Otra terminal o un proceso de escritorio puede no recibir las variables de esta sesión. Conserva tus preferencias de aprobación y aislamiento.

## Comprueba el resultado

Abre un proyecto pequeño y pide un resumen del README sin modificar archivos. Confirma que la sesión utiliza el proveedor y modelo configurados, que llega una respuesta completa y que el consumo correspondiente aparece en MandAPI. Una respuesta de texto correcta no verifica todas las funciones de Responses ni todas las acciones con herramientas.

## Solución de problemas y restauración

Ante un error de autenticación, comprueba la presencia de la variable y el estado de la clave sin mostrar su valor. Si falta el modelo, revisa el identificador exacto y el acceso. Si un parámetro no es compatible, revisa el modelo elegido y la versión instalada del cliente; no inventes límites del modelo para resolverlo. Para volver a la configuración anterior, restaura los ajustes guardados y elimina la variable de sesión. El inicio de sesión de ChatGPT y este proveedor personalizado usan credenciales distintas.

## Referencias

- [https://learn.chatgpt.com/docs/config-file/config-reference](https://learn.chatgpt.com/docs/config-file/config-reference)
- [https://mandapi.com/en/connect](https://mandapi.com/en/connect)
- [https://mandapi.com/es/connect](https://mandapi.com/es/connect)
