Позвольте Claude координировать текущую работу с помощью Projects

• Отправляете работу в одно место: вставляйте отчет об ошибке, трассировку стека или список задач в разговор, когда они появляются. Claude запускает поток для каждого элемента работы или передает его потоку, уже работающему в этой области, и отвечает на быстрые вопросы на месте.
• Устанавливаете контекст один раз: каждый новый поток начинается с репозиториев, инструкций и памяти проекта, поэтому правило, которое вы указываете один раз, например какую ветку выбрать, достигает все потоки.
• Уходите и возвращаетесь к завершенной работе: когда вы вернетесь через час или на следующее утро, панель Overview показывает, какие потоки завершены, какие pull request готовы к проверке и какой поток ждет вашего ответа.

​

Когда использовать проект

• Одна цель в нескольких репозиториях: “Обновить каждый сервис на новую конфигурацию lint.” Claude может запустить поток для каждого репозитория, каждый с собственным pull request, и панель Overview показывает, какие готовы к проверке.
• Область, которую вы постоянно пополняете: ошибки, трассировки стека и запросы на проверку для одного сервиса, вставляемые в разговор по мере их поступления. Ошибка, которую вы просите Claude запомнить после одного исправления, находится в памяти проекта для следующей.
• Сборка или миграция больше, чем сеанс: “Построить то, что описывает docs/spec.md” или “Перенести приложение с устаревшего ORM.” Работа разбивается на потоки, каждый берет часть, решения, которые вы просите Claude запомнить в начале, достигают более поздние потоки, и изменения спецификации и ошибки, которые вы находите во время сборки, попадают в один разговор.
• Работа, которая не является кодом: папка контрактов или экспорт билетов поддержки, к которым вы постоянно возвращаетесь с новыми вопросами, например “найти десять наиболее распространенных ошибок интеграции в этих билетах.” Загрузите документы вместо добавления репозитория, и потоки доставляют каждый отчет как файл на вкладке Library проекта.

​

Когда что-то другое подходит лучше

• Одна задача, которая подходит в сеанс: “Исправить нестабильный тест входа.” Запустите облачный сеанс самостоятельно.
• Работа, которая требует инструментов или сервисов, которые может достичь только ваша машина: локальная база данных, эмулятор устройства, API за вашим VPN. Используйте локальный сеанс или agent view для запуска нескольких одновременно. Если работе нужны только локальные файлы, загрузите их в проект вместо этого.
• Одна задача, которая повторяется по расписанию без разговора вокруг нее: “Отправить отчет о зависимостях каждый понедельник.” Создайте routine самостоятельно.
• Несколько человек дают Claude работу и направляют его вместе в канале Slack: см. Claude Tag.

​

Как организован проект

• Разговор проекта: один долгоживущий сеанс, где Claude действует как координатор. Он берет то, что вы отправляете, решает, что становится потоком, и отслеживает каждый запущенный поток. Он видит, что потоки сообщают обратно, а не каждый шаг, который они предпринимают.
• Потоки: рабочие. Каждый — это отдельный облачный сеанс с собственным контекстным окном, который выполняет одну часть работы на собственной ветке, открывает pull request, когда работа это требует, и сообщает обратно в разговор, когда завершается.
• С чего начинает каждый поток:
  • Репозитории и файлы проекта, плюс его инструкции и память
  • CLAUDE.md, skills и plugins в каждом из репозиториев проекта, и в проекте с одним репозиторием также правила разрешений и hooks этого репозитория
  • Connectors на вашем аккаунте claude.ai
  • Облачная среда, которая устанавливает его сетевой доступ, переменные окружения, учетные данные API и установленные инструменты
• Панель Overview: где вы видите все потоки сразу и какие из них вам нужны. Его другие вкладки — Library для добавленных вами файлов и файлов, созданных потоками, Pull requests для открытых потоками, и Routines для запланированной работы в проекте.

​

Создание проекта

• С нуля, когда вы знаете поток работы, который хотите запустить в Claude: откройте диалог New project и назовите его. Запуск нового проекта с нуля проходит через диалог.
• Из облачного сеанса, который уже выполняет работу: выберите Continue as a project из меню этого сеанса, и Claude предлагает настройку проекта на основе того, что делал сеанс. См. Запуск из существующего облачного сеанса.

​

Проверка предварительных условий

• План: вы на Pro или Max и Projects отображается на вашей боковой панели.
• GitHub, если проект будет работать с кодом: ваш код находится на github.com, а не на GitHub Enterprise Server, GitLab или Bitbucket, ваш подключенный аккаунт GitHub имеет доступ на push к нему, и Claude GitHub App установлено на нем. Если вы подключили GitHub с помощью /web-setup, этот токен позволяет вашим другим облачным сеансам достичь репозитория, но недостаточно для потоков проекта, которым нужно Claude GitHub App. Настройка доступа GitHub содержит шаги.
• Сеть, учетные данные и инструменты: они поступают из облачной среды проекта. Среда по умолчанию уже достигает общих реестров пакетов, поэтому проверьте это только если работе нужны другие домены, секрет или инструмент, который не предустановлен. Если работе нужен MCP server, проверьте, что он отображается как подключенный в ваших claude.ai connectors.

​

Запуск нового проекта с нуля

​

Запуск из существующего облачного сеанса

• Continue as a project создает новый проект с названием сеанса и открывает его. Claude читает сеанс и публикует Setup recommendations в разговоре для вашего подтверждения. Исходный сеанс остается в вашем списке сеансов, и если он был в середине хода, он продолжает работу, поэтому остановите его самостоятельно, если вы не хотите, чтобы оба работали одновременно. Если вы используете баннер Set up project, который может появиться над полем сообщения облачного сеанса, результат тот же, за исключением того, что работающий ход сеанса останавливается после открытия проекта.
• Move to project переносит работу сеанса в существующий проект. Он публикует сообщение в разговоре этого проекта, прося Claude прочитать сеанс и продолжить с того, где он остановился, и новая работа продолжается в собственных потоках проекта. Исходный сеанс остается в вашем списке сеансов, без изменений.

​

Настройка доступа GitHub

​

Работа в проекте

​

Ваш первый пакет

1. Напишите инструкции проекта: краткое описание, с которого начинает каждый поток, например какую ветку выбрать, как поток проверяет свою работу и что требует вашего одобрения.
2. Отправьте один небольшой кусок реальной работы или запустите один из потоков, которые Claude предложил, и откройте поток, когда он завершится, чтобы увидеть, как он сообщает обратно и что он сделал на своей ветке. Если он что-то неправильно предположил или не мог достичь то, что ему нужно, Потоки угадали или застопорились вместо того, чтобы спросить охватывает, где это исправить.
3. Проверьте Thread model и Thread effort в Project settings > General. Новый проект запускает каждый поток на Opus с высокой интенсивностью, что использует ваш план быстрее; Выбор моделей и позволить Claude управлять контекстом охватывает альтернативы.
4. Попросите Claude предложить потоки перед их запуском и запустить несколько одновременно, и отпустите эти лимиты, когда несколько потоков вернутся так, как вы хотите.

​

Отправляйте работу и читайте результаты

• Быстрый вопрос обычно получает ответ в разговоре.
• Новая работа идет в новый поток или в поток, уже работающий в этой области, и Claude говорит вам, какой. Каждый новый поток отображается под вашим сообщением как карточка: коробка с названием и статусом потока, которую вы нажимаете, чтобы открыть поток.
• Несколько несвязанных задач в одном сообщении становятся отдельными потоками.

​

Проверка pull request потока

• Branch: работает на новой ветке, начиная с ветки по умолчанию репозитория.
• Pull request: открывает один, когда вы просите, и может открыть один самостоятельно для исправления ошибки или другого конкретного изменения.
• После открытия: наблюдает за pull request с включенным auto-fix, независимо от того, включен ли auto-fix для ваших других облачных сеансов. Он отправляет исправления, когда CI не работает, обращается к комментариям проверки и отвечает в потоке, когда проверки проходят и pull request готов для вас.

​

Посмотрите, что вам нужно в Overview

​

Откройте поток, когда вам нужен контроль

• Прочитать, что сделал Claude, шаг за шагом.
• Направить задачу, написав в собственное поле сообщения потока. Сообщение там идет прямо в этот поток, в то время как последующее действие в разговоре проекта достигает его только, когда Claude соответствует последующему действию этому потоку.
• Ответить на подсказку разрешения, на которую ждет поток.
• Прервать поток с помощью Stop, который заменяет кнопку отправки, пока поток работает, или нажав Esc.

​

Выбор моделей и позволить Claude управлять контекстом

• Thread model и Thread effort применяются к потокам. Чтобы использовать другую модель для одной задачи, попросите это в задаче; для уже работающего потока используйте выбор модели этого потока.
• Coordinator model и Coordinator effort применяются к Claude в разговоре проекта.

​

Настройка того, как Claude запускает проект

• “Предложить потоки и ждать моего одобрения перед их запуском” или “Запустить их сейчас без просьбы подтверждения”
• “Запускать максимум два потока одновременно” или “Повторно использовать существующий поток для последующих действий в той же области”
• “Публиковать более короткие обновления” или “Публиковать только когда что-то завершается или блокируется”
• “Дать мне обновление статуса по каждому потоку”
• “Выполнить эту задачу с меньшей моделью”
• “Не открывать pull request, пока я не видел план”
• “Скажи мне, что не так в этих репозиториях и ничего не исправляй”, когда вы хотите пройти через выводы перед тем, как любой из них станет потоком
• “Ответить здесь вместо запуска потока”, когда Claude запускает поток для чего-то, что вы имели в виду как быстрый вопрос

​

Разблокировка потока, ожидающего одобрения

​

Предоставление проекту постоянного контекста

​

Напишите инструкции проекта

• Для чего предназначен проект
• Где происходит работа: какие репозитории, какую ветку начать, как назвать pull requests
• Как поток проверяет свою работу перед тем, как назвать это выполненным
• Что делать, когда что-то, что ему нужно, отсутствует
• Что требует вашего одобрения в первую очередь

Этот проект держит p95 задержку для API платежей ниже 200 мс: профилирование, исправления запросов и кэширования, и обновления зависимостей, которые с ними идут, в репозитории payments-api.

- Ветвитесь от main и откройте один черновик pull request для каждого потока.
- Перед тем, как назвать работу выполненной, запустите `make test` и `make lint` и вставьте строки сводки в ваше финальное сообщение.
- Если вы не можете достичь что-то, что вам нужно, например репозиторий, секрет, API или connector, скажите точно, что отсутствует в вашем первом сообщении и остановитесь. Не подменяйте, не имитируйте и не угадывайте.
- Не объединяйте, не выполняйте force-push и не изменяйте конфигурацию CI без моего запроса в потоке.

​

Решение, какие репозитории добавить

• Добавьте его в проект, в диалоге New project, в Project settings > Environment, или попросив Claude в разговоре добавить его в проект. Каждый поток с этого момента клонирует его и начинает с его CLAUDE.md и skills загруженными, независимо от того, касается ли задача его. Переход от одного репозитория к нескольким также изменяет то, что потоки берут из .claude/settings.json каждого репозитория; см. Что потоки берут из ваших репозиториев.
• Оставьте его и позвольте потокам добавить его, когда это необходимо. Поток, чья задача требует репозитория, который проект не имеет, может добавить его к себе, и заметка в потоке говорит, что он был добавлен только в этот поток. Клон происходит в середине задачи, поэтому CLAUDE.md и skills этого репозитория не были там, когда поток начался. Следующий поток начинает без него снова. Репозиторий, который добавляет поток, требует те же предварительные условия, что и репозиторий проекта: Claude GitHub App установлено на нем и доступ на push из вашего аккаунта GitHub.

​

Что потоки берут из ваших репозиториев

​

Выбор среды для потоков

​

Получить skills, plugins, connectors и инструменты в потоки

• Skills, subagents и команды: зафиксируйте их в репозитории, который вы добавили в проект, например skill в .claude/skills/<skill-name>/SKILL.md. Каждый поток клонирует каждый репозиторий в проекте и загружает .claude/skills/, .claude/agents/ и .claude/commands/ из каждого из них, поэтому skill, зафиксированный в одном репозитории, доступен в каждом новом потоке. Потоки также загружают skills, которые вы включаете для вашего аккаунта claude.ai.
• Plugins: добавьте их в Project settings > Plugins; они загружаются в каждый новый поток. Plugins, которые репозиторий объявляет в его .claude/settings.json, также загружаются; см. Что переносится из вашей настройки.
• MCP servers: потоки получают свои MCP инструменты из connectors на вашем аккаунте claude.ai, которые являются MCP servers, которые вы подключаете один раз в claude.ai/customize/connectors или через ссылку Manage connectors в Project settings > Environment. Каждый поток может использовать все их без настройки для каждого проекта. Разговор проекта сам по себе не имеет connectors, поэтому отправляйте работу, которая требует один, как задачу для потока. В проекте с одним репозиторием потоки также загружают MCP servers из .mcp.json этого репозитория. Как connectors достигают Claude Code перечисляет правила для облачных сеансов и параметры, которые отключают connectors.
• Инструменты командной строки и пакеты: установите их в скрипт настройки среды.

​

Справочник параметров проекта

​

Пауза, архивирование или удаление проекта

• Pause: останавливает все сразу. Каждый работающий поток и разговор прерываются, новые потоки не запускаются, routines не работают, и проект не принимает сообщения, пока вы его не возобновите. Нажмите Resume в том же месте или на баннере выше поля сообщения проекта; приостановленный поток продолжает работу, когда вы отправляете ему сообщение после этого.
• Archive: скрывает проект из боковой панели и архивирует его потоки, что останавливает любой поток, который работал или наблюдал за pull request. Routines в проекте не работают, пока он архивирован. Чтобы вернуть проект, откройте его со страницы Projects и нажмите Unarchive. Его потоки остаются архивированными, пока вы не разархивируете их отдельно из списка сеансов.
• Delete: постоянно удаляет проект вместе с его потоками, его памятью и его файлами, и отключает routines проекта. Это не может быть отменено. Ветки и pull request, которые потоки отправили на GitHub, не затрагиваются.

​

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

​

Что использует ваш план

• Работающие потоки: каждый — это полный сеанс, и несколько могут работать одновременно. Нет фиксированного числа; Claude запускает столько, сколько требует работа, и лимит, который вы просите, — это предпочтение, а не ограничение. Принудительный лимит — 200 новых потоков в день во всех ваших проектах.
• Разговор: Claude использует токены самостоятельно, читая то, что сообщают потоки и решая, что делать дальше.
• Потоки, наблюдающие за pull request: неактивный поток просыпается и использует ваш план снова, когда CI не работает или приходит комментарий проверки на его pull request. Чтобы остановить это, попросите в потоке остановить наблюдение за pull request.

​

Посмотрите и уменьшите использование проекта

• Последующее действие, направленное в поток, который был неактивным дольше, чем время жизни кэша, час на Pro и Max в пределах лимитов вашего плана, перечитывает весь разговор этого потока перед тем, как что-то делать. Для новой работы, просьба Claude запустить свежий поток может использовать меньше, чем возрождение большого старого.
• Для работы, которая не требует самую большую модель, выберите меньшую модель или более низкий уровень интенсивности для потоков, разговора или обоих.
• Попросите Claude в разговоре проекта запускать меньше потоков одновременно или отвечать на маленькие вопросы самостоятельно вместо запуска потока.

​

Как проекты связаны с другими функциями Claude Code

• Claude Tag: Claude Tag — это Claude в каналах Slack вашей команды, на планах Team и Enterprise. Любой в канале может дать ему работу, все в канале видят и направляют его, и он использует соединения, которые администратор установил для этого канала. Проект — это только ваш: вы единственный, кто отправляет ему работу или видит его потоки, он использует ваш собственный доступ GitHub и connectors, и он на Pro и Max. Как Claude Tag отличается от Cowork и Claude Code имеет рядом.
• Cloud sessions: каждый поток — это облачный сеанс, запущенный и отслеживаемый Claude вместо вас. Облачный сеанс, который вы запустили самостоятельно, может стать проектом или питать один через Continue as a project или Move to project.
• Routines: когда вы просите запланированную работу в проекте, Claude создает routine, которая работает как потоки в этом проекте и отображается на его вкладке Routines. Routines, которые вы создаете вне проекта, продолжают работать самостоятельно.
• Local sessions и agent view: сеансы в вашем терминале, IDE или локальной среде настольного приложения работают на вашей машине и не могут быть частью проекта. Agent view — это экран для отслеживания нескольких из этих локальных сеансов; он не имеет координатора.
• Worktrees: worktree дает каждому локальному сеансу свою рабочую копию репозитория, поэтому параллельные сеансы на вашей машине не перезаписывают друг друга. Потокам они не нужны: каждый поток клонирует свои репозитории в свою облачную песочницу и работает на своей ветке.
• Agent teams: agent team — это один сеанс, который запускает сеансы товарищей для одной задачи, на вашей машине или внутри облачного сеанса, и заканчивается этой задачей.
• Projects в claude.ai chat и Cowork: более ранний опыт Projects, который группирует разговоры и справочные файлы без потоков или координатора. Эти проекты продолжают работать так, как они работают сегодня, пока переработанный опыт не достигнет их.

​

Ограничения

• Projects доступны в claude.ai/code и в настольном приложении, а не в CLI терминала или через Amazon Bedrock, Google Cloud’s Agent Platform или Microsoft Foundry. Команда claude project CLI, которая управляет локальным состоянием Claude Code для директории, не связана.
• Потоки проекта — это облачные сеансы с Anthropic в качестве поставщика модели. Безопасность и Использование данных охватывают, как облачные сеансы изолированы и что сохраняется.
• Локальный сеанс не может быть частью проекта.
• Песочница потока приостанавливается между ходами и возобновляется, когда поток продолжает. Если песочница не может быть возобновлена, поток продолжает с свежего клона, поэтому незафиксированные изменения могут быть потеряны. На долгих задачах попросите Claude зафиксировать и отправить работу в процессе.
• Проект принадлежит одному пользователю. Вы не можете поделиться проектом или его потоками с другим пользователем, и транскрипты потоков не имеют опции поделиться, которую имеют другие облачные сеансы. Нет элементов управления на уровне организации для проектов во время бета-версии.
• Поток принадлежит одному проекту, который его запустил. Вы не можете переместить или скопировать поток в другой проект или переместить его отдельно. Move to project идет только в другую сторону: он переносит работу облачного сеанса в проект.

​

Troubleshooting

​

Поток выглядит застрявшим

​

Потоки угадали или застопорились вместо того, чтобы спросить

1. Попросите Claude в разговоре: “Для каждого открытого потока, перечислите, что вы просили его сделать, что он предположил или не мог достичь, и на что он ждет.” Claude читает каждый поток и отвечает в разговоре.
2. Для потоков, которые начались с неправильного предположения, откройте поток из Overview и отметьте его разрешенным из его меню, или скажите ему, что делать вместо этого в его поле сообщения. Его ветка и любой pull request остаются на GitHub, пока вы их не удалите.
3. Исправьте пробел один раз, в инструкциях проекта или среде, затем отправьте один поток перед отправкой остальной работы снова как новые потоки.

​

Claude не ответил

​

Ошибки доступа к репозиторию

• “Couldn’t start the session — Claude doesn’t have GitHub access to this project’s repository”, сообщено перед запуском потока, когда Claude GitHub App не установлено на этом репозитории, приостановлено или не связано с аккаунтом GitHub, который вы подключили.
• “Unable to access your repository”, сообщено потоком, когда его клон не работает: GitHub отклонил клон, репозиторий не был найден под названием, которое имеет проект, или ветка, с которой потоку было предложено начать, не существует.
• “Claude can’t access” репозиторий, показано, когда вы сохраняете репозитории в диалоге New project или Project settings. Сообщение продолжается со ссылкой на установку и ссылкой на переподключение. Используйте ссылку на установку, если Claude GitHub App не на этом репозитории, и ссылку на переподключение, если она есть, так как GitHub App может быть установлено на GitHub без связи с аккаунтом, который вы подключили к Claude. Если сообщение говорит, что GitHub App приостановлено или не включает этот репозиторий, следуйте его ссылке на GitHub, чтобы это исправить.

​

Поток достиг лимита использования

​

Требуются дополнительные usage credits

​

Другие сообщения

​

Связанные ресурсы

• Используйте Claude Code в облаке: как работают облачные сеансы за каждым потоком, включая варианты доступа GitHub и auto-fix на pull request
• Настройте облачные среды: измените, что потоки могут достичь в сети, дайте им переменные окружения и учетные данные API и установите инструменты со скриптом настройки
• Автоматизируйте работу с routines: расписания, триггеры и управление для routines, включая те, которые Claude создает из проекта
• Управляйте несколькими агентами с agent view: запускайте и отслеживайте несколько сеансов на вашей собственной машине, когда работе требуются инструменты или сервисы, которые может достичь только ваша машина
• Projects redesigned: from folder to conversation: объявление о запуске с объяснением идеи превращения проекта в беседу с Claude