Выбор и настройка агента
Откройте терминал: Claude Code, Codex и OpenCode уже установлены, подтверждения выключены, инструкции проекта на месте. Выберите агента, подключённую подписку или API-ключ одного из семи провайдеров и дайте агенту задачу.
Выберите агента
Откройте Терминалы, нажмите Новый терминал, выберите проект, а затем в поле Агент укажите Claude Code, Codex или OpenCode. После этого выберите аккаунт в поле Работает на: список предлагает только аккаунты, с которыми этот агент работает.
| Агент | Как входит |
|---|---|
| Claude Code | Ваша подписка Claude или совместимый API-ключ; можно также войти внутри терминала |
| Codex | Ваша подписка ChatGPT или совместимый API-ключ; можно также войти внутри терминала |
| OpenCode | Совместимый API-ключ или собственный вход внутри терминала |
Войти внутри терминала можно, пока у этого агента нет аккаунта по умолчанию: выберите в поле Работает на вариант, где сказано, что агент входит в аккаунт внутри терминала. Агент попросит войти так же, как на ноутбуке, а вход сохранится в домашней папке этого проекта, и другие проекты его не увидят.
Какие ключи принимает каждый агент:
- Claude Code: Anthropic, DeepSeek, Z.ai, abliteration.ai.
- Codex: OpenAI, xAI, DeepSeek, Z.ai, abliteration.ai.
- OpenCode: Anthropic, OpenAI, xAI, DeepSeek, Z.ai, abliteration.ai, Gemini.
Как их добавить, переименовать и заменить, показывает раздел API-ключи.

Что есть на вашем Compute
Каждый терминал работает на Ubuntu 26.04 LTS с sudo и Docker Engine с compose, и в нём уже есть:
- агенты: Claude Code, Codex и OpenCode;
- языки: Node 26, Python 3.14, Bun, uv, mise, pnpm, Yarn и pipx, а также gcc и make из build-essential;
- инструменты: git, gh, glab, ripgrep, fd, fzf, jq, yq, bat, delta, git-lfs, httpie, tmux, tree, ncdu, htop, btop, rsync, strace, lsof, netcat, dig, ping, socat, zip, vim и nano;
- базы данных: psql, redis-cli, sqlite3 и клиент MariaDB;
- браузеры: Playwright с headless Chromium, подключённым в кеш Playwright каждой домашней папки, и
chrome-headless-shellс заданнымCHROME_PATH.
Go, Rust, Java и Ruby ставятся одной командой: mise use -g go@latest, mise use -g rust и так далее.
У Docker и всего, что в нём работает, приоритет к CPU и диску ниже, чем у шелла, tmux и агента, поэтому тяжёлая сборка не тормозит ни агента, ни ваш ввод. Каждый контейнер работает под init из Docker, который убирает зомби-процессы.
Сохраните свои инструменты
Системный пакет ставьте через sudo в конкретном терминале: при завершении или перезапуске терминала он исчезнет. Чтобы инструмент остался, установите его в домашнюю папку, а она принадлежит проекту:
mise use -g kubectl helm opentofu aws-cliставит туда эти облачные CLI.npm i -g <package>кладёт пакет в~/.npm-global, который уже есть в вашемPATH.- Бинарник, положенный в
~/.local/bin, запускается в каждом терминале проекта.
Go в каждой домашней папке собирает с -trimpath, поэтому в кеше сборки лежит одна копия каждого пакета, а не по копии на путь каждого рабочего дерева агента. Тестам, которые ищут файлы рядом с собой через runtime.Caller, этот флаг мешает: выполните go env -w GOFLAGS= в терминале проекта или задайте GOFLAGS в окружении.
Свежие агенты, проверенные заранее
Каждые 6 часов мы пересобираем базовый образ с обновлениями системы и последними Claude Code, Codex и OpenCode и проверяем его, прежде чем его получит хоть один терминал. Новые и перезапущенные терминалы получают последний проверенный образ, работающий терминал остаётся на своём.
Посреди работы агенты сами не обновляются: в терминале стоит та версия, которую мы проверили. Чтобы перевести терминал на новейшие версии агентов, перезапустите его.
Подтверждения выключены
| Агент | Режим |
|---|---|
| Claude Code | bypassPermissions |
| Codex | Политика подтверждений never, полный доступ |
| OpenCode | Разрешение allow |
Экраны первого запуска и вопросы о доверии к папкам уже пройдены, включая папку проекта. Откройте терминал, и агент готов к задаче.
Инструкции вашего проекта и наши
Любой агент стартует в /work/<project>, поэтому собственные CLAUDE.md, AGENTS.md, скиллы, хуки и настройки в .claude/ и .mcp.json проекта работают так же, как на вашем ноутбуке.
Попросите любого агента запомнить что-то для проекта, и он запишет это в AGENTS.md в корне проекта. Этот файл читают Claude Code, Codex и OpenCode, а Claude Code читает его даже рядом с CLAUDE.md.
Ещё каждый агент читает /etc/detachbox/AGENTS.md, наш короткий файл. Он объясняет, как работают адреса превью, чтобы агенты сами давали вам ссылку, когда сервер поднят. Файл подключён в ~/.claude/CLAUDE.md, ~/.codex/AGENTS.md и ~/.config/opencode/AGENTS.md, а также в папку настроек, которую каждый запуск держит в проекте.
Ваш собственный файл в одном из этих мест остаётся вашим: detachbox только добавляет в него ссылку на наш.
Откройте страницу в своём браузере через detachbox-open
detachbox-open <url> открывает ссылку http или https в браузере того, кто сидит за терминалом. xdg-open, open, sensible-browser, www-browser, x-www-browser и $BROWSER указывают на него, поэтому входы, которые запускают gh, модуль webbrowser в Python или агент, открываются в вашем браузере.
Ссылка на собственный localhost:<port> вашего Compute превращается в его адрес превью. Другие схемы, например file:, отклоняются. Если в этот момент терминал не открыт ни в одном браузере, команда печатает ссылку, чтобы вы открыли её сами. Что делает кабинет, когда приходит страница, показано в разделе Браузерный терминал.
Получите ссылку превью через detachbox-preview
detachbox-preview <port> [path] печатает адрес, по которому сервер на этом порту открывается в вашем браузере, например https://3000-<terminal ID>.detachbox.dev/admin. Команда предупреждает, если сервер слушает только localhost или порт пока никто не слушает. Через неё агенты и дают вам ссылку.
Передайте агенту промпт через detachbox-say
detachbox-say <tmux session> <text> отправляет в этом терминале новый промпт через самого агента, без имитации нажатий клавиш, поэтому строка, которую вы печатаете, остаётся целой. Работает с Claude Code и Codex.
Через него сервер пишет «continue», когда лимит сбрасывается. Код выхода 3 значит, что в терминале нет запущенного Claude Code или Codex, которому можно передать текст, а код 4 значит, что агент текст не принял. В обоих случаях сервер впечатывает текст прямо в терминал.