# CodingAgent Accounts: ваши аккаунты, использование и ротация

## Обзор

С одной Specification могут одновременно работать Builder и Reviewer, пока другой Workspace использует третью
сессию. Этим сессиям не обязательно незаметно для вас конкурировать за один вход: **CodingAgent Accounts** показывает
доступный ресурс ваших аккаунтов и позволяет выбрать, как CodingAgents его используют.

Пул принадлежит вам и используется во всех ваших Workspaces. Он не предназначен для передачи аккаунтов другим
людям. Настройка необязательна: с одним лишь нативным входом provider вы продолжаете работать как раньше.

Уже существующий на компьютере вход — основной аккаунт, **Main**. Если provider сообщает ваш e-mail, Kavor использует
только этот адрес как отображаемое имя; если данные о личности недоступны, отображается **Main**. Добавление
аккаунта в Kavor не заменяет этот вход и не завершает сеансы приложений provider, которые его используют.

Начните с группы **Accounts** в верхней панели Workspace. Наведите указатель на provider, чтобы увидеть сводку,
и нажмите, чтобы открыть панель. Здесь собраны использование, аккаунты, выбор для Workspace и предпочтения;
отдельного менеджера аккаунтов в Settings нет.

## Использование

**Проценты показывают оставшийся ресурс, а не количество агентов.** Несколько CodingAgents могут использовать
один аккаунт и одновременно расходовать его лимиты в соответствующих окнах.

![Иллюстрация интерфейса индикаторов Accounts для Claude Code, Codex, Antigravity и Grok.](https://media.agentkavor.com/product/2.1.0/coding-agent-accounts/header.118710635e3f.png)

Иллюстрация интерфейса со значениями из исходного снимка; это не новые данные об использовании от провайдеров.

### Читайте сводку в верхней панели

- Каждый индикатор использует цвет своего provider и показывает до двух общих окон аккаунта, от самого короткого
  к следующему по длительности. Для аккаунта с пятичасовым и недельным окнами показываются оба; аккаунту только
  с месячным окном не приписывается вымышленное пятичасовое. Проценты разных аккаунтов не складываются.
- Если в этом Workspace используется несколько аккаунтов, сводка представляет тот, у которого меньше всего
  ресурса в одном из этих окон. При наведении показываются используемые аккаунты и окна каждого из них.
- Если этот provider не используется ни одним CodingAgent, индикатор приглушён и показывает лучший известный
  доступный аккаунт среди тех, которые Workspace может выбрать в Automatic. Это не значит, что он уже выбран.
- **+N** — резерв других аккаунтов с известным доступным ресурсом для автоматического выбора в этом Workspace,
  а не исключительное резервирование. В него могут входить аккаунты, уже используемые другими CodingAgents.
  **+N?** указывает на ещё неизвестные показания; у provider с одним аккаунтом резерв не отображается.
- Окно становится янтарным при достижении порога ротации. Весь индикатор становится светло-красным, когда все
  аккаунты, доступные Automatic в этом Workspace, по подтверждённым данным достигли настроенного порога или
  превысили его. Это информация о доступном ресурсе, а не блокировка работы.

### Проверяйте окна и показания

В панели у каждого окна показаны оставшийся ресурс и следующее обновление лимита. Окна отдельных моделей находятся
в подробностях аккаунта, а не в общем индикаторе. Откройте **More**, чтобы посмотреть время **Read**, тариф, кредиты,
накопленные сбросы и другие данные, которые provider действительно сообщил.

Видимые показания обновляются периодически. Во время обновления последнее достоверное показание остаётся видимым
со своим фактическим временем; закрытие и повторное открытие панели не превращает старые данные в новое наблюдение.
При ошибке показывается недоступность или подсказка по входу, а не вымышленные значения вместо последних
достоверных процентов. Для запроса обновления используйте **Refresh** рядом с селектором provider.

**Unavailable** и **—** не означают ни 0 %, ни 100 %. Неизвестное показание не подтверждает ни исчерпание ресурса
аккаунта, ни истечение входа. Проверьте ошибку и время; попробуйте обновить данные или войдите снова, если есть
соответствующая подсказка. Ошибка запроса использования не скрывает действия добавления аккаунта и повторного входа.

| Provider | Какие данные могут отображаться |
| --- | --- |
| **Codex** | Основное и дополнительное окна, их периоды и сбросы, область действия по моделям, кредиты и накопленные сбросы, если они сообщены. Периоды зависят от аккаунта. |
| **Claude Code** | Окна, распознанные в нативном результате использования, например сессия и неделя, с процентами и сбросами. Локальная статистика токенов или стоимости не превращается в квоту. |
| **Grok** | Использование кредитов, период и обновление лимита; тариф и предоплаченный баланс, если они сообщены. |
| **Antigravity** | Оставшийся ресурс и сбросы групп или buckets, о которых сообщает CLI. |
| **OpenCode** | Не участвует в этом мониторинге; использование зависит от provider, настроенного в harness. |

Запросы используют нативный канал provider и не поручают работу модели. Просмотр баланса не даёт разрешения его
расходовать.

## Аккаунты

### Добавьте аккаунт и выполните вход

1. Откройте панель поддерживаемого provider: **Codex**, **Claude Code** или **Grok**.
2. Используйте **Add account**, задайте узнаваемое имя, например `Trabalho`, и подтвердите
   **Add account and sign in**.
3. Завершите нативный вход на странице provider и при необходимости используйте показанный код. Адрес авторизации
   открывается один раз для начатого вами процесса; если CLI provider сам открывает браузер, Kavor не открывает
   вторую вкладку.
4. Проверьте состояние аутентификации и показания использования. **Открытие браузера не означает завершение входа.**
5. Если хотите включить новый аккаунт в автоматический выбор, разрешите его участие в нужном Workspace. Новый
   аккаунт изначально исключён из Automatic во всех Workspaces; глобальный пул сам по себе его не включает.

Kavor готовит изолированный профиль для добавленного аккаунта. Учётные данные находятся в хранилище, которое
использует CLI этого аккаунта, а не в базе данных Kavor. Нативный вход Main остаётся на прежнем месте.

Если срок входа истёк, используйте **Sign in again**. Для управляемых аккаунтов панель предлагает это действие
и тогда, когда состояние аутентификации определить не удалось; это не превращает неизвестное показание в
подтверждённое истечение. Каждый клик, запускающий вход, включая повторную попытку, один раз открывает адрес
авторизации, когда тот становится доступен. Если открыть его не удалось, вручную используйте
**Continue provider sign-in**. Повторное открытие панели или восстановление незавершённой операции само по себе
не открывает вкладки.

### Main — не копия вашего входа

Main использует нативный вход непосредственно там, где его хранит provider. В панели для Main нет действий входа,
выхода или удаления; управляйте этим входом инструментами provider. Если вы меняете нативный аккаунт вне Kavor,
Main начинает представлять этот вход, не предлагая восстановить предыдущий аккаунт.

Нативный вход без данных о личности или использовании, например ключ API Codex, продолжает работать как раньше,
но не участвует в автоматической ротации. Kavor не читает учётные данные, пытаясь определить личность.

### Выход и удаление — разные действия

**Sign out** сохраняет аккаунт в списке для повторного входа. **Remove account** убирает аккаунт из списка
и удаляет его изолированный профиль под управлением Kavor; вход Main и общая история сессий не удаляются.

Если аккаунт используют CodingAgents, Kavor показывает затронутых агентов и запрашивает подтверждение. Изменение
ожидает безопасной границы между ходами и освобождения старого процесса. Фиксированный выбор этого аккаунта
возвращается в Automatic; если он был аккаунтом Workspace по умолчанию, им снова становится Main. Если другого
аккаунта нет, выполнение использует нативный вход.

## Копирование личной конфигурации

При добавлении аккаунта вы получаете **первоначальную копию** личной конфигурации provider из нативной среды.
Это позволяет не настраивать заново предпочтения, skills и MCPs для каждого аккаунта. Содержимое зависит от
provider и того, что есть в источнике:

| Provider | Что копируется |
| --- | --- |
| **Codex** | `config.toml` с предпочтениями, профилями, личными MCPs и пользовательскими providers; личные hooks из `hooks.json`; `AGENTS.md` и каталоги `skills`, `plugins`, `rules` и `prompts`. `forced_chatgpt_workspace_id` не копируется. |
| **Claude Code** | `settings.json`, включая statusline и личные hooks; `keybindings.json`; `CLAUDE.md`; каталоги `skills`, `plugins`, `rules`, `agents` и `commands`. Из `.claude.json` копируются только личные MCPs, а не весь файл. |
| **Grok** | `config.toml` с предпочтениями и личными MCPs; `AGENTS.md` и каталоги `skills`, `plugins`, `rules` и `hooks`. |

**Секреты, встроенные в эти настройки, тоже копируются.** Это включает значения переменных окружения MCPs,
статические HTTP-заголовки и ключи пользовательских providers, записанные в этих файлах. Файлы сохраняют свои
права доступа; эти значения не попадают в логи и не хранятся в базе данных Kavor.

**Нативный вход, файлы аутентификации, элементы Keychain и данные о личности аккаунта никогда не копируются.**
Для добавленного аккаунта нужен собственный вход. Принадлежащие Kavor записи интеграции тоже не наследуются:
Kavor готовит свою интеграцию для этого аккаунта.

Это копирование, а не синхронизация. MCP, добавленный в Main позже, нужно настроить и в тех аккаунтах, где вы
собираетесь его использовать. Изменение добавленного аккаунта не меняет Main; повторный вход не копирует
предпочтения заново.

Если подготовка сообщает об ошибке конфигурации, проверьте указанный личный TOML или JSON перед повторной попыткой.
Не копируйте файлы аутентификации и не удаляйте весь нативный профиль в качестве способа исправления.

## Смена аккаунта

### Выберите поведение каждого Workspace

Выбор **Manual** в настройках CodingAgent закрепляет аккаунт за этим Node и имеет приоритет над политикой Workspace.
CodingAgent в **Auto (Automatic)** следует выбору своего Workspace для этого provider.

В панели Accounts самого Workspace:

- При включённом **Auto Rotate** переключатели участия определяют, какие аккаунты может использовать Automatic.
  У каждого Workspace собственный выбор, даже при общем пуле. Исключённый из этого выбора аккаунт остаётся видимым:
  его можно выбрать вручную в CodingAgent или использовать в другом Workspace.
- При единственном участвующем аккаунте Automatic остаётся на нём, даже если он достиг порога. Без участников
  используется нативный вход Main, без автоматической ротации в этом Workspace.
- При выключенном **Auto Rotate** кнопки выбора одного аккаунта задают аккаунт по умолчанию для CodingAgents
  в Automatic. При выключении им становится Main; прежний выбор не восстанавливается. Настройки участия
  сохраняются до следующего включения Auto Rotate.

Сохранение Auto Rotate или участия действует сразу и **не перезапускает и не перераспределяет работающих агентов**.
Участие учитывается при следующем реальном автоматическом выборе, например при открытии или ротации по порогу.
А явный выбор другого аккаунта по умолчанию или другого аккаунта Manual может перевести затронутых CodingAgents
на безопасной границе между ходами. Агент, фактический аккаунт которого не изменился, не перезапускается.

![Переключатель Workspaces Kavor на фоне нескольких открытых окон Canvas для разных программных проектов.](https://media.agentkavor.com/releases/1.3.0/multiple-workspaces/overview.baa20506a993.jpg)

Независимые Workspaces могут оставаться открытыми в отдельных окнах. Участие аккаунтов настраивается в панели Accounts каждого Workspace.

### Как Automatic выбирает другой аккаунт

Порог по умолчанию — **95 % использования**. Его можно изменить в **Rotate at used capacity (%)**, в разделе
**Global rotation preferences**. Kavor учитывает аутентификацию, соответствие тарифа требованиям, выбранную модель,
участие в Workspace и все сообщённые окна. Он не меняет модель, чтобы аккаунт подошёл для выбора.

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

1. Аккаунт, который уже используют CodingAgents этого Workspace.
2. Аккаунт, который не использует ни один другой Workspace.
3. Общий аккаунт, используемый наименьшим числом других Workspaces.

При равных условиях предпочтение получает аккаунт, чей ресурс обновится раньше. При четырёх Workspaces и четырёх
доступных подходящих аккаунтах это позволяет выделить по аккаунту каждому Workspace. Это не исключительное
резервирование: при необходимости аккаунты могут использоваться совместно. Открытие или закрытие Workspace
не вызывает общего перераспределения.

Смена перезапускает harness на другом аккаунте **между ходами**, возобновляя ту же нативную сессию с её историей.
Node показывает фактические этапы ожидания, выбора, перезапуска и возобновления. Указание ожидания не блокирует
терминал, которым ещё можно пользоваться; при перезапуске CLI терминал закрывается и возвращается, когда сессия
готова. Успешная смена не вызывает системного уведомления; уведомления предназначены для реальных ошибок
с указанием Workspace и CodingAgent.

### Исчерпанный ресурс и ошибки хода

**Низкий или исчерпанный ресурс сам по себе не приостанавливает CodingAgent, не блокирует сообщение и не отключает
ввод в терминал.** Если альтернативы с доступным ресурсом нет, агент остаётся на текущем аккаунте. При первом
открытии в Automatic без подходящего аккаунта с ресурсом используется Main и сообщается об этом состоянии.
Фактические лимиты и списания за ход по-прежнему применяет provider.

Если подтверждено, что срок входа истёк, он не учитывается при автоматическом выборе; ошибка сети или неизвестное
показание не подтверждают истечение. Это не отменяет выбор Manual.

В **Codex и Claude Code** ход, завершившийся ошибкой из-за квоты аккаунта, подтверждённой provider, можно возобновить
на другом аккаунте по тем же правилам Automatic, когда повторная отправка безопасна. Неопределённость доставки,
аутентификация, rate limit, общая перегрузка и неизвестная причина не разрешают повторять запрос.
**Завершившийся ошибкой ход Grok не отправляется автоматически повторно**, поскольку нативный сигнал не отличает
квоту от rate limit; ротация по порогу использования остаётся доступной.

### Кредиты и накопленные сбросы

**Allow spending credits** и **Allow spending banked resets** — отдельные разрешения, выключенные по умолчанию.
Они управляют выбором и ротацией в Kavor; просмотр баланса не включает ни одно из них. При выключенных кредитах
аккаунт на настроенном пороге не становится доступным для автоматического выбора лишь потому, что на нём ещё есть
средства. Это не прерывает уже работающую сессию и не меняет ваш выбор Manual.

**Эти настройки не блокируют нативные списания внутри хода.** Управляйте лимитами расходов и платным потреблением
аккаунта у самого provider. Kavor не покупает кредиты и не меняет настройки оплаты вашего входа.

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

## Инструменты для CodingAgents

CodingAgent может просматривать ваши аккаунты, не получая учётных данных:

- `kavor_coding_agent_account_list_usage` запрашивает глобальный пул и нативные входы с пагинацией, окнами,
  сбросами, допустимостью выбора и временем наблюдения; поддерживает фильтр по provider.
- `kavor_coding_agent_account_request_change` запрашивает смену **собственного аккаунта** вызывающего CodingAgent
  в конце хода, с соблюдением Automatic и разрешённых в этом Workspace аккаунтов.

Запрос отклоняется в Manual и не гарантирует наличия подходящей альтернативы. Эти инструменты не позволяют менять
аккаунт другого CodingAgent, выполнять вход, удалять аккаунты, менять разрешения на расходование или получать токены.

Например:

> Сравни окна и сроки обновления лимитов моих аккаунтов, не меняя никакого выбора. Если рекомендуешь сменить аккаунт
> собственной сессии, объясни, какие показания подтверждают рекомендацию, и соблюдай мой выбор Manual.

## Команды Agent Kavor

В разговоре **Agent Kavor**, в том числе через включённый Channel, команды действуют в выбранном Workspace
без хода модели для интерпретации управления. Используйте настоящие имена, показанные Kavor:

```text
/accounts
/accounts codex
/account
@Reviewer /account "Trabalho"
@Reviewer /account auto
/autorotate codex off
/autorotate codex on
/status
```

- `/accounts [provider]` показывает сводку использования, обновлений лимитов и резерва Workspace. Это не полный
  экспорт всех аккаунтов: если есть дополнительные результаты или неизвестные показания, команда указывает
  ограничения и направляет в панель.
- `/account [@Nome]` запрашивает аккаунт и режим выбранного или указанного агента. Добавьте имя или e-mail
  аккаунта, чтобы закрепить его; используйте `auto` для возврата в Automatic. Имена с пробелами заключайте в кавычки.
- `/autorotate [provider] on|off` включает или выключает Auto Rotate в этом Workspace, не переводя работающих
  агентов на другие аккаунты. Без provider используется provider CodingAgent по умолчанию; если такого агента нет,
  provider нужно указать.
- `/status` включает аккаунт и его общие окна; `/help` показывает доступные средства управления и примеры.

Закрепление другого аккаунта соблюдает те же проверки, безопасную границу и обратную связь, что и desktop. Ответ
на команду не доказывает завершение возобновления. Добавление аккаунтов, вход, выход, удаление, изменение участия
и выбор аккаунта Workspace по умолчанию остаются действиями панели на desktop. Правила авторизации Channel
не меняются.

См. [Agent Kavor и Channels](./agent-kavor.md), чтобы выбрать Workspace и получателя перед использованием управления.

## Поддержка и ограничения по provider

- **Codex, Claude Code и Grok** поддерживают управляемые аккаунты и смену с продолжением сессии. Тариф аккаунта
  и модель должны допускать выполнение. Изолированная конфигурация не превращает неподходящий тариф в поддерживаемый.
- **Grok** не сообщает нативные данные о личности аккаунта. Main сохраняет это нейтральное имя; тариф и баланс
  не используются для вывода e-mail. Исключение для повторной отправки ходов описано выше.
- **Antigravity** поддерживает мониторинг аккаунта компьютера без пула, смены аккаунтов и копирования конфигурации,
  описанных в этом руководстве.
- **OpenCode** не участвует в описанных здесь мониторинге и управлении аккаунтами; его лимиты зависят от provider,
  настроенного в самом harness.
- Входы без сообщённых данных о личности или использовании остаются доступны нативным способом, без вымышленной
  квоты или включения автоматической ротации. Доступные сведения и окна могут различаться между аккаунтами
  и способами аутентификации.
- Отсутствие данных не означает нулевой баланс. Изменения нативных форматов могут сделать наблюдение недоступным;
  проверьте время, сообщение и вход, прежде чем заключать, что квота исчерпана.

Чтобы организовать работу с этими аккаунтами, перейдите к [руководству CodingAgent](./coding-agent.md)
и [разделению агентов и ролей](./agents-and-roles.md).