Чтобы вести ИИ-агентов для программирования по нескольким клиентским проектам, дайте каждому клиенту свою папку, свой файл инструкций и, если этого требует договор, свой аккаунт агента, а затем запускайте каждого агента только внутри папки этого клиента. Большинство проблем, на которые агентства жалуются при работе с агентами (чужие соглашения, утечка контекста, неожиданные расходы), возникают из-за общей настройки, а не из-за модели.
Это руководство для небольших агентств и фрилансеров, которые уже используют Claude Code, Codex или другой агент для программирования в одном проекте и теперь хотят использовать его в пяти. В нём — настройка для каждого клиента, прозрачные расходы, проверка перед сдачей и то, как держать всё это в одном окне.
Почему одна настройка на всех клиентов не работает
Агент для программирования работает с тем, что видит: с папкой, в которой запущен, с файлами инструкций в ней и с аккаунтом, под которым он вошёл. Если всё это общее для нескольких клиентов, ломаются три вещи:
- Соглашения перетекают. Агент перенимает привычки из кода или инструкций предыдущего клиента и применяет их к следующему.
- Расходы размываются. Один аккаунт и одна шкала использования на всё — и уже не понять, какой клиент сколько потратил.
- Доступ шире, чем нужно. Агент, запущенный в родительской папке, может читать все клиентские папки под ней, включая файлы
.env.
Решение скучное, но рабочее: одна граница на каждого клиента.
Шаг 1: одна папка на клиента, и агенты запускаются внутри неё
Держите каждого клиента в своей папке, со своим репозиторием:
~/clients/
acme-shop/
dental-clinic-site/
logistics-dashboard/Всегда запускайте агента изнутри одной клиентской папки, а не из ~/clients/. Claude Code, Codex и Gemini CLI считают проектом ту папку, в которой вы их запустили. Если нужен второй агент на того же клиента, например один чинит баг, а другой делает новую страницу, дайте ему git worktree, чтобы они не правили одни и те же файлы.
Шаг 2: один файл инструкций на клиента
Каждый агент для программирования в начале сессии читает файл инструкций проекта: CLAUDE.md у Claude Code, AGENTS.md у Codex и многих других. Положите такой файл в корень каждой клиентской папки. Пишите коротко и конкретно:
# Клиент: интернет-магазин (тема Shopify + API на Node)
- Стек: тема на Liquid, Node 22, Postgres. Тесты: npm test.
- Стиль клиента: никаких новых зависимостей без согласования; тексты на турецком и английском.
- Никогда не трогать: настройки оплаты, /infra, продовые файлы .env.
- Готово — это: тесты проходят, есть pull request с кратким описанием для клиента.Этот файл отличает агента, который угадывает, от агента, который следует правилам клиента. Когда клиент меняет правило, меняйте файл, а не свои промпты.
Шаг 3: решите вопрос с аккаунтами для каждого клиента
Некоторым клиентам всё равно, под каким аккаунтом работает агент. Другие хотят, чтобы работа шла через аккаунт, который оплачивают они, или запрещают отправлять свой код провайдеру, которого не одобрили. Сначала проверьте договор.
Если клиенту нужен отдельный вход, дайте этому аккаунту свою папку конфигурации. Claude Code берёт свою папку из CLAUDE_CONFIG_DIR, а Codex — из CODEX_HOME, так что две папки — это два входа на одной машине без выхода из системы. В нашем руководстве по смене аккаунтов Claude Code ручная настройка разобрана по шагам.
Шаг 4: держите секреты вне досягаемости
Агенты читают файлы, чтобы понять проект, а .env — это тоже файлы. Для каждого клиента:
- держите продовые учётные данные вне рабочей папки; используйте
.envдля разработки с тестовыми ключами; - добавьте чувствительные пути в файл инструкций в раздел «никогда не трогать»;
- используйте настройки разрешений агента, чтобы он спрашивал перед командами, которые деплоят, мигрируют или удаляют.
Шаг 5: считайте токены по каждому клиенту
Если вы собираетесь выставлять счёт за использование ИИ или просто хотите знать, какой клиент приносит прибыль, измеряйте расход по каждому агенту и каждой папке с первого дня. Помогают два простых правила:
- задайте дневной лимит для каждого агента, чтобы зависший цикл не сжёг бюджет клиента за ночь;
- используйте более дешёвую модель для рутинных правок, а более сильную — только для проектирования и отладки.
В нашей статье о лимитах использования Claude Code объясняется, как работают 5-часовой и недельный лимиты; это становится важно, как только несколько клиентов делят одну подписку.
Шаг 6: проверяйте каждый diff до того, как его увидит клиент
Пусть агенты работают в ветке и открывают pull request. Прочитайте diff, запустите тесты и сами проверьте страницу. Клиенты платят не за код, написанный агентом, а за код, который проверил человек, которому они доверяют. Короткое письменное описание к каждому pull request заодно упрощает еженедельный отчёт клиенту.
Всё это в одном окне с AgentVera
Описанные шаги работают и в обычных терминалах. Сложнее всего держать в поле зрения пять клиентов и десять агентов. AgentVera — десктопное приложение для macOS, Windows и Linux, которое запускает Claude Code, Codex, Gemini CLI и другие агенты рядом друг с другом, каждого в настоящем терминале с вашей собственной установкой и вашим входом. Для работы агентства важно следующее:
- Сетка на каждый проект. У каждой клиентской папки свой набор агентов, и вы переключаетесь между клиентами, не теряя их состояния. См. рабочее пространство.
- Аккаунт на каждого агента. Добавьте аккаунты в Settings → Accounts и выберите один при создании агента, чтобы агенты клиента всегда работали под нужным входом. См. аккаунты.
- Лимиты токенов на агента. Лимиты на агента, на ход и на день, предупреждение на 80%, а при достижении лимита агент останавливается, но сохраняет свой диалог. См. бюджеты токенов.
- Код-ревью перед сдачей. Проверяйте изменения агента прямо в приложении, прежде чем они попадут в репозиторий клиента. См. код-ревью.
Бесплатный тариф включает до 18 агентов, MCP, Git, Docker, SSH, код-ревью и экономию токенов. Pro стоит $9,99 в месяц; если у вас ещё не было пробного периода, первый вход в приложение включает Pro на 7 дней без карты.
Итог
Агенты масштабируются на много клиентов, когда у каждого клиента есть чёткая граница: своя папка, свой файл инструкций, правильный аккаунт, никаких продовых секретов в зоне доступа, свой учёт токенов и проверка человеком перед сдачей. Настройте это один раз для каждого клиента, и подключение шестого клиента займёт минуты, а не неделю разгребания.
Источники: Claude Code settings, AGENTS.md.