---
title: Dépannage de l’interface fr-CA ligne de commande Archbee
slug: docs/fr/depannage-de-linterface-fr-ca-ligne-de-commande-archbee
createdAt: 2026-08-25T09:37:14.629Z
---

## Résolution des problèmes liés au Archbee CLI

Ce guide couvre les problèmes les plus courants que les utilisateurs rencontrent lorsqu’ils travaillent avec le Archbee CLI.

Utilisez ces étapes de dépannage avant d’ouvrir un billet de support. La plupart des problèmes peuvent être résolus en validant votre configuration, en vérifiant l’authentification ou en examinant les options de commande CLI.

:::::ExpandableHeading{isOpen="true"}
### Le CLI ne démarre pas

**Problème**

L’exécution de `archbee` échoue ou ne fait rien.

**Étapes recommandées**

::::WorkflowBlock
:::WorkflowBlockItem
Exécutez `version archbee` pour vérifier que le CLI est installé.
:::

:::WorkflowBlockItem
Réinstallez le CLI globalement à l’aide de npm si la commande est manquante.
:::

:::WorkflowBlockItem
Redémarrez votre session de terminal et réessayez la commande.
:::
::::

**Commande d’installation**

```bash
npm install -g @archbee/cli
```
:::::

:::::ExpandableHeading
### Le rechargement à chaud ne fonctionne pas

**Problème**

Les modifications ne sont pas mises à jour dans l’aperçu local.

**Étapes recommandées**

::::WorkflowBlock
:::WorkflowBlockItem
Redémarrez le serveur de développement local à l’aide de `archbee dev`.
:::

:::WorkflowBlockItem
Vérifiez que votre projet contient un fichier de configuration pris en charge.
:::

:::WorkflowBlockItem
Vérifiez que votre dossier de documentation n’est pas ignoré ou exclu.
:::
::::
:::::

:::ExpandableHeading
### Les liens brisés ne sont pas détectés

Exécutez :

```bash
archbee broken-links
```

Assurez-vous que vos liens internes utilisent des chemins relatifs valides.
:::

:::ExpandableHeading
### Problèmes de synchronisation OpenAPI

**Problème**

`sync-openapi` échoue pendant l’importation.

**Causes courantes**

- Schéma OpenAPI invalide
- Références non prises en charge
- Chemin de fichier incorrect
- Authentification manquante

**Première étape recommandée**

Validez le fichier OpenAPI avant la synchronisation.
:::

:::ExpandableHeading
### Erreurs d’authentification

**401 Non autorisé**

Habituellement causé par :

- Clé API invalide
- Jeton expiré
- ID d’espace incorrect

**403 Interdit**

Habituellement causé par des permissions manquantes ou une clé API d’équipe en lecture seule.
:::

:::ExpandableHeading
### Problèmes de publication

**Problème**

`publish-space` échoue.

**Solution**

Vérifiez :

- Vous disposez des permissions d’écriture
- L’ID de l’espace est correct
- La clé API appartient à la bonne organisation
:::

:::::ExpandableHeading
### Workflow de débogage recommandé

::::WorkflowBlock
:::WorkflowBlockItem
Exécutez `validation archbee` pour vérifier la structure du projet.
:::

:::WorkflowBlockItem
Exécutez `liens brisés archbee` pour analyser les liens internes.
:::

:::WorkflowBlockItem
Utilisez `archbee <commande> --help` pour consulter l’utilisation de la commande et les arguments.
:::
::::
:::::

## Ressources supplémentaires

- Documentation principale : [https://archbee.com/docs](https://archbee.com/docs)
- package npm : [https://www.npmjs.com/package/@archbee/cli](https://www.npmjs.com/package/@archbee/cli)
- Aide CLI : `archbee --help`