Чтобы пользоваться AgentVera, установите нужные CLI кодинг-агентов, добавьте папку проекта, запустите одного или нескольких агентов через New agent и работайте с ними рядом в сетке проекта. Каждый агент — настоящий CLI, например Claude Code или Codex, в своей панели терминала и со своим входом. AgentVera добавляет всё вокруг него: сетку на проект, поле сообщений с очередью, статус с первого взгляда, контрольные точки на каждый ход, код-ревью и работу с аккаунтами.
Это руководство проведёт вас от пустого окна до нескольких работающих агентов. В нём: что установить заранее, как работает диалог New agent, как расставить сетку, как устроен вход для CLI и для самого AgentVera и какие привычки не дают параллельным агентам мешать друг другу.
Что нужно до начала
AgentVera — настольное приложение для macOS, Windows и Linux. Скачать его можно на странице загрузки. Своей модели у него нет. Он запускает CLI-агентов, уже установленных на вашем компьютере.
| Что нужно | Зачем |
|---|---|
| Хотя бы один CLI-агент, например Claude Code или Codex | AgentVera запускает настоящий CLI для каждого агента |
| Вход в этот CLI | Агенты используют вход и тариф самого CLI |
| Папка проекта, лучше всего репозиторий Git | Контрольные точки, worktree и код-ревью опираются на Git |
| Аккаунт AgentVera (необязательно) | Только для функций Pro и Team |
Если вы никогда не пользовались Claude Code, в статье как пользоваться Claude Code описаны установка и вход. AgentVera поддерживает 18 CLI-агентов, включая Claude Code, Codex, Gemini CLI и GitHub Copilot CLI, так что начинать можно с того, за которого вы уже платите.
Шаг 1: добавьте первый проект
Откройте AgentVera и нажмите Add project folder в верхней панели. Выберите папку репозитория, с которым вы работаете. Проект появится на экране Projects home и в верхней панели, а переходить между проектами можно оттуда или через палитру команд (⌘K, Ctrl K в Windows и Linux).
У каждого проекта два вида:
- Workspace: сетка панелей агентов, где вы проводите больше всего времени.
- Details: информация о проекте вокруг агентов.
Если хочется просто быстро о чём-то спросить, не настраивая проект, на главном экране есть быстрый чат. Такие чаты работают в собственной папке приложения и ваших проектов не касаются.
Шаг 2: запустите первого агента
Нажмите New agent в боковой панели или нажмите ⌘N. Диалог подсказывает, что нужно: выберите инструмент, затем задайте агенту имя и, при необходимости, роль.
- Tool: выберите CLI, например Claude Code или Codex. Инструмент, который AgentVera не находит на этом компьютере, помечен Not installed.
- Agent name и Color: короткое имя вроде «Backend» или «Reviewer» упрощает просмотр сетки.
- Runs on: пока оставьте This computer. Агента можно запустить и на SSH-сервере.
- Account: вход, которым пользуется агент. По умолчанию это тот, что уже есть на этом компьютере. В поле написано Signed in или Signed out.
- Workspace: основная папка или один из git worktree проекта.
- Role and instructions: необязательно. Для Claude это добавляется в системный промпт, а для Codex — как инструкции разработчика.
- Нажмите Start agent.
В диалоге есть и другие параметры, включая профиль контекста, браузер, карту проекта, MCP-серверы, контейнер Docker, бюджет токенов и закреплённые пути. Для первого запуска можно оставить их значения по умолчанию и вернуться позже. О профилях контекста рассказывает страница экономия токенов, а о запуске агента в контейнере — страница Docker.
Агент открывается в панели. Эта панель — настоящий терминал с запущенным CLI, поэтому здесь работает всё, что CLI умеет в обычном терминале, включая его слэш-команды. Под ней поле сообщений с историей промптов, черновиками и очередью (⌘Enter ставит сообщение в очередь, пока агент ещё занят).
Шаг 3: войдите в агентов
Агенты входят не через AgentVera. Они используют собственные входы CLI, так что если claude или codex уже работает в вашем терминале, аккаунт по умолчанию готов. AgentVera помечает этот аккаунт по умолчанию как this computer.
Если аккаунт не выполнил вход, диалог New agent предупредит: «This account is signed out. Sign in from Settings → Accounts, or the agent will ask you to sign in on first launch.» Можно пойти любым путём.
Чтобы использовать больше одного аккаунта Claude или Codex, откройте Settings → Accounts, нажмите Add Claude account или Add Codex account, задайте имя и выберите Add and sign in. У каждого дополнительного аккаунта своя папка конфигурации, а нужный аккаунт вы выбираете при создании агента. Подробно об этом рассказывает статья как переключать аккаунты Claude Code.
Шаг 4: добавьте агентов и расставьте сетку
Один агент полезен. Два-три параллельно — там AgentVera оправдывает своё место. Создайте второго агента так же и дайте каждому понятную отдельную работу.
Сетка настраивается в Screen splitter (⌘⌥L). Выберите число столбцов и строк, от 1×1 до 5×4, или готовую раскладку вроде «Top 2 · Bottom 1». Перетаскивайте разделители, чтобы менять размеры панелей, а Equalize pane sizes вернёт их к равным. Каждый проект помнит свою раскладку.
| Действие | Как |
|---|---|
| Поменять две панели местами | Перетащите панель на другую |
| Развернуть панель | Двойной щелчок по её заголовку или ⌘⇧Enter |
| Переключать фокус между агентами | ⌘⌥ + стрелки |
| Перейти к панели | От ⌘1 до ⌘9 |
| Открыть палитру команд | ⌘K |
| Открыть screen splitter | ⌘⌥L |
В Windows и Linux используйте Ctrl вместо ⌘ и Alt вместо ⌥. Любое сочетание можно изменить в Settings. Панель также может открыться в модальном окне или в отдельном окне, если нужно вынести одного агента на второй экран.
Когда несколько агентов работают в одной папке, они могут перезаписывать файлы друг друга. Чтобы этого избежать, укажите каждому агенту свой git worktree в поле Workspace. Настройку объясняет статья git worktree для параллельных агентов, а о разделении работы рассказано в статье как запускать нескольких агентов Claude Code.
Шаг 5: следите за тем, что делает каждый агент
У каждого агента есть статус: Working, Waiting for you, Needs approval, Idle, Asleep, Stopped или Error. Строка состояния их считает, например «2 working» или «3 agents need approval», так что видно, что требует вас, не открывая каждую панель. Нажмите ⇧⌘A, чтобы перейти к следующему агенту, ждущему подтверждения.
Когда вы отходите, уведомления на рабочем столе сообщают, что агент закончил, упал или ждёт подтверждения. Их можно отправлять и на телефон. См. уведомления и подтверждения.
Шаг 6: проверьте работу и откатите неудачный ход
Две бесплатные функции помогают доверять тому, что производят параллельные агенты.
- Код-ревью: если включить его в настройках проекта, выбранная вами модель Claude проверяет код каждого агента, когда заканчивается его ход. Находки приходят с серьёзностью и ссылкой file:line и при желании возвращаются агенту. См. код-ревью.
- Контрольные точки: в начале каждого хода AgentVera делает снимок рабочей папки агента. Кнопка Turns в заголовке панели показывает ходы и файлы, изменённые каждым, а Roll back this turn возвращает папку назад. Пошагово это описано в статье как отменить изменения Claude Code.
Шаг 7: входите в AgentVera, только когда нужно
Большая часть описанного в руководстве входит в бесплатный тариф и обходится без аккаунта. Pro и Team добавляют такие функции, как flows, ночная смена, автоодобрение и автоматическое переключение аккаунтов. Чтобы ими пользоваться, выберите в приложении Sign in to AgentVera. Войти можно через браузер (вход Google и двухфакторная аутентификация обрабатываются там) или по email и паролю. Что входит в каждый тариф, перечислено на странице цен.
Первая сессия, которая работает
Если не знаете, с чего начать, вот простая схема, быстро показывающая пользу:
- Добавьте репозиторий, который вы хорошо знаете.
- Запустите агента Claude Code в новом worktree и попросите небольшое, чётко ограниченное изменение.
- Запустите второго агента (Codex или ещё один Claude Code) в его собственном worktree на несвязанной задаче.
- Установите сетку на два столбца и держите обоих на виду.
- Пока они работают, читайте diff, отвечайте на подтверждения и ставьте в очередь следующее сообщение.
- Если ход пошёл не так, откатите его из Turns, а не спорьте с агентом.
Советы на первую неделю
- Одна задача на агента. Называйте агентов по их работе. Чёткая роль в Role and instructions избавляет от повторений.
- Один worktree на агента. Это самый простой способ не дать агентам перезаписывать друг друга.
- Сначала держите сетку небольшой. Двое-трое агентов, которых вы действительно читаете, лучше восьми, которых вы лишь пролистываете.
- Пользуйтесь палитрой. ⌘K находит почти любое действие, рядом с ним показано сочетание клавиш.
- Следите за лимитами. Строка состояния показывает использование каждого аккаунта за 5 часов и за неделю. В статье лимиты Claude Code есть советы, как их растянуть.
- Смените язык, если хотите. Интерфейс есть на английском и турецком, со светлой и тёмной темами, в Settings → Appearance.
Итоги
Начать работать с AgentVera можно за несколько минут. Вы добавляете проект, запускаете агента с CLI, которым уже пользуетесь, и добавляете второго, когда появляется вторая задача. Всё остальное, то есть worktree, контрольные точки, ревью, дополнительные аккаунты и уведомления на телефон, строится на той же сетке. Добавлять каждое из них можно по мере необходимости.