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

# Vincular un proyecto de backend existente

> Configura y ejecuta código de proyecto de backend de Base44 existente, como apps de ejemplo

Puedes vincular código existente de un proyecto de backend de Base44, como el de una [app de ejemplo](https://github.com/base44/apps-examples), a un backend en Base44. Usa esto cuando ya tengas archivos de proyecto de backend de Base44 localmente.

Si todavía no tienes archivos de proyecto, usa [`base44 create`](/developers/references/cli/commands/create) para generar un nuevo proyecto.

<Note>
  * Esta guía es para vincular código existente de un proyecto de backend de Base44, como apps de ejemplo o proyectos compartidos por miembros del equipo. Si has creado una app con el [editor de apps de Base44](https://base44.com) y quieres desarrollarla localmente, usa [`base44 eject`](/developers/backend/overview/start-from-existing-app) en su lugar.
  * El CLI requiere Node.js 20.19.0 o superior.
</Note>

## Entender el código local vs. los proyectos de backend

Al trabajar con Base44, hay dos componentes separados:

* **Código local:** Los archivos del proyecto en tu ordenador, como el código del frontend, los esquemas de entidades y las funciones de backend.
* **Proyecto de backend de Base44:** La infraestructura de backend en los servidores de Base44, que incluye la base de datos, los endpoints, el hosting, etc.

La vinculación conecta tu código local con un proyecto de backend para que tu app pueda usar la infraestructura de Base44. Durante el proceso de vinculación, elegirás una de dos opciones:

* **Crear un nuevo proyecto:** Crea un backend nuevo en Base44 para tu código. Elige esto si estás configurando este código por primera vez.
* **Vincular a uno existente:** Conecta con un backend que ya existe en Base44. Elige esto si te estás reconectando a un backend que configuraste antes, o si te unes a un proyecto de equipo en el que el backend ya se ha creado.

## Vincular un proyecto

<Steps>
  <Step title="Obtén el código del proyecto">
    Clona una app de ejemplo o descarga código de proyecto existente y luego navega al directorio del proyecto.

    El proyecto ya debe contener una carpeta `base44/` con un archivo `config.jsonc`.
  </Step>

  <Step title="Instala las dependencias">
    Instala las dependencias del proyecto:

    ```bash theme={null}
    npm install
    ```
  </Step>

  <Step title="Instala el CLI de Base44">
    Instala el CLI de Base44 globalmente:

    ```bash theme={null}
    npm install -g base44@latest
    ```
  </Step>

  <Step title="Autentícate">
    Inicia sesión en tu cuenta de Base44:

    ```bash theme={null}
    base44 login
    ```

    El CLI genera un código de dispositivo. Abre la URL proporcionada, introduce el código y completa la autenticación en tu navegador.
  </Step>

  <Step title="Vincula el proyecto">
    Vincula tu proyecto local a un backend de Base44:

    ```bash theme={null}
    base44 link
    ```

    El CLI te pedirá que crees un nuevo proyecto de backend o que vincules a uno existente. Esto crea un archivo `.app.jsonc` en tu directorio `base44/` con tu app ID:

    ```jsonc theme={null}
    {
      "id": "your-app-id"
    }
    ```

    <Warning>
      El archivo `.app.jsonc` nunca debe enviarse al control de versiones. Se añade automáticamente a `.gitignore` y es específico de cada desarrollador y entorno de despliegue.
    </Warning>
  </Step>

  <Step title="Configura las variables de entorno (si es necesario)">
    Tu app ID es necesario al configurar un cliente del SDK. Los proyectos suelen almacenar su app ID en una variable de entorno y recuperarlo para crear un cliente. Consulta la documentación del proyecto o los archivos de configuración para ver las instrucciones sobre cómo establecer las variables de entorno necesarias.
  </Step>

  <Step title="Construye el frontend si el proyecto tiene uno">
    Si tu proyecto incluye un frontend, constrúyelo para que esté listo para desplegarse en el siguiente paso.
  </Step>

  <Step title="Envía los recursos">
    Sincroniza los recursos de tu proyecto con tu backend de Base44:

    ```bash theme={null}
    base44 deploy
    ```

    Esto envía las entidades, las funciones y el sitio si tu proyecto tiene uno.

    Si tu proyecto tiene agentes, envíalos también:

    ```bash theme={null}
    base44 agents push
    ```
  </Step>
</Steps>

## Siguientes pasos

Ahora que tu proyecto está configurado y en ejecución, puedes:

* Usar el [SDK](/developers/references/sdk/getting-started/overview) para añadir más funcionalidad a tu frontend, si el proyecto tiene uno.
* Añadir [entidades](/developers/backend/resources/entities/overview), [funciones de backend](/developers/backend/resources/backend-functions/overview) y [agentes](/developers/backend/resources/agents-config).
* Seguir creando y desplegar actualizaciones con [`base44 deploy`](/developers/references/cli/commands/deploy).

## Ver también

* [Referencia de comandos del CLI](/developers/references/cli/commands/introduction): Todos los comandos del CLI disponibles
* [Estructura del proyecto](/developers/backend/overview/project-structure): Cómo se organizan los archivos del proyecto
* [Documentación del SDK de JavaScript](/developers/references/sdk/getting-started/overview): Conecta tu app al backend
* [Skills de Base44](/developers/backend/overview/base44-skills): Enseña a los asistentes de IA a trabajar con Base44
* [Repositorio de apps de ejemplo](https://github.com/base44/apps-examples): Proyectos de muestra para aprender

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