# Как пользоваться AgentVera: первый проект и сетка

URL: https://agentvera.dev/ru/blog/getting-started-with-agentvera/ · Опубликовано: 2026-10-24

Как пользоваться AgentVera по шагам: добавьте папку проекта, запустите агентов Claude Code или Codex, расставьте сетку, следите за статусом; аккаунт нужен лишь для Pro.

**Коротко:**

- Установите нужные CLI-агенты, откройте AgentVera, добавьте папку проекта и запускайте агентов через New agent; каждый работает как настоящий CLI в своей панели терминала.
- Агенты используют существующие входы CLI. Дополнительные аккаунты Claude и Codex добавляются в Settings → Accounts, а выбирается нужный в диалоге New agent.
- Основные функции работают без аккаунта AgentVera. Входите в него только ради функций Pro и Team: flows, автоодобрение и автоматическое переключение аккаунтов.

**Чтобы пользоваться AgentVera, установите нужные CLI кодинг-агентов, добавьте папку проекта, запустите одного или нескольких агентов через New agent и работайте с ними рядом в сетке проекта.** Каждый агент — настоящий CLI, например Claude Code или Codex, в своей панели терминала и со своим входом. AgentVera добавляет всё вокруг него: сетку на проект, поле сообщений с очередью, статус с первого взгляда, контрольные точки на каждый ход, код-ревью и работу с аккаунтами.

Это руководство проведёт вас от пустого окна до нескольких работающих агентов. В нём: что установить заранее, как работает диалог New agent, как расставить сетку, как устроен вход для CLI и для самого AgentVera и какие привычки не дают параллельным агентам мешать друг другу.

## Что нужно до начала

AgentVera — настольное приложение для macOS, Windows и Linux. Скачать его можно на [странице загрузки](/ru/download/). Своей модели у него нет. Он запускает CLI-агентов, уже установленных на вашем компьютере.

| Что нужно | Зачем |
| --- | --- |
| Хотя бы один CLI-агент, например Claude Code или Codex | AgentVera запускает настоящий CLI для каждого агента |
| Вход в этот CLI | Агенты используют вход и тариф самого CLI |
| Папка проекта, лучше всего репозиторий Git | Контрольные точки, worktree и код-ревью опираются на Git |
| Аккаунт AgentVera (необязательно) | Только для функций Pro и Team |

Если вы никогда не пользовались Claude Code, в статье [как пользоваться Claude Code](/ru/blog/how-to-use-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. Диалог подсказывает, что нужно: выберите инструмент, затем задайте агенту имя и, при необходимости, роль.

1. **Tool:** выберите CLI, например Claude Code или Codex. Инструмент, который AgentVera не находит на этом компьютере, помечен **Not installed**.
2. **Agent name** и **Color:** короткое имя вроде «Backend» или «Reviewer» упрощает просмотр сетки.
3. **Runs on:** пока оставьте **This computer**. Агента можно запустить и на SSH-сервере.
4. **Account:** вход, которым пользуется агент. По умолчанию это тот, что уже есть на этом компьютере. В поле написано **Signed in** или **Signed out**.
5. **Workspace:** основная папка или один из git worktree проекта.
6. **Role and instructions:** необязательно. Для Claude это добавляется в системный промпт, а для Codex — как инструкции разработчика.
7. Нажмите **Start agent**.

В диалоге есть и другие параметры, включая профиль контекста, браузер, карту проекта, MCP-серверы, контейнер Docker, бюджет токенов и закреплённые пути. Для первого запуска можно оставить их значения по умолчанию и вернуться позже. О профилях контекста рассказывает страница [экономия токенов](/ru/features/token-savings/), а о запуске агента в контейнере — страница [Docker](/ru/features/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](/ru/blog/switch-claude-code-accounts/).

## Шаг 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 для параллельных агентов](/ru/blog/git-worktree-parallel-agents/), а о разделении работы рассказано в статье [как запускать нескольких агентов Claude Code](/ru/blog/run-multiple-claude-code-agents/).

## Шаг 5: следите за тем, что делает каждый агент

У каждого агента есть статус: **Working**, **Waiting for you**, **Needs approval**, **Idle**, **Asleep**, **Stopped** или **Error**. Строка состояния их считает, например «2 working» или «3 agents need approval», так что видно, что требует вас, не открывая каждую панель. Нажмите ⇧⌘A, чтобы перейти к следующему агенту, ждущему подтверждения.

Когда вы отходите, уведомления на рабочем столе сообщают, что агент закончил, упал или ждёт подтверждения. Их можно отправлять и на телефон. См. [уведомления и подтверждения](/ru/features/notifications-and-approvals/).

## Шаг 6: проверьте работу и откатите неудачный ход

Две бесплатные функции помогают доверять тому, что производят параллельные агенты.

- **Код-ревью:** если включить его в настройках проекта, выбранная вами модель Claude проверяет код каждого агента, когда заканчивается его ход. Находки приходят с серьёзностью и ссылкой file:line и при желании возвращаются агенту. См. [код-ревью](/ru/features/code-review/).
- **Контрольные точки:** в начале каждого хода AgentVera делает снимок рабочей папки агента. Кнопка **Turns** в заголовке панели показывает ходы и файлы, изменённые каждым, а **Roll back this turn** возвращает папку назад. Пошагово это описано в статье [как отменить изменения Claude Code](/ru/blog/undo-claude-code-changes/).

## Шаг 7: входите в AgentVera, только когда нужно

Большая часть описанного в руководстве входит в бесплатный тариф и обходится без аккаунта. Pro и Team добавляют такие функции, как flows, ночная смена, автоодобрение и автоматическое переключение аккаунтов. Чтобы ими пользоваться, выберите в приложении **Sign in to AgentVera**. Войти можно через браузер (вход Google и двухфакторная аутентификация обрабатываются там) или по email и паролю. Что входит в каждый тариф, перечислено на [странице цен](/ru/pricing/).

## Первая сессия, которая работает

Если не знаете, с чего начать, вот простая схема, быстро показывающая пользу:

1. Добавьте репозиторий, который вы хорошо знаете.
2. Запустите агента Claude Code в новом worktree и попросите небольшое, чётко ограниченное изменение.
3. Запустите второго агента (Codex или ещё один Claude Code) в его собственном worktree на несвязанной задаче.
4. Установите сетку на два столбца и держите обоих на виду.
5. Пока они работают, читайте diff, отвечайте на подтверждения и ставьте в очередь следующее сообщение.
6. Если ход пошёл не так, откатите его из **Turns**, а не спорьте с агентом.

## Советы на первую неделю

- **Одна задача на агента.** Называйте агентов по их работе. Чёткая роль в **Role and instructions** избавляет от повторений.
- **Один worktree на агента.** Это самый простой способ не дать агентам перезаписывать друг друга.
- **Сначала держите сетку небольшой.** Двое-трое агентов, которых вы действительно читаете, лучше восьми, которых вы лишь пролистываете.
- **Пользуйтесь палитрой.** ⌘K находит почти любое действие, рядом с ним показано сочетание клавиш.
- **Следите за лимитами.** Строка состояния показывает использование каждого аккаунта за 5 часов и за неделю. В статье [лимиты Claude Code](/ru/blog/claude-code-usage-limits/) есть советы, как их растянуть.
- **Смените язык, если хотите.** Интерфейс есть на английском и турецком, со светлой и тёмной темами, в Settings → Appearance.

## Итоги

Начать работать с AgentVera можно за несколько минут. Вы добавляете проект, запускаете агента с CLI, которым уже пользуетесь, и добавляете второго, когда появляется вторая задача. Всё остальное, то есть worktree, контрольные точки, ревью, дополнительные аккаунты и уведомления на телефон, строится на той же сетке. Добавлять каждое из них можно по мере необходимости.

## Частые вопросы

**Нужен ли аккаунт AgentVera, чтобы начать?** Нет. Проекты, агенты, сетка, Git, MCP, Docker, SSH, код-ревью и экономия токенов входят в бесплатный тариф и не требуют аккаунта. Входить в аккаунт AgentVera нужно только ради функций Pro или Team.

**Заменяет ли AgentVera Claude Code или Codex?** Нет. AgentVera запускает настоящие CLI. Каждый агент — это процесс Claude Code, Codex, Gemini CLI, Copilot CLI или другого CLI в собственном терминале, и он использует вход и настройки этого CLI.

**Что делать, если выбранный инструмент помечен как Not installed?** AgentVera не нашёл этот CLI на компьютере. Установите его так, как описано у разработчика, убедитесь, что команда запускается в обычном терминале, и снова откройте диалог New agent.

**Сколько агентов можно запустить в одном проекте?** В бесплатном тарифе лимита на агентов нет. Сетка показывает до 5 столбцов на 4 строки панелей на проект, и каждый проект помнит свою раскладку.

**На каких системах работает AgentVera?** На macOS, Windows и Linux. Приложение обновляется само с agentvera.dev, а агенты возвращаются к своему диалогу при следующем открытии.

---

**Об AgentVera.** AgentVera — настольное приложение для macOS, Windows и Linux от Solviera Teknoloji. Оно запускает 18 ИИ-агентов для программирования (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) рядом, по проектам, в настоящих терминалах с собственными установками CLI и входами пользователя. В бесплатном тарифе количество агентов не ограничено. Скачать: https://agentvera.dev/ru/download/ · Цены: https://agentvera.dev/ru/pricing/