Anthropic недавно переработал Projects в Claude Code. Теперь это одна координирующая беседа, которая сама запускает параллельные облачные сессии-потоки под задачи и получает от них отчёты. Проект стоит заводить, когда у работы есть цель, которая переживёт одну сессию и будет порождать новые задачи - например, развитие репозитория на GitHub в течение нескольких недель. Одной потребности в параллельной работе для этого недостаточно. Если нужно быстро поправить один файл здесь и сейчас, обычной сессии достаточно.
Работу ведёт координатор - долгоживущая беседа, где Claude решает, что из твоего сообщения превратить в задачу для потока. Сам код пишут потоки: каждый из них - отдельная облачная сессия Claude Code на своей ветке репозитория. Потоков может быть несколько одновременно, у каждого свой контекст и своя ветка. Координатор видит, что поток сообщает по завершении, но не каждый его шаг. Он отчитывается тебе о готовых pull request'ах (запросах на слияние изменений) и по твоей команде просит поток их доработать или слить. Ниже - разбор по официальной документации Anthropic: что нужно настроить, как устроена работа и какие у беты ограничения.
Бета становится доступна постепенно, начиная с аккаунтов Pro и Max, которые уже пользовались облачными сессиями Claude Code и не завели проект в обычном чате или Cowork. Если раздела Projects пока не видно - можно записаться в лист ожидания.
В Telegram-канале - что нового в вайб-кодинге: инструменты, находки, ошибки. Подпишись, если хочешь следить за разборами следующих обновлений.
Что такое Claude Code Projects простыми словами
Проект - это одна долгоживущая беседа с координатором, к которой привязаны репозитории, память и инструкции. Ты пишешь координатору, а он сам решает: ответить сразу или запустить поток. Открывать новую сессию под каждую задачу вручную не нужно.
Поток - это полноценная облачная сессия Claude Code: у неё свой контекст, своя ветка репозитория, и при необходимости она открывает pull request. Координатор может держать открытыми сразу несколько потоков - например, один чинит баг, второй пишет тесты, третий обновляет документацию, - и параллельно отвечать тебе на вопросы в основной беседе.
Для сравнения представь несколько вкладок с локальными сессиями Claude Code, каждая в своей рабочей копии репозитория. Такая копия называется worktree - это отдельная папка под одну ветку, чтобы локальные сессии не мешали друг другу. Между сессиями ты переключаешься сам и решаешь, кому что поручить. Облачным потокам worktree не нужен: каждый поток сам клонирует репозитории в свою изолированную облачную среду. Projects берёт координацию на себя - решает, когда завести новый поток, а когда обойтись без него.
У проекта есть общая память и инструкции, которые получает каждый новый поток. Что в них сохранить и как они передаются потокам - в разделе о настройке.
Чем это отличается от обычной сессии и agent team
Если ты уже запускаешь вложенных субагентов внутри одной сессии Claude Code, стоит различать их, agent team и потоки проекта. Agent team - ещё один способ делегировать работу: одна сессия запускает сессии-напарники под конкретную задачу. Вести её можно и на своей машине, и внутри облачной сессии.
- Agent team - сессии-напарники для одной конкретной задачи, которые можно запускать и локально, и в облаке. Это не отдельные потоки проекта.
- Проект и его потоки - работа выполняется в облаке. Каждый поток - отдельная сессия на своей ветке, она продолжает жить, даже если ты закрыл ноутбук. Локальная сессия не может быть частью проекта.
- Agent view - экран для наблюдения за несколькими локальными сессиями на твоей машине. У него нет координатора: ты сам решаешь, что каждой поручить.
Официальная документация Anthropic отдельно поясняет: параллельная работа сама по себе - не повод заводить проект. В проекте Claude сам запускает сессии и получает от них отчёты, все они стартуют с общими репозиториями, инструкциями и памятью. Работа при этом остаётся в облаке на протяжении задачи.
Похожий подход - координатор, который распределяет задачи между агентами - реализован и в другом инструменте: ему посвящена статья про Cursor Projects. Механизм другой, но решение о том, кому что поручить, тоже принимает координатор.
Что нужно настроить перед первым проектом
Прежде чем заводить проект, проверь три вещи.
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. Но координатор не гарантирует, что задачи никогда не пересекутся: если несколько потоков окажутся в одной и той же области кода, можно в интерфейсе попросить нужный поток разрешить конфликт. Для этого рядом с его pull request есть кнопка Resolve conflicts, которая отправляет потоку инструкцию как сообщение от тебя.
Официальная документация предлагает задавать предпочтения по числу потоков через инструкции проекта: например, просить координатора запускать не больше двух потоков одновременно или переиспользовать существующий поток для новых задач в той же области. Это пожелание, которое координатор старается соблюдать, а не жёсткий лимит. Само по себе оно не гарантирует, что потоки не столкнутся в одном файле, - уже возникший конфликт нужно разрешать отдельно. Для связанных задач в той же области можно переиспользовать как активный, так и простаивавший поток. При простое дольше часа он заново перечитывает всю историю при новом сообщении, что влияет на расход лимита подписки.
Чем чётче задачи разделены по файлам или модулям, тем проще работать параллельно. Делению крупной задачи на независимые части посвящён отдельный разбор - как Борис Черны делегирует кодинг тысячам агентов: там масштаб другой, но принцип разделения работы тот же.
Пока действует кеш беседы (на планах Pro и Max - в пределах часа, если это позволяют лимиты твоего плана), поток тратит меньше токенов из лимита подписки на повторную обработку истории. Как только кеш истёк, поток при новом сообщении заново перечитывает всю свою историю целиком, прежде чем начать работу. Для новой независимой задачи может быть выгоднее попросить координатора завести свежий поток: это способно расходовать меньше токенов из того же лимита подписки, чем продолжение старой сессии с большой историей после истечения кеша.
Ограничения беты, о которых стоит знать заранее
Прежде чем заводить проект под важную задачу, стоит свериться с ограничениями беты:
- Доступ только на Pro и Max. Team и Enterprise пока не поддерживаются.
- Лимит 200 новых потоков в сутки на аккаунт - суммарно по всем проектам.
- Проект принадлежит одному пользователю. Предоставить другому человеку совместный доступ к нему или отдельному потоку нельзя, организационных настроек для команд в бете нет.
- Доступ только через claude.ai/code, десктоп-приложение и мобильное приложение. В терминальном CLI, через Amazon Bedrock, Google Cloud Agent Platform или Microsoft Foundry Projects не работают.
- Проект не видит локальные файлы и инструменты. Потоки работают с GitHub-репозиториями, загруженными файлами и папками Google Drive - но не с тем, что есть только на твоей машине.
Нужен доступ из терминала или к инструментам, которые есть только на твоей машине, - подойдёт локальная сессия или agent view для нескольких таких сессий. Нужна совместная работа нескольких человек над одним рабочим пространством - для команд на Team и Enterprise у Anthropic есть отдельный продукт Claude Tag: он живёт в Slack-канале, любой участник может дать Claude задачу, а видят и направляют работу все в канале. Проект устроен иначе - он принадлежит только тебе. Если нужны только конкретные локальные файлы, их можно загрузить в проект, и тогда каждый поток получит к ним доступ. Доступ к локальным инструментам это не даёт.
Что дальше
Прежде чем переносить рабочий процесс на Projects, попробуй завести один тестовый проект на некритичном репозитории: подключи GitHub App, напиши короткие инструкции, дай координатору одну независимую задачу и посмотри, как он с ней справится. Такой первый запуск покажет, понятен ли тебе интерфейс координатора и потоков. Вопросы параллельной работы, конфликтов и расхода лимитов на нескольких задачах он не закрывает - для них нужна отдельная проверка.
Источники
Новые материалы - дайджестом, без спама
Гайды выходят регулярно. Подпишись, чтобы не пропускать: пришлю подборку в Telegram или на email. Раз в неделю или каждый день - выбираешь сам.
