> ## 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 link

> Vincula un proyecto local de Base44 existente a una app de Base44 en la nube. Úsalo cuando tengas un base44/config.jsonc pero aún no lo hayas conectado a una app de Base44.

<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 link

Vincula un proyecto local de Base44 existente a una app de Base44 en la nube. Úsalo cuando tengas un `base44/config.jsonc` pero aún no lo hayas conectado a una app de Base44.

## Crítico: cuándo usar Link vs Create

| Escenario                                        | Comando                |
| ------------------------------------------------ | ---------------------- |
| Empezar de cero, sin carpeta `base44/`           | `npx base44 create`    |
| Tener `base44/config.jsonc` pero no `.app.jsonc` | `npx base44 link`      |
| Proyecto ya vinculado (tiene `.app.jsonc`)       | Ya hecho, usa `deploy` |

## Sintaxis

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

## Opciones

| Opción                            | Descripción                                                                                   | Requerido      |
| --------------------------------- | --------------------------------------------------------------------------------------------- | -------------- |
| `-c, --create`                    | Crea un nuevo proyecto (omite el aviso de selección)                                          | No             |
| `-n, --name <name>`               | Nombre del proyecto (requerido cuando se usa `--create`)                                      | Con `--create` |
| `-d, --description <description>` | Descripción del proyecto                                                                      | No             |
| `--app-id <id>`                   | ID de app para vincular a un proyecto existente (bandera global, omite el aviso de selección) | No             |

## Modo no interactivo

Para uso en CI/CD o agentes:

**Crear un nuevo proyecto:**

```bash theme={null}
npx base44 link --create --name my-app
```

**Vincular a una app existente:**

```bash theme={null}
npx base44 link --app-id <app-id>
```

INCORRECTO: `npx base44 link --create` (falta --name)
INCORRECTO: `npx base44 link --create --app-id <id>` (no se pueden usar ambos)
CORRECTO: `npx base44 link --create --name my-app`
CORRECTO: `npx base44 link --app-id <id>`

## Ejemplos

```bash theme={null}
# Modo interactivo - pregunta por los detalles del proyecto
npx base44 link

# No interactivo - crear y vincular en un paso
npx base44 link --create --name my-app

# Con descripción
npx base44 link --create --name my-app --description "My awesome app"

# Vincular a un proyecto existente específico por ID
npx base44 link --app-id abc123
```

## Lo que hace

1. Encuentra el `base44/config.jsonc` en el directorio actual (o directorios padres)
2. Verifica que no existe `.app.jsonc` (el proyecto no está ya vinculado)
3. Ya sea:
   * Crea una nueva app de Base44 en la nube (con `--create`), O
   * Vincula a una app existente (con `--app-id` o selección interactiva)
4. Escribe el app ID en `base44/.app.jsonc`

## Requisitos

* Debe tener `base44/config.jsonc` en el proyecto
* NO debe tener `base44/.app.jsonc` (usa `deploy` si ya está vinculado)
* Debes estar autenticado (ejecuta `npx base44 login` primero)

## Notas

* Después de vincular, puedes desplegar recursos con `npx base44 deploy`
* El archivo `.app.jsonc` debería estar ignorado por git (contiene tu app ID)

<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>