> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fintoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Instalar la Fintoc CLI

> Instala la Fintoc CLI en macOS, Linux o Windows.

La Fintoc CLI te permite hacer solicitudes a la API y escuchar webhooks desde la línea de comandos. Puedes usar la Fintoc CLI para:

* Crear, obtener, actualizar o eliminar cualquiera de tus recursos de Fintoc en modo test.
* Recibir webhooks en tiempo real en `localhost` sin un túnel público y sin crear nuevos webhook endpoints.

## Elige un método de instalación

### npm

La CLI está publicada en npm y funciona en macOS, Linux y Windows. Requiere Node.js >= 22. En Windows, instala con npm, ya que Homebrew no está disponible. Para instalar con npm ejecuta:

```bash theme={null}
npm install -g @fintoc/cli
fintoc --version
```

`npm install -g @fintoc/cli` funciona en PowerShell y en el Símbolo del sistema en Windows.

### Homebrew

Homebrew está disponible en macOS y Linux. Para instalar con Homebrew ejecuta:

```bash theme={null}
brew install fintoc-com/tap/fintoc
fintoc --version
```

Para actualizar ejecuta:

```
brew update && brew upgrade fintoc
```

<br />

## Iniciar sesión en la CLI

Autentica la CLI con una API key de Fintoc.

```bash theme={null}
fintoc login
```

Esto abre un flujo interactivo. Si no quieres usar un navegador, pasa la API key inline con la flag `--api-key`:

```bash theme={null}
fintoc login --api-key sk_test_xxx
```

Por defecto, `fintoc login` autentica en modo test. Pasa `--mode live` para iniciar sesión en modo live en su lugar.

También puedes omitir la persistencia de la credencial exportando la variable de entorno `FINTOC_API_KEY`; la CLI la detecta automáticamente. Consulta [Llaves de la Fintoc CLI](/es/docs/resources/cli/fintoc-cli-keys-and-permissions) para ver el orden completo de precedencia.

## Verifica tu configuración

`fintoc doctor` verifica tu configuración de la CLI. Revisa la API key resuelta, la versión de Node.js, la ruta del archivo de configuración y la conectividad a api.fintoc.com. Ejecútalo para depurar errores de autenticación o conectividad.

```bash theme={null}
fintoc doctor
```