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

# base44 dev

> Inicia el desarrollo local para un proyecto de Base44 vinculado.

<Warning>
  Esta página es parte de una habilidad de agente de codificación con IA y está escrita para agentes, no para humanos. Para la documentación de Base44 legible por humanos, consulta la [documentación para desarrolladores](/developers).
</Warning>

# base44 dev

Inicia el desarrollo local para un proyecto de Base44 vinculado.

Este comando siempre inicia el backend de Base44 localmente. Si `base44/config.jsonc` define `site.serveCommand`, también ejecuta tu servidor de desarrollo frontend desde la raíz del proyecto y lo conecta automáticamente al backend local.

## Sintaxis

```bash theme={null}
npx base44 dev [options]
```

## Opciones

| Opción                | Descripción                            | Requerido | Predeterminado |
| --------------------- | -------------------------------------- | --------- | -------------- |
| `-p, --port <number>` | Puerto para el backend local de Base44 | No        | 4400           |

## Autenticación

**Requerida**: Sí. Si no estás autenticado, se te pedirá que inicies sesión primero.

## Requisitos

* Debe ejecutarse desde un **proyecto local de Base44 vinculado**
* Debe existir `base44/.app.jsonc`
* `base44 dev` no puede usarse con `--app-id` o `BASE44_APP_ID`

## Lo que hace

1. Lee la configuración de tu proyecto local vinculado
2. Inicia el backend local de Base44 para entidades, funciones y rutas de autenticación
3. Observa los recursos locales de Base44 y los recarga cuando cambian
4. Si `site.serveCommand` está configurado, inicia tu servidor de desarrollo frontend desde la raíz del proyecto
5. Inyecta `VITE_BASE44_APP_ID` y `VITE_BASE44_APP_BASE_URL` en el proceso frontend
6. Apaga todo limpiamente cuando detienes el comando

## Comportamiento de frontend + backend

`base44 dev` funciona para **tanto backend como frontend**:

* **Backend**: siempre se ejecuta localmente
* **Frontend**: se ejecuta solo cuando `base44/config.jsonc` incluye `site.serveCommand`

Antes de usar `base44 dev` para desarrollo local full-stack, verifica tu configuración:

```jsonc theme={null}
{
  "site": {
    "serveCommand": "npm run dev"
  }
}
```

Si falta `site.serveCommand`, `base44 dev` aún funciona, pero solo inicia el backend de Base44.

## Ejemplos

```bash theme={null}
# Iniciar el desarrollo local en el puerto predeterminado
npx base44 dev

# Iniciar el backend en un puerto específico
npx base44 dev --port 4500
```

## Notas

* Usa esto desde un proyecto local vinculado, no con `--app-id`
* Cuando el frontend se está ejecutando, la CLI transmite la salida del backend y frontend juntas
* Si el proceso del frontend sale, el entorno de desarrollo local también se apaga

<Note>Esta página fue traducida usando IA. Para obtener la información más precisa y actualizada, consulta la [versión en inglés](/).</Note>