detachbox
СтраницыПроекты и запуски

Проекты и запуски

Каждый репозиторий, с которым вы работаете, — это проект: папка /work/<project> на диске аккаунта. Один клик запускает в ней Claude Code, Codex или OpenCode, каждого на своей подписке, по несколько бок о бок.

Проекты в shipyard: api, storefront, etl-pipeline и landing, у каждого агенты, которые на нём работают.

Что такое проект

Проект — это папка /work/<project> на диске аккаунта рядом с домашней папкой /home/dev. В ней ваш код, его запуски и общие для всех запусков сессии агентов, и она остаётся, когда терминалы, которые с ней работали, завершаются.

Терминал проекта видит свой проект и общую домашнюю папку. У каждого терминала свои Docker и системные пакеты. Терминал оболочки видит все ваши проекты.

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

Создайте проект

  1. Откройте Проекты и нажмите Новый проект.
  2. Выберите, откуда берётся код:
    • Клонировать: вставьте адрес, который вы дали бы git clone, например git@github.com:you/app.git или https://…. Репозиторий клонируется вашими git-ключами на Compute, так что приватные репозитории тоже работают.
    • Пустой: пустая папка. Оставьте галочку Сделать git-репозиторием, чтобы начать с git init.
    • Папка: папка внутри /home/dev на вашем Compute. Она копируется в проект, а сама остаётся на месте.
  3. Проверьте Имя. Оно повторяет имя репозитория или папки, пока вы не введёте своё: до 40 строчных латинских букв, цифр и дефисов. Имя становится путём, /work/<name>.
  4. Нажмите Создать проект.

Клонирование большого репозитория занимает несколько минут, страница обновляется сама. Первый проект можно начать и в Терминалах сразу после оплаты: раздел Начало работы показывает три вопроса.

Запустите агента в проекте

Запуск — это агент и то, на чём он работает: Claude Code, Codex или OpenCode на подписке или API-ключе. Добавьте модель, если нужна не та, что у агента по умолчанию, а для Claude Code и Codex — ротацию и Продолжать после сброса лимита.

Сначала выберите агента, затем в поле Работает на аккаунт, который ему подходит: подписку Claude для Claude Code, подписку ChatGPT для Codex или совместимый API-ключ для любого из трёх. Какой ключ с каким агентом работает, перечислено в разделе Агенты.

Запуск в api: Claude Code на одном из трёх аккаунтов Claude и двух API-ключей, модель по желанию и ротация на подписку с наибольшим запасом, когда кончается лимит.

Первый запуск в проекте становится его Запуском по умолчанию — тем, что стартует в один клик. Все остальные связки, которые вы запускали или сохранили, ждут в Сохранённых запусках: их можно запустить, изменить, удалить или сделать запуском по умолчанию.

Каждый запуск хранит свои настройки и вход внутри проекта, вне git. Сессии агента принадлежат проекту: все его запуски видят их в claude --resume или codex resume, а новый запуск подхватывает последнюю, с какого бы аккаунта она ни началась.

Claude / Codex · API · Rotation

Откройте новый терминал

Нажмите Новый терминал в Терминалах и заполните три поля: Проект, Агент и Работает на. Нажмите Запустить. Связка, которую вы уже сохранили, стартует как есть; новая по пути сохраняется запуском в проекте — на следующий раз.

Новый проект… в списке проектов добавляет ещё код, а Оболочка открывает обычный login shell, которому запуск не нужен. Каждый вариант даёт свежее окружение, поэтому, чтобы вернуться к работающему терминалу, выберите его в списке.

Новый терминал в shipyard: выберите проект, агента и на чём он работает, затем «Запустить»; или откройте обычную «Оболочку».

Каждый терминал в списке показывает свой проект, агента и аккаунт, на котором он работает, а если запуск чередует подписки — ещё и значок ротации.

Проект api: Claude Code с ротацией как запуск по умолчанию, в одном клике, и Codex review на своём аккаунте среди сохранённых запусков.

Что остаётся на следующий раз

Папка проекта с кодом, запусками и каждой сессией агента остаётся на диске аккаунта, как и всё в /home/dev.

Образы Docker, кэш сборки, контейнеры, пакеты apt и системные службы принадлежат этому терминалу. Они работают после закрытия браузера и удаляются при завершении терминала. Храните данные баз и работу в проекте или домашней папке.

Удалите запуск или проект

  • Удалить запуск: откройте его меню ⋯ на странице проекта и выберите Удалить. Его вкладки закроются, а его настройки и вход уйдут из проекта. Код и сессии агента остаются для других запусков проекта.
  • Удалить проект: откройте меню проекта ⋯, выберите Удалить проект и введите его имя. Его вкладки закроются, запуски уйдут, а папка сотрётся со всеми файлами и сессиями агентов. Сначала запушьте то, что хотите сохранить.

Проекты и ключи сервисов

С Vault каждый проект сам получает своего агента Sallyport с именем detachbox · <project>, общего для всего, что работает в проекте. В Sallyport вы решаете, что может вызывать каждый проект, а его пропуск лежит в папке .detachbox проекта.