# Installer et se connecter

Installez la CLI Lockpick depuis npm et connectez-vous depuis votre terminal avec votre navigateur.

La CLI Lockpick vous permet, à vous comme à votre assistant de code, d’utiliser Lockpick depuis un terminal. Elle nécessite Node.js 20.9 ou une version ultérieure.

## Installer

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

Le paquet s’appelle `lockpicks`, avec un s, et il installe une commande `lockpick`. Vous pouvez aussi l’exécuter sans l’installer, avec `npx lockpicks`.

## Se connecter

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

L’extrait désigne ce serveur Lockpick avec `--host`. Il n’existe aucun hôte par défaut intégré. La CLI utilise `--host`, puis `LOCKPICK_HOST`, puis votre profil enregistré. Après la première connexion, `lockpick login` peut réutiliser ce profil.

Votre navigateur s’ouvre et vous demande d’autoriser la connexion. La clé arrive directement dans votre terminal, et vous ne la copiez jamais à la main.

Par défaut, la clé peut lire vos sites et vos rapports. Demandez davantage lors de la connexion.

* `--pulse` lui permet de lancer des analyses Pulse, des contrôles rapides et « Relire cet enregistrement » gratuit.
* `--sites` lui permet d’ajouter des sites, de changer votre site gratuit et d’envoyer les versions de vos paquets à [Monitor](/fr/docs/protect/monitor).
* `--deep` lui permet de préparer des analyses Deep, que vous autorisez toujours dans Lockpick.
* `--no-browser` affiche l’adresse de connexion au lieu de l’ouvrir.

Vérifiez avec quel compte vous êtes connecté grâce à `lockpick whoami`, et déconnectez-vous avec `lockpick logout`, qui révoque aussi la clé.

## Vos premières commandes

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

Ces commandes lisent votre compte et les résultats existants sans lancer d’analyse. Exécutez `lockpick doctor` si la connexion ne fonctionne pas.

Pour lancer un contrôle, connectez-vous avec `--pulse` et utilisez un site que vous possédez ou que vous êtes autorisé à tester. `atlas.example` est une adresse d’exemple, pas une cible de test réelle. Lancer une analyse utilise le quota affiché par Lockpick ; lire son état ou son rapport n’utilise pas une autre analyse.

Chaque commande accepte `--json` pour les scripts et `--help` pour ses options. [Commandes](/fr/docs/cli/commands) les liste toutes.

## Codes de sortie

| Code | Signification                                                                                    |
| ---- | ------------------------------------------------------------------------------------------------ |
| 0    | Succès                                                                                           |
| 1    | Une erreur s’est produite, ou ce que vous avez demandé est introuvable                           |
| 2    | Vous devez vous connecter                                                                        |
| 3    | L’analyse attendue n’a pas réussi, ou elle est toujours en cours                                 |
| 4    | Votre clé ou votre rôle ne le permet pas, ou votre quota est épuisé                              |
| 5    | La commande ou l’une de ses valeurs n’est pas valide                                             |
| 6    | Trop de requêtes ; attendez puis réessayez                                                       |
| 7    | Lockpick ou un fournisseur qu’il utilise est occupé ou indisponible                              |
| 8    | Des points à corriger ouverts ont atteint `--fail-on` ([Lancer Lockpick en CI](/fr/docs/cli/ci)) |

Les erreurs se terminent par un lien vers la page qui les explique. `lockpick doctor` vérifie votre configuration, et `lockpick docs <words>` recherche dans cette documentation depuis votre terminal.