---
title: Solución de problemas de Archbee CLI
slug: docs/es/solucion-de-problemas-de-archbee-cli
docTags: 
createdAt: 2026-08-25T09:37:14.629Z
---

## Solución de problemas del Archbee CLI

Esta guía cubre los problemas más comunes que los usuarios encuentran al trabajar con el Archbee CLI.

Utilice estos pasos de solución de problemas antes de abrir un ticket de soporte. La mayoría de los problemas pueden resolverse validando su configuración, verificando la autenticación o revisando las opciones del comando CLI.

:::::ExpandableHeading{isOpen="true"}
### El CLI no inicia

**Problema**

Ejecutar `archbee` falla o no hace nada.

**Pasos recomendados**

::::WorkflowBlock
:::WorkflowBlockItem
Ejecute `versión archbee` para verificar que el CLI esté instalado.
:::

:::WorkflowBlockItem
Reinstale el CLI globalmente usando npm si falta el comando.
:::

:::WorkflowBlockItem
Reinicie su sesión de terminal e intente el comando nuevamente.
:::
::::

**Comando de instalación**

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

:::::ExpandableHeading
### La recarga en caliente no funciona

**Problema**

Los cambios no se actualizan en la vista previa local.

**Pasos recomendados**

::::WorkflowBlock
:::WorkflowBlockItem
Reinicie el servidor de desarrollo local usando `archbee desv`.
:::

:::WorkflowBlockItem
Verifique que su proyecto contenga un archivo de configuración compatible.
:::

:::WorkflowBlockItem
Compruebe que su carpeta de documentación no esté ignorada o excluida.
:::
::::
:::::

:::ExpandableHeading
### No se detectan enlaces rotos

Ejecute:

```bash
archbee broken-links
```

Asegúrese de que sus enlaces internos utilicen rutas relativas válidas.
:::

:::ExpandableHeading
### Problemas de sincronización de OpenAPI

**Problema**

`sync-openapi` falla durante la importación.

**Causas comunes**

- Esquema de OpenAPI no válido
- Referencias no compatibles
- Ruta de archivo incorrecta
- Falta de autenticación

**Primer paso recomendado**

Valide el archivo OpenAPI antes de sincronizar.
:::

:::ExpandableHeading
### Errores de autenticación

**401 No autorizado**

Generalmente causado por:

- Clave API no válida
- Token expirado
- ID de espacio incorrecto

**403 Prohibido**

Generalmente causado por permisos faltantes o una clave API de equipo de solo lectura.
:::

:::ExpandableHeading
### Problemas de publicación

**Problema**

`espacio-publicado` falla.

**Solución**

Verifique:

- Que tiene permisos de escritura
- Que el ID del espacio es correcto
- Que la clave API pertenece a la organización correcta
:::

:::::ExpandableHeading
### Flujo de trabajo de depuración recomendado

::::WorkflowBlock
:::WorkflowBlockItem
Ejecute `archbee validar` para verificar la estructura del proyecto.
:::

:::WorkflowBlockItem
Ejecute `archbee enlaces rotos` para analizar los enlaces internos.
:::

:::WorkflowBlockItem
Use `archbee <command> --help` para revisar el uso del comando y los argumentos.
:::
::::
:::::

## Recursos adicionales

- Documentación principal: [https://archbee.com/docs](https://archbee.com/docs)
- paquete npm: [https://www.npmjs.com/package/@archbee/cli](https://www.npmjs.com/package/@archbee/cli)
- Ayuda de CLI: `archbee --help`