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

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

Каждый репозиторий, с которым вы работаете, становится проектом: папкой /work/<project> на диске аккаунта, и новый проект стоит $0. Один клик отправляет в неё Claude Code, Codex или OpenCode на выбранной подписке или API-ключе, и несколько агентов работают бок о бок.

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

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

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

Терминал проекта видит свой проект и свою домашнюю папку. Входы в аккаунты, git-ключи, настройки агентов и кеши в ней принадлежат только этому проекту, и ничего из того, что код одного проекта положил в свою домашнюю папку, не запустится в другом. У каждого терминала свои Docker и системные пакеты. Терминал оболочки видит все проекты своего Compute и работает в собственной домашней папке.

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

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

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

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

Если у вас больше одного Compute, окно спросит ещё, на каком из них живёт проект. Там он и остаётся: чтобы работать над ним на другом Compute, сделайте push и клонируйте его там.

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

Найдите проект

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

Откройте проект: блок Где он живёт покажет папку (кнопка рядом копирует команду cd), откуда взялся код и когда создан проект.

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

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

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

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

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

Каждый запуск хранит свои настройки и вход внутри проекта, вне git. Разговоры агента принадлежат проекту: любой его запуск находит их через claude --resume, codex resume или opencode --continue, с какого бы аккаунта они ни начались, так что при смене аккаунта разговор не теряется. Новый терминал начинает новый разговор. Перезапустить терминал на этом разговоре и Продолжать после сброса лимита продолжают текущий.

Скиллы, субагенты, команды, стили вывода и правила в ~/.claude проекта, а также скиллы в ~/.codex/skills доступны каждому запуску проекта, на каком бы аккаунте он ни работал.

Claude и Codex · API-ключи · Ротация

Измените запуск

  • Запуск по умолчанию: нажмите Изменить в его строке.
  • Сохранённый запуск: откройте его меню ⋯ и выберите Изменить или Сделать по умолчанию.

Поменяйте агента, Работает на, модель, ротацию и Продолжать после сброса лимита и нажмите Сохранить. Настройки агента и модели применятся к терминалам, которые вы откроете после этого. Ротация применяется сразу, в том числе к уже работающим терминалам.

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

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

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

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

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

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

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

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

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

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

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

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