Перейти к основному содержанию
Projects доступны в публичной бета-версии на планах Pro, Max и Ultra и развертываются постепенно. Развертывание началось с аккаунтов, которые использовали облачные сессии и не имеют существующих проектов в чате claude.ai или Cowork. Projects пока недоступны на планах Team и Enterprise.Если вы не видите Projects на боковой панели на claude.ai/code или на вкладке Code настольного приложения, проверьте раздел More там же. Если их нет и там, развертывание еще не достигло вашего аккаунта. Вы можете присоединиться к списку ожидания, а в разделе Запуск агентов параллельно узнать, что можно использовать тем временем.
Проект — это один текущий разговор, в котором Claude координирует поток связанной работы для вас. Вы говорите ему, что нужно сделать, и он запускает поток для каждой задачи. Каждый поток обычно является облачным сеансом: Claude Code, работающий в облаке, а не на вашем компьютере. Когда задаче требуется что-то, что есть только на вашем компьютере, вы можете попросить Claude запустить этот поток на вашем компьютере вместо облака через Remote Control. Потоки работают параллельно, и вы можете проверять их и управлять ими со своего телефона. Облачные потоки продолжают работать после того, как вы закроете ноутбук, в то время как поток на вашем компьютере работает только при включенном компьютере. Без проекта запуск нескольких сеансов означает самостоятельное координирование: вы решаете, над чем работает каждый, повторяете одинаковый контекст в начале каждого и проверяете, какой завершился или требует ответа. С проектом вместо этого вы:
  • Отправляете работу в одно место: вставляйте отчет об ошибке, трассировку стека или список задач в разговор, когда они появляются. Claude запускает поток для каждого фрагмента работы или передает его потоку, который уже работает в этой области, и отвечает на быстрые вопросы на месте.
  • Устанавливаете контекст один раз: каждый новый поток начинается с инструкций проекта, поэтому правило, которое вы указываете один раз, например какую ветку выбрать, достигает все потоки.
  • Уходите и возвращаетесь к завершенной работе: когда вы вернетесь через час или на следующее утро, панель Overview показывает, какие потоки завершены, какие pull request готовы к проверке и какой поток ждет вашего ответа.
Если вы уже знаете работу, которую хотите, чтобы проект выполнил, переходите прямо к Создание проекта.

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

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

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

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

Как устроен проект

Проект — это один координирующий диалог с Claude плюс потоки, которые он запускает для выполнения работы. Вот его составные части:
  • Диалог проекта: одна долгоживущая сессия, в которой Claude выступает координатором. Он принимает то, что вы отправляете, решает, что станет потоком, и отслеживает каждый запущенный им поток. Он видит то, о чём потоки отчитываются, а не каждый их шаг.
  • Потоки: исполнители. Каждый из них — отдельная сессия со своим собственным контекстным окном, которая выполняет одну часть работы и отчитывается перед диалогом по завершении. Облачный поток работает в своей собственной ветке и открывает pull request, когда этого требует работа.
  • С чем начинает каждый облачный поток:
  • Панель Overview: здесь вы видите все потоки сразу, а также какие из них требуют вашего участия. Другие её вкладки: Library для добавленных вами файлов и файлов, созданных потоками, Pull requests для pull request, открытых потоками, и Scheduled tasks для запланированной работы в проекте.
Облачные потоки ничего не берут из настроек Claude Code на вашем собственном компьютере. В разделе Передача скиллов, плагинов, коннекторов и инструментов в потоки описано, как предоставить им то, чего им иначе не хватало бы. Вот как связаны эти части — от вас через диалог к потокам, выполняющим работу, а Overview отслеживает их состояние:
Схема проекта. Вы пишете в диалоге проекта, где Claude отвечает или запускает поток. Каждый облачный поток работает в своей собственной ветке и pull request. Панель Overview перечисляет потоки по состоянию, например готов к проверке, ожидает вас и в работе.Схема проекта. Вы пишете в диалоге проекта, где Claude отвечает или запускает поток. Каждый облачный поток работает в своей собственной ветке и pull request. Панель Overview перечисляет потоки по состоянию, например готов к проверке, ожидает вас и в работе.

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

Вы создаете и используете проекты в claude.ai/code, на вкладке Code настольного приложения или в мобильном приложении Claude для iOS и Android. В браузере и настольном приложении есть два способа начать проект:
  • С нуля, когда вы знаете поток работы, который хотите запустить в Claude: откройте диалог New project и назовите его. Запуск нового проекта с нуля проходит через диалог.
  • Из облачной сессии, которая уже выполняет работу: в меню этой сессии на боковой панели выберите Continue in project, затем Continue as new project. Claude предлагает настройку проекта на основе того, что делала сессия. См. Запуск из существующей облачной сессии.
В любом случае сначала проверьте предварительные условия.

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

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

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

Запуск проекта с нуля означает открытие диалога New project, назначение потока работы и опционально предоставление ему цели и репозиториев и файлов, над которыми он работает. Требуется только имя, поэтому вы можете создать проект первым и заполнить остальное по мере развития работы.
1

Откройте Projects

В claude.ai/code или на вкладке Code настольного приложения выберите Projects на левой боковой панели или в разделе More на ней. В браузере вы также можете перейти прямо на claude.ai/code/projects/browse. Затем выберите New project. Если вместо этого на кнопке написано Get started, выберите ее и сначала обновите или архивируйте существующие проекты claude.ai, которые в ней перечислены.
2

Заполните диалоговое окно New project

Ограничьте проект одним потоком работы, который вы будете постоянно пополнять, например всем, что требуется для поддержания одного API в пределах его целевой задержки. Когда использовать проект содержит больше примеров. Затем заполните поля диалогового окна:
  • Name: как проект отображается в списке Projects.
  • Goal (опционально): одна строка того, что вы пытаетесь сделать, например “Держать p95 задержку API ниже 200 мс”. Claude в разговоре работает над этим. Без цели Claude работает из задач, которые вы отправляете, и вы можете добавить цель позже в Project settings > General.
  • Context (опционально): репозитории GitHub, над которыми работает этот проект, плюс любые файлы, папки или папки Google Drive, которые потоки должны читать. Нажмите Add для каждого. Добавьте репозитории, которые нужны большинству задач, а не каждый, который работа может затронуть; Решение, какие репозитории добавить охватывает выбор, и вы можете добавить больше позже в Project settings > Environment.
Постоянные правила того, как потоки должны работать, идут в инструкции проекта, которые вы устанавливаете после создания проекта.
3

Создайте проект

Нажмите Create project. Разговор проекта открывается с полем сообщения внизу, где вы описываете работу для Claude.На вашем первом проекте Claude делает ход самостоятельно сразу после создания проекта, если вы не отправите сообщение первым. Этот ход использует ваш план. В нем Claude может:
  • Запустить один поток, который исследует репозиторий, ничего не изменяя, и предлагает следующие шаги, если у проекта есть репозиторий, который он может читать.
  • Опубликовать Setup recommendations, основанные на ваших недавних облачных сессиях: репозитории для добавления, запланированные задачи для создания и потоки, которые он может запустить. Каждый рекомендуемый репозиторий и каждая запланированная задача изначально включены. Отключите те, которые вам не нужны, затем нажмите Update setup, чтобы добавить остальные, или игнорируйте рекомендации и опишите работу самостоятельно.
Проект теперь указан в разделе Projects на боковой панели, и его разговор открыт. Ваш первый пакет охватывает то, что нужно настроить перед отправкой ему работы.

Запуск из существующей сессии

Если облачная сессия, которую вы запустили сами, выполняет работу, которая относится к проекту, откройте ее меню на боковой панели, выберите Continue in project, а затем выберите вариант в подменю:
  • Выберите Continue as new project, чтобы создать новый проект из сессии. Проект открывается, Claude читает сессию и публикует Setup recommendations в диалоге проекта для вашего подтверждения. Исходная сессия остается в вашем списке сессий. Если она была в середине хода, она продолжает работу, поэтому остановите ее самостоятельно, если вы не хотите, чтобы обе работали одновременно.
  • Выберите один из ваших существующих проектов, чтобы перенести работу сессии в этот проект. Этот проект открывается, и сообщение, отправленное от вашего имени, просит Claude прочитать сессию и продолжить с того места, где она остановилась. Исходная сессия остается в вашем списке сессий без изменений.
Над полем сообщения облачной сессии также может появиться баннер Set up project. Если вы используете его вместо Continue as new project, результат тот же, за исключением того, что выполняющийся ход сессии останавливается после открытия проекта. Сессия на вашем собственном компьютере получает то же меню на боковой панели в claude.ai/code после того, как вы подключите ее через Remote Control. Из проекта Claude не может прочитать транскрипт сессии, которая была подключена, пока для вашего аккаунта была включена настройка Require trusted devices. Если эта настройка отключена:
  1. Если сессия еще не подключена, выполните в ней /remote-control. Если она была подключена, пока эта настройка была включена, сначала отключите ее и подключите снова.
  2. В браузере найдите строку сессии на боковой панели в claude.ai/code, откройте ее меню и выберите вариант в том же подменю.
Если Require trusted devices включена или вы не используете Remote Control, опишите работу в диалоге проекта самостоятельно. Или отправьте ветку сессии (push), добавьте ее репозиторий в проект и сообщите Claude имя ветки.

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

Большинство настроек GitHub происходит один раз, а не для каждого проекта. Вы подключаете свой аккаунт GitHub к Claude один раз, и Claude GitHub App устанавливается один раз для каждого репозитория или один раз для всей организации GitHub, если вы даете ей все репозитории. Вы возвращаетесь к этим шагам, когда добавляете репозиторий, который Claude GitHub App еще не охватывает, или один в организации GitHub, которая требует SSO.
1

Подключите свой аккаунт GitHub

Если вы раньше не использовали claude.ai/code, ваше первое посещение проведет вас через подключение GitHub; см. Подключение GitHub. В противном случае используйте один из вариантов аутентификации GitHub.
2

Установите Claude GitHub App на репозитории проекта

Установите Claude GitHub App и предоставьте ей репозитории, которые будет использовать проект. На репозитории, принадлежащем организации GitHub, только владелец организации может завершить установку; если вы не являетесь одним из них, GitHub отправляет владельцу запрос на установку и проект не может использовать репозиторий, пока они его не одобрят.
3

Авторизуйте SSO для организаций, которые его требуют

Если организация GitHub требует SAML SSO, переподключите GitHub и авторизуйте Claude app для этой организации. До тех пор приватные репозитории этой организации не отображаются в диалоге New project или Project settings > Environment.
Когда один из этих шагов неполный, диалог New project и страница проекта называют отсутствующий шаг и ссылаются на то, где вы его завершаете. Завершите шаг там, затем нажмите Check again, если диалог это предлагает. Если репозиторий все еще отсутствует в списке после этого, откройте установку Claude GitHub App на GitHub в github.com/settings/installations для личного аккаунта и подтвердите, что репозиторий указан в разделе Repository access. Для сообщений об ошибках, которые поток или проект сообщают, когда доступ все еще неправильный, см. Ошибки доступа к репозиторию.

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

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

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

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

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

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

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

Когда поток изменяет код, вот что он делает, если вы не скажете иное:
  • Branch: работает на новой ветке, начиная с ветки по умолчанию репозитория.
  • Pull request: открывает один, когда вы просите, и может открыть один самостоятельно для исправления ошибки или другого конкретного изменения.
  • После открытия: наблюдает за pull request с включенным auto-fix, независимо от того, включен ли auto-fix для ваших других облачных сеансов. Он отправляет исправления, когда CI не работает, обращается к комментариям проверки и отвечает в потоке, когда проверки проходят и pull request готов для вас.
Когда поток отправил ветку или открыл pull request, его карточка в разговоре может показать кнопку для следующего шага:
  • Resolve conflicts, Fix CI, Address comments и Merge it отправляют эту инструкцию потоку как сообщение от вас, поэтому вы можете подсказать потоку самостоятельно вместо ожидания его реакции на pull request.
  • Review PR открывает pull request на GitHub.
  • Create PR появляется, когда неактивный поток отправил ветку, но не открыл pull request. Нажатие на нее создает pull request из этой ветки напрямую, а не отправляет потоку инструкцию открыть один.
Чтобы изменить, когда потоки открывают pull request, например только когда вы просите, или с какой ветки они начинают, скажите об этом в задаче или в инструкциях проекта.

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

Панель Overview рядом с разговором отслеживает потоки проекта. Она уже открыта в первый раз, когда вы открываете новый проект. Кнопка Overview в заголовке проекта закрывает и открывает ее заново и показывает точку, когда поток ждет вас. В настольном приложении вы также получаете уведомление рабочего стола, когда Claude публикует в разговоре, поток попадает в ошибку или потоку нужен ваш ввод, поэтому вам не нужно держать проект открытым, чтобы узнать. Чтобы также получить один каждый раз, когда поток завершает ход, или отключить их для проекта, выберите Notifications в меню боковой панели проекта. Эти уведомления только для рабочего стола: в браузере проверьте точку на кнопке Overview. Вкладка Threads панели группирует потоки по состоянию: Другие вкладки панели:
  • Library: файлы и папки, которые вы добавили, и файлы, созданные потоками
  • Pull requests: отображается, когда потоки открыли хотя бы один
  • Scheduled tasks: облачные запланированные задачи, которые Claude настроил из этого проекта

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

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

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

Установите модели и интенсивность в Project settings > General. Новый проект запускает Opus везде с высокой интенсивностью для потоков и низкой интенсивностью для разговора:
  • Thread model и Thread effort применяются к потокам. Чтобы использовать другую модель для одной задачи, попросите это в задаче; для уже работающего потока используйте выбор модели этого потока.
  • Coordinator model и Coordinator effort применяются к Claude в разговоре проекта.
Вы не управляете контекстными окнами в проекте. Потоки автоматически компактируются, и разговор работает из недавних сообщений, недавних потоков и памяти проекта, а не из полной истории, поэтому он продолжается столько, сколько работает проект. Поместите все, что никогда не должно быть потеряно, в память проекта. Если один поток перерастает свой контекст, он показывает Claude ran out of context on this turn.

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

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

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

Потоки работают в auto mode, когда модель потока это поддерживает, поэтому большинство вызовов инструментов работают без вашего запроса. Когда потоку нужно ваше одобрение, подсказка находится внутри этого потока и поток ждет, пока вы ответите там. Сказание Claude в разговоре проекта идти дальше не достигает его. Каждое подтверждение охватывает этот запрос или остаток этого потока, если вы выберете более широкий вариант. Облачные потоки не читают правила разрешений из .claude/settings.json репозитория, поэтому вы полагаетесь на авторежим и на подтверждения, которые вы даете внутри каждого потока.

Запустите поток на своем компьютере

Когда задача требует что-то, что есть только на вашем компьютере, например локальную базу данных, эмулятор устройства или API за вашим VPN, попросите Claude запустить поток для этой задачи на вашем компьютере вместо облака. Когда вы просите в разговоре проекта, поток — это сеанс Claude Code в папке на вашей машине, подключенный через Remote Control. Другие потоки проекта продолжают работать в облаке. По сравнению с облачным потоком, поток на вашем компьютере:
  • Работает с файлами, инструментами, MCP серверами и параметрами Claude Code на этой машине, включая его hooks и правила разрешений, вместо облачной среды проекта
  • Начинается с инструкций проекта, но без загруженных файлов памяти
  • Работает только пока этот компьютер включен с включенным Remote Control
1

Подключите папку

На компьютере, у которого есть папка, которая нужна задаче, сделайте ее доступной через Remote Control одним из двух способов. Оба требуют Claude Code v2.1.280 или позже на этом компьютере.
  • В приложении Claude для рабочего стола: откройте Settings > Code или Settings > Claude Code и включите Use this computer from your phone and claude.ai. Добавьте папку в список под этим переключателем. Потоки могут работать на этом компьютере, пока приложение открыто.
  • В терминале: запустите claude remote-control в папке и оставьте его работающим. В git-репозитории добавьте --spawn worktree, чтобы дать каждому потоку там свой worktree вместо самой папки.
2

Попросите задачу с Work locally

В диалоге проекта выберите Work locally из меню + рядом с полем сообщения, которое помечает ваше сообщение Local, и напишите, что вы хотите сделать. Можно также указать в сообщении, что задача должна выполняться на вашем компьютере.
3

Разрешите это на карточке

Claude отвечает карточкой Allow Claude to work in a folder on your device. Выберите папку, если вы подключили несколько. Два потока, работающих в одной папке одновременно, могут перезаписать изменения друг друга, поэтому если папка — это git-репозиторий, вы можете включить Worktree в параметрах папки, чтобы вместо этого дать этому потоку свой worktree. Затем нажмите Allow once.
Поток работает в auto mode, поэтому Claude запускает команды и редактирует файлы в этой папке без вашего запроса каждый раз. Если auto mode недоступен или отключен в Claude Code этого компьютера, поток работает без него, и любая подсказка разрешения, которую он вызывает, ждет вашего ответа в потоке, как описано в Разблокировка потока, ожидающего одобрения. Пока поток работает, значок ноутбука в его заголовке показывает, подключен ли ваш компьютер. Нажмите на него, чтобы увидеть, какую папку использует поток, или отключить соединение. Поток приостанавливается, пока этот компьютер спит, и останавливается, если приложение для рабочего стола или claude remote-control завершает работу.
  • Чтобы снова запустить поток: см. Lost contact with your folder
  • Чтобы компьютер не засыпал самостоятельно: в приложении для рабочего стола включите Keep this computer awake for Remote Control в Settings > Code или Settings > Claude Code
Проект не может запустить поток на вашем компьютере, пока Require trusted devices включен для вашей учетной записи.

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

Память проекта, инструкции проекта, а также репозитории, файлы и среда проекта переносят контекст между потоками. Каждый из них вы настраиваете один раз. Project settings > Memory перечисляет эти файлы в разделе Auto memory, потому что Claude пишет их сам, пока работает в проекте. Они отделены от автоматической памяти, которую Claude Code хранит на вашей машине, хотя обе используют индекс MEMORY.md. Память проекта также отделена от файлов CLAUDE.md в репозиториях проекта. Каждый облачный поток по-прежнему читает эти файлы CLAUDE.md из своего клона при запуске, поэтому помещайте инструкции о репозитории в его CLAUDE.md, а заметки о проекте — в память проекта.

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

Инструкции проекта — это краткое описание, с которого начинает каждый новый поток. Нажмите значок шестерёнки в заголовке проекта, чтобы открыть Project settings, затем перейдите в Memory > Project instructions. Полезное краткое описание охватывает:
  • Для чего предназначен проект
  • Где происходит работа: какие репозитории, от какой ветки начинать, как называть pull requests
  • Как поток проверяет свою работу, прежде чем считать её выполненной
  • Что делать, когда чего-то нужного не хватает
  • Что сначала требует вашего одобрения
Например:
Правила, касающиеся одного репозитория, например его команды сборки, следует размещать в CLAUDE.md этого репозитория, который каждый облачный поток читает, когда репозиторий входит в проект. Когда работа уже идёт и вы исправляете поток, также попросите Claude запомнить исправление: оно попадёт в память проекта, и последующие облачные потоки будут начинать с ним.

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

Репозитории, которые вы добавляете в проект, попадают в каждый облачный поток со своим кодом и CLAUDE.md, но без своих скиллов, .claude/settings.json и .mcp.json. Репозитории, которые вы не добавляете, всё равно остаются доступными: облачный поток может добавить такой репозиторий себе, когда это требуется для его задачи. Большинство проектов используют оба варианта:
  • Добавьте его в проект в диалоговом окне New project, в Project settings > Environment или попросив Claude в диалоге добавить его в проект. Каждый облачный поток с этого момента клонирует его и начинает с загруженным CLAUDE.md этого репозитория, независимо от того, затрагивает ли его задача.
  • Не добавляйте его и позвольте потокам добавлять его при необходимости. Облачный поток, задаче которого нужен репозиторий, отсутствующий в проекте, может добавить его себе, и заметка в потоке сообщает, что он добавлен только в этот поток. Клонирование происходит в середине задачи, поэтому CLAUDE.md этого репозитория не было, когда поток запускался. Следующий поток начинает без него. Репозиторию, добавленному таким образом, нужны те же предварительные требования, что и репозиторию проекта: установленное на нём Claude GitHub App и доступ на push из вашего аккаунта GitHub.
Проекту вообще не обязателен репозиторий. Его облачные потоки всё равно могут проводить исследования, писать документы, а также писать и запускать код в собственной песочнице, и они доставляют файлы на вкладку Library. Любой из его облачных потоков по-прежнему может добавить себе репозиторий, когда этого требует задача. Когда у проекта есть репозитории, Claude может добавлять только репозитории того владельца GitHub, которого проект уже использует, — добавляет ли он репозиторий в проект или поток добавляет его себе. Чтобы подключить репозиторий другого владельца, добавьте его в проект самостоятельно в Project settings > Environment. Для проекта, охватывающего много репозиториев, например одну функцию с серверным, веб-, мобильным и десктопным кодом, добавьте один или два репозитория, которые затрагивает почти каждая задача, и назовите остальные в инструкциях проекта, чтобы Claude знал, где находится остальной код. Тогда облачные потоки начинают с малого и подтягивают другие репозитории только для тех задач, которым они нужны.

Добавьте файлы и папки

Добавьте файлы и папки, которые должны читать потоки, в поле Context диалогового окна New project или позже с помощью Add на вкладке Library в Overview. К добавляемому применяются следующие ограничения:
  • Вкладка Library: до 100 файлов и 2 ГБ за один выбор, при этом один файл — до 480 МБ.
  • Диалоговое окно New project: файлы размером более 30 МБ пропускаются, поэтому добавляйте более крупные файлы с вкладки Library после создания проекта.
  • Папки: когда вы добавляете папку из любого из этих мест, проект получает копию её первых 100 файлов объёмом до 200 МБ, без файлов размером более 30 МБ, скрытых файлов и node_modules. Проект может содержать до 10 папок и папок Google Drive в сумме, а отдельные файлы в это ограничение не засчитываются.
  • Изменения после загрузки: загрузки являются копиями, поэтому изменение, которое вы позже вносите на своём компьютере, не попадает в проект, пока вы снова не загрузите файл и не выберете Replace при запросе о существующем имени.

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

Облачные потоки загружают инструкции CLAUDE.md каждого репозитория, но не его скиллы, серверы из .mcp.json или .claude/settings.json, независимо от того, один репозиторий в проекте или несколько.

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

Каждый новый облачный поток начинается в облачной среде проекта. Среда определяет, к каким доменам могут обращаться потоки, какие переменные окружения у них есть, какие сетевые секреты добавляются в их запросы и что устанавливает скрипт настройки до запуска Claude. Облачные потоки используют среду по умолчанию, размещённую Anthropic, пока вы не выберете другую в Project settings > Environment. Если облачным потокам нужно обращаться к внутреннему API или приватному реестру пакетов либо нужен токен, который обычно хранится на вашей машине, измените среду, а не проект: см. Сетевой доступ, Добавление сетевых секретов и Скрипты настройки.

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

У облачных потоков нет скиллов, MCP-серверов, плагинов и инструментов, установленных только на вашей машине. Поток, который Claude запускает на вашей машине через Remote Control, использует то, что установлено там. Чтобы сделать каждый из них доступным для облачных потоков:
  • Скиллы: включите их для своего аккаунта claude.ai, и облачные потоки будут загружать скиллы, которые вы там включили, за исключением некоторых потоков в самостоятельно размещённой среде. Скиллы, добавленные коммитом в .claude/skills/ репозитория, не загружаются в облачных потоках.
  • Плагины: добавьте их в Project settings > Plugins; они загружаются в каждый новый облачный поток. Плагины, которые репозиторий объявляет в своём .claude/settings.json, не загружаются в облачных потоках.
  • MCP-серверы: облачные потоки получают свои инструменты MCP из коннекторов вашего аккаунта claude.ai — это MCP-серверы, которые вы один раз подключаете на claude.ai/customize/connectors. Каждый облачный поток может использовать их все без настройки для каждого проекта. У самого диалога проекта нет коннекторов, поэтому работу, требующую коннектора, отправляйте как задачу для облачного потока. В разделе Как коннекторы попадают в Claude Code перечислены правила для облачных сессий и настройки, отключающие коннекторы.
  • Инструменты командной строки и пакеты: установите их в скрипте настройки среды.
Чтобы увидеть, какие коннекторы есть у работающего облачного потока в claude.ai/code, откройте поток и выберите Connectors в меню + рядом с его полем ввода сообщения. Отключение коннектора там удаляет его из этого потока и сохраняет это как значение по умолчанию для вашего аккаунта, поэтому новые потоки и чаты claude.ai начинаются без него, пока вы снова его не включите. Облачный поток подхватывает коннектор, который вы добавили или переподключили, после следующего отправленного ему сообщения.

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

Вы изменяете параметры проекта в claude.ai/code или в настольном приложении, а не в settings.json. Откройте Project settings из Settings в меню боковой панели проекта или из значка шестеренки в заголовке проекта. Параметры сохраняются по мере их изменения; текстовое поле, которое вы редактируете, например цель или инструкции, показывает Save changes и Discard до тех пор, пока вы его не покинете. Изменения инструкций, репозиториев, plugins и среды в Project settings достигают новые потоки, а не уже работающие потоки.

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

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

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

Использование проекта считается против тех же лимитов плана, что и ваши другие сеансы Claude Code, и проект не может потратить больше этих лимитов самостоятельно. Поток, который достигает лимита вашего плана, ждет и продолжает самостоятельно, когда лимит сбрасывается, поэтому работа, которую вы оставили работающей, начинает использовать ваше следующее окно использования без сообщения от вас. Поток достиг лимита использования охватывает то, что вы видите, как его остановить и один случай, который не ждет. Работа выходит за пределы лимитов вашего плана только если вы включили usage credits для вашего аккаунта. Поток не может включить их для вас.

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

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

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

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

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

Несколько функций Claude Code позволяют более чем одному сеансу работать одновременно, поэтому запуск работы параллельно — это не само по себе то, для чего предназначен проект. В проекте Claude запускает и отслеживает сеансы вместо вас, и каждый начинается с одних и тех же инструкций. Вот как каждая соседняя функция соединяется с проектом:
  • Claude Tag: Claude Tag — это Claude в каналах Slack вашей команды, на планах Team и Enterprise. Любой в канале может дать ему работу, все в канале видят и направляют его, и он использует подключения, которые администратор настроил для этого канала. Проекты доступны на планах Pro, Max и Ultra. Проект принадлежит только вам: только вы отправляете ему работу и видите его потоки, и он использует ваш собственный доступ к GitHub и ваши коннекторы. Сравнение приведено в разделе Как Claude Tag отличается от Cowork и Claude Code.
  • Облачные сессии: каждый поток — это облачная сессия, если вы не попросите Claude запустить его на вашей машине. В любом случае Claude запускает и отслеживает его вместо вас. Вы также можете перенести в проект работу облачной сессии, которую запустили самостоятельно: выберите Continue in project в меню боковой панели этой сессии.
  • Scheduled tasks: когда вы запрашиваете запланированную работу в проекте, Claude создает облачную запланированную задачу, которая выполняется как потоки в этом проекте и отображается на его вкладке Scheduled tasks. Запланированные задачи, которые вы создаете вне проекта, продолжают работать самостоятельно.
  • Remote Control: Remote Control соединяет claude.ai с сеансом Claude Code, работающим на вашей машине. Когда вы просите Claude в проекте запустить поток на вашем компьютере, проект использует Remote Control для этого.
  • Локальные сессии и agent view: сессия, которую вы запускаете самостоятельно в терминале, IDE или локальной среде настольного приложения, остается вне ваших проектов, хотя вы можете перенести ее работу в проект. Agent view — это экран для отслеживания нескольких локальных сессий рядом, и вы по-прежнему сами запускаете каждую из них и даете ей задачу.
  • Worktrees: worktree дает каждой локальной сессии собственную рабочую копию репозитория. Облачным потокам они не нужны: каждый клонирует свои репозитории в собственную облачную песочницу и работает в собственной ветке.
  • Agent teams: agent team — это один сеанс, который запускает сеансы товарищей для одной задачи, на вашей машине или внутри облачного сеанса, и заканчивается этой задачей.
  • Subagents: subagent работает внутри одного сеанса, выполняет побочную задачу в своем собственном контекстном окне и возвращает резюме в этот сеанс. Потоки проекта — это целые сеансы, которые Claude запускает и которые отчитываются перед разговором проекта, и поток все еще может использовать subagents для своих собственных побочных задач.
  • Projects в claude.ai chat и Cowork: более ранний опыт Projects, который группирует разговоры и справочные файлы без потоков или координатора. Эти проекты продолжают работать так, как они работают сегодня, пока переработанный опыт не достигнет их.
Запуск агентов параллельно сравнивает эти варианты рядом.

Ограничения

  • Projects доступны в claude.ai/code, в настольном приложении и в мобильном приложении Claude, но не в CLI терминала, расширении VS Code или плагине JetBrains, и не через Amazon Bedrock, Google Cloud’s Agent Platform или Microsoft Foundry.
  • Потоки проекта — это облачные сеансы или сеансы на вашей собственной машине через Remote Control, с Anthropic в качестве поставщика модели в обоих случаях. Безопасность и Использование данных охватывают, как облачные сеансы изолированы и что сохраняется, а Connection and security охватывает, как поток на вашей машине подключается и что хранится.
  • Вы не можете добавить в проект сессию, которую запустили сами на своей машине, но можете перенести её работу в проект. Проект попадает на вашу машину путём запуска потока там через Remote Control, и в этом разделе перечислено, что для этого нужно.
  • Песочница потока приостанавливается между ходами и возобновляется, когда поток продолжает. Если песочница не может быть возобновлена, поток продолжает с свежего клона, поэтому незафиксированные изменения могут быть потеряны. На долгих задачах попросите Claude зафиксировать и отправить работу в процессе.
  • Проект принадлежит одному пользователю. Вы не можете поделиться проектом или его потоками с другим пользователем, и транскрипты потоков не имеют опции поделиться, которую имеют другие облачные сеансы. Нет элементов управления на уровне организации для проектов во время бета-версии.
  • Поток принадлежит одному проекту, который его запустил. Вы не можете переместить или скопировать поток в другой проект или вынести его в отдельный поток. Continue in project работает только в обратную сторону: эта функция переносит работу облачной сессии в проект. Вы не можете объединить два проекта в один.

Troubleshooting

Для подсказок настройки GitHub в диалоге New project, см. Настройка доступа GitHub.

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

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

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

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

Claude не ответил

Разговор проекта показывает баннер “Claude hasn’t responded”, когда Claude работает, но его ответы не достигают проекта. Нажмите Restart Claude на баннере или перейдите в Project settings > General и нажмите Restart в строке Restart Claude. Claude переподключается к разговору; любой ответ, который он был в процессе написания, потеряется, и потоки не затрагиваются.

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

Три сообщения означают, что поток или проект не может достичь один из своих репозиториев. Потокам проекта требуются предварительные условия GitHub даже когда ваши другие облачные сеансы клонируют один и тот же репозиторий без проблем.
  • “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, чтобы это исправить.
Чтобы исправить любой из них, нажмите кнопку, которую предлагает сообщение, например Install GitHub App или Select repositories on GitHub, затем Check again. Когда блок находится на стороне организации GitHub, например владелец, который не одобрил приложение или IP allow list, который исключает Claude, сообщение показывает ссылку See how to fix вместо этого. Если нет кнопки, следуйте Настройка доступа GitHub, затем отправьте другое сообщение для повтора.

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

Когда поток или диалог проекта достигает пятичасового или недельного лимита вашего плана, он продолжает повторять попытки самостоятельно и продолжает работу, когда лимит сбрасывается. Поток, который запустила запланированная задача, не ждет: его ход останавливается с ошибкой лимита, и вы отправляете ему сообщение после сброса лимита. Пока поток ждет, он показывает Service is busy с “Claude is still retrying and will continue automatically.” Вам не нужно ничего делать, чтобы работа продолжилась. Если вы предпочитаете, чтобы он не использовал ваше следующее окно использования, нажмите Stop в потоке или приостановите проект, чтобы поставить на паузу все потоки. Ошибки лимита использования объясняют лимиты и когда они сбрасываются.

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

Поток или разговор проекта сделал запрос, который ваш план охватывает только с usage credits, например один к модели или размеру контекста, который ваш план не включает, и usage credits не включены для вашего аккаунта. Добавить usage credits к вашей подписке охватывает, кто может их включить или купить на каждом плане. Когда credits доступны, отправьте другое сообщение для повтора.

Потеря контакта с вашей папкой

Поток, работающий на вашем компьютере, показывает это, когда сессия Claude Code там перестала отвечать, обычно потому, что компьютер перешел в режим сна или настольное приложение либо claude remote-control завершили работу. Выведите компьютер из режима сна. Если настольное приложение или claude remote-control там больше не работает, запустите его снова:
  • Настольное приложение: снова откройте приложение и убедитесь, что Use this computer from your phone and claude.ai по-прежнему включено в Settings > Code или Settings > Claude Code
  • Терминал: снова запустите claude remote-control в той же папке

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

Эти сообщения называют свою собственную причину. Таблица дает следующий шаг для каждого.