Skip to main content
Trae tu propio agente de codificación de IA, o tus propios scripts, a una app de Base44 conectándote a su sandbox. El sandbox es un entorno en la nube privado que contiene el código de la rama actualmente activa en el editor de app, y ejecuta su servidor de desarrollo. Es el mismo entorno, y el mismo código, que edita el propio editor de app de Base44, sin ninguna bifurcación o copia que mantener sincronizada. Cuando escribes un archivo a través de un comando de sandbox, estás cambiando tu app real directamente, en su rama activa, de la misma forma que lo haría el editor de app. Esto te permite desarrollar una app con tus propias herramientas en lugar del editor de app, sin checkout local y sin nada que instalar. Trabaja en una app desde una máquina que no tiene copia de ella, o programa un cambio en una app que construiste completamente en el editor de app.
Editar a través del sandbox no es lo mismo que publicar. Tu edición se convierte en parte del código de la app de inmediato y aparece en el editor de app y en su vista previa en vivo, pero llegar al sitio público de la app aún requiere el mismo paso de publicación que requeriría un cambio hecho en el editor de app.
Necesitas un plan Builder o superior para acceder al sandbox de una app desde fuera del editor de app. Sin uno, los comandos fallan con PREMIUM_REQUIRED.
El sandbox en sí es un proceso de computación en vivo, no solo almacenamiento: se detiene cuando permanece inactivo durante un tiempo, y se reinicia con el siguiente comando. Tu código no se ve afectado de ninguna manera, ya que vive en git en lugar de en ese proceso. Si el sandbox no se está ejecutando actualmente, el primer comando lo inicia, y esa llamada tarda más que las siguientes.

​
Dos formas de conectarse

El sandbox expone el mismo conjunto de operaciones a través de dos superficies, respaldadas por la misma implementación. Usa la que se ajuste a tu configuración.
  • CLI: Adecuado para todo lo que se ejecute en tu propia máquina, incluido un agente de codificación local y tus propios scripts. Autentícate una vez con base44 login, luego apunta a la app con --app-id o la variable de entorno BASE44_APP_ID. No se requiere un proyecto local.
  • Servidor MCP: Adecuado para un asistente de IA que se conecta a través de MCP, incluidos asistentes basados en web que no pueden ejecutar una CLI en absoluto. Conéctalo una vez y autoriza con OAuth.
Los conectores no pasan por el sistema de archivos del sandbox, así que no están en la tabla de arriba. Para configurar un conector en una app con la que estás trabajando de esta forma, usa connectors initiate en su lugar. Apunta al mismo id de app directamente, sin un sandbox o un proyecto local.
La forma más rápida de empezar con tu propio agente de codificación es usar Send to Coding Agent en el editor de app de Base44. En escritorio, abre More actions (los tres puntos junto a Publish, en la esquina superior derecha) y selecciona Send to Coding Agent. Elige un agente CLI local o un chat web, y te entrega un prompt listo para pegar, así no tienes que configurar nada de esto a mano. No está disponible para apps móviles o apps con código fuente no gestionado.

​
Los cambios se guardan automáticamente

Una llamada a sandbox write o sandbox edit confirma el cambio por ti como parte de la misma solicitud, antes de que el comando devuelva, así que no hay un paso separado de guardar, desplegar o hacer push. Un cambio de archivo hecho a través de sandbox run, como rm o mv, confirma unos segundos después en su lugar, una vez que se cierra una ventana corta de debounce. Si escribes o editas de nuevo antes de que un commit debounced anterior haya aterrizado, la nueva llamada espera por él y falla con COMMIT_FLUSH_PENDING si no puede confirmar que ese commit terminó a tiempo. Una vez que un commit aterriza:
  • El cambio es visible en el editor de app de Base44.
  • Es seguro incluso si el entorno de computación del sandbox se recicla tras estar inactivo, ya que uno nuevo siempre parte de tu último commit en lugar de una instantánea más antigua.
  • Se incluye la próxima vez que publiques la app.
Los recursos estructurados se sincronizan de la misma forma: a diferencia de un proyecto local, donde ejecutarías entities push o functions deploy después de añadir un archivo, crear base44/functions/send-email/entry.ts en el sandbox es todo lo que se necesita para añadir esa función.
  • No ejecutes deploy, functions deploy, entities push, ni los otros comandos push contra una app que estás editando en su sandbox. Esos comandos sincronizan un proyecto local con Base44, y no hay proyecto local cuando trabajas con un sandbox.
  • Si tu última acción fue un comando shell ejecutado a través de sandbox run en lugar de una llamada write o edit, su commit aún va un momento por detrás. Dale unos segundos antes de desconectarte.

​
Checkpoints

Un checkpoint es un punto de restauración en el historial de versiones de la app, anclado a un commit específico. Crea uno con sandbox checkpoint para marcar un estado conocido como bueno, luego restaúralo desde el editor de app si un cambio posterior sale mal. Los cambios pendientes se confirman antes de tomar el checkpoint, así que siempre captura tu código más reciente.

​
Trabajar junto al editor de app

Tu agente de codificación y el editor de app de Base44 pueden trabajar en la misma app al mismo tiempo. No hay bloqueo que adquirir y no hay sesión que liberar. Los cambios de cualquier lado aterrizan en el mismo lugar, así que trátalo como tratarías a un compañero editando el mismo proyecto.
No hay paso de merge. Si tu agente de codificación y el editor de app cambian el mismo archivo al mismo tiempo, la escritura que aterrice al final gana, y el cambio anterior desaparece. Evita que ambos lados toquen el mismo archivo en el mismo tramo de trabajo.

​
Permisos

Dos comprobaciones separadas controlan el acceso al sandbox: si puedes acceder a esta app en absoluto, y si a tu sesión actual se le concedió acceso de escritura.

​
Acceso a la app

Necesitas acceso de administrador a la propia app, ya sea como administrador del espacio de trabajo o como colaborador en esta app específica. El acceso se comprueba en cada llamada, así que un cambio en tu rol del espacio de trabajo tiene efecto de inmediato. Un simple viewer del espacio de trabajo no puede llegar al sandbox en absoluto. La única excepción es un viewer que también tiene un rol heredado de editor por app de antes de que tu espacio de trabajo se moviera al acceso basado en roles. Esa combinación aún puede leer del sandbox, pero no cambiar nada. Los superagentes no admiten los comandos de sandbox.

​
Alcance de sesión

Más allá del acceso a la app, leer y cambiar el sandbox requieren diferentes permisos en tu sesión: Los permisos de tu sesión se fijan cuando se crea y no se pueden ampliar más tarde. La CLI pide sandbox:write durante base44 login, y sobre MCP lo concedes en el paso de consentimiento OAuth. Renovar una sesión existente no lo añade. Así que si los comandos de lectura funcionan pero los de cambio fallan con NOT_AUTHORIZED, estás en una sesión que nunca tuvo sandbox:write. Ejecuta base44 login de nuevo, o reconecta el servidor MCP y aprueba el acceso al sandbox, para iniciar una sesión que lo tenga.

​
Límites y barandillas

Los comandos de archivo están confinados a la raíz de la app. Las rutas absolutas y las rutas que suben por encima de la raíz se rechazan con PATH_OUTSIDE_SANDBOX. Los directorios .agents y .git no son alcanzables desde los comandos de archivo, y fallan con PROTECTED_PATH, porque contienen los secretos de tu app y credenciales del repositorio. La única excepción es .agents/skills, que puedes leer y escribir para que tu agente pueda trabajar con las skills que la app tiene instaladas. En toda la función, tienes un límite de 120 solicitudes de lectura, 60 solicitudes de cambio y 30 comandos de ejecución por minuto, por app. Superar cualquiera de estos falla con RATE_LIMITED. La página de referencia de cada comando cubre sus propios límites de tamaño y recuento, como cuántas rutas acepta sandbox read o cuán grande permite sandbox write un archivo.

​
Consulta también

Esta página fue traducida con IA. Para obtener la información más precisa y actualizada, consulta la versión en inglés.