Настройка облачных сред

• Приложение Desktop
• Мобильное приложение Claude
• Ваш браузер на claude.ai/code
• Терминал с claude --cloud
• Облачные запланированные задачи
• Claude Tag

​

Среда Default

• Потоки CLI, такие как /web-setup: создают Default для вас
• Веб-подключение на Pro и Max: создаёт Default для вас
• Веб-подключение на Team и Enterprise: показывает форму Create your first cloud environment, если владелец не включил Quick setup; сохраните значения по умолчанию в форме и нажмите Create & finish, чтобы получить ту же среду Default

• Trusted доступ в сеть: сеансы достигают реестров пакетов и других разрешённых доменов, и ничего больше через сеть сеанса.
• Никакой другой конфигурации: Default не определяет переменные окружения или скрипт установки, поэтому сеансы начинаются только с предустановленных инструментов.

• На приложении Desktop, мобильном приложении и на claude.ai/code сеансы, которые вы запускаете сами, используют среду, показанную в селекторе. Организационное значение по умолчанию, установленное владельцем, заполняет выбор, когда вы не выбрали ничего. Потоки в проекте используют среду, установленную в параметрах проекта.
• Из CLI Claude Code использует ваш выбор /remote-env, или возвращается к среде, размещённой Anthropic, когда ваш список имеет одну, и в противном случае к первой среде в вашем списке, которая не является мостовой средой, записью Remote Control, которую регистрирует для представления вашей собственной машины, а не облачной среды. Для самостоятельно размещённой среды передача --environment <environment-id> с её ccpool_ ID когда вы отправляете сеанс переопределяет выбор /remote-env и резервный вариант для этого вызова. Claude Code отклоняет размещённые Anthropic env_ ID, переданные флагу, поэтому используйте /remote-env для их целевого назначения. Флаг требует Claude Code v2.1.224 или позже.

​

Настройка вашей среды

​

Установка переменных окружения

NODE_ENV=development
LOG_LEVEL=debug
DATABASE_URL=postgres://localhost:5432/myapp

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

​

Добавление сетевых секретов

​

Требования

• Роль: на планах Pro, Max и Team вы можете добавлять и удалять секреты в своих собственных средах независимо от вашей роли. На Team и Enterprise пользователи с ролью Owner имеют роль администратора организации в вашей организации claude.ai, а пользователи с ролью Admin — нет, что меняет то, что вы видите в следующих случаях:
  • Ваша собственная среда на Enterprise: с ролью администратора организации вы добавляете и удаляете секреты. Без неё строка Network secrets открывает список секретов с примечанием «Only an organization admin can add or delete network secrets», без кнопки Add secret и кнопки удаления. Попросите пользователя с ролью Owner добавить секрет в общую среду, а затем запускайте свои сессии там
  • Общая среда: пользователи с ролью Owner добавляют и удаляют её секреты в настройках администратора. Без роли администратора организации попросите пользователя с ролью Owner добавить секрет, потому что в диалоге среды нет раздела Network secrets
  • Ваша собственная среда на Team: без роли администратора организации кнопка Add secret открывает сокращённую форму, которая принимает один хост
• Тип среды: облачная среда, размещённая Anthropic, которая уже существует. У самостоятельно размещённой среды нет сетевых секретов
• Доступность API: API принимает соединения из интернета, потому что запросы выходят из сети Anthropic
• Ключи шифрования: если ваша организация использует управляемые клиентом ключи шифрования, вы не можете сохранять сетевые секреты

​

Добавление секрета

​

Добавление секрета на плане Team без роли администратора организации

• Host: единственный хост, который получает секрет, например api.example.com. Форма не принимает подстановочный знак *.
• Name: необязательная метка для секрета
• Secret type: Token для ключа, который передаётся в заголовке запроса, или Username and password. Для токена вставьте ключ в качестве Value

​

Какие запросы получают секрет

​

Запросы, которые никогда не получают секрет

• GitHub: запросы к GitHub вместо этого аутентифицирует прокси GitHub, поэтому сетевой секрет для него не нужен
• API Anthropic и общедоступные реестры пакетов: api.anthropic.com, registry.npmjs.org, jsr.io, npm.jsr.io, pypi.org, files.pythonhosted.org, index.crates.io и proxy.golang.org
• Запросы скрипта установки: Claude Code подключается к прокси агента, когда он запускается, после того как скрипт установки запустился
• Экспорт телеметрии Claude Code: Claude Code отправляет свой экспорт телеметрии сам, а не через команду, которую он запускает, и этот запрос не проходит через прокси агента

​

Выбор среды из CLI

​

Архивирование среды

• Сеансы, которые уже работают в среде, продолжают работать.
• Среда исчезает из селектора и из /remote-env, поэтому вы не можете выбрать её для новых сеансов.
• Сетевые секреты среды остаются прикреплёнными в её работающих сессиях. Перед архивированием удалите те, которые вам больше не нужны.
• Ни одна новая сессия не может запуститься в архивированной среде ни в одном интерфейсе:
  • Сохранённое значение по умолчанию CLI: если среда была вашим сохранённым значением по умолчанию CLI, Claude Code запускает облачные сессии CLI в среде, размещённой Anthropic, если такая есть в вашем списке. В противном случае он запускает их в первой среде вашего списка, которая не является мостовой средой Remote Control.
  • Явная настройка: всё, что явно настроено на эту среду, например облачная запланированная задача, не может запускать в ней новые сессии. Укажите для него другую среду.

​

Общие среды организации

• Создание общей среды: используйте страницу Cloud environments в параметрах администратора, которая также является местом, где владельцы редактируют и архивируют общие среды. Каждая имеет имя, уровень доступа в сеть, переменные окружения в формате .env и скрипт установки.
• Совместное использование личной среды: откройте одну из ваших собственных сред для редактирования в селекторе среды, затем поделитесь ею из строки Who can use it. Среда сохраняет свой ID, поэтому сессии и запланированные задачи, которые уже её используют, не затрагиваются, и каждый член может затем её видеть и запускать в ней сессии.

​

Установка среды, которую использует канал Claude Tag

• Установите общую или самостоятельно размещённую среду как среду по умолчанию организации на claude.ai/admin-settings/claude-code.
• Закрепите одну на канале в параметрах администратора Claude Tag.

​

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

​

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

• GitHub, через его отдельный прокси
• Соединители MCP, которые вы включаете, трафик которых проходит через серверы Anthropic
• Хосты, которые вы указали в сетевых секретах среды, кроме хостов, которые никогда не получают секрет
• API Anthropic, для собственных запросов Claude Code, даже при None, как отмечено в разделе Безопасность и изоляция

​

Разрешить определённые домены

api.example.com
*.internal.example.com
registry.example.com

• Сеансы в этой среде открывают публичные артефакты другой организации: Claude Code получает их с хоста напрямую, поэтому добавьте его в этот список.
• Вы настраиваете локальный CLI или самостоятельно размещённый runner: сохраняйте хост в этом списке разрешённых. См. требования к сетевому доступу и требования к сетевому доступу самостоятельно размещённого сетевые требования.

​

Прокси GitHub

• Учётные данные Git: git-клиент внутри виртуальной машины использует ограниченные учётные данные, которые прокси проверяет и заменяет на ваш реальный токен GitHub.
• Запросы API: запросы от встроенных инструментов GitHub и от gh под заполнителем proxy-injected отправляются с подставленными вашими реальными учётными данными.
• Ограничения push: прокси отклоняет удаление веток и push чего-либо, кроме ветки, например тега. Он не ограничивает, какие ветки может обновлять push. Для этого используйте правила защиты веток или rulesets на GitHub.
• Область действия репозиториев: прокси обслуживает запросы GitHub API для репозиториев, прикреплённых к сессии. Запрос API к другому репозиторию получает 403 с сообщением, которое начинается с GitHub access to и содержит is not enabled for this session. Архив исходного кода, который вы загружаете по URL github.com/{owner}/{repo}/archive/ или codeload.github.com, получает ту же ошибку 403, если репозиторий не прикреплён, даже если он публичный.
• Ограничения GraphQL: прокси отклоняет запросы к эндпоинту GraphQL GitHub с ошибкой 403, сообщение которой начинается с GitHub GraphQL is not available from Claude Code sessions и указывает резервный вариант REST, gh api repos/{owner}/{repo}/.... Подкоманды gh, использующие GraphQL, такие как gh pr и gh issue, получают ту же ошибку 403. Ограничение применяется к каждому запросу через прокси независимо от предоставленных вами учётных данных, поэтому установленный вами GH_TOKEN получает ту же ошибку 403. Claude не может обратиться через прокси к API GitHub, которые существуют только в GraphQL, например Projects v2.

​

Прокси безопасности

• Защиту от вредоносных запросов
• Ограничение скорости и предотвращение злоупотреблений

​

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

​

Что переносится из вашей конфигурации

​

Добавление личных предпочтений без коммита в репозиторий

#!/bin/bash
mkdir -p ~/.claude
cat > ~/.claude/CLAUDE.md <<'EOF'
Use conventional commit messages.
EOF

​

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

​

Работа с issues и pull requests GitHub

• Если вы задали токен, он передаётся в контейнер без изменений, поэтому ваши скрипты и gh CLI от GitHub используют его напрямую.
• Если вы не задали ни одну из переменных и аутентификацию для вашей сессии выполняет прокси GitHub, обе переменные в командах, которые выполняет Claude, содержат строку-заполнитель proxy-injected, а прокси подставляет ваши реальные учётные данные в исходящие запросы к GitHub. Вызовы gh api для подключённых репозиториев работают без вашего собственного токена, но скрипт, который читает GITHUB_TOKEN напрямую, получает заполнитель, а не пригодный для использования токен.

​

Связь результатов с сессией

echo "https://claude.ai/code/${CLAUDE_CODE_REMOTE_SESSION_ID/#cse_/session_}"

​

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

​

Запуск тестов

​

Запуск сервисов

service postgresql start

service redis-server start

​

Добавление пакетов

​

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

• 4 vCPU
• 16 ГБ оперативной памяти
• 30 ГБ дискового пространства

​

Ограничения времени

• Команды, которые выполняет Claude: облачная среда не задаёт собственный таймаут команд, поэтому применяются значения по умолчанию инструмента Bash. По умолчанию Claude ждёт команду переднего плана 2 минуты и может запросить до 10 минут. Когда команда достигает своего таймаута, Claude Code переводит её в фоновый режим, а не останавливает, если только команда не начинается с sleep. Команда, переведённая таким образом, может продолжать работать ещё до 30 минут, после чего Claude Code останавливает её по достижении ограничения времени для фоновых команд. Установка BASH_DEFAULT_TIMEOUT_MS выше 1800000 миллисекунд увеличивает это ограничение, а также значение по умолчанию для команд переднего плана.
• Хуки SessionStart: Claude Code отменяет хук command через 600 секунд, если вы не задали timeout в секундах в записи хука. Claude Code не применяет таймаут к хуку, который вы запускаете с async: true.
• Скрипт настройки: скрипт, выполнение которого занимает больше примерно пяти минут, не кэшируется. О том, как уложиться в это время, рассказывается в разделе Требования к скрипту.
• Неактивные сессии: после нескольких минут без активности виртуальная машина сессии приостанавливается с сохранением файлов, а приостановленная виртуальная машина позже может быть освобождена. В разделе Установка переменных окружения описано, что сессия подхватывает в каждом случае, а в разделе Environment expired — как заново открыть сессию, виртуальная машина которой была освобождена.

​

Скрипты установки

​

Добавление скрипта установки

#!/bin/bash
apt update && apt install -y shellcheck

​

Требования к скрипту

• Выход с нулём: если скрипт выходит с ненулевым значением, сеанс не запускается. Добавьте || true к некритичным командам, чтобы перебой установки не блокировал сеанс.
• Завершение в течение пяти минут: держите общее время выполнения скрипта примерно под пять минут, чтобы кэш среды мог построиться. Когда установка занимает больше времени, среда не кэшируется. Запускайте независимые установки параллельно с & и wait, и переместите любую одиночную загрузку, которая не подходит, в SessionStart hook, который запускает её в фоне. Если новые сеансы зависают или не удаются во время установки, смотрите New sessions hang or time out during setup.
• Сетевой доступ для установок: установки пакетов должны достичь реестров. Уровень Trusted по умолчанию охватывает общие реестры пакетов, включая npm, PyPI, RubyGems и crates.io; с None сетевым доступом установки не удаются.
• Переменные среды ещё не заданы: скрипт запускается до того, как сессия задаёт переменные окружения среды. Задавайте все значения, которые нужны скрипту, в самом скрипте.

​

Кэширование среды

​

Скрипты установки против hooks SessionStart

• Среда, размещённая Anthropic: Claude Code запускает хуки из настроек, управляемых сервером вашей организации, а вне треда проекта — также из репозитория. Сессии Claude Tag не получают настройки, управляемые сервером, поэтому хуки из настроек, управляемых сервером, там не запускаются.
• Самостоятельно размещённая среда: Claude Code также запускает hooks, которые оператор посеял из ~/.claude/ хоста runner, и hooks в файле управляемых параметров образа runner, когда этот файл является одним из управляемых источников, которые применяет Claude Code.

​

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

{
  "hooks": {
    "SessionStart": [
      {
        "matcher": "startup|resume",
        "hooks": [
          {
            "type": "command",
            "command": "bash \"$CLAUDE_PROJECT_DIR\"/scripts/install_pkgs.sh"
          }
        ]
      }
    ]
  }
}

#!/bin/bash

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

cd "$CLAUDE_PROJECT_DIR" || exit 1
hashes=node_modules/.install_pkgs.sha256

if ! sha256sum --check --status "$hashes" 2>/dev/null; then
  # Delete the old hashes first, so a failed install runs again next time
  rm -f "$hashes"
  if npm install; then
    sha256sum scripts/install_pkgs.sh package.json package-lock.json > "$hashes" || rm -f "$hashes"
  fi
fi

# pip skips requirements that are already satisfied
pip install -r requirements.txt
exit 0

​

Ограничения в облачных сеансах

• Один репозиторий на сессию: в среде, размещённой Anthropic, сессия с несколькими репозиториями не загружает хуки из .claude/settings.json ни одного репозитория, поэтому определённый там хук SessionStart не запускается. Вместо этого устанавливайте зависимости для таких сессий с помощью скрипта установки. Для самостоятельно размещённой среды смотрите, настройки какого репозитория применяются.
• Не работают в облачных тредах проекта: облачный тред в проекте не запускает хуки из .claude/settings.json репозитория, независимо от количества репозиториев. В среде, размещённой Anthropic, устанавливайте зависимости для тредов с помощью скрипта установки. В самостоятельно размещённой среде вместо этого используйте хук в настройках хоста runner.
• Нет облачного ограничения: hooks запускаются в локальных и облачных сеансах. Чтобы пропустить локальное выполнение, выйдите рано, если переменная окружения CLAUDE_CODE_REMOTE не true, как показано в скрипте установки зависимостей.
• Требует сетевого доступа: команды установки должны достичь реестров пакетов. Если ваша среда использует None сетевой доступ, эти hooks не удаются. Список разрешений по умолчанию под Trusted охватывает npm, PyPI, RubyGems и crates.io.
• Совместимость с прокси: в среде, размещённой Anthropic, весь исходящий трафик проходит через прокси безопасности, и некоторые менеджеры пакетов не работают правильно с этим прокси; Bun — известный пример. В самостоятельно размещённой среде исходящий трафик проходит через вашу собственную границу сети вместо этого.
• Добавляет задержку запуска: хуки запускаются каждый раз, когда сессия запускается или возобновляется, в отличие от скриптов установки, которые выигрывают от кэширования среды. Держите скрипты установки быстрыми, пропуская уже выполненную работу, как это делает скрипт установки зависимостей.

​

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

​

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

• Cloud sessions reference: запуск, управление и совместное использование облачных сеансов
• Cloud sessions quickstart: подключение GitHub и запуск вашего первого облачного сеанса
• Claude Tag: сеансы, которые Claude запускает из Slack, работают в одних и тех же средах
• Облачные запланированные задачи: запланированные запуски используют те же среды и уровни доступа к сети
• Remote Control: запуск сеансов на сети и файлах вашей собственной машины вместо этого
• Self-hosted environments: запуск облачных сеансов на инфраструктуре вашей организации
• SessionStart hooks: зафиксированная в репозитории установка, которая работает в локальных и облачных сеансах
• Server-managed settings: политика организации, которая достигает облачных сеансов