# Claude Code Projects: координатор, облачные потоки и ограничения беты > Обзор Claude Code Projects по официальной документации Anthropic: как координатор запускает облачные потоки задач, что настроить и какие ограничения есть у бета-версии. Source: https://ailoot.ai/blog/ru/claude-code-projects/ Canonical: https://ailoot.ai/blog/ru/claude-code-projects/ Language: ru Publisher: Ailoot (https://ailoot.ai/) Translation: guide-051 Revision: sha256-7df44e51e8b44d8eaa00386bbde6ce5b8d5bb4ff7b2d0a0714b1c5b48c1d4db8 Anthropic обновила Projects в Claude Code. Теперь работа строится вокруг одной беседы-координатора: она запускает параллельные облачные потоки для отдельных задач и получает от них отчёты. Проект имеет смысл создавать, если у работы есть долгосрочная цель, которая не укладывается в одну сессию и будет порождать новые задачи. Например, можно несколько недель развивать репозиторий на GitHub. Одной лишь потребности выполнять задачи параллельно недостаточно. Для быстрой правки одного файла удобнее обычная сессия. Работой управляет координатор — длительная беседа, в которой Claude определяет, какие сообщения превратить в задачи для потоков. Код пишут сами потоки: каждый представляет собой отдельную облачную сессию Claude Code в собственной ветке репозитория. Несколько потоков могут работать одновременно, у каждого свой контекст и своя ветка. Координатор получает отчёт потока по завершении, но не наблюдает за каждым этапом его работы. Он сообщает тебе о готовых pull request'ах (запросах на слияние изменений), а по твоей команде поручает потоку внести правки или слить изменения. В этом материале по официальной документации Anthropic объясняется, что настроить, как организована работа и какие ограничения есть у беты. Бета постепенно открывается пользователям тарифов Pro и Max, которые уже работали с облачными сессиями Claude Code и не создавали проекты в обычном чате или Cowork. Если раздел Projects ещё не появился, можно оставить заявку в лист ожидания.
Практические руководства по Ailoot доступны в [документации](https://ailoot.ai/docs/).
## Claude Code Projects простыми словами Проект — это длительная беседа с координатором, связанная с репозиториями, памятью и инструкциями. Ты обращаешься к координатору, а он выбирает: ответить самому или запустить поток. Вручную создавать новую сессию для каждой задачи не требуется. Поток — полноценная облачная сессия Claude Code с собственным контекстом и отдельной веткой репозитория. При необходимости он создаёт pull request. Координатор может одновременно вести несколько потоков: например, один исправляет ошибку, другой добавляет тесты, а третий обновляет документацию. В это же время координатор может отвечать на твои вопросы в основной беседе. Представь вместо этого несколько вкладок с локальными сессиями Claude Code, каждая из которых работает в отдельной копии репозитория. Такая копия называется worktree: это отдельная папка для одной ветки, которая не позволяет локальным сессиям мешать друг другу. Тебе пришлось бы самому переключаться между сессиями и распределять задания. Облачным потокам worktree не требуется: каждый из них клонирует репозитории в собственную изолированную облачную среду. В Projects координацию выполняет Claude — он решает, когда создать поток, а когда можно ответить без него. У проекта есть общие память и инструкции, доступные каждому новому потоку. О том, как их подготовить и передавать потокам, рассказано в разделе о настройке. ## Отличия от обычной сессии и agent team Если ты уже используешь [вложенных субагентов](https://ailoot.ai/blog/ru/claude-code-nested-subagents/) в одной сессии Claude Code, полезно разобраться, чем они отличаются от agent team и потоков проекта. Agent team — это ещё один способ делегирования: одна сессия запускает сессии-партнёры для конкретной задачи. Их можно запускать как на своём компьютере, так и в облачной сессии. - **Agent team** — сессии-партнёры для одной конкретной задачи. Их можно запускать локально или в облаке; к потокам проекта они не относятся. - **Проект и его потоки** — вся работа выполняется в облаке. Каждый поток — отдельная сессия в собственной ветке, которая продолжает работать, даже если ноутбук закрыт. Локальную сессию включить в проект нельзя. - **Agent view** — экран для наблюдения за несколькими локальными сессиями на твоём компьютере. Координатора у него нет, поэтому задания каждой сессии ты определяешь самостоятельно. В официальной документации Anthropic отдельно отмечено, что сама по себе параллельная работа не служит основанием для создания проекта. Claude самостоятельно запускает сессии и получает их отчёты, а все сессии начинают работу с общими репозиториями, инструкциями и памятью. На протяжении задачи работа остаётся в облаке. Сходный принцип — координатор распределяет задачи между агентами — используется и в другом инструменте. Подробнее он разобран в статье о [Cursor Projects](https://ailoot.ai/blog/ru/cursor-projects-coordinator-agents/). Устройства инструментов отличаются, но в обоих случаях задания распределяет координатор. ## Что настроить перед созданием проекта Перед созданием проекта проверь три условия. **1. Аккаунт GitHub и Claude GitHub App.** Если GitHub уже подключён через `/web-setup`, этот токен позволяет обычным облачным сессиям работать с репозиторием. Для потоков проекта этого недостаточно: подключённый аккаунт GitHub должен иметь право push в репозиторий, а Claude GitHub App — быть установленным для этого репозитория. Без приложения поток не сможет клонировать репозиторий или создать pull request. **2. Инструкции проекта.** Project instructions — это текст длиной до 16 000 символов, который получают координатор и каждый новый поток. Включи в него сведения, которые иначе пришлось бы повторять в каждой сессии: структуру репозитория, правила оформления кода и обязательные проверки перед созданием pull request. **3. Модель и уровень усилий (effort).** По умолчанию каждый поток нового проекта использует модель Opus с высоким уровнем усилий (effort), а координатор — низкий уровень. Документация предупреждает: такая конфигурация «быстрее всего расходует лимит плана» (перевод; оригинал: draws on your plan fastest). Для простых задач в **Project settings \> General** можно выбрать менее затратную модель или снизить effort. Параметры координатора и потоков настраиваются отдельно; документация также приводит более экономные варианты. Память проекта состоит из обычных файлов, а её индексом служит `MEMORY.md`. Каждый новый поток читает этот файл при запуске, а остальные файлы открывает при необходимости. Поэтому сведения, сохранённые одним потоком, могут использоваться следующим без повторного объяснения. ## Если потоки редактируют один и тот же код У каждого потока своя ветка, и при необходимости он самостоятельно создаёт pull request. Однако координатор не предотвращает пересечение задач автоматически: если несколько потоков затронули одну область кода, можно попросить нужный поток устранить конфликт через интерфейс. Кнопка Resolve conflicts рядом с его pull request отправит ему инструкцию от твоего имени. В официальной документации предлагается задавать предпочтения по количеству потоков в инструкциях проекта. Например, можно попросить координатора одновременно запускать не более двух потоков или использовать уже существующий поток для новых задач в той же области. Это пожелание, которому координатор старается следовать, а не строгий лимит. Оно не предотвращает конфликты в общих файлах: если конфликт уже возник, его нужно разрешить отдельно. Для связанных задач одной области можно продолжить работу в активном или простаивавшем потоке. Если поток простаивает больше часа, при получении нового сообщения он заново читает всю историю, что расходует лимит подписки. Параллельная работа проще, когда задачи распределены по разным файлам или модулям. В статье о делегировании работы над кодом тысячам агентов крупную задачу рассматривают в ином масштабе, но принцип разделения на независимые части тот же. Пока действует кеш беседы, поток расходует меньше токенов лимита подписки на повторную обработку истории. На планах Pro и Max кеш может сохраняться до часа, если это допускают лимиты твоего плана. После его истечения поток перед началом работы перечитывает всю историю при получении нового сообщения. Для новой независимой задачи может быть выгоднее попросить координатора запустить свежий поток: после истечения кеша это способно потребовать меньше токенов лимита подписки, чем продолжение старой сессии с длинной историей. ## Ограничения беты Перед тем как поручать проекту важную работу, учти ограничения бета-версии: - **Только тарифы Pro и Max.** Team и Enterprise пока не поддерживаются. - **Не более 200 новых потоков в сутки** для аккаунта, включая все проекты. - **Проект принадлежит одному пользователю.** Нельзя открыть совместный доступ к проекту или отдельному потоку. В бете также нет организационных настроек для команд. - **Доступ через claude.ai/code, приложение для компьютера и мобильное приложение.** Projects не работает в терминальном CLI, через Amazon Bedrock, Google Cloud Agent Platform или Microsoft Foundry. - **Нет доступа к локальным файлам и инструментам.** Потоки работают с репозиториями GitHub, загруженными файлами и папками Google Drive, но не с данными, которые находятся только на твоём компьютере. Для работы из терминала или доступа к инструментам, установленным только на твоём компьютере, используй локальную сессию или Agent view для нескольких сессий. Если несколько человек должны работать в одном пространстве, Anthropic предлагает для планов Team и Enterprise отдельный продукт Claude Tag: он работает в канале Slack, где любой участник может поручить Claude задачу, а все участники видят работу и могут направлять её. Проект устроен иначе: он принадлежит одному пользователю. Если потокам нужны отдельные локальные файлы, их можно загрузить в проект. Это откроет к ним доступ, но не даст доступ к локальным инструментам. ## Следующие шаги Перед переносом рабочего процесса в Projects создай тестовый проект для некритичного репозитория. Подключи GitHub App, добавь короткие инструкции, поручить координатору одну независимую задачу и оцени результат. Первый запуск поможет понять, насколько удобен интерфейс координатора и потоков. Он не проверит параллельную работу над несколькими задачами, разрешение конфликтов или расход лимитов — эти вопросы требуют отдельной проверки.
### Источники - [Claude Code Projects — официальная документация Anthropic](https://code.claude.com/docs/en/claude-projects)
Узнать больше об Ailoot можно на [ailoot.ai](https://ailoot.ai/).
## Вопросы и ответы ### Достаточно ли одной параллельной работы для создания Project? Project подходит цели, продолжающейся между сессиями и использующей общие репозитории, инструкции и память. Быструю локальную правку можно оставить обычной сессии. Беседы Projects работают в изолированных облачных средах. ### Что проверить, если беседа не клонирует репозиторий? Проверьте право подключённого GitHub-аккаунта на push и установку Claude GitHub App для репозитория. Токена обычных облачных сессий недостаточно для бесед Project. ## Ailoot · Компания и портфель её проектов Ailoot опирается на накопленный опыт работы, большую клиентскую базу, стабильный сервис и постоянный контроль KPI. Компания и портфель её проектов: миллионы клиентов; продажи на миллиарды ежемесячно. Этот опыт Ailoot использует для API-доступа к нейросетям в продуктах клиентов, агентах, приложениях и автоматизациях.