Proyectos y lanzamientos

Cada repositorio con el que trabajas es un proyecto: una carpeta en /work/<project> en el disco de tu cuenta. Un clic lanza Claude Code, Codex u OpenCode dentro de él, cada uno con su propia suscripción, varios en paralelo.

Qué es un proyecto

Un proyecto es una carpeta en /work/<project> en el disco de tu cuenta, junto a tu carpeta personal /home/dev. Guarda tu código, sus lanzamientos y las sesiones del agente que todos ellos comparten, y sigue ahí cuando los terminales que lo usaron finalizan.

Un terminal de proyecto ve su proyecto y tu carpeta personal compartida. Cada terminal tiene su propio Docker y paquetes del sistema. Un terminal Shell puede acceder a todos tus proyectos.

/work/<project> · CLAUDE.md · AGENTS.md · .claude/ · .mcp.json

Crea un proyecto

1. Abre Proyectos y elige Nuevo proyecto.
2. Elige de dónde viene el código:
   • Clonar: pega la dirección que le darías a git clone, como git@github.com:you/app.git o https://…. Se clona con tus claves git de tu Compute, así que los repositorios privados funcionan.
   • Vacío: una carpeta vacía. Deja marcado Convertirlo en repositorio git para empezar con git init.
   • Carpeta: una carpeta dentro de /home/dev en tu Compute. Se copia al proyecto, y la carpeta se queda donde estaba.
3. Revisa el Nombre. Sigue al repositorio o a la carpeta hasta que escribas el tuyo: hasta 40 letras latinas minúsculas, dígitos y guiones. El nombre será la ruta, /work/<name>.
4. Elige Crear proyecto.

Clonar un repositorio grande tarda unos minutos, y la página se actualiza sola. Tu primer proyecto también puede nacer desde Terminales justo después del pago: Primeros pasos muestra las tres preguntas.

Lanza un agente en un proyecto

Un lanzamiento es un agente y aquello con lo que funciona: Claude Code, Codex u OpenCode, con una suscripción o una clave API. Añade un modelo si quieres otro distinto del predeterminado del agente y, para Claude Code y Codex, la rotación y Seguir cuando el límite se reinicie.

Elige primero el agente y después, en Funciona con, una cuenta que pueda usar: una suscripción de Claude para Claude Code, una de ChatGPT para Codex o una clave API compatible para cualquiera de los tres. Agentes lista qué clave funciona con qué agente.

El primer lanzamiento de un proyecto se convierte en su Lanzamiento predeterminado: el que arranca con un solo clic. Cualquier otra combinación que ejecutes o guardes espera en Lanzamientos guardados, donde puedes lanzarla, editarla, quitarla o hacerla predeterminada.

Cada lanzamiento guarda sus propios ajustes e inicio de sesión dentro del proyecto, fuera de git. Las sesiones del agente son del proyecto: todos sus lanzamientos las ven en claude --resume o codex resume, y un lanzamiento nuevo retoma la más reciente, sin importar qué cuenta la empezó.

Claude / Codex · API · Rotation

Abre un terminal nuevo

Elige Nueva terminal en Terminales y responde tres campos: Proyecto, Agente y Funciona con. Pulsa Lanzar. Una combinación que ya guardaste arranca tal cual; una nueva se guarda por el camino como lanzamiento del proyecto, lista para la próxima vez.

Nuevo proyecto… en la lista de proyectos trae más código, y Shell abre un shell de login normal que no necesita lanzamiento. Cada opción arranca un entorno nuevo, así que elige un terminal en marcha en la lista para volver a él.

Cada terminal de la lista muestra su proyecto, su agente y la cuenta con la que funciona, con una marca de rotación cuando el lanzamiento rota suscripciones.

Lo que queda para la próxima sesión

La carpeta de tu proyecto, con su código, sus lanzamientos y cada sesión del agente, sigue en el disco de la cuenta, igual que todo lo que hay en /home/dev.

Las imágenes Docker, la caché de compilación, los contenedores, los paquetes apt y los servicios del sistema pertenecen a ese terminal. Siguen funcionando al cerrar el navegador y se eliminan al terminar el terminal. Guarda los datos y el trabajo en el proyecto o la carpeta personal.

Quita un lanzamiento o elimina un proyecto

• Quita un lanzamiento: abre su menú ⋯ en la página del proyecto y elige Quitar. Sus pestañas se cierran, y sus ajustes e inicio de sesión salen del proyecto. El código y las sesiones del agente se quedan para los demás lanzamientos del proyecto.
• Elimina un proyecto: abre el menú ⋯ del proyecto, elige Eliminar proyecto y escribe su nombre. Sus pestañas se cierran, sus lanzamientos se van y la carpeta se borra con todos sus archivos y sesiones del agente. Antes, haz push de lo que quieras conservar.

Proyectos y claves de servicios

Con Vault, cada proyecto recibe su propio agente de Sallyport, llamado detachbox · <project>, creado para ti y compartido por todo lo que corre en el proyecto. Tú decides en Sallyport a qué puede llamar cada proyecto, y su pase vive en la carpeta .detachbox del proyecto.