# Instalar e iniciar sesión

Instala la CLI de Lockpick desde npm e inicia sesión desde tu terminal con tu navegador.

La CLI de Lockpick permite que tú y tu asistente de programación usen Lockpick desde una terminal. Necesita Node.js 20.9 o posterior.

## Instalar

```bash title="Terminal"
npm install -g lockpicks
```

El paquete se llama `lockpicks`, con s, e instala un comando `lockpick`. También puedes ejecutarlo sin instalarlo, con `npx lockpicks`.

## Iniciar sesión

```
lockpick login --host https://www.lockpick.app
```

El fragmento indica este servidor de Lockpick con `--host`. No hay un host predeterminado integrado. La CLI usa `--host`, luego `LOCKPICK_HOST` y después tu perfil guardado. Después del primer inicio de sesión, `lockpick login` puede reutilizar ese perfil.

Tu navegador se abre y te pide que apruebes el inicio de sesión. La clave va directamente a tu terminal, y nunca la copias a mano.

Por defecto, la clave puede leer tus sitios e informes. Pide más permisos al iniciar sesión.

* `--pulse` le permite iniciar escaneos Pulse, comprobaciones rápidas y la función gratuita Volver a leer este registro.
* `--sites` le permite añadir sitios, cambiar tu sitio gratuito y enviar las versiones de tus paquetes a [Monitor](/es/docs/protect/monitor).
* `--deep` le permite preparar escaneos Deep, que sigues aprobando en Lockpick.
* `--no-browser` muestra la dirección de inicio de sesión en lugar de abrirla.

Comprueba con quién has iniciado sesión con `lockpick whoami`, y cierra sesión con `lockpick logout`, que además revoca la clave.

## Tus primeros comandos

```bash title="Terminal"
lockpick whoami
lockpick sites
lockpick status
```

Estos comandos leen tu cuenta y los resultados existentes sin iniciar ningún escaneo. Ejecuta `lockpick doctor` si la conexión no funciona.

Para iniciar una comprobación, inicia sesión con `--pulse` y usa un sitio que sea tuyo o que tengas permiso para probar. `atlas.example` es una dirección de ejemplo, no un objetivo de prueba real. Iniciar un escaneo usa el cupo que muestra Lockpick; leer su estado o informe no usa otro escaneo.

Todos los comandos aceptan `--json` para scripts y `--help` para sus opciones. [Comandos](/es/docs/cli/commands) los enumera todos.

## Códigos de salida

| Código | Significado                                                                               |
| ------ | ----------------------------------------------------------------------------------------- |
| 0      | Funcionó                                                                                  |
| 1      | Algo salió mal, o lo que pediste no se encontró                                           |
| 2      | Necesitas iniciar sesión                                                                  |
| 3      | El escaneo que esperabas no tuvo éxito, o sigue en curso                                  |
| 4      | Tu clave o tu rol no lo permiten, o tu cupo se agotó                                      |
| 5      | El comando o uno de sus valores no es válido                                              |
| 6      | Demasiadas solicitudes; espera y vuelve a intentarlo                                      |
| 7      | Lockpick o un proveedor que usa está ocupado o no disponible                              |
| 8      | Los hallazgos abiertos alcanzaron `--fail-on` ([Ejecuta Lockpick en CI](/es/docs/cli/ci)) |

Los errores terminan con un enlace a la página que los explica. `lockpick doctor` revisa tu configuración, y `lockpick docs <words>` busca en estos documentos desde tu terminal.