← Все статьи

Claude Code в облаке: гид Anthropic по облачным сессиям

Claude Code в облаке: гид Anthropic по облачным сессиям

Addy Osmani, инженер Anthropic, выпустил большой гид по облачным сессиям Claude Code. Идея простая: агент работает не в твоём терминале, а на отдельной виртуальной машине, поднятой под конкретную задачу, с уже склонированным репозиторием и готовым окружением. Гид построен на реальном эксперименте: автор запустил четыре облачные сессии на демо-репозитории и показывает их тайминги, диффы и переписки. Ниже — полный перевод, а после него — наш фактчек и советы, с чего начать.

Вероятно, ты запускаешь Claude Code в терминале на своём ноутбуке. Такая сессия зависит от ноутбука в трёх вещах:

  • Она делит с тобой рабочие файлы, поэтому две сессии в одном репозитории могут править одни и те же файлы и конфликтовать за один порт.
  • Она работает с твоими учётными данными.
  • Она останавливается, когда компьютер засыпает или пропадает Wi-Fi.

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

Запустить её можно из claude.ai/code, мобильного приложения Claude, десктопного приложения, терминала и Slack. Следить за ней — из браузера, мобильного приложения и Desktop. Когда работа сделана, она лежит в ветке, из которой можно сделать пулреквест.

Облачные сессии входят в тарифы Pro, Max, Team и Enterprise без дополнительной платы: за облачную машину отдельно платить не нужно, сессии расходуют те же лимиты, что и остальной Claude Code. В зависимости от тарифа владелец организации может сначала включить облачные сессии.

Бонусный кредит за облачные сессии. Существующие индивидуальные подписчики Pro и Max могут получить разовый бонусный кредит сверх лимитов тарифа: $100 на Pro и $250 на Max. Забрать его нужно до 7 октября на claude.ai/code/claim-credit или командой /claim-credit в Claude Code. Кредит сгорает 4 ноября. После того как он использован или истёк, действуют обычные лимиты тарифа. Кредит не действует для Projects и Routines. Подробности — в условиях промо-кредита.

Для этого гида я запустил четыре реальные облачные сессии на небольшом демо-репозитории. Их переписки, диффы и тайминги встречаются по всему тексту. Репозиторий и пользователь на скриншотах вымышлены. Работа, вывод и цифры взяты из тех сессий.

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

Видео: реальная хронология трёх облачных сессий в одном репозитории, в секундах от старта первой. Штрихованные полосы — шаг настройки, воссоздававший демо-репозиторий (при обычном использовании вместо него клон с GitHub), каждая точка — один вызов инструмента. — Хронология трёх облачных сессий в трёх виртуальных машинах, запущенных в пределах 16 секунд друг от друга. После штрихованной полосы настройки исправление нестабильного теста заканчивается на 65-й секунде — тесты прогнаны 40 раз, 0 провалов; переработка документации — на 62-й секунде, исправлено 5 ошибок в доках; переход на структурные логи — на 87-й секунде, JSON-логи и 5 новых тестов.

Три задачи, один репозиторий, три машины

Демо-репозиторий — tidepool, небольшой Node-API, который предсказывает приливы для трёх вымышленных гаваней. В нём было три обычные проблемы: один тест падал примерно в каждом четвёртом запуске, документация API описывала параметры, которые код уже не читает, а логгер собирал строки конкатенацией.

Я запустил три облачные сессии в пределах 16 секунд друг от друга, по одной на проблему. Запускал программно, и поскольку tidepool не на GitHub, каждая сессия сначала воссоздавала репозиторий из файлов в своём промпте. С реальным репозиторием этот шаг пропадает, а из терминала каждая сессия — одна команда claude --cloud. В сокращённом виде три промпта:

claude --cloud "npm test fails maybe one run in four. Find the flaky test, fix the root cause in the code (not the test), and prove it by running the suite at least 30 times in a row."
claude --cloud "docs/API.md is out of date with src/server.js. Rewrite it so every endpoint, parameter, default and response shape matches the code. Start the server and run each curl example to check it."
claude --cloud "Make src/logger.js emit one JSON object per line, keep LOG_LEVEL, and log method, path, status and duration_ms as fields. Add a test for the logger."

Сессии шли 61, 65 и 72 секунды, и все три закончились через 87 секунд после старта первой. Воссоздание репозитория занимало от трети до чуть больше половины каждого прогона. Вот результаты.

  • Нестабильный тест. Claude нашёл гонку в TtlCache.get. Кэш сохранял значение только после завершения загрузки, поэтому второй get того же ключа во время загрузки вызывал загрузчик повторно. Claude переделал кэш так, что он хранит обещание в процессе выполнения (in-flight promise), удаляет запись при неудачной загрузке и прогнал npm test 40 раз подряд без единого провала.
  • Документация. Claude поднял сервер, прогнал curl по каждому эндпоинту и нашёл пять расхождений старого дока с кодом: перечислял поля, которых API не возвращает, описывал параметр days, который код игнорирует, давал высоты в футах вместо метров, пропускал эндпоинт /next-high и не упоминал ответы с ошибками. Заодно выяснил, что кривое значение from= возвращает пустой список со статусом 200 — и описал это как оговорку в доках, вместо того чтобы трогать серверный код, который его не просили менять.
  • Логгер. Claude написал JSON-логгер, перевёл лог запросов на структурные поля и добавил пять тестов. Его коммит попал в ветку с одним падающим тестом — Claude перезапустил тест кэша восемь раз, увидел падение в пяти из них и выследил ту же гонку, которую чинила первая сессия. Предложил тот же фикс, но кэш не трогал — это было вне его задачи — и честно написал в итогах, что набор тестов не чистый.

claude.ai/code с сессией Structured logging: развёрнутый дифф src/server.js, заменяющий собранный из строк лог запроса на logger.info('request', { method, path, status, duration_ms }), и панель ветки claude/structured-logging с кнопкой Create PR.

Три сессии в интерфейсе claude.ai/code, запущенном локально и проигрывающем реальные переписки. Шаги настройки обрезаны, пути показываются под /home/user, три нижних заголовка в сайдбаре — заглушки, чип режима показывает значение по умолчанию.

Сессия Fix the flaky test: команда, пропатчившая cache.js и прогнавшая набор тестов 40 раз, её вывод runs=40 fails=0 и объяснение Claude о гонке в TtlCache.get.

Сессия Fix the flaky test

Сессия Update the tidepool API docs: итоги Claude о пяти способах, которыми старый docs/API.md расходился с кодом.

Сессия Update the tidepool API docs

Видео: 20-секундная запись той же локальной сборки: переключение между тремя сессиями и прокрутка переписки сессии с логгером. — Переключение между тремя сессиями в сайдбаре, затем прокрутка переписки сессии с логгером.

Результат с логгером показывает, почему облачные сессии подходят для параллельной работы. У каждой сессии была своя копия репозитория, свои процессы и своя ветка. Сессия с доками и сессия с логгером каждая поднимала API-сервер для проверки — и никак не влияли друг на друга. На одном ноутбуке два агента в одном чекауте правили бы одни и те же файлы и столкнулись бы на порту, если бы каждый не выбрал свой.

Из-за этой изоляции у сессии с логгером не было доступа к фиксу кэша, который делала первая сессия. Разбивай параллельные задачи по границам файлов, мержи ветки в разумном порядке и будь готов, что сессия отрапортует о проблеме, которую другая сессия уже чинит.

Как устроена облачная сессия Claude Code

Облачная сессия — это сессия Claude Code на инфраструктуре Anthropic или на машинах твоей организации с self-hosted environment (окружением на собственных серверах). На схеме — составные части. Четыре вывода после неё — те, что меняют то, как ты работаешь.

Сессию можно запустить из браузера, с телефона, из Desktop, терминала, Slack или по расписанию. Она идёт в свежей виртуальной машине с клоном репозитория на ветке claude, с Claude Code в режиме auto и с выполненной настройкой окружения. Трафик к GitHub проходит через прокси, который хранит твой токен вне виртуальной машины; остальной трафик проходит через прокси безопасности, применяющий сетевой белый список. Результат — ветка и пулреквест.

Анатомия облачной сессии. Всё, до чего агент может дотянуться, сидит внутри виртуальной машины. Твой GitHub-токен и сетевая политика — снаружи.

  • Каждая задача получает свою машину. Свежая виртуальная машина с клоном твоего репозитория на новой ветке, поэтому сессии не могут трогать файлы и порты друг друга. См. что установлено.
  • Твой GitHub-токен никогда не попадает в виртуальную машину. Его держит прокси, а сессия получает короткоживущий доступ, который может пушить только в свою рабочую ветку. См. GitHub-прокси.
  • Конфиг Claude из репозитория приезжает. Твой личный — нет. CLAUDE.md, правила, скиллы, агенты и команды едут вместе с репозиторием, а твой ~/.claude остаётся на ноутбуке. См. настройки в облачных сессиях.
  • Простаивающие машины забирают. Откроешь сессию снова — получишь свежую виртуальную машину с восстановленным разговором, поэтому коммить то, что тебе важно. См. environment expiry.

За характеристиками, режимами разрешений и сетевыми уровнями — в доках по облачным окружениям.

Локально или в облаке?

Облачные сессии не заменяют локальные, и большинство людей пользуется обоими вариантами. Таблица показывает, где различия, а абзацы после неё — когда что подходит.

Локальная сессияОблачная сессия
Где работаетТвоя машинаСвежая виртуальная машина на каждую задачу
Ноутбук уснул или офлайнСессия останавливаетсяСессия продолжает работать
Несколько задач в одном репозиторииОтдельные worktree (дополнительные рабочие копии), порты и аккуратностьОдна виртуальная машина и одна ветка на задачу
Что доступно агентуВсё, что доступно твоему пользователю, включая SSH-ключи, облачные CLI и ~/.claudeРепозиторий, заданный тобой сетевой уровень, включённые коннекторы и сессионный доступ к GitHub
Где запустить и следитьТа же машина или телефон через remote controlБраузер, телефон, Desktop, терминал, Slack, вызов API или расписание
ПодтвержденияЛюбой режим, включая подтверждение каждой командыAuto, Accept edits или Plan
Чем заканчиваетсяИзменениями в твоём рабочем деревеВеткой и, если хочешь, пулреквестом
ВычисленияТвоя машинаОтдельной платы за вычисления нет; расходуются лимиты тарифа

Оставайся локально, когда задаче нужно то, что есть только на твоей машине. Это база с реальными локальными данными, сервис, до которого добираешься через VPN, GPU, симулятор телефона или железо на столе. Локально также стоит работать в плотных визуальных циклах, когда хочешь видеть каждое изменение в своём браузере в течение секунд, и когда твоя организация использует Zero Data Retention (режим, при котором данные не хранятся) — он выключает облачные сессии.

Две возможности стоят между этими вариантами. Remote control оставляет сессию на твоей машине, но позволяет рулить ею с телефона или из браузера. Self-hosted environments, в бете для Team и Enterprise, запускают облачные сессии на инфраструктуре твоей организации, поэтому они могут достучаться до приватных сетей.

Если ничего из этого не про тебя — задача хороший кандидат на облако. В следующем разделе — сценарии, где это даёт больше всего.

Семь сценариев, для которых подходят облачные сессии

Эти сценарии используют различия из таблицы: отдельная машина на каждую задачу, сессии, которые работают, пока тебя нет, и ветка в конце на проверку.

1. Разгребай бэклог параллельно

Допустим, у тебя пять небольших несвязанных правок. Локально ты делал бы их по очереди или поднимал пять worktree и разводил их порты и установки. В облаке ты запускаешь пять сессий и ревьюишь пять веток.

claude --cloud "Fix the flaky test in auth.spec.ts"
claude --cloud "Update the API documentation"
claude --cloud "Refactor the logger to use structured output"

claude --cloud клонирует твой GitHub-удалённый репозиторий на текущей ветке, поэтому сначала запушь локальные коммиты. Пока машина поднимается, CLI показывает живой чеклист шагов настройки и ставит в очередь всё, что ты печатаешь.

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

Когда задачи принадлежат одной большой работе, project (публичная бета для Pro и Max) запускает разговор-координатор, который стартует и отслеживает облачные сессии за тебя. Затем он группирует их по состоянию: работает, ждёт тебя, готово к ревью.

2. Пусть докажет, что починил

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

Шаг Bash из сессии с нестабильным тестом: патч src/cache.js с кэшированием in-flight promise, затем цикл, прогоняющий набор тестов 40 раз, с выводом runs=40 fails=0.

Сорок прогонов, ноль провалов: реальная команда и вывод сессии с нестабильным тестом, проигранные в интерфейсе claude.ai/code, запущенном локально. Claude пропатчил src/cache.js и зациклил полный набор тестов 40 раз в один шаг. Пути показываются под /home/user.

За виртуальную машину отдельной платы нет, и её процессор не твой, поэтому проси тщательных доказательств. Прогони набор 200 раз, найди регрессию бинарным поиском по 50 коммитам, запусти медленный интеграционный уровень или подними приложение и постучись в него curl, как сделала сессия с доками.

Каждый ход Claude по-прежнему расходует лимиты тарифа, но долгий прогон тестов внутри одной команды стоит дёшево. Команды на переднем плане по умолчанию обрываются по таймауту через 2 минуты (максимум 10), а затем продолжают работать в фоне ещё до 30 минут. Значения по умолчанию можно поднять переменными BASH_DEFAULT_TIMEOUT_MS и BASH_MAX_TIMEOUT_MS в окружении.

3. Спланируй за столом, собери в облаке, добей в терминале

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

claude --permission-mode plan
# ...договорились о плане, сохранили в docs/migration-plan.md, закоммитили и запушили...
claude --cloud "Execute the migration plan in docs/migration-plan.md"

Пока облачная сессия собирает, твой терминал свободен для другой работы. Когда она закончит, затяни сессию в терминал и добей руками.

claude --teleport            # выбрать облачную сессию
claude --teleport <session-id>

Teleport проверяет, что ты в том же репозитории, подтягивает ветку сессии, переходит на неё и загружает весь разговор в твой терминал. Нужно чистое рабочее дерево (он предложит сделать stash), и ветка должна быть запушена. Изнутри Claude Code то же меню открывают /teleport (или /tp), а ещё /tasks и затем t. Приложение Desktop работает в обратную сторону: его меню Open in отправляет локальную сессию в облако.

4. Проверяй со смартфона

Вкладка Code в приложении Claude подключается к тем же сессиям. С телефона можно запустить задачу, следить за ней, корректировать курс, ответить на вопрос Claude или попросить следить за пулреквестом.

Телефон подходит для вопросов, которые ты забудешь, пока дойдёшь до клавиатуры. Четвёртой сессии я задал вопрос того сорта, что набирают одной рукой: как tidepool предсказывает приливы и как это может сломаться на краях временного окна? Она прогнала код, чтобы проверить ответ, и нашла настоящий баг. Цикл никогда не смотрит первый и последний образец, поэтому API пропускает высокий прилив, выпавший ровно на начало окна.

claude.ai/code шириной с телефон с началом ответа Claude: у predictTides две проблемы на краях, подтверждённые запуском кода, с разделом How it works.

Вопрос с телефона: claude.ai/code на ширине телефона в браузере (не нативное приложение), запущенный локально и проигрывающий реальный ответ четвёртой сессии

Конец ответа: таблица, как часто по каждой станции у предсказанных максимумов и минимумов был сосед той же высоты, и предложенный фикс.

Claude проверил каждое утверждение, прогнав код на демо-данных, и не изменил ни одного файла

5. Отдай Claude падения CI и комментарии из ревью

Если на репозитории установлено приложение Claude GitHub App, облачная сессия может следить за пулреквестом и реагировать на то, что с ним происходит. Из CI-панели в сессии на claude.ai/code включи Auto-fix. Можно также запустить /autofix-pr на ветке пулреквеста в терминале, попросить мобильное приложение следить за пулреквестом или вставить его URL в сессию.

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

6. Запускай работу, не запуская её сам

Routine (research preview) — это набор сохранённых ресурсов для выполнения задачи: промпт, репозитории, коннекторы и окружение. Каждый запуск — облачная сессия, стартующая по триггеру. Триггером может быть расписание (не чаще раза в час), HTTP-вызов собственного эндпоинта routine или событие GitHub вроде открытия пулреквеста или релиза. Создать можно на claude.ai/code/routines, в приложении Desktop или командой /schedule в CLI. Routines работают без запросов подтверждений и по умолчанию пушат в ветки с префиксом claude/.

Здесь помогают два инструмента поменьше. В работающую сессию можно поставить в очередь продолжение с любой машины, где ты залогинен, включая CI-задачу.

claude -p "The integration tier is green now; rebase on main and push" --cloud <session-id>

Можно также сохранить в закладки сессию с предзаполненным промптом. URL вида claude.ai/code?prompt=Triage+the+newest+issues&repositories=acme-labs/tidepool открывает claude.ai/code с уже заполненными промптом и репозиторием.

7. Запускай код, которому не до конца доверяешь

Пулреквест контрибьютора, инсталляционный скрипт новой зависимости или репозиторий, склонированный пять минут назад, — всё это может запустить код, который ты не читал. На ноутбуке этот код работает рядом с твоими SSH-ключами, сессиями облачных CLI и профилем браузера. В облачной сессии он работает в одноразовой виртуальной машине, где ничего этого нет, с доступом к GitHub только для своей сессии и с сетью, которую можно сузить.

Поставь сетевой доступ окружения в None для самого строгого запуска или оставь Trusted, который разрешает пакетные реестры, GitHub и хосты крупных облачных SDK. Даже на None Claude Code всё равно шлёт запросы к API Anthropic, поэтому данные могут покинуть виртуальную машину этим путём, и сессия всё ещё может пушить в свою ветку. Весь исходящий трафик проходит через прокси, который логирует имена хостов.

Подключаем GitHub без застревания

Если твоя первая облачная сессия пошла не так, самая вероятная причина — GitHub. Большинство проблем из-за того, что облачным сессиям нужны два отдельных разрешения GitHub.

  • Вход через GitHub говорит Claude, кто ты.
  • Установка Claude GitHub App на аккаунт или организацию определяет, какие приватные репозитории Claude там видит.

Публичные репозитории работают с одним только входом. Приватным нужен второй пункт — на том аккаунте или организации, которым они принадлежат. Если ты подключил GitHub, а приватного репозитория нет, приложение обычно не установлено на аккаунте или организации-владельце.

Что подключеноПубличные репозиторииТвои приватныеПриватные организацииAuto-fix, GitHub-триггеры, projects
Только вход через GitHubДаНетНетНет
+ App на твоём личном аккаунтеДаДаНетТвои репозитории
+ App на организации (одобряет владелец)ДаТолько если App есть и на твоём аккаунтеДаРепозитории организации
/web-setup (твой токен gh)ДаДаВсё, до чего дотягивается твой токенНет, нужен App

Путь A: подключиться в браузере (рекомендуется)

Подключи аккаунт GitHub на claude.ai/connect-github, затем установи Claude GitHub App на аккаунт или организацию, которой принадлежит твой репозиторий. Для организации обычно нужно одобрение владельца. Quickstart проводит по каждому шагу.

Экран Code with Claude anywhere с кнопкой Connect to GitHub.

Шаг 1, вход через GitHub. Экраны онбординга claude.ai/code, запущенные локально с демо-данными; названия репозиториев на иллюстрациях и чип Research preview — часть собственного оформления продукта.

Экран Connect your repositories с просьбой установить Claude GitHub App на твои репозитории, с кнопками Skip и Connect repositories.

Шаг 2, установка Claude GitHub App

Если GitHub не возвращает тебя на claude.ai/code, страница подключения на claude.ai/connect-github может показать короткий чеклист типовых причин. Одна из них — шаг единого входа (single sign-on), который прячет репозитории организации, если его пропустить.

Экран Didn't finish connecting с пятью советами: войди в правильный аккаунт GitHub, авторизуй каждую организацию на шаге единого входа, начни заново, если увидел GitHub connection not completed, подключи сначала свой аккаунт и дай владельцу одобрить доступ к организации позже или запусти /web-setup из терминала.

Если GitHub не вернул тебя: собственный чеклист продукта для прерванного подключения GitHub, из потока быстрой настройки в интерфейсе claude.ai/code, запущенном локально

Auto-fix, routines с триггерами GitHub и projects тоже зависят от App, так что установи его, даже если подключаешься другим способом.

Путь B: подключиться из терминала через /web-setup

Если ты уже пользуешься gh CLI, запусти /web-setup внутри Claude Code, чтобы отправить свой токен gh в аккаунт Claude. Сессии смогут достучаться до любого репозитория, до которого дотягивается этот токен, с App или без него. Пошаговое описание — в Connect from your terminal. На тарифах Team и Enterprise владелец должен сначала включить Quick setup.

Путь C: обойтись без GitHub для разовой задачи

Запусти claude --cloud в репозитории без GitHub-удалённого или там, где App не установлен, — и Claude Code загрузит архив твоего репозитория вместо клонирования. Запушить обратно сессия сможет, только если у твоего подключения к GitHub есть доступ на запись в этот репозиторий. В доках есть список того, что архив включает и что пропускает.

Если у тебя Team или Enterprise

У владельца короткий чеклист: включи коннектор GitHub на claude.ai/admin-settings/connectors, разреши облачные сессии в админ-настройках Claude Code, установи Claude GitHub App на репозитории организации (или одобри запросы участников) и реши, включать ли Quick setup. У организаций с белыми списками IP или GitHub Enterprise Server есть дополнительный шаг. См. доки по белым спискам IP и GitHub Enterprise Server.

Если всё равно не работает

Что ты видишьПочемуКак починить
Приватного репозитория нет в спискеApp не установлен на аккаунте или организации-владельце, либо его доступ к репозиториям исключает этот репозиторийУстанови App там или добавь репозиторий в Repository access у App в настройках GitHub
Ошибка, что ты должен быть владельцем организации, чтобы связать еёОрганизация заблокировала проверку членства — обычно из-за запроса разрешений App в ожидании, белого списка IP или SAML single sign-onВладелец принимает запрос разрешений в настройках GitHub App организации, включает наследование белого списка IP для установленных GitHub Apps или (при SAML) выдаёт Claude доступ к организации
Репозиториев организации нет сразу после подключенияОрганизация использует SAML single sign-on, и шаг авторизации был пропущенНа шаге GitHub «Single sign-on to your organizations» нажми Authorize напротив каждой организации, прежде чем продолжить. Если уже пропустил — авторизуй Claude для этой организации в настройках GitHub и подключись заново
Каждая облачная сессия падает с ошибкой аутентификацииТвоя организация Claude использует белый список IPПопроси поддержку сделать исключение для сервисов, хостящихся у Anthropic

По всему остальному см. troubleshooting в доках, включая случай, когда репозитории не появляются после подключения GitHub. Полностью отключить GitHub можно на claude.ai/customize/connectors.

Дай сессиям то, что нужно для самопроверки

Сессия, которая может запустить твои тесты, проверяет свою работу, прежде чем отдать её тебе. Без этого ты ревьюишь изменения, которые никто не запускал. Большая часть ценности демо из этого гида — из того, что Claude что-то запускал: набор тестов 40 раз, сервер с его curl, расчёт прилива на краю окна. Десять минут настройки окружения дают Claude способ прогонять такие проверки.

Диалог Add cloud environment с именем tidepool, сетевым доступом Trusted, LOG_LEVEL=debug и setup-скриптом, устанавливающим shellcheck через apt-get.

Добавление облачного окружения в интерфейсе claude.ai/code, локально с демо-значениями: имя, уровень сетевого доступа, переменные в формате .env и setup-скрипт

  • Начни с окружения Default. Оно использует сетевой доступ Trusted, без переменных и без setup-скрипта — для большинства репозиториев на JavaScript, Python, Go и Rust этого достаточно.
  • Используй setup-скрипт для машины. Он запускается от root до старта Claude Code, поэтому работает apt install. Он обязан завершиться с кодом 0, иначе сессия не стартует, и должен укладываться примерно в пять минут, чтобы окружение попало в кэш. После этого новые сессии стартуют из снимка с твоими инструментами на диске. Кэш пересобирается при изменении скрипта или разрешённых хостов, а также примерно раз в семь дней.
  • Используй SessionStart-хук для проекта. Положи npm install и подобные шаги в хук в .claude/settings.json репозитория, чтобы они шли одинаково локально и в облаке. Проверяй CLAUDE_CODE_REMOTE, если шаг должен выполняться только в облаке. Хуки репозитория загружаются в сессиях одного репозитория.
  • Поднимай сервисы в каждой сессии. Кэш хранит файлы. Запущенные процессы его не переживают. Попроси Claude выполнить service postgresql start или сделай это в SessionStart-хуке.
  • Выбирай самый узкий сетевой уровень, который работает. Trusted покрывает обычные реестры. Custom — чтобы добавить приватный реестр, Full — только когда задаче нужен открытый интернет. Изменения доходят до работающих сессий примерно за минуту.
  • Держи секреты подальше от общих переменных. Переменные окружения видны всем, кто пользуется окружением. На Pro и Max API-креденшалы окружения подставляют ключ к запросам к названным тобой хостам вне виртуальной машины, поэтому ключ никогда не лежит в переменной.
  • Положи команды в CLAUDE.md. Твой личный ~/.claude не доезжает до облачной машины. Если Claude должен знать, как запускать интеграционные тесты, репозиторий должен это сказать.

Привычки, которые окупаются

  • Одна задача — одна сессия. Маленькие отдельные сессии проще ревьюить и дешевле выбрасывать.
  • Проси доказательств. Назови команду, которая докажет, что задача сделана, и читай итоги Claude до диффа.
  • Пушь до claude --cloud. Виртуальная машина клонирует с GitHub, поэтому незапушенные коммиты до неё не доедут.
  • Коммить по ходу в долгих задачах. Простаивающие машины могут забрать.
  • Ревью в режиме диффа. Инлайн-комментарии собираются в твоё следующее сообщение, а Create PR может открыть полноценный пулреквест, черновик или страницу создания на GitHub.
  • Корректируй курс, пока Claude работает. Сообщения, отправленные во время работы, встают в очередь, и одно из них можно забрать обратно.
  • Делись сессией. На Team и Enterprise поставь видимость сессии в Team, чтобы ревьюер мог прочитать, как делалось изменение. Коммиты из облачных сессий несут трейлер Claude-Session, который ссылается на переписку.
  • Следи за лимитами. Параллельные сессии расходуют лимиты тарифа параллельно, поэтому пять сессий израсходуют их примерно в пять раз быстрее одной. У Routines свои часовые лимиты, а projects могут запускать до 200 новых тредов в день.

Частые вопросы

Кому доступны облачные сессия? Тарифам Pro, Max и Team, а также пользователям Enterprise с премиальным местом или местом Chat + Claude Code, залогиненным через аккаунт claude.ai. С ключом Console API или сторонним провайдером они недоступны. См. доки облачных сессий.

Куда уходят мои данные? Anthropic хранит переписку сессии, срок хранения зависит от тарифа и настройки улучшения моделей. Виртуальные машины забираются после простоя, а удаление сессии удаляет её данные. См. data usage и security.

Будет ли Claude обучаться на моих облачных сессиях? Облачные сессии следуют той же политике, что и остальной Claude Code. На Team, Enterprise и API Anthropic не обучает модели на твоём коде и промптах, если организация явно не включила это. На Free, Pro и Max — зависит от твоей настройки улучшения моделей. См. data usage.

Справится ли с моим большим репозиторием? У виртуальной машины около 4 vCPU, 16 ГБ RAM и 30 ГБ диска. Тяжёлые установки положи в setup-скрипт, чтобы они шли один раз и попадали в кэшированный снимок.

А как же GitLab или Bitbucket? claude --cloud может загрузить архив из любого git-репозитория, но запушить обратно на эти хосты сессия не сможет. GitHub Enterprise Server поддерживается на Team и Enterprise. См. ограничения платформ.

Что будет при конфликте параллельных веток? Сессии не знают друг о друге. Смержи одну ветку, затем отправь следующей сессии продолжение вроде claude -p "rebase on main and fix any conflicts" --cloud <session-id>.

Я потеряю свои локальные инструменты? Пользовательский конфиг не travels, то есть не переезжает, поэтому перенеси нужное команде в репозиторий: закоммить скиллы и команды в .claude/, добавь проектные MCP-серверы в .mcp.json, а команды тестов опиши в CLAUDE.md. Настройки в облачных сессиях перечисляют, что читает каждая сессия.

Старт за пять минут

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

  1. Открой claude.ai/code или запусти /login в Claude Code с аккаунтом claude.ai.
  2. Подключи GitHub и установи Claude GitHub App там, где живёт твой репозиторий.
  3. Выбери репозиторий и окружение Default.
  4. Дай Claude одну задачу из бэклога — с командой, которая докажет, что она сделана.
  5. Закрой вкладку. Позже загляни с телефона, затем ревьюни дифф и создай пулреквест на claude.ai/code.

Фактчек

  • Облачные сессии как фича — правда. Claude Code on the web анонсировали осенью 2025-го, затем добавили запуск из терминала, мобильное приложение и Desktop. Описанное в статье соответствует известной картине продукта.
  • Автор — реальный человек из Anthropic. Addy Osmani публично объявил о переходе туда из Google в конце 2025 года, так что авторство и должность правдоподобны.
  • Бонусные кредиты ($100 на Pro, $250 на Max, дедлайны 7 октября и 4 ноября) проверить нечем. Это промо-акция со сгораемым кредитом — по сути маркетинговый ход, чтобы подтолкнуть к пробе. Даты и суммы сверяй на официальной странице акции.
  • Внутренние цифры Anthropic независимо не проверить: характеристики машины (4 vCPU, 16 ГБ RAM, 30 ГБ диска), таймауты команд (2 минуты по умолчанию, 10 максимум, до 30 минут в фоне), пересборка кэша окружения раз в ~7 дней, до 200 тредов в день для projects. Это слова самой компании о своей инфраструктуре.
  • Заявления о безопасности (токен GitHub вне виртуальной машины, прокси с логированием хостов) — тоже на слово Anthropic. Код закрыт, проверить изоляцию со стороны нельзя.
  • Демо с tidepool — авторская самодемонстрация. Репозиторий вымышленный, цифры (61/65/72 секунды, 40 прогонов тестов) воспроизвести нельзя. Зато честно указано, что репозиторий воссоздавался из файлов промпта и занимал треть-половину каждого прогона — без GitHub реальные цифры будут другими.
  • «Без дополнительной платы» — формально правда, но с оговоркой. Отдельной платы за машину нет, однако сессии расходуют лимиты тарифа, и статья сама признаёт: пять параллельных сессий съедят их в пять раз быстрее.
  • «Настройка за пять минут» — оптимизм. На личном аккаунте может и хватит, но в организации с SSO и белыми списками IP подключение GitHub легко растянется на день ожидания владельца.
  • Routines в статусе research preview, self-hosted environments в бете — статья сама помечает сырость, это хороший знак. Отдельные команды (/teleport, /autofix-pr, /schedule) появились недавно — перед использованием проверь их наличие в своей версии через claude --help.

Как применить

  • Проверь тариф и забери кредит. Облачные сессии доступны на Pro, Max, Team и Enterprise. Если ты на Pro или Max и давно подписан, до 7 октября выполни /claim-credit в Claude Code — разовые $100–250 сверху лимитов не помешают.
  • Подключи GitHub по полной. Одного входа мало: для приватных репозиториев и Auto-fix установи Claude GitHub App на аккаунт или организацию через claude.ai/connect-github. В организации заранее позови владельца.
  • Проведи первую сессию с доказательством. Запушь коммиты, затем: claude --cloud "почини X и докажи командой Y". Формулировка «прогони тесты минимум 30 раз подряд» — хороший шаблон.
  • Попробуй параллель на мелочах. Возьми 2–3 независимые правки из бэклога (разные файлы!), запусти отдельные сессии и сравни ветки. Сессии не видят работу друг друга — мержи по очереди и проси rebase.
  • Собери окружение один раз. Системные зависимости — в setup-скрипт, npm install — в SessionStart-хук в .claude/settings.json, команды тестов — в CLAUDE.md. Тогда каждая сессия сможет проверять свою работу.
  • Дотяни сессию в терминал. Когда облако закончит, claude --teleport перенесёт ветку и весь разговор в твой локальный Claude Code для финальных правок.
  • Для команды: владельцу нужно включить коннектор GitHub, разрешить облачные сессии в админке и установить App на репозитории организации — без этого у сотрудников ничего не заведётся.
  • Кому это нужно в первую очередь: тем, у кого копятся мелкие правки, падают нестабильные тесты и есть долгие прогоны, которые жалко держать на рабочей машине. Локально оставь всё, что требует твоего железа, VPN или живого визуального цикла.

Источники

  1. https://claude.dev/blog/claude-code-in-the-cloud/