detachbox
PáginasProyectos y lanzamientos

Proyectos y lanzamientos

Cada repositorio con el que trabajas es un proyecto: una carpeta en /work/<project> en el disco de tu cuenta, y uno nuevo cuesta $0. Un clic pone a trabajar dentro a Claude Code, Codex u OpenCode con la suscripción o clave de API que elijas, y varios agentes trabajan en paralelo.

Proyectos en shipyard: api, storefront, etl-pipeline y landing, cada uno con los agentes que lo ejecutan.

Qué es un proyecto

Un proyecto es una carpeta en /work/<project> en el disco de tu cuenta, con una carpeta personal propia que sus terminales ven en /home/dev. La carpeta del proyecto guarda tu código, sus lanzamientos y las conversaciones del agente que comparten. La carpeta del proyecto y su carpeta personal siguen ahí cuando terminan los terminales que las usaron.

Un terminal de proyecto ve su proyecto y su propia carpeta personal. Los inicios de sesión, las claves de git, los ajustes del agente y las cachés que hay en ella son solo de ese proyecto, y nada de lo que el código de un proyecto deje en su carpeta personal se ejecuta en otro. Cada terminal tiene su propio Docker y sus propios paquetes del sistema. Un terminal de shell llega a todos los proyectos de su Compute y trabaja en una carpeta personal propia.

Cada proyecto nuevo empieza con una carpeta personal limpia: inicia sesión en git, gh y tus demás herramientas una sola vez desde su terminal. Un proyecto creado antes de que se separaran las carpetas personales ya tiene tus skills, subagentes, comandos, reglas, estilos de salida y plugins copiados en su carpeta personal.

/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 la sesión y las claves de git de la carpeta personal de tu shell, así que los repositorios privados funcionan: inicia sesión una vez en un terminal de shell con gh auth login o glab auth login.
    • Vacío: una carpeta vacía. Deja marcado Convertirlo en repositorio git para empezar con git init.
    • Carpeta: una carpeta dentro de /home/dev de tus terminales de shell. 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.

Si tienes más de un Compute, el diálogo también pregunta en cuál vive el proyecto. Se queda allí: para seguir con él en otro Compute, haz push y clónalo allí.

Clonar un repositorio grande tarda unos minutos, y la página muestra el progreso. Si la preparación se detiene, la página del proyecto dice por qué: corrige la dirección ahí mismo y pulsa Reintentar para preparar de nuevo el mismo proyecto. Tu primer proyecto también puede nacer desde Terminales justo después del pago: Primeros pasos muestra las tres preguntas.

Encuentra un proyecto

Proyectos lista cada proyecto con los agentes de sus lanzamientos. A partir de 6 proyectos aparece arriba un campo de búsqueda: pulsa / y escribe parte de un nombre, un agente o una cuenta.

Abre un proyecto para ver Dónde vive: la carpeta (el botón de al lado copia el comando cd), de dónde vino el código y cuándo se creó el proyecto.

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 de API. Añade un modelo si quieres otro distinto del predeterminado; el campo Modelo vacío indica el modelo que recibe el lanzamiento para ese agente y ese proveedor. Un lanzamiento con una suscripción o clave conectada en el panel también puede activar la rotación y Seguir cuando el límite se reinicie, y entonces un límite ya no corta el trabajo.

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 de API compatible para cualquiera de los tres. Agentes lista qué clave funciona con qué agente.

El lanzamiento por defecto de api: Claude Code con una de tres suscripciones de Claude, con una clave de DeepSeek y otra de Z.ai también a elegir, un modelo opcional y rotación entre las suscripciones de Claude cuando se agotan los límites.

El primer lanzamiento de un proyecto se convierte en su Lanzamiento predeterminado: el que arranca con un solo clic. Un proyecto sin ninguno muestra Elegir el lanzamiento predeterminado. Cualquier otra combinación que ejecutes o guardes espera en Lanzamientos guardados; Nuevo lanzamiento añade una ahí sin arrancarla.

Cada lanzamiento guarda sus propios ajustes e inicio de sesión dentro del proyecto, fuera de git. Las conversaciones del agente son del proyecto: cualquier lanzamiento las encuentra con claude --resume, codex resume u opencode --continue, sin importar qué cuenta las empezó, así que cambiar de cuenta nunca te hace perder la conversación. Un terminal nuevo empieza una conversación nueva. Reiniciar el terminal en esta conversación y Seguir cuando el límite se reinicie continúan la actual.

Tus skills, subagentes, comandos, estilos de salida y reglas del ~/.claude del proyecto, y tus skills de ~/.codex/skills, llegan a cada lanzamiento del proyecto, funcione con la cuenta que funcione.

Claude y Codex · Claves de API · Rotación

Edita un lanzamiento

  • Lanzamiento predeterminado: elige Editar en su fila.
  • Lanzamiento guardado: abre su menú ⋯ y elige Editar o Poner por defecto.

Cambia el agente, Funciona con, el modelo, la rotación y Seguir cuando el límite se reinicie, y elige Guardar. El agente y el modelo se aplican a los terminales que abras a partir de entonces. La rotación llega también a los que ya están en marcha, al momento.

Abre un terminal de un proyecto

Elige Lanzar junto a un lanzamiento en la página del proyecto, o elige Nueva terminal en Terminales y responde Proyecto, Agente y Funciona con. Una combinación que ya guardaste arranca tal cual; una nueva se guarda como lanzamiento del proyecto para la próxima vez. La línea bajo el formulario dice cuál de las dos cosas hace Lanzar.

Nueva terminal en shipyard: elige el proyecto, el agente y con qué funciona, y pulsa Lanzar; o abre un Shell normal.

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

El proyecto api: Claude Code con rotación como lanzamiento predeterminado, a un clic, y Codex review con su propia cuenta entre los lanzamientos guardados.

Lo que queda para la próxima sesión

La carpeta de tu proyecto, con su código, sus lanzamientos y todas las conversaciones del agente, sigue en el disco de la cuenta. También la carpeta personal del proyecto, /home/dev en sus terminales.

Las imágenes Docker, la caché de compilación, los contenedores, los paquetes apt y los servicios del sistema pertenecen a ese terminal. Sobreviven a un navegador cerrado y a un reinicio del nodo, y se van cuando finalizas o reinicias el terminal. Guarda los datos de las bases y el resto del trabajo en el proyecto o en su carpeta personal.

Quita un lanzamiento o elimina un proyecto

  • Quita un lanzamiento: abre su menú ⋯ en la página del proyecto, elige Quitar y después Eliminar lanzamiento. Sus terminales se cierran, y sus ajustes e inicio de sesión salen del proyecto. El código y las conversaciones del agente siguen ahí para los demás lanzamientos. Si quitas el lanzamiento predeterminado, el guardado más antiguo pasa a ser el predeterminado.
  • Elimina un proyecto: abre el menú ⋯ del proyecto, elige Eliminar proyecto y escribe su nombre. Sus terminales se cierran, sus lanzamientos se van y la carpeta se borra con todos sus archivos y conversaciones 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>. detachbox lo crea por ti, y todo lo que corre en el proyecto lo comparte. Tú decides en Sallyport a qué puede llamar cada proyecto; su pase vive en la carpeta .detachbox del proyecto.