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.
- Варианты аутентификации GitHub: два способа подключения GitHub
- Облачное окружение: какая конфигурация переносится, какие инструменты установлены и как настроить окружения
- Setup scripts и управление зависимостями
- Сетевой доступ: уровни, прокси и список разрешений по умолчанию
- Перемещение задач между веб-интерфейсом и терминалом с помощью
--remoteи--teleport - Работа с сессиями: просмотр, совместное использование, архивирование, удаление
- Auto-fix pull requests: автоматический ответ на сбои CI и комментарии рецензентов
- Безопасность и изоляция: как сессии изолированы
- Ограничения: ограничения скорости и ограничения платформы
Варианты аутентификации GitHub
Облачным сессиям нужен доступ к вашим репозиториям GitHub для клонирования кода и отправки веток. Вы можете предоставить доступ двумя способами:| Метод | Как это работает | Лучше всего для |
|---|---|---|
| GitHub App | Авторизуйте приложение Claude GitHub во время веб-подключения. | Веб-подключение в браузере; команды, которые хотят Auto-fix |
/web-setup | Запустите /web-setup в вашем терминале для синхронизации вашего локального токена gh CLI с вашим аккаунтом Claude. | Отдельные разработчики, которые уже используют gh |
/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.
/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 требует входа на основе браузера, который не может работать в облачной сессии |
Установленные инструменты
Облачные сессии поставляются с предустановленными распространёнными средами выполнения языков, инструментами сборки и базами данных. Таблица ниже суммирует, что включено по категориям.| Категория | Включено |
|---|---|
| Python | Python 3.x с pip, poetry, uv, black, mypy, pytest, ruff |
| Node.js | 20, 21 и 22 через nvm, с npm, yarn, pnpm, bun¹, eslint, prettier, chromedriver |
| Ruby | 3.1, 3.2, 3.3 с gem, bundler, rbenv |
| PHP | 8.4 с Composer |
| Java | OpenJDK 21 с Maven и Gradle |
| Go | последняя стабильная версия с поддержкой модулей |
| Rust | rustc и cargo |
| C/C++ | GCC, Clang, cmake, ninja, conan |
| Docker | docker, dockerd, docker compose |
| Databases | PostgreSQL 16, Redis 7.0 |
| Utilities | git, jq, yq, ripgrep, tmux, vim, nano |
check-tools в облачной сессии. Эта команда существует только в облачных сессиях.
Работа с проблемами GitHub и pull requests
Облачные сессии включают встроенные инструменты GitHub, которые позволяют Claude читать проблемы, перечислять pull requests, получать diffs и публиковать комментарии без какой-либо настройки. Эти инструменты аутентифицируются через GitHub proxy, используя любой метод, который вы настроили в разделе Варианты аутентификации GitHub, поэтому ваш токен никогда не входит в контейнер. CLIgh не предустановлен. Если вам нужна команда gh, которую встроенные инструменты не охватывают, например gh release или gh workflow run, установите и аутентифицируйте её самостоятельно:
Установите gh в ваш setup script
apt update && apt install -y gh в ваш setup script.Предоставьте токен
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:
Запускайте тесты, запускайте сервисы и добавляйте пакеты
Claude запускает тесты как часть работы над задачей. Попросите это в вашей подсказке, например “fix the failing tests intests/” или “run pytest after each change.” Средства запуска тестов, такие как pytest, jest и cargo test, работают из коробки, так как они предустановлены.
PostgreSQL и Redis предустановлены, но не запущены по умолчанию. Попросите Claude запустить каждый во время сессии:
docker compose up для запуска сервисов вашего проекта. Сетевой доступ для получения образов следует вашему окружению уровень доступа, и Доверенные значения по умолчанию включают Docker Hub и другие распространённые реестры.
Если ваши образы большие или медленно загружаются, добавьте docker compose pull или docker compose build в ваш setup script. Полученные образы сохраняются в кэшированном окружении, поэтому каждая новая сессия имеет их на диске. Кэш хранит только файлы, не запущенные процессы, поэтому Claude всё ещё запускает контейнеры каждую сессию.
Чтобы добавить пакеты, которые не предустановлены, используйте setup script. Вывод скрипта кэшируется, поэтому пакеты, которые вы устанавливаете там, доступны в начале каждой сессии без переустановки каждый раз. Вы также можете попросить Claude установить пакеты во время сессии, но эти установки не сохраняются между сессиями.
Ограничения ресурсов
Облачные сессии работают с приблизительными потолками ресурсов, которые могут меняться со временем:- 4 vCPU
- 16 ГБ оперативной памяти
- 30 ГБ диска
Настройте ваше окружение
Окружения контролируют сетевой доступ, переменные окружения и setup script, который запускается перед запуском сессии. См. Установленные инструменты для того, что доступно без какой-либо конфигурации. Вы можете управлять окружениями из веб-интерфейса или терминала:| Действие | Как |
|---|---|
| Добавить окружение | Выберите текущее окружение, чтобы открыть селектор, затем выберите Add environment. Диалог включает имя, уровень сетевого доступа, переменные окружения и setup script. |
| Отредактировать окружение | Выберите значок облака, показывающий имя текущего окружения, чтобы открыть селектор, наведите курсор на окружение и нажмите значок параметров, который появляется справа. |
| Архивировать окружение | Откройте окружение для редактирования и выберите Archive. Архивированные окружения скрыты из селектора, но существующие сессии продолжают работать. |
Установить значение по умолчанию для --remote | Запустите /remote-env в вашем терминале. Если у вас одно окружение, эта команда показывает вашу текущую конфигурацию. /remote-env только выбирает значение по умолчанию; добавляйте, редактируйте и архивируйте окружения из веб-интерфейса. |
.env с одной парой KEY=value на строку. Не оборачивайте значения в кавычки, так как кавычки хранятся как часть значения.
Setup scripts
Setup script — это Bash скрипт, который запускается при запуске новой облачной сессии, перед запуском Claude Code. Используйте setup scripts для установки зависимостей, настройки инструментов или получения чего-либо, что сессии нужно, но что не предустановлено. Скрипты запускаются от имени root на Ubuntu 24.04, поэтомуapt install и большинство менеджеров пакетов языков работают.
Чтобы добавить setup script, откройте диалог параметров окружения и введите ваш скрипт в поле Setup script.
Этот пример устанавливает CLI gh, который не предустановлен:
|| true к некритичным командам, чтобы избежать блокирования сессии при нестабильной установке.
Держите общее время выполнения скрипта ниже примерно пяти минут, чтобы кэш окружения мог построиться. Запускайте независимые установки параллельно с & и wait. Если одна загрузка не поместится в пятиминутный лимит, переместите её в SessionStart hook, который запускает её в фоновом режиме.
Кэширование окружения
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 scripts | SessionStart hooks | |
|---|---|---|
| Прикреплено к | Облачному окружению | Вашему репозиторию |
| Настроено в | Пользовательском интерфейсе облачного окружения | .claude/settings.json в вашем репозитории |
| Запускается | Перед запуском Claude Code, когда нет кэшированного окружения | После запуска Claude Code, на каждой сессии, включая возобновлённые |
| Область | Только облачные окружения | Как локальные, так и облачные |
~/.claude/settings.json локально, но пользовательские параметры не переносятся в облачные сессии. В облаке запускаются только hooks, зафиксированные в репозитории.
Установите зависимости с помощью SessionStart hook
Чтобы установить зависимости только в облачных сессиях, добавьте SessionStart hook в.claude/settings.json вашего репозитория:
scripts/install_pkgs.sh и сделайте его исполняемым с помощью chmod +x. Переменная окружения CLAUDE_CODE_REMOTE установлена в true в облачных сессиях, поэтому вы можете использовать её для пропуска локального выполнения:
- Нет облачного ограничения области: hooks запускаются как в локальных, так и в облачных сессиях. Чтобы пропустить локальное выполнение, проверьте переменную окружения
CLAUDE_CODE_REMOTE, как показано выше. - Требует сетевой доступ: команды установки нуждаются в доступе к реестрам пакетов. Если ваше окружение использует доступ в сеть None, эти hooks не будут работать. Список разрешений по умолчанию под Trusted охватывает npm, PyPI, RubyGems и crates.io.
- Совместимость с прокси: весь исходящий трафик проходит через security proxy. Некоторые менеджеры пакетов не работают правильно с этим прокси. Bun — известный пример.
- Добавляет задержку при запуске: hooks запускаются каждый раз при запуске или возобновлении сессии, в отличие от setup scripts, которые получают выгоду от кэширования окружения. Держите скрипты установки быстрыми, проверяя, присутствуют ли зависимости, перед переустановкой.
$CLAUDE_ENV_FILE. См. SessionStart hooks для деталей.
Замена базового образа вашим собственным образом Docker пока не поддерживается. Используйте setup script для установки того, что вам нужно поверх предоставленного образа, или запустите ваш образ как контейнер рядом с Claude с помощью docker compose.
Сетевой доступ
Сетевой доступ контролирует исходящие соединения из облачного окружения. Каждое окружение указывает один уровень доступа, и вы можете расширить его пользовательскими разрешёнными доменами. По умолчанию используется Trusted, который позволяет реестры пакетов и другие разрешённые домены. Чтобы изменить сетевой доступ окружения, откройте его для редактирования и используйте селектор Network access в диалоге. Нет отдельной страницы Environments. Значок облака появляется везде, где вы запускаете облачную сессию или настраиваете routine.Уровни доступа
Выберите уровень доступа при создании или редактировании окружения:| Уровень | Исходящие соединения |
|---|---|
| None | Нет исходящего сетевого доступа |
| Trusted | Только разрешённые домены: реестры пакетов, GitHub, облачные SDK |
| Full | Любой домен |
| Custom | Ваш собственный список разрешений, опционально включая значения по умолчанию |
Разрешите конкретные домены
Чтобы разрешить домены, которые не в списке Trusted, выберите Custom в параметрах сетевого доступа окружения. Появляется поле Allowed domains. Введите один домен на строку:*. для совпадения поддоменов с подстановочными знаками. Отметьте 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.
Сервисы Anthropic
Сервисы Anthropic
- 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
Менеджеры пакетов JavaScript и Node
Менеджеры пакетов JavaScript и Node
- registry.npmjs.org
- www.npmjs.com
- www.npmjs.org
- npmjs.com
- npmjs.org
- yarnpkg.com
- registry.yarnpkg.com
Менеджеры пакетов Python
Менеджеры пакетов Python
- pypi.org
- www.pypi.org
- files.pythonhosted.org
- pythonhosted.org
- test.pypi.org
- pypi.python.org
- pypa.io
- www.pypa.io
Менеджеры пакетов Ruby
Менеджеры пакетов Ruby
- rubygems.org
- www.rubygems.org
- api.rubygems.org
- index.rubygems.org
- ruby-lang.org
- www.ruby-lang.org
- rubyforge.org
- www.rubyforge.org
- rubyonrails.org
- www.rubyonrails.org
- rvm.io
- get.rvm.io
Менеджеры пакетов Rust
Менеджеры пакетов Rust
- crates.io
- www.crates.io
- index.crates.io
- static.crates.io
- rustup.rs
- static.rust-lang.org
- www.rust-lang.org
Менеджеры пакетов Go
Менеджеры пакетов Go
- proxy.golang.org
- sum.golang.org
- index.golang.org
- golang.org
- www.golang.org
- goproxy.io
- pkg.go.dev
Менеджеры пакетов JVM
Менеджеры пакетов JVM
- 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
Другие менеджеры пакетов
Другие менеджеры пакетов
- packagist.org (PHP Composer)
- www.packagist.org
- repo.packagist.org
- nuget.org (.NET NuGet)
- www.nuget.org
- api.nuget.org
- pub.dev (Dart/Flutter)
- api.pub.dev
- hex.pm (Elixir/Erlang)
- www.hex.pm
- cpan.org (Perl CPAN)
- www.cpan.org
- metacpan.org
- www.metacpan.org
- api.metacpan.org
- cocoapods.org (iOS/macOS)
- www.cocoapods.org
- cdn.cocoapods.org
- haskell.org
- www.haskell.org
- hackage.haskell.org
- swift.org
- www.swift.org
Дистрибутивы Linux
Дистрибутивы Linux
- archive.ubuntu.com
- security.ubuntu.com
- ubuntu.com
- www.ubuntu.com
- *.ubuntu.com
- ppa.launchpad.net
- launchpad.net
- www.launchpad.net
- *.nixos.org
Инструменты разработки и платформы
Инструменты разработки и платформы
- 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
Схема и конфигурация
Схема и конфигурация
- json-schema.org
- www.json-schema.org
- json.schemastore.org
- www.schemastore.org
Model Context Protocol
Model Context Protocol
- *.modelcontextprotocol.io
Перемещение задач между веб-интерфейсом и терминалом
Эти рабочие процессы требуют Claude Code CLI, вошедшего в один и тот же аккаунт claude.ai. Вы можете запускать новые облачные сессии из вашего терминала или вытягивать облачные сессии в ваш терминал для продолжения локально. Облачные сессии сохраняются даже если вы закроете ваш ноутбук, и вы можете мониторить их откуда угодно, включая мобильное приложение Claude.--teleport, но вы не можете отправить существующую сессию терминала в веб-интерфейс. Флаг --remote создаёт новую облачную сессию для вашего текущего репозитория. Desktop app предоставляет меню Continue in, которое может отправить локальную сессию в веб-интерфейс.От терминала к веб-интерфейсу
Запустите облачную сессию из командной строки с флагом--remote:
--remote работает с одним репозиторием за раз. Задача запускается в облаке, пока вы продолжаете работать локально.
--remote создаёт облачные сессии. --remote-control не связан: он предоставляет локальную сессию CLI для мониторинга из веб-интерфейса. См. Remote Control./tasks в Claude Code CLI для проверки прогресса, или откройте сессию на claude.ai или в мобильном приложении Claude для прямого взаимодействия. Оттуда вы можете управлять Claude, предоставлять обратную связь или отвечать на вопросы, как в любом другом разговоре.
Советы для облачных задач
Планируйте локально, выполняйте удалённо: для сложных задач начните Claude в режиме плана для совместной работы над подходом, затем отправьте работу в облако:--remote создаёт свою собственную облачную сессию, которая запускается независимо. Вы можете запустить несколько задач, и они все будут запускаться одновременно в отдельных сессиях:
/tasks в Claude Code CLI. Когда сессия завершится, вы можете создать PR из веб-интерфейса или телепортировать сессию в ваш терминал для продолжения работы.
Отправляйте локальные репозитории без GitHub
Когда вы запускаетеclaude --remote из репозитория, который не подключен к GitHub, Claude Code упаковывает ваш локальный репозиторий и загружает его непосредственно в облачную сессию. Пакет включает вашу полную историю репозитория во всех ветках, плюс любые незафиксированные изменения отслеживаемых файлов.
Этот fallback активируется автоматически, когда доступ GitHub недоступен. Чтобы принудительно использовать его даже когда GitHub подключен, установите CCR_FORCE_BUNDLE=1:
- Каталог должен быть git репозиторием с по крайней мере одним коммитом
- Упакованный репозиторий должен быть менее 100 МБ. Большие репозитории переходят к упаковке только текущей ветки, затем к одному сжатому снимку рабочего дерева и не пройдут только если снимок всё ещё слишком большой
- Неотслеживаемые файлы не включены; запустите
git addна файлы, которые вы хотите, чтобы облачная сессия видела - Сессии, созданные из пакета, не могут отправляться обратно на удалённый сервер, если у вас также не настроена аутентификация GitHub
От веб-интерфейса к терминалу
Вытягивайте облачную сессию в ваш терминал, используя любое из этих:- Используя
--teleport: из командной строки запуститеclaude --teleportдля интерактивного выбора сессии, илиclaude --teleport <session-id>для прямого возобновления конкретной сессии. Если у вас есть незафиксированные изменения, вам будет предложено сначала их спрятать. - Используя
/teleport: внутри существующей сессии CLI запустите/teleport(или/tp) для открытия того же выбора сессии без перезагрузки Claude Code. - Из
/tasks: запустите/tasksдля просмотра ваших фоновых сессий, затем нажмитеtдля телепортирования в одну из них - Из веб-интерфейса: выберите Open in CLI для копирования команды, которую вы можете вставить в ваш терминал
--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 | Нет | Запустите новую сессию из боковой панели вместо этого |
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 исследует и отправляет исправление, если оно очевидно.- 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 автоматически исправить его
Как Claude реагирует на активность PR
Когда auto-fix активен, Claude получает события GitHub для PR, включая новые комментарии рецензентов и сбои проверок CI. Для каждого события Claude исследует и решает, как действовать:- Очевидные исправления: если Claude уверен в исправлении и оно не конфликтует с более ранними инструкциями, Claude вносит изменение, отправляет его и объясняет, что было сделано в сессии
- Неоднозначные запросы: если комментарий рецензента может быть интерпретирован несколькими способами или касается чего-то архитектурно значимого, Claude спрашивает вас перед действием
- Дублирующиеся или события без действия: если событие является дубликатом или не требует изменений, Claude отмечает это в сессии и продолжает
Безопасность и изоляция
Каждая облачная сессия отделена от вашей машины и от других сессий через несколько слоёв:- Изолированные виртуальные машины: каждая сессия запускается в изолированной виртуальной машине, управляемой 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 сохраняет из облачных сессий