Claude Code Projects — это рабочее пространство, в котором Claude координирует несколько связанных задач. Вы описываете работу в общем разговоре, а Claude запускает отдельные рабочие потоки, отслеживает их состояние и собирает результаты. Потоки используют общие инструкции проекта, его материалы и память.
Projects подходят для развития приложения, регулярной обработки документов или сопровождения продукта: когда работа продолжается дольше одного разговора и постоянно появляются новые задачи. Ниже — настройка через английский интерфейс, готовые инструкции и пример первого запуска.
Доступность проверена 11 октября 2026 года. По официальной документации Anthropic, новые Projects находятся в публичной бете на тарифах Pro и Max. Доступ предоставляется постепенно; для Team и Enterprise эта версия пока недоступна.
Что такое Projects и чем они отличаются от обычного чата?
В обычной сессии вы поручаете Claude одну задачу и сами решаете, когда открыть следующую. В Projects общий разговор становится координатором: принимает задания, передаёт их исполнителям и отслеживает выполнение.
Thread, или рабочий поток, — отдельная сессия Claude Code со своим контекстом. Обычно она выполняется в облаке. Для работы с кодом поток использует собственную копию репозитория и отдельную ветку. Результатом могут быть изменения кода, pull request — запрос на их включение в основную ветку — или готовый файл.
| Элемент | Для чего нужен |
|---|---|
| Project conversation | Общий разговор: цели, новые задания, решения и сводки. |
| Threads | Отдельные исполнители задач. |
| Project instructions | Постоянные правила для координатора и новых потоков. |
| Project memory | Сохранённые решения, требования и замечания. |
| Overview | Контроль задач, результатов и запросов к пользователю. |
| Library | Исходные материалы и файлы, подготовленные потоками. |
Например, вы поручаете улучшить Telegram-бота. Один поток разбирает ошибку авторизации, второй готовит тесты оплаты, третий обновляет инструкцию пользователя. Общий разговор показывает, что завершено, что заблокировано и какой результат требует проверки.
Общие принципы такого подхода разобраны в статье как работают ИИ-агенты и где их применять.
Для каких задач стоит создавать проект?
Создавайте проект вокруг одной длительной цели. Хорошая граница — конкретный продукт, сервис или регулярно повторяющийся процесс.
- Развитие приложения: исправления, новые функции, тесты и документация.
- Миграция нескольких репозиториев: согласованные изменения сервера, сайта и мобильного приложения.
- Сопровождение сервиса: разбор ошибок, отчётов пользователей и результатов проверок.
- Работа с документами: анализ выгрузок поддержки, подготовка инструкций и сравнительных отчётов.
Для одного небольшого исправления достаточно обычной сессии Claude Code. Если почти каждая задача требует локальной базы, устройства или доступа через VPN, удобнее начать с локальных сессий.
Не объединяйте в одном проекте весь бизнес. У проекта «Развитие клиентского Telegram-бота» понятные материалы и критерии результата. У проекта «Все задачи компании» быстро появляются противоречивые инструкции и лишний контекст.
Шаг 1. Проверьте доступ и подготовьте материалы
Откройте claude.ai/code или вкладку Code в приложении Claude Desktop. В боковом меню должен быть раздел Projects.
Если раздела нет, доступ ещё не предоставлен. Можно записаться в лист ожидания Projects. Наличие подписки Pro или Max само по себе не означает, что функция уже появилась в аккаунте.
Если проект будет изменять код
- Репозиторий должен находиться на github.com.
- Подключённый к Claude аккаунт GitHub должен иметь право отправлять изменения в репозиторий.
- На нужный репозиторий должно распространяться подключение Claude GitHub App.
Подключение GitHub через команду /web-setup, достаточное для некоторых облачных сессий, не заменяет Claude GitHub App для потоков Projects. GitLab, Bitbucket и GitHub Enterprise Server не подходят для описанного в документации подключения репозиториев.
Если проект будет работать с документами
GitHub не обязателен. Подготовьте исходные файлы, описание задачи и требования к результату. Например: обезличенную выгрузку обращений, действующую инструкцию поддержки и шаблон итогового отчёта.
Для первого запуска используйте небольшой набор материалов, который можете проверить самостоятельно.
Шаг 2. Создайте проект
- Откройте Projects → New project.
- В поле Name укажите понятное название.
- В поле Goal опишите одну цель.
- В поле Context через Add добавьте нужные репозитории, файлы или папки.
- Нажмите Create project.
Обязательным является только название. Цель и материалы можно добавить позже, но с ними Claude проще правильно определить работу.
Пример заполнения:
- Name: Customer Support Bot.
- Goal: Подготовить бота поддержки к тестовому запуску: исправить ошибки, проверить сценарии и обновить документацию.
- Context: репозиторий бота, описание сценариев, список известных ошибок.
Если Claude показывает Setup recommendations, сначала проверьте предложенные репозитории, расписания и задачи. В рекомендациях репозитории и routines могут быть включены по умолчанию. Отключите ненужные пункты перед нажатием Update setup.
Уже начатую облачную сессию можно продолжить через Continue as project. Учтите: исходная сессия при этом может продолжать работать. Проверьте её состояние, чтобы две сессии одновременно не выполняли одно задание.
Шаг 3. Задайте постоянные инструкции
Откройте значок шестерёнки в заголовке проекта, затем Project settings → Memory → Project instructions. Здесь задаются правила, которые получает каждый новый поток.
Инструкция должна объяснять цель, порядок работы, проверку результата и действия при недостатке данных. Ниже — пример для проекта разработки. Замените названия и команды на реальные.
Цель проекта — подготовить клиентского Telegram-бота к тестовому запуску.
Работай в подключённом репозитории. Создавай отдельную ветку от main для каждой самостоятельной задачи.
Перед изменением кода прочитай CLAUDE.md и инструкции относящихся к задаче каталогов.
До начала работы укажи критерий готовности. Перед завершением выполни проверки, предусмотренные репозиторием. В результате перечисли изменения, выполненные проверки и оставшиеся ограничения.
Если не хватает доступа, файла, зависимости или секрета, точно назови проблему. Не подменяй недоступные данные выдуманными результатами.
Не объединяй pull requests, не выполняй развёртывание, не изменяй рабочую базу данных и настройки платежей без моего отдельного разрешения.
Для первого запуска предлагай потоки до начала выполнения. После подтверждения выполняй не более двух потоков одновременно. Зависимые задачи выполняй последовательно.
Инструкции управляют поведением Claude, но не заменяют технические ограничения доступа. В частности, просьба запускать не более двух потоков является предпочтением, а не жёстким лимитом платформы.
Что хранить в Project instructions, CLAUDE.md и памяти?
| Место | Что туда записывать |
|---|---|
| Project instructions | Цель проекта, общие правила, формат результатов, порядок согласования. |
| CLAUDE.md в репозитории | Архитектуру, команды запуска и тестирования, соглашения о коде. |
| Project memory | Принятые решения, обнаруженные особенности и исправленные предположения. |
Например, после исправления ошибки напишите: «Запомни: тестовые платежи выполняем только в sandbox; рабочий платёжный аккаунт не используем». Затем проверьте запись в Project settings → Memory.
Подробнее о назначении разных видов памяти — в материале память AI-агента: архитектура и риски.
Шаг 4. Настройте среду и инструменты
Облачный поток запускается в отдельной среде. Программы, переменные окружения и подключения, настроенные только на вашем компьютере, автоматически в неё не переносятся.
Откройте Project settings → Environment и проверьте:
- Репозитории: доступен ли весь код, необходимый задаче.
- Сетевой доступ: разрешены ли нужные домены и API.
- Переменные и секреты: есть ли необходимые настройки и учётные данные.
- Setup script: устанавливает ли он зависимости для запуска и проверки проекта.
- Connectors: подключены ли внешние инструменты.
Конфигурация облачной среды описана в документации Cloud environments. Секреты задавайте через предусмотренные настройки среды, не вставляйте их в инструкции и файлы репозитория.
Skills и другие инструкции можно хранить в подключённом репозитории. Плагины для облачных потоков добавляются через Project settings → Plugins: одного объявления плагина в локальном файле настроек недостаточно.
Основной разговор проекта не имеет connectors. Задачу, требующую такого подключения, нужно поручить рабочему потоку. Если вы подключаете CRM, базу данных или другой сервис, полезно сначала разобраться, как MCP предоставляет AI-агенту доступ к инструментам.
Особенность нескольких репозиториев: в среде Anthropic правила разрешений и hooks из их файлов .claude/settings.json не применяются к потоку так же, как в проекте с одним репозиторием. Не рассчитывайте, что локальные ограничения автоматически защитят облачную работу.
Шаг 5. Запустите одну проверочную задачу
Первое задание должно проверить, что Claude видит нужные материалы, понимает инструкции и умеет подтверждать результат. Для начала достаточно анализа без изменения кода.
Проверь сценарий регистрации нового пользователя в подключённом репозитории. Код пока не изменяй.
Найди обработчики регистрации и связанные тесты. Опиши текущий путь пользователя и укажи возможные ошибки со ссылками на конкретные файлы.
Отдельно перечисли подтверждённые проблемы, предположения и то, что не удалось проверить. Заверши предложением одного небольшого исправления и критерия его готовности.
Для этой задачи запусти один поток.
После выполнения откройте поток и проверьте:
- Работал ли он с правильным репозиторием и веткой.
- Прочитал ли необходимые инструкции.
- Подтверждены ли выводы конкретными файлами и результатами проверок.
- Не выдаёт ли предположение за найденную ошибку.
- Не изменил ли код вопреки заданию.
Если обнаружено неправильное предположение, исправьте его в потоке и обновите постоянные инструкции или память. Затем повторите небольшую задачу, прежде чем отправлять большой пакет работы.
Шаг 6. Разделите работу на независимые потоки
Параллельно запускайте задачи, которые могут выполняться независимо. Если одна задача меняет интерфейс, от которого зависит другая, сначала завершите и согласуйте интерфейс.
Пример пакета для бота поддержки:
Подготовь план трёх задач:
1. Исправить подтверждённую ошибку регистрации и добавить проверку этого сценария.
2. Обновить пользовательскую инструкцию по текущему поведению бота без изменения кода.
3. Проанализировать обработку неизвестных вопросов и предложить улучшения без реализации.
Для каждой задачи укажи результат и зависимости. Если потоки будут изменять одинаковые файлы, предложи последовательное выполнение.
Разные ветки защищают от прямого перезаписывания файлов в облачных копиях, но не исключают конфликтов при объединении изменений. Просите координатора отдельно указывать порядок включения pull requests.
Дополнение к уже выполняемой задаче можно отправить прямо в её поток. Это надёжнее, чем рассчитывать, что общий разговор правильно определит адресата короткого сообщения.
Как контролировать выполнение через Overview?
Overview показывает состояние потоков. Открывайте его регулярно: отсутствие новых сообщений в общем разговоре не означает, что работа остановилась.
| Статус | Что означает | Что проверить |
|---|---|---|
| Working | Поток выполняет работу. | При необходимости откройте его журнал. |
| Waiting on you | Нужен ответ, разрешение или устранение ошибки. | Откройте поток и ответьте на конкретный запрос. |
| Ready for review | Pull request ожидает проверки. | Изменения, тесты и критерий готовности. |
| Landing | Pull request одобрен или поставлен в очередь на объединение. | Порядок включения зависимых изменений. |
| Idle | Поток закончил текущую работу и ничего не ожидает. | Итоговый ответ и подготовленные файлы. |
| Resolved | Поток отмечен завершённым. | Соответствует ли завершение фактическому результату. |
Запрос разрешения подтверждается внутри конкретного потока. Сообщение «разрешаю» в общем разговоре не снимает ожидающее подтверждение инструмента.
Файлы ищите на вкладке Library, запросы на изменение кода — на вкладке Pull requests. Для остановки отдельной задачи откройте поток и нажмите Stop.
Для сводки отправьте координатору:
По каждому открытому потоку перечисли задачу, результат, выполненные проверки, блокировки и следующий шаг. Отдельно укажи, какие изменения зависят друг от друга и в каком порядке их включать.
Как поручить задачу на своём компьютере?
Если задаче нужна локальная база данных, установленная программа или ресурс за VPN, Projects могут запустить поток через Remote Control. Такой поток работает, пока компьютер включён и подключение активно.
- Обновите Claude Code: для описанного сценария документация требует версию 2.1.280 или новее.
- В Claude Desktop откройте Settings → Claude Code.
- Включите Use this computer from your phone and claude.ai и добавьте рабочую папку.
- В разговоре проекта выберите + → Work locally и опишите задачу.
- В карточке Allow Claude to work in a folder on your device выберите папку и нажмите Allow once.
Альтернативный способ подключения — запустить в нужной папке команду claude remote-control и оставить её работающей. Для Git-репозитория параметр —spawn worktree позволяет выделять потокам отдельные рабочие копии.
Не запускайте несколько потоков в одной папке без изоляции: они могут перезаписать изменения друг друга. Локальный поток использует инструменты и настройки компьютера, получает инструкции проекта, но его файлы памяти не загружаются при старте. Необходимые решения укажите непосредственно в задании.
Дополнительные условия подключения приведены в руководстве Remote Control.
Как контролировать расход лимитов?
Projects используют те же лимиты подписки, что и другие сессии Claude Code. Расход складывается из работы потоков и координатора. Несколько параллельных задач могут исчерпать доступный объём быстрее одной сессии.
Откройте Project settings → General и проверьте Thread model, Thread effort, Coordinator model и Coordinator effort. По текущей документации новый проект использует Opus; для потоков по умолчанию задан высокий effort, для координатора — низкий.
- Для простых задач выбирайте подходящую менее ресурсоёмкую модель и уровень effort.
- Просите отвечать на небольшие вопросы в общем разговоре без отдельного потока.
- Не подключайте ко всем задачам репозитории, которые нужны лишь изредка.
- Проверяйте расход по потокам и моделям в Project settings → Usage.
- Останавливайте ненужную работу и наблюдение за завершёнными pull requests.
После открытия pull request поток может продолжать следить за ошибками CI и комментариями, исправляя их автоматически. Такое наблюдение тоже расходует лимиты при появлении новой работы.
Обычный поток, достигший лимита, может самостоятельно продолжить после его обновления. Если продолжение не нужно, нажмите Stop или приостановите проект. Работа сверх включённых лимитов возможна при активированных usage credits; поток не может включить их за вас.
Какие ошибки встречаются при настройке?
| Проблема | Что делать |
|---|---|
| Claude не видит репозиторий. | Проверьте право push, установку Claude GitHub App и доступ приложения к этому репозиторию. |
| Локально команда работает, в облаке — нет. | Проверьте зависимости, setup script, переменные и сетевой доступ облачной среды. |
| Поток использует старые правила. | Изменения инструкций, среды, репозиториев и плагинов применяются к новым потокам. Передайте исправление текущему потоку отдельно. |
| Claude читает старую версию документа. | Загруженные файлы являются копиями. Загрузите обновлённый файл и выберите Replace. |
| Работа выглядит зависшей. | Откройте поток: он может готовить среду, выполнять команду или ожидать разрешения. |
| Пропали незакоммиченные изменения. | При невозможности восстановить облачную среду поток может продолжить со свежей копии. На длительных задачах сохраняйте промежуточную работу коммитами и push. |
Дополнительно учитывайте: в текущей бете проект принадлежит одному пользователю. Поделиться самим проектом и его потоками с коллегой нельзя. Для работы нескольких сотрудников потребуется другой способ организации доступа.
Перед подключением рабочих систем определите допустимые операции и минимальные права. Практический порядок описан в статье как ограничить доступ AI-агента к почте, CRM и данным.
С какого MVP начать?
Первый MVP — один проект, один источник материалов и одна проверяемая задача. Цель первого запуска — убедиться, что Claude работает с правильными данными и подтверждает результат.
Для разработки выберите небольшую ошибку в тестовой ветке. Для работы с документами загрузите обезличенную выгрузку обращений и поручите найти повторяющиеся проблемы.
Проанализируй приложенную выгрузку обращений поддержки. Выдели повторяющиеся проблемы пользователей.
Для каждой проблемы укажи количество обращений, идентификаторы примеров и предлагаемое изменение инструкции. Не считай повторный экспорт того же обращения новой заявкой.
Подготовь отчёт. Если данных недостаточно для вывода, обозначь это. Ничего не отправляй клиентам и не изменяй в CRM.
Проверьте несколько примеров и расчётов вручную. После этого добавляйте новые задачи и подключения. Расширять проект стоит тогда, когда понятны качество результата, типичные ошибки и расход лимитов.
Если хотите применить такой процесс к разработке, поддержке или документам своей компании, обсудите с CenterAI задачу и состав первого MVP.
Частые вопросы
Можно ли пользоваться новыми Projects из терминала или VS Code?
Интерфейс Projects доступен в браузере, Claude Desktop и мобильном приложении. В терминальном CLI, расширении VS Code и плагине JetBrains самого интерфейса проектов нет. Терминал можно использовать для подключения локальной папки через Remote Control.
Можно ли подключить OpenRouter вместо Anthropic?
Описанные Projects используют Anthropic как поставщика моделей — и для облачных потоков, и для потоков на компьютере через Remote Control. Подключение OpenRouter вместо этого поставщика документация Projects не предусматривает.
Можно ли автоматически выполнять работу по расписанию?
Да. Из проекта можно поручить Claude создать routine — задачу с расписанием или другим поддерживаемым триггером. Она появляется на вкладке Routines. Добавляйте расписание после проверки обычного запуска.
Как остановить весь проект?
Откройте Project settings → General → Pause. Приостановка прерывает активные потоки и разговор, блокирует новые запуски и останавливает routines до возобновления проекта.
Что произойдёт при удалении проекта?
Delete безвозвратно удаляет проект, его потоки, память и файлы, а также отключает routines. Ветки и pull requests, уже отправленные в GitHub, сохраняются.
Источники и проверка
Дата проверки функций, доступности и названий элементов интерфейса: 11 октября 2026 года. Projects находятся в бете, поэтому интерфейс и условия доступа могут изменяться.