вольный пересказ документации Claude Code
Оригинал — здесь
Допустим, у вас открыты три облачные сессии Claude Code. Одна чинит баг, вторая переписывает отчёт, третья разбирается с тестами. Каждой вы отдельно объяснили, от какой ветки работать и как проверять результат. И каждые полчаса заходите в каждую посмотреть, закончила она или ждёт вашего ответа.
В этой схеме диспетчер — вы.
Проекты в Claude Code забирают эту роль себе. Вы пишете в один разговор всё подряд: баг-репорт, текст ошибки, список дел на неделю. Claude решает, что из этого отдельная задача, запускает под неё сессию, следит за ней и зовёт вас, только когда нужно ваше решение.
К оглавлениюПредставьте прораба и несколько бригад. Вы разговариваете только с прорабом. Он раздаёт работу, принимает отчёты и приходит к вам с вопросами.
Прораб здесь — Claude в разговоре проекта, в документации его называют координатором. Бригады — треды. Каждый тред — обычная облачная сессия: работает на серверах Anthropic в своей git-ветке, открывает пул-реквест и отчитывается в разговор. Треды идут параллельно и продолжают работать, когда ноутбук закрыт. Заглянуть к ним можно и с телефона.
Координатор видит отчёты тредов, но не каждый их шаг. Поэтому тишина в разговоре ничего не значит: тред, скорее всего, просто работает. Чтобы понять, что происходит, откройте его.
Всё хозяйство видно на панели Overview справа от разговора. Треды там разложены по группам: Ready for review — пул-реквест ждёт проверки, Waiting on you — нужен ваш ответ или тред упал, Working — ещё в работе. Когда кто-то вас ждёт, на кнопке Overview загорается точка.
Общее знание переходит от треда к треду через три вещи. Первая — инструкции проекта: их получает каждый новый тред. Вторая — память проекта: туда Claude записывает решения и грабли, если попросить его «запомни это». Третья — репозитории и файлы, подключённые к проекту. Работать можно и без кода: загрузите папку договоров или выгрузку обращений в поддержку, и треды будут класть результаты файлами на вкладку Library.
К оглавлениюСейчас это бета для тарифов Pro и Max, и открывают её не всем сразу. Если в боковой панели claude.ai/code нет пункта Projects, значит, до вас ещё не дошло, и можно записаться в лист ожидания. На Team и Enterprise проектов пока нет.
Если проект будет работать с кодом, код должен лежать на github.com, а в репозиторий нужно установить приложение Claude для GitHub. Здесь легко споткнуться: подключения через /web-setup обычным облачным сессиям хватает, а тредам проекта — нет.
Сам проект создаётся кнопкой New project. Обязательно только имя. Остальное можно заполнить позже. Свяжите проект с одним потоком работы, в который постоянно что-то добавляется, например со всем, что нужно одному API, чтобы он отвечал быстрее.
Дальше документация советует не отдавать сразу всю работу, а сначала обкатать проект:
Если треды гадают вместо того, чтобы спросить, или встают со словом «blocked», в каждой задаче копаться не нужно. Почти всегда это одна и та же дыра в брифе или в настройках доступа. Закройте её один раз.
К оглавлениюИнструкции проекта — это текст до 16 000 символов, с которого начинает каждый тред. Лежат они в Project settings → Memory → Project instructions. В хорошем брифе написано, зачем проект, где идёт работа, как тред проверяет себя, что делать, если чего-то не хватает, и что нельзя делать без вас. Вот пример из документации, я его пересказал по-русски:
Этот проект держит p95 задержки платёжного API ниже 200 мс: профилирование, исправления запросов и кеширования и сопутствующие обновления зависимостей — в репозитории payments-api.
- Ветку создавай от main, на каждый тред — один черновой пул-реквест.
- Прежде чем сказать «готово», запусти `make test` и `make lint` и вставь итоговые строки в последнее сообщение.
- Если не можешь до чего-то дотянуться — репозиторий, секрет, API, коннектор, — в первом же сообщении точно скажи, чего не хватает, и остановись. Ничего не подменяй, не делай заглушек и не угадывай.
- Не сливай, не делай force-push и не меняй настройки CI, не спросив меня в треде.Самая полезная строчка здесь — про «остановись и скажи, чего не хватает». Без неё тред, которому не дали ключ к API, может обойти проблему заглушкой. Документация прямо называет это типичной поломкой: треды возвращаются с неверными догадками и обходными путями.
Правила, которые касаются одного репозитория, например как его собирать, лучше держать в его CLAUDE.md. Треды его тоже читают. А когда вы поправили какой-то тред, добавьте «запомни это»: поправка уйдёт в память проекта, и следующие треды начнут уже с ней.
Остальными настройками координатора управляют обычными фразами. Например: «не больше двух тредов одновременно», «пиши, только когда что-то закончилось или застряло», «на это ответь здесь, тред не заводи». Claude запоминает такие пожелания, но это договорённость, и он может её нарушить. Если правило должно соблюдаться всегда, запишите его в бриф.
К оглавлениюДокументация о многом говорит между делом. Вот что стоит знать заранее.
Первое и главное — лимиты. Проект расходует тот же лимит тарифа, что и остальные сессии, только заметно быстрее: каждый тред — полноценная сессия, их несколько одновременно, и сам координатор тоже тратит токены на чтение отчётов. На Pro в день, когда работает проект, до потолка вы дойдёте раньше обычного. Сверх лимита проект ничего не потратит, если вы сами не включили платные кредиты. Но тред, упёршийся в лимит, не останавливается, а ждёт следующего окна и сам продолжает работу. Если вы не хотите тратить это окно, нажмите Stop или поставьте проект на паузу.
Лимит расходуют и треды, которые уже закончили работу. По умолчанию тред присматривает за своим пул-реквестом: если упал CI или пришёл комментарий на ревью, он просыпается и чинит. Удобно, но за каждое такое пробуждение платите вы. Если это не нужно, напишите треду, чтобы перестал следить.
Старый тред дорого будить. Если он молчал больше часа, то при новом сообщении перечитывает всю свою переписку с начала. Для новой работы дешевле завести свежий тред.
Разрешения нужно давать внутри треда. Если он ждёт вашего «да», то «давай, продолжай» в общем разговоре до него не дойдёт. Откройте тред и ответьте там.
Треды не видят вашего компьютера: ни локальной базы, ни API за VPN, ни навыков и плагинов из вашей локальной настройки Claude Code. Всё это придётся перенести в репозиторий, в облачное окружение или в коннекторы claude.ai.
Когда в проекте несколько репозиториев, правила разрешений, хуки и переменные из их .claude/settings.json перестают действовать. CLAUDE.md и навыки при этом загружаются как обычно. На это легко напороться, если вы добавили в проект второй репозиторий.
Изменённые инструкции, репозитории и окружение получат только новые треды, уже работающие их не увидят.
И последнее. Между ходами песочница треда засыпает. Если она не проснётся, тред продолжит работу со свежей копии репозитория, а всё незакоммиченное пропадёт. На длинных задачах просите коммитить и пушить промежуточные результаты.
К оглавлениюПроект окупается, когда задачи идут потоком и конца им не видно. Например, переезд большого приложения, одна правка во всех репозиториях или сервис, по которому каждый день приходят баги. Ещё один случай — папка документов, к которой вы возвращаетесь с новыми вопросами.
Если задача влезает в одну сессию, проект не нужен. Если работа держится на том, что есть только на вашей машине, — тоже. Одну задачу по расписанию без обсуждений лучше сделать рутиной. А если задачи Claude должны ставить несколько человек, это не сюда: проект личный, поделиться им нельзя.
Я бы на Pro начинал с одного проекта, модели попроще и не больше двух тредов за раз. Сначала стоит посмотреть, сколько лимита уходит на обычный день. А разумный бриф нужен с самого начала: без него пять тредов принесут пять разных ошибок одного и того же происхождения.
Полная таблица настроек, пауза, архив и удаление, разбор сообщений об ошибках, настройка GitHub для организаций и сравнение проектов с agent view, рутинами и Claude Tag — в оригинале.
К оглавлениюЭтого раздела нет в оригинале — он добавлен в пересказе.