detachbox
СтраницыВыбор и настройка агента

Выбор и настройка агента

Откройте терминал: 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-ключи.

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

Что есть на вашем 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 CodebypassPermissions
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 значит, что агент текст не принял. В обоих случаях сервер впечатывает текст прямо в терминал.