Перейти к основному содержанию

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Claude Code в веб-интерфейсе находится в исследовательском предпросмотре для пользователей Pro, Max и Team, а также для пользователей Enterprise с премиум-местами или местами Chat + Claude Code.
Claude Code в веб-интерфейсе запускает задачи на облачной инфраструктуре, управляемой Anthropic, по адресу claude.ai/code. Сессии сохраняются даже если вы закроете браузер, и вы можете мониторить их из мобильного приложения Claude.
Новичок в Claude Code в веб-интерфейсе? Начните с Начало работы для подключения вашего аккаунта GitHub и отправки вашей первой задачи.
На этой странице рассматривается:

Варианты аутентификации GitHub

Облачным сессиям нужен доступ к вашим репозиториям GitHub для клонирования кода и отправки веток. Вы можете предоставить доступ двумя способами:
МетодКак это работаетЛучше всего для
GitHub AppАвторизуйте приложение Claude GitHub во время веб-подключения.Веб-подключение в браузере; команды, которые хотят Auto-fix
/web-setupЗапустите /web-setup в вашем терминале для синхронизации вашего локального токена gh CLI с вашим аккаунтом Claude.Отдельные разработчики, которые уже используют gh
При использовании любого метода облачная сессия может получить доступ к любому репозиторию, который может видеть подключённый аккаунт GitHub, а не только к репозиториям, на которых установлено приложение Claude GitHub. Установка приложения включает PR webhooks для Auto-fix; это не контроль доступа на уровне сессии. Чтобы ограничить, какие репозитории ваша команда может использовать из облачных сессий, ограничьте доступ на самом GitHub, например, ограничив членство в команде или репозитории для подключённых аккаунтов GitHub.
Любой метод работает. /schedule проверяет наличие любой формы доступа и предлагает запустить /web-setup, если ничего не настроено. См. Подключение из вашего терминала для пошагового руководства /web-setup. GitHub App требуется для Auto-fix, который использует приложение для получения PR webhooks. Если вы подключитесь с помощью /web-setup и позже захотите Auto-fix, установите приложение на эти репозитории. Администраторы Team и Enterprise могут отключить /web-setup с помощью переключателя Quick web setup на claude.ai/admin-settings/claude-code.
Организации с включённым Zero Data Retention не могут использовать /web-setup или другие функции облачных сессий.

Облачное окружение

Каждая сессия запускается на свежей виртуальной машине, управляемой Anthropic, с клонированным вашим репозиторием. В этом разделе рассматривается, что доступно при запуске сессии и как её настроить.

Что доступно в облачных сессиях

Облачные сессии начинаются со свежего клона вашего репозитория. Всё, что зафиксировано в репозитории, доступно. Всё, что вы установили или настроили только на своей машине, недоступно.
Доступно в облачных сессияхПочему
Ваш CLAUDE.md репозиторияДаЧасть клона
Ваши hooks .claude/settings.json репозиторияДаЧасть клона
Ваши MCP серверы .mcp.json репозиторияДаЧасть клона
Ваш .claude/rules/ репозиторияДаЧасть клона
Ваш .claude/skills/, .claude/agents/, .claude/commands/ репозиторияДаЧасть клона
Plugins объявленные в .claude/settings.jsonДаУстановлены при запуске сессии из marketplace, который вы объявили. Требует сетевого доступа для доступа к источнику marketplace
Ваш пользовательский ~/.claude/CLAUDE.mdНетНаходится на вашей машине, не в репозитории
Plugins включённые только в ваши пользовательские параметрыНетПользовательский enabledPlugins находится в ~/.claude/settings.json. Объявите их в .claude/settings.json репозитория вместо этого
MCP серверы, которые вы добавили с помощью claude mcp addНетОни записываются в вашу локальную пользовательскую конфигурацию, не в репозиторий. Объявите сервер в .mcp.json вместо этого
Статические API токены и учётные данныеНетВыделенного хранилища секретов пока не существует. См. ниже
Интерактивная аутентификация, такая как AWS SSOНетНе поддерживается. SSO требует входа на основе браузера, который не может работать в облачной сессии
Чтобы сделать конфигурацию доступной в облачных сессиях, зафиксируйте её в репозитории. Выделенное хранилище секретов пока не доступно. Как переменные окружения, так и setup scripts хранятся в конфигурации окружения, видимой для всех, кто может редактировать это окружение. Если вам нужны секреты в облачной сессии, добавьте их как переменные окружения с учётом этой видимости.

Установленные инструменты

Облачные сессии поставляются с предустановленными распространёнными средами выполнения языков, инструментами сборки и базами данных. Таблица ниже суммирует, что включено по категориям.
КатегорияВключено
PythonPython 3.x с pip, poetry, uv, black, mypy, pytest, ruff
Node.js20, 21 и 22 через nvm, с npm, yarn, pnpm, bun¹, eslint, prettier, chromedriver
Ruby3.1, 3.2, 3.3 с gem, bundler, rbenv
PHP8.4 с Composer
JavaOpenJDK 21 с Maven и Gradle
Goпоследняя стабильная версия с поддержкой модулей
Rustrustc и cargo
C/C++GCC, Clang, cmake, ninja, conan
Dockerdocker, dockerd, docker compose
DatabasesPostgreSQL 16, Redis 7.0
Utilitiesgit, jq, yq, ripgrep, tmux, vim, nano
¹ Bun установлен, но имеет известные проблемы совместимости с прокси для получения пакетов. Для точных версий попросите Claude запустить check-tools в облачной сессии. Эта команда существует только в облачных сессиях.

Работа с проблемами GitHub и pull requests

Облачные сессии включают встроенные инструменты GitHub, которые позволяют Claude читать проблемы, перечислять pull requests, получать diffs и публиковать комментарии без какой-либо настройки. Эти инструменты аутентифицируются через GitHub proxy, используя любой метод, который вы настроили в разделе Варианты аутентификации GitHub, поэтому ваш токен никогда не входит в контейнер. CLI gh не предустановлен. Если вам нужна команда gh, которую встроенные инструменты не охватывают, например gh release или gh workflow run, установите и аутентифицируйте её самостоятельно:
1

Установите gh в ваш setup script

Добавьте apt update && apt install -y gh в ваш setup script.
2

Предоставьте токен

Добавьте переменную окружения GH_TOKEN в ваши параметры окружения с личным токеном доступа GitHub. gh автоматически читает GH_TOKEN, поэтому шаг gh auth login не требуется.

Свяжите артефакты обратно с сессией

Каждая облачная сессия имеет URL транскрипта на claude.ai, и сессия может читать свой собственный ID из переменной окружения CLAUDE_CODE_REMOTE_SESSION_ID. Используйте это, чтобы поместить отслеживаемую ссылку в тела PR, сообщения коммитов, посты Slack или созданные отчёты, чтобы рецензент мог открыть запуск, который их создал. Значение переменной использует префикс cse_, в то время как путь URL транскрипта использует тот же ID с префиксом session_. Замените префикс при построении ссылки. Следующая команда выводит URL:
echo "https://claude.ai/code/${CLAUDE_CODE_REMOTE_SESSION_ID/#cse_/session_}"

Запускайте тесты, запускайте сервисы и добавляйте пакеты

Claude запускает тесты как часть работы над задачей. Попросите это в вашей подсказке, например “fix the failing tests in tests/” или “run pytest after each change.” Средства запуска тестов, такие как pytest, jest и cargo test, работают из коробки, так как они предустановлены. PostgreSQL и Redis предустановлены, но не запущены по умолчанию. Попросите Claude запустить каждый во время сессии:
service postgresql start
service redis-server start
Docker доступен для запуска контейнеризованных сервисов. Попросите Claude запустить docker compose up для запуска сервисов вашего проекта. Сетевой доступ для получения образов следует вашему окружению уровень доступа, и Доверенные значения по умолчанию включают Docker Hub и другие распространённые реестры. Если ваши образы большие или медленно загружаются, добавьте docker compose pull или docker compose build в ваш setup script. Полученные образы сохраняются в кэшированном окружении, поэтому каждая новая сессия имеет их на диске. Кэш хранит только файлы, не запущенные процессы, поэтому Claude всё ещё запускает контейнеры каждую сессию. Чтобы добавить пакеты, которые не предустановлены, используйте setup script. Вывод скрипта кэшируется, поэтому пакеты, которые вы устанавливаете там, доступны в начале каждой сессии без переустановки каждый раз. Вы также можете попросить Claude установить пакеты во время сессии, но эти установки не сохраняются между сессиями.

Ограничения ресурсов

Облачные сессии работают с приблизительными потолками ресурсов, которые могут меняться со временем:
  • 4 vCPU
  • 16 ГБ оперативной памяти
  • 30 ГБ диска
Задачи, требующие значительно больше памяти, такие как большие работы сборки или тесты, требующие много памяти, могут не пройти или быть прерваны. Для рабочих нагрузок, превышающих эти ограничения, используйте Remote Control для запуска Claude Code на вашем собственном оборудовании.

Настройте ваше окружение

Окружения контролируют сетевой доступ, переменные окружения и setup script, который запускается перед запуском сессии. См. Установленные инструменты для того, что доступно без какой-либо конфигурации. Вы можете управлять окружениями из веб-интерфейса или терминала:
ДействиеКак
Добавить окружениеВыберите текущее окружение, чтобы открыть селектор, затем выберите Add environment. Диалог включает имя, уровень сетевого доступа, переменные окружения и setup script.
Отредактировать окружениеВыберите значок облака, показывающий имя текущего окружения, чтобы открыть селектор, наведите курсор на окружение и нажмите значок параметров, который появляется справа.
Архивировать окружениеОткройте окружение для редактирования и выберите Archive. Архивированные окружения скрыты из селектора, но существующие сессии продолжают работать.
Установить значение по умолчанию для --remoteЗапустите /remote-env в вашем терминале. Если у вас одно окружение, эта команда показывает вашу текущую конфигурацию. /remote-env только выбирает значение по умолчанию; добавляйте, редактируйте и архивируйте окружения из веб-интерфейса.
Переменные окружения используют формат .env с одной парой KEY=value на строку. Не оборачивайте значения в кавычки, так как кавычки хранятся как часть значения.
NODE_ENV=development
LOG_LEVEL=debug
DATABASE_URL=postgres://localhost:5432/myapp

Setup scripts

Setup script — это Bash скрипт, который запускается при запуске новой облачной сессии, перед запуском Claude Code. Используйте setup scripts для установки зависимостей, настройки инструментов или получения чего-либо, что сессии нужно, но что не предустановлено. Скрипты запускаются от имени root на Ubuntu 24.04, поэтому apt install и большинство менеджеров пакетов языков работают. Чтобы добавить setup script, откройте диалог параметров окружения и введите ваш скрипт в поле Setup script. Этот пример устанавливает CLI gh, который не предустановлен:
#!/bin/bash
apt update && apt install -y gh
Если скрипт завершится с ненулевым кодом, сессия не запустится. Добавьте || true к некритичным командам, чтобы избежать блокирования сессии при нестабильной установке. Держите общее время выполнения скрипта ниже примерно пяти минут, чтобы кэш окружения мог построиться. Запускайте независимые установки параллельно с & и wait. Если одна загрузка не поместится в пятиминутный лимит, переместите её в SessionStart hook, который запускает её в фоновом режиме.
Setup scripts, которые устанавливают пакеты, нуждаются в сетевом доступе для доступа к реестрам. Доступ в сеть по умолчанию Trusted позволяет подключения к распространённым реестрам пакетов, включая npm, PyPI, RubyGems и crates.io. Скрипты не смогут установить пакеты, если ваше окружение использует доступ в сеть None.

Кэширование окружения

Setup script запускается в первый раз, когда вы запускаете сессию в окружении. После завершения Anthropic создаёт снимок файловой системы и повторно использует этот снимок в качестве начальной точки для последующих сессий. Новые сессии начинаются с вашими зависимостями, инструментами и образами Docker уже на диске, и шаг setup script пропускается. Это сохраняет быстрый запуск даже когда скрипт устанавливает большие наборы инструментов или получает образы контейнеров. Кэш захватывает файлы, не запущенные процессы. Всё, что setup script записывает на диск, переносится. Сервисы или контейнеры, которые он запускает, нет, поэтому запускайте их за сессию, попросив Claude или с помощью SessionStart hook. Setup script запускается снова для перестроения кэша, когда вы изменяете setup script окружения или разрешённые сетевые хосты, и когда кэш достигает своего истечения примерно через семь дней. Возобновление существующей сессии никогда не переустанавливает setup script. Вам не нужно включать кэширование или управлять снимками самостоятельно.

Setup scripts в сравнении с SessionStart hooks

Используйте setup script для установки того, что облаку нужно, но ваш ноутбук уже имеет, например, среду выполнения языка или инструмент CLI. Используйте SessionStart hook для настройки проекта, которая должна выполняться везде, в облаке и локально, например npm install. Оба запускаются в начале сессии, но они принадлежат разным местам:
Setup scriptsSessionStart hooks
Прикреплено кОблачному окружениюВашему репозиторию
Настроено вПользовательском интерфейсе облачного окружения.claude/settings.json в вашем репозитории
ЗапускаетсяПеред запуском Claude Code, когда нет кэшированного окруженияПосле запуска Claude Code, на каждой сессии, включая возобновлённые
ОбластьТолько облачные окруженияКак локальные, так и облачные
SessionStart hooks также могут быть определены в вашем пользовательском файле ~/.claude/settings.json локально, но пользовательские параметры не переносятся в облачные сессии. В облаке запускаются только hooks, зафиксированные в репозитории.

Установите зависимости с помощью SessionStart hook

Чтобы установить зависимости только в облачных сессиях, добавьте SessionStart hook в .claude/settings.json вашего репозитория:
{
  "hooks": {
    "SessionStart": [
      {
        "matcher": "startup|resume",
        "hooks": [
          {
            "type": "command",
            "command": "\"$CLAUDE_PROJECT_DIR\"/scripts/install_pkgs.sh"
          }
        ]
      }
    ]
  }
}
Создайте скрипт в scripts/install_pkgs.sh и сделайте его исполняемым с помощью chmod +x. Переменная окружения CLAUDE_CODE_REMOTE установлена в true в облачных сессиях, поэтому вы можете использовать её для пропуска локального выполнения:
#!/bin/bash

if [ "$CLAUDE_CODE_REMOTE" != "true" ]; then
  exit 0
fi

npm install
pip install -r requirements.txt
exit 0
SessionStart hooks имеют некоторые ограничения в облачных сессиях:
  • Нет облачного ограничения области: hooks запускаются как в локальных, так и в облачных сессиях. Чтобы пропустить локальное выполнение, проверьте переменную окружения CLAUDE_CODE_REMOTE, как показано выше.
  • Требует сетевой доступ: команды установки нуждаются в доступе к реестрам пакетов. Если ваше окружение использует доступ в сеть None, эти hooks не будут работать. Список разрешений по умолчанию под Trusted охватывает npm, PyPI, RubyGems и crates.io.
  • Совместимость с прокси: весь исходящий трафик проходит через security proxy. Некоторые менеджеры пакетов не работают правильно с этим прокси. Bun — известный пример.
  • Добавляет задержку при запуске: hooks запускаются каждый раз при запуске или возобновлении сессии, в отличие от setup scripts, которые получают выгоду от кэширования окружения. Держите скрипты установки быстрыми, проверяя, присутствуют ли зависимости, перед переустановкой.
Чтобы сохранить переменные окружения для последующих команд Bash, запишите в файл в $CLAUDE_ENV_FILE. См. SessionStart hooks для деталей. Замена базового образа вашим собственным образом Docker пока не поддерживается. Используйте setup script для установки того, что вам нужно поверх предоставленного образа, или запустите ваш образ как контейнер рядом с Claude с помощью docker compose.

Сетевой доступ

Сетевой доступ контролирует исходящие соединения из облачного окружения. Каждое окружение указывает один уровень доступа, и вы можете расширить его пользовательскими разрешёнными доменами. По умолчанию используется Trusted, который позволяет реестры пакетов и другие разрешённые домены. Чтобы изменить сетевой доступ окружения, откройте его для редактирования и используйте селектор Network access в диалоге. Нет отдельной страницы Environments. Значок облака появляется везде, где вы запускаете облачную сессию или настраиваете routine.
Трафик MCP connector маршрутизируется через серверы Anthropic, поэтому connectors, которые вы включаете на сессии или routine, работают без добавления их хостов в Allowed domains. Connectors настраиваются для каждой сессии или для каждой routine; удалите любые, которые вам не нужны, чтобы ограничить, какие инструменты Claude может достичь. Это полагается на тот же канал, привязанный к Anthropic, отмеченный в разделе Безопасность и изоляция.

Уровни доступа

Выберите уровень доступа при создании или редактировании окружения:
УровеньИсходящие соединения
NoneНет исходящего сетевого доступа
TrustedТолько разрешённые домены: реестры пакетов, GitHub, облачные SDK
FullЛюбой домен
CustomВаш собственный список разрешений, опционально включая значения по умолчанию
Операции GitHub используют отдельный прокси, который независим от этого параметра.

Разрешите конкретные домены

Чтобы разрешить домены, которые не в списке Trusted, выберите Custom в параметрах сетевого доступа окружения. Появляется поле Allowed domains. Введите один домен на строку:
api.example.com
*.internal.example.com
registry.example.com
Используйте *. для совпадения поддоменов с подстановочными знаками. Отметьте Also include default list of common package managers, чтобы сохранить Trusted домены вместе с вашими пользовательскими записями, или оставьте её без отметки, чтобы разрешить только то, что вы указали.

GitHub proxy

Для безопасности все операции GitHub проходят через выделённый сервис прокси, который прозрачно обрабатывает все взаимодействия git. Внутри песочницы клиент git аутентифицируется с помощью пользовательского ограниченного учётного данного. Этот прокси:
  • Безопасно управляет аутентификацией GitHub: клиент git использует ограниченное учётное данное внутри песочницы, которое прокси проверяет и переводит в ваш фактический токен аутентификации GitHub
  • Ограничивает операции git push к текущей рабочей ветке для безопасности
  • Обеспечивает беспрепятственное клонирование, получение и операции PR при сохранении границ безопасности

Security proxy

Окружения работают за HTTP/HTTPS сетевым прокси для целей безопасности и предотвращения злоупотреблений. Весь исходящий интернет-трафик проходит через этот прокси, который обеспечивает:
  • Защиту от вредоносных запросов
  • Ограничение скорости и предотвращение злоупотреблений
  • Фильтрацию контента для повышенной безопасности

Разрешённые домены по умолчанию

При использовании доступа в сеть Trusted следующие домены разрешены по умолчанию. Домены, отмеченные с *, указывают на совпадение поддоменов с подстановочными знаками, поэтому *.gcr.io позволяет любой поддомен gcr.io.
  • api.anthropic.com
  • statsig.anthropic.com
  • docs.claude.com
  • platform.claude.com
  • code.claude.com
  • claude.ai
  • github.com
  • www.github.com
  • api.github.com
  • npm.pkg.github.com
  • raw.githubusercontent.com
  • pkg-npm.githubusercontent.com
  • objects.githubusercontent.com
  • release-assets.githubusercontent.com
  • codeload.github.com
  • avatars.githubusercontent.com
  • camo.githubusercontent.com
  • gist.github.com
  • gitlab.com
  • www.gitlab.com
  • registry.gitlab.com
  • bitbucket.org
  • www.bitbucket.org
  • api.bitbucket.org
  • registry-1.docker.io
  • auth.docker.io
  • index.docker.io
  • hub.docker.com
  • www.docker.com
  • production.cloudflare.docker.com
  • download.docker.com
  • gcr.io
  • *.gcr.io
  • ghcr.io
  • mcr.microsoft.com
  • *.data.mcr.microsoft.com
  • public.ecr.aws
  • cloud.google.com
  • accounts.google.com
  • gcloud.google.com
  • *.googleapis.com
  • storage.googleapis.com
  • compute.googleapis.com
  • container.googleapis.com
  • azure.com
  • portal.azure.com
  • microsoft.com
  • www.microsoft.com
  • *.microsoftonline.com
  • packages.microsoft.com
  • dotnet.microsoft.com
  • dot.net
  • visualstudio.com
  • dev.azure.com
  • *.amazonaws.com
  • *.api.aws
  • oracle.com
  • www.oracle.com
  • java.com
  • www.java.com
  • java.net
  • www.java.net
  • download.oracle.com
  • yum.oracle.com
  • proxy.golang.org
  • sum.golang.org
  • index.golang.org
  • golang.org
  • www.golang.org
  • goproxy.io
  • pkg.go.dev
  • maven.org
  • repo.maven.org
  • central.maven.org
  • repo1.maven.org
  • repo.maven.apache.org
  • jcenter.bintray.com
  • gradle.org
  • www.gradle.org
  • services.gradle.org
  • plugins.gradle.org
  • kotlinlang.org
  • www.kotlinlang.org
  • spring.io
  • repo.spring.io
  • dl.k8s.io (Kubernetes)
  • pkgs.k8s.io
  • k8s.io
  • www.k8s.io
  • releases.hashicorp.com (HashiCorp)
  • apt.releases.hashicorp.com
  • rpm.releases.hashicorp.com
  • archive.releases.hashicorp.com
  • hashicorp.com
  • www.hashicorp.com
  • repo.anaconda.com (Anaconda/Conda)
  • conda.anaconda.org
  • anaconda.org
  • www.anaconda.com
  • anaconda.com
  • continuum.io
  • apache.org (Apache)
  • www.apache.org
  • archive.apache.org
  • downloads.apache.org
  • eclipse.org (Eclipse)
  • www.eclipse.org
  • download.eclipse.org
  • nodejs.org (Node.js)
  • www.nodejs.org
  • developer.apple.com
  • developer.android.com
  • pkg.stainless.com
  • binaries.prisma.sh
  • statsig.com
  • www.statsig.com
  • api.statsig.com
  • sentry.io
  • *.sentry.io
  • downloads.sentry-cdn.com
  • http-intake.logs.datadoghq.com
  • *.datadoghq.com
  • *.datadoghq.eu
  • api.honeycomb.io
  • sourceforge.net
  • *.sourceforge.net
  • packagecloud.io
  • *.packagecloud.io
  • fonts.googleapis.com
  • fonts.gstatic.com
  • *.modelcontextprotocol.io

Перемещение задач между веб-интерфейсом и терминалом

Эти рабочие процессы требуют Claude Code CLI, вошедшего в один и тот же аккаунт claude.ai. Вы можете запускать новые облачные сессии из вашего терминала или вытягивать облачные сессии в ваш терминал для продолжения локально. Облачные сессии сохраняются даже если вы закроете ваш ноутбук, и вы можете мониторить их откуда угодно, включая мобильное приложение Claude.
Из CLI передача сессии односторонняя: вы можете вытягивать облачные сессии в ваш терминал с помощью --teleport, но вы не можете отправить существующую сессию терминала в веб-интерфейс. Флаг --remote создаёт новую облачную сессию для вашего текущего репозитория. Desktop app предоставляет меню Continue in, которое может отправить локальную сессию в веб-интерфейс.

От терминала к веб-интерфейсу

Запустите облачную сессию из командной строки с флагом --remote:
claude --remote "Fix the authentication bug in src/auth/login.ts"
Это создаёт новую облачную сессию на claude.ai. Сессия клонирует удалённый GitHub вашего текущего каталога в вашей текущей ветке, поэтому сначала отправьте, если у вас есть локальные коммиты, так как виртуальная машина клонирует из GitHub, а не с вашей машины. --remote работает с одним репозиторием за раз. Задача запускается в облаке, пока вы продолжаете работать локально.
--remote создаёт облачные сессии. --remote-control не связан: он предоставляет локальную сессию CLI для мониторинга из веб-интерфейса. См. Remote Control.
Используйте /tasks в Claude Code CLI для проверки прогресса, или откройте сессию на claude.ai или в мобильном приложении Claude для прямого взаимодействия. Оттуда вы можете управлять Claude, предоставлять обратную связь или отвечать на вопросы, как в любом другом разговоре.

Советы для облачных задач

Планируйте локально, выполняйте удалённо: для сложных задач начните Claude в режиме плана для совместной работы над подходом, затем отправьте работу в облако:
claude --permission-mode plan
В режиме плана Claude читает файлы, запускает команды для исследования и предлагает план без редактирования исходного кода. Когда вы будете довольны, сохраните план в репозиторий, зафиксируйте и отправьте, чтобы облачная виртуальная машина могла его клонировать. Затем запустите облачную сессию для автономного выполнения:
claude --remote "Execute the migration plan in docs/migration-plan.md"
Этот паттерн даёт вам контроль над стратегией, позволяя Claude выполняться автономно в облаке. Планируйте в облаке с ultraplan: чтобы составить и просмотреть сам план в веб-сессии, используйте ultraplan. Claude генерирует план на Claude Code в веб-интерфейсе, пока вы продолжаете работать, затем вы комментируете разделы в вашем браузере и выбираете выполнение удалённо или отправку плана обратно в ваш терминал. Запускайте задачи параллельно: каждая команда --remote создаёт свою собственную облачную сессию, которая запускается независимо. Вы можете запустить несколько задач, и они все будут запускаться одновременно в отдельных сессиях:
claude --remote "Fix the flaky test in auth.spec.ts"
claude --remote "Update the API documentation"
claude --remote "Refactor the logger to use structured output"
Мониторьте все сессии с помощью /tasks в Claude Code CLI. Когда сессия завершится, вы можете создать PR из веб-интерфейса или телепортировать сессию в ваш терминал для продолжения работы.

Отправляйте локальные репозитории без GitHub

Когда вы запускаете claude --remote из репозитория, который не подключен к GitHub, Claude Code упаковывает ваш локальный репозиторий и загружает его непосредственно в облачную сессию. Пакет включает вашу полную историю репозитория во всех ветках, плюс любые незафиксированные изменения отслеживаемых файлов. Этот fallback активируется автоматически, когда доступ GitHub недоступен. Чтобы принудительно использовать его даже когда GitHub подключен, установите CCR_FORCE_BUNDLE=1:
CCR_FORCE_BUNDLE=1 claude --remote "Run the test suite and fix any failures"
Упакованные репозитории должны соответствовать этим ограничениям:
  • Каталог должен быть git репозиторием с по крайней мере одним коммитом
  • Упакованный репозиторий должен быть менее 100 МБ. Большие репозитории переходят к упаковке только текущей ветки, затем к одному сжатому снимку рабочего дерева и не пройдут только если снимок всё ещё слишком большой
  • Неотслеживаемые файлы не включены; запустите git add на файлы, которые вы хотите, чтобы облачная сессия видела
  • Сессии, созданные из пакета, не могут отправляться обратно на удалённый сервер, если у вас также не настроена аутентификация GitHub

От веб-интерфейса к терминалу

Вытягивайте облачную сессию в ваш терминал, используя любое из этих:
  • Используя --teleport: из командной строки запустите claude --teleport для интерактивного выбора сессии, или claude --teleport <session-id> для прямого возобновления конкретной сессии. Если у вас есть незафиксированные изменения, вам будет предложено сначала их спрятать.
  • Используя /teleport: внутри существующей сессии CLI запустите /teleport (или /tp) для открытия того же выбора сессии без перезагрузки Claude Code.
  • Из /tasks: запустите /tasks для просмотра ваших фоновых сессий, затем нажмите t для телепортирования в одну из них
  • Из веб-интерфейса: выберите Open in CLI для копирования команды, которую вы можете вставить в ваш терминал
Когда вы телепортируете сессию, Claude проверяет, что вы находитесь в правильном репозитории, получает и проверяет ветку из облачной сессии и загружает полную историю разговора в ваш терминал. --teleport отличается от --resume. --resume переоткрывает разговор из локальной истории этой машины и не перечисляет облачные сессии; --teleport вытягивает облачную сессию и её ветку.

Требования для телепортирования

Телепортирование проверяет эти требования перед возобновлением сессии. Если какое-либо требование не выполнено, вы увидите ошибку или будете приглашены разрешить проблему.
ТребованиеДетали
Чистое состояние gitВаш рабочий каталог должен не иметь незафиксированных изменений. Телепортирование предложит вам спрятать изменения, если необходимо.
Правильный репозиторийВы должны запустить --teleport из проверки того же репозитория, не форка.
Доступность веткиВетка из облачной сессии должна быть отправлена на удалённый сервер. Телепортирование автоматически получает и проверяет её.
Один и тот же аккаунтВы должны быть аутентифицированы на том же аккаунте claude.ai, который использовался в облачной сессии.

--teleport недоступен

Телепортирование требует аутентификации подписки claude.ai. Если вы аутентифицированы через API ключ, Bedrock, Vertex AI или Microsoft Foundry, запустите /login для входа с вашим аккаунтом claude.ai вместо этого. Если вы уже вошли через claude.ai и --teleport всё ещё недоступен, ваша организация может отключить облачные сессии.

Работа с сессиями

Сессии появляются в боковой панели на claude.ai/code. Оттуда вы можете просмотреть изменения, поделиться с товарищами по команде, архивировать завершённую работу или удалить сессии постоянно.

Управление контекстом

Облачные сессии поддерживают встроенные команды, которые производят текстовый вывод. Команды, которые открывают интерактивный выбор терминала, такие как /model или /config, недоступны. Для управления контекстом конкретно:
КомандаРаботает в облачных сессияхПримечания
/compactДаСуммирует разговор для освобождения контекста. Принимает опциональные инструкции фокуса, такие как /compact keep the test output
/contextДаПоказывает, что в настоящее время находится в окне контекста
/clearНетЗапустите новую сессию из боковой панели вместо этого
Auto-compaction запускается автоматически, когда окно контекста приближается к ёмкости, так же как в CLI. Чтобы запустить его раньше, установите CLAUDE_AUTOCOMPACT_PCT_OVERRIDE в ваши переменные окружения. Например, CLAUDE_AUTOCOMPACT_PCT_OVERRIDE=70 компактирует при 70% ёмкости вместо значения по умолчанию ~95%. Чтобы изменить эффективный размер окна для расчётов компактирования, используйте CLAUDE_CODE_AUTO_COMPACT_WINDOW. Subagents работают так же, как они работают локально. Claude может порождать их с помощью инструмента Task для разгрузки исследования или параллельной работы в отдельное окно контекста, сохраняя основной разговор легче. Subagents определённые в .claude/agents/ вашего репозитория подбираются автоматически. Agent teams отключены по умолчанию, но могут быть включены путём добавления CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 в ваши переменные окружения.

Просмотр изменений

Каждая сессия показывает индикатор diff с добавленными и удалёнными строками, например +42 -18. Выберите его для открытия представления diff, оставьте встроенные комментарии на конкретных строках и отправьте их Claude с вашим следующим сообщением. См. Review and iterate для полного пошагового руководства, включая создание PR. Чтобы Claude мониторил PR на сбои CI и комментарии рецензентов автоматически, см. Auto-fix pull requests.

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

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

Совместное использование из аккаунта Enterprise или Team

Для аккаунтов Enterprise и Team два варианта видимости — Private и Team. Видимость Team делает сессию видимой для других членов вашей организации claude.ai. Проверка доступа к репозиторию включена по умолчанию на основе аккаунта GitHub, подключённого к аккаунту получателя. Отображаемое имя вашего аккаунта видно всем получателям с доступом. Сессии Claude в Slack автоматически общаются с видимостью Team.

Совместное использование из аккаунта Max или Pro

Для аккаунтов Max и Pro два варианта видимости — Private и Public. Видимость Public делает сессию видимой для любого пользователя, вошедшего в claude.ai. Проверьте вашу сессию на чувствительный контент перед совместным использованием. Сессии могут содержать код и учётные данные из приватных репозиториев GitHub. Проверка доступа к репозиторию не включена по умолчанию. Чтобы требовать, чтобы получатели имели доступ к репозиторию, или скрыть своё имя из общих сессий, перейдите в Settings > Claude Code > Sharing settings.

Архивируйте сессии

Вы можете архивировать сессии, чтобы держать ваш список сессий организованным. Архивированные сессии скрыты из списка сессий по умолчанию, но могут быть просмотрены путём фильтрации архивированных сессий. Чтобы архивировать сессию, наведите курсор на сессию в боковой панели и выберите значок архива.

Удаляйте сессии

Удаление сессии постоянно удаляет сессию и её данные. Это действие не может быть отменено. Вы можете удалить сессию двумя способами:
  • Из боковой панели: отфильтруйте архивированные сессии, затем наведите курсор на сессию, которую вы хотите удалить, и выберите значок удаления
  • Из меню сессии: откройте сессию, выберите раскрывающееся меню рядом с названием сессии и выберите Delete
Вам будет предложено подтвердить перед удалением сессии.

Auto-fix pull requests

Claude может наблюдать за pull request и автоматически реагировать на сбои CI и комментарии рецензентов. Claude подписывается на активность GitHub в PR, и когда проверка не пройдена или рецензент оставляет комментарий, Claude исследует и отправляет исправление, если оно очевидно.
Auto-fix требует установки приложения Claude GitHub в вашем репозитории. Если вы ещё этого не сделали, установите его со страницы приложения GitHub или при появлении запроса во время настройки.
Есть несколько способов включить auto-fix в зависимости от того, откуда пришёл PR и какое устройство вы используете:
  • PR, созданные в Claude Code в веб-интерфейсе: откройте строку статуса CI и выберите Auto-fix
  • Из вашего терминала: запустите /autofix-pr на ветке PR. Claude Code обнаруживает открытый PR с помощью gh, порождает веб-сессию и включает auto-fix в один шаг
  • Из мобильного приложения: скажите Claude автоматически исправить PR, например “watch this PR and fix any CI failures or review comments”
  • Любой существующий PR: вставьте URL PR в сессию и скажите Claude автоматически исправить его
Auto-fix — это переключатель для каждого PR. Чтобы остановить мониторинг, откройте строку статуса CI в веб-сессии и отключите переключатель Auto-fix, или скажите Claude прекратить наблюдение за PR.

Как Claude реагирует на активность PR

Когда auto-fix активен, Claude получает события GitHub для PR, включая новые комментарии рецензентов и сбои проверок CI. Для каждого события Claude исследует и решает, как действовать:
  • Очевидные исправления: если Claude уверен в исправлении и оно не конфликтует с более ранними инструкциями, Claude вносит изменение, отправляет его и объясняет, что было сделано в сессии
  • Неоднозначные запросы: если комментарий рецензента может быть интерпретирован несколькими способами или касается чего-то архитектурно значимого, Claude спрашивает вас перед действием
  • Дублирующиеся или события без действия: если событие является дубликатом или не требует изменений, Claude отмечает это в сессии и продолжает
Claude может отвечать на потоки комментариев рецензентов на GitHub как часть их разрешения. Эти ответы публикуются с использованием вашего аккаунта GitHub, поэтому они появляются под вашим именем пользователя, но каждый ответ помечен как исходящий от Claude Code, чтобы рецензенты знали, что он был написан агентом, а не вами напрямую.
Если ваш репозиторий использует автоматизацию, запускаемую комментариями, такую как Atlantis, Terraform Cloud или пользовательские GitHub Actions, которые запускаются на событиях issue_comment, имейте в виду, что Claude может отвечать от вашего имени, что может запустить эти рабочие процессы. Проверьте автоматизацию вашего репозитория перед включением auto-fix и рассмотрите отключение auto-fix для репозиториев, где комментарий PR может развернуть инфраструктуру или запустить привилегированные операции.

Безопасность и изоляция

Каждая облачная сессия отделена от вашей машины и от других сессий через несколько слоёв:
  • Изолированные виртуальные машины: каждая сессия запускается в изолированной виртуальной машине, управляемой Anthropic
  • Элементы управления сетевым доступом: сетевой доступ ограничен по умолчанию и может быть отключен. При запуске с отключённым сетевым доступом Claude Code всё ещё может общаться с API Anthropic, что может позволить данным выйти из виртуальной машины.
  • Защита учётных данных: чувствительные учётные данные, такие как учётные данные git или ключи подписи, никогда не находятся в песочнице с Claude Code. Аутентификация обрабатывается через защищённый прокси с использованием ограниченных учётных данных.
  • Безопасный анализ: код анализируется и изменяется в изолированных виртуальных машинах перед созданием PR

Troubleshooting

Для ошибок API времени выполнения, которые появляются в разговоре, такие как API Error: 500, 529 Overloaded, 429 или Prompt is too long, см. Error reference. Эти ошибки и их исправления общие с CLI и Desktop app. Разделы ниже охватывают проблемы, специфичные для облачных сессий.

Session creation failed

Если новая сессия не запускается с Session creation failed или зависает при подготовке, Claude Code не смог выделить облачное окружение.
  • Проверьте status.claude.com на предмет инцидентов облачных сессий
  • Повторите попытку через минуту, так как ёмкость подготавливается по требованию
  • Подтвердите, что ваш репозиторий доступен. Подключаемый аккаунт GitHub должен иметь доступ к репозиторию на GitHub либо через авторизацию Claude GitHub App, либо через токен gh, синхронизированный через /web-setup — установка приложения на репозиторий не требуется. См. Варианты аутентификации GitHub.

Remote Control session expired or access denied

--teleport подключается через ту же инфраструктуру сессии Remote Control, которую используют облачные сессии, поэтому ошибки аутентификации и истечения сессии появляются с формулировкой Remote Control. Вы можете увидеть Remote Control session expired или Access denied. Токен соединения имеет короткий срок действия и ограничен вашим аккаунтом.
  • Запустите /login локально для обновления ваших учётных данных, затем переподключитесь
  • Подтвердите, что вы вошли в один и тот же аккаунт, который владеет сессией
  • Если вы видите Remote Control may not be available for this organization, ваш администратор не включил удалённые сессии для вашего плана

Environment expired

Облачные сессии останавливаются после периода неактивности и базовое окружение отзывается. Из локального терминала это появляется как Could not resume session ... its environment has expired. Creating a fresh session instead. На веб-интерфейсе сессия помечена как истекшая в списке сессий. Переоткройте сессию из claude.ai/code для подготовки свежего окружения с восстановленной историей разговора.

Ограничения

Перед тем как полагаться на облачные сессии для рабочего процесса, учтите эти ограничения:
  • Ограничения скорости: Claude Code в веб-интерфейсе делит ограничения скорости со всеми другими использованиями Claude и Claude Code в вашем аккаунте. Запуск нескольких задач параллельно потребляет больше ограничений скорости пропорционально. Нет отдельной платы за вычисления для облачной виртуальной машины.
  • Аутентификация репозитория: вы можете перемещать сессии из веб-интерфейса в локальный только когда вы аутентифицированы на одном и том же аккаунте
  • Ограничения платформы: клонирование репозитория и создание pull request требуют GitHub. Самостоятельно размещённые экземпляры GitHub Enterprise Server поддерживаются для планов Team и Enterprise. Репозитории GitLab, Bitbucket и другие не-GitHub репозитории могут быть отправлены в облачные сессии как локальный пакет, но сессия не может отправлять результаты обратно на удалённый сервер
  • Список разрешений IP организации: облачные сессии вызывают API Anthropic из инфраструктуры, управляемой Anthropic, а не из вашей сети. Если ваша организация имеет IP allowlisting включённый, каждая облачная сессия не пройдёт с ошибкой аутентификации. То же самое применяется к Code Review и Routines. Свяжитесь с поддержкой Anthropic для исключения размещённых Anthropic сервисов из списка разрешений IP вашей организации.

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

  • Ultraplan: составьте план в облачной сессии и просмотрите его в вашем браузере
  • Ultrareview: запустите глубокий многоагентный обзор кода в облачной песочнице
  • Routines: автоматизируйте работу по расписанию, через вызов API или в ответ на события GitHub
  • Конфигурация Hooks: запускайте скрипты при событиях жизненного цикла сессии
  • Справочник параметров: все параметры конфигурации
  • Безопасность: гарантии изоляции и обработка данных
  • Использование данных: что Anthropic сохраняет из облачных сессий