Начало работы с Claude Code в веб-версии
Запустите Claude Code в облаке из браузера или мобильного приложения. Подключите репозиторий GitHub, отправьте задачу и просмотрите PR без локальной настройки.
Claude Code в веб-версии работает на облачной инфраструктуре вместо вашей машины, управляемой Anthropic по умолчанию. Отправляйте задачи с claude.ai/code из браузера или мобильного приложения Claude.
Вам потребуется репозиторий GitHub для начала работы. Claude клонирует его в изолированную виртуальную машину, вносит изменения и отправляет ветку для вашего просмотра. Сеансы сохраняются на всех устройствах, поэтому задача, которую вы начали на ноутбуке, готова к просмотру с телефона позже.
Claude Code в веб-версии хорошо подходит для:
- Параллельные задачи: запускайте несколько независимых задач одновременно, каждую в своем сеансе и ветке, без управления несколькими worktrees
- Репозитории, которые у вас нет локально: Claude клонирует репозиторий заново в каждом сеансе, поэтому вам не нужно его проверять
- Задачи, которые не требуют частого управления: отправьте четко определенную задачу, займитесь чем-то другим и просмотрите результат, когда Claude закончит
- Вопросы о коде и исследование: поймите кодовую базу или проследите, как реализована функция, без локального клона
Для работы, которая требует вашей локальной конфигурации, инструментов или окружения, запуск Claude Code локально или использование Remote Control — лучший вариант.
Как работают сеансы
Описанные ниже шаги относятся к сеансам, размещённым на серверах Anthropic. В самостоятельно размещённой среде клонирование и всё остальное выполняется на собственных средствах выполнения вашей организации, где границы сети, настройка и поведение отправки настраиваются оператором. Когда вы отправляете задачу:
- Клонирование и подготовка: ваш репозиторий клонируется на управляемую Anthropic ВМ, и ваш скрипт настройки запускается, если он настроен.
- Настройка сети: доступ в интернет устанавливается на основе уровня доступа вашего окружения.
- Работа: Claude анализирует код, вносит изменения, запускает тесты и проверяет свою работу. Вы можете наблюдать и управлять на протяжении всего процесса или отойти и вернуться, когда это будет сделано.
- Отправка ветки: когда Claude достигает точки остановки, он отправляет свою ветку на GitHub. Вы просматриваете diff, оставляете встроенные комментарии, создаете PR или отправляете еще одно сообщение, чтобы продолжить.
Сеанс не закрывается при отправке ветки. Создание PR и дальнейшие правки происходят в одном и том же разговоре.
Сравнение способов запуска Claude Code
Claude Code ведет себя одинаково везде. Что меняется, так это место выполнения кода и доступность вашей локальной конфигурации. Приложение Desktop предлагает как локальные, так и облачные сеансы, поэтому ответы ниже зависят от того, что вы выберете:
| В веб-версии | Remote Control | Terminal CLI | Приложение Desktop | |
|---|---|---|---|---|
| Код выполняется на | Облачной ВМ Anthropic | Вашей машине | Вашей машине | Вашей машине или облачной ВМ |
| Вы общаетесь с | claude.ai или мобильного приложения | claude.ai или мобильного приложения | Вашего терминала | Интерфейса Desktop |
| Использует вашу локальную конфигурацию | Нет, только репозиторий | Да | Да | Да для локального, нет для облачного |
| Требует GitHub | Да, или отправьте локальный репозиторий через --cloud |
Нет | Нет | Только для облачных сеансов |
| Продолжает работать при отключении | Да | Пока терминал остается открытым | Нет | Зависит от типа сеанса |
| Режимы разрешений | Принять правки, Plan, Auto | Спросить, Автоматическое принятие правок, Plan | Все режимы | Зависит от типа сеанса |
| Доступ в сеть | Настраивается для каждого окружения | Сеть вашей машины | Сеть вашей машины | Зависит от типа сеанса |
Смотрите документацию быстрого старта терминала, приложения Desktop или Remote Control для их настройки.
Подключение GitHub
Подключение GitHub — это одноразовый процесс. Если вы уже используете GitHub CLI, вы можете сделать это из терминала вместо браузера.
Посетите claude.ai/code
Перейдите на claude.ai/code и войдите со своей учетной записью claude.ai. На macOS или Windows первый экран предлагает приложение Claude Code для рабочего стола и другие способы установки Claude Code. Чтобы остаться в браузере, нажмите Continue on web внизу страницы.
Войдите с помощью GitHub
После входа claude.ai/code предложит вам подключить GitHub. Следуйте подсказке, и claude.ai/code отправит вас на страницу авторизации GitHub. Одобрите запрос авторизации, и GitHub вернет вас на claude.ai/code. Облачные сеансы работают с существующими репозиториями GitHub. Чтобы запустить новый проект, сначала создайте пустой репозиторий на GitHub.
С этим подключением сеанс может клонировать любой открытый репозиторий, но может работать в приватном репозитории только когда приложение Claude GitHub установлено на нем. Установите приложение на каждую учетную запись GitHub или организацию, чьи приватные репозитории вы хотите использовать. В организации GitHub владелец организации может потребоваться одобрить установку. Установка приложения также включает Auto-fix, который позволяет Claude реагировать на сбои CI и комментарии рецензентов в pull requests в этих репозиториях.
Если встроенная настройка предложит вам установить приложение на этом этапе и вы предпочитаете сделать это позже, нажмите Skip.
Настройте ваше окружение по умолчанию
Облачное окружение — это сохраненная конфигурация, которая контролирует, какой доступ в сеть имеет Claude во время сеансов и что запускается при запуске сеанса. То, что происходит после подключения GitHub, зависит от вашего плана:
- Pro и Max: встроенная настройка создает для вас окружение с именем Default.
- Team и Enterprise: встроенная настройка показывает форму Create your first cloud environment. Оставьте предзаполненное имя и доступ в сеть без изменений и нажмите Create & finish, чтобы создать окружение Default. Если Owner включил Quick web setup, встроенная настройка создает Default для вас вместо этого.
Default использует Trusted доступ в сеть: сеансы получают доступ к общим реестрам пакетов и другим доменам в списке разрешений, и ничему больше через сеть сеанса. Смотрите Installed tools для того, что доступно без какой-либо конфигурации.
Для первого проекта окружение Default работает как есть. Чтобы изменить его доступ в сеть, добавить переменные окружения или запустить скрипт настройки перед запуском сеансов, отредактируйте его или создайте дополнительные окружения.
Подключение из терминала
Если вы уже используете GitHub CLI (gh), вы можете настроить Claude Code в веб-версии без открытия браузера. Это требует Claude Code CLI. На планах Team и Enterprise /web-setup доступен только после того, как Owner включит Quick web setup.
Когда вы запускаете /web-setup, Claude Code читает токен, который выводит gh auth token, просит вас подтвердить и отправляет токен в Anthropic. Anthropic хранит его в зашифрованном виде с вашей учетной записью claude.ai, и ваши облачные сеансы используют его для доступа к GitHub до тех пор, пока вы не удалите его. Облачный сеанс может затем получить доступ к любому репозиторию, к которому может получить доступ этот токен, без установки приложения Claude GitHub.
Если вы уже подключили GitHub в браузере, /web-setup предупредит вас, что продолжение заменит это подключение для ваших облачных сеансов.
Аутентификация с помощью GitHub CLI
В вашей оболочке аутентифицируйте GitHub CLI, если вы еще этого не сделали:
gh auth login
Войдите в Claude
В Claude Code CLI запустите /login для входа со своей учетной записью claude.ai. Пропустите этот шаг, если вы уже вошли со своей учетной записью claude.ai. Аутентификация с помощью ключа API не считается. Чтобы проверить, запустите /status и подтвердите, что строка Login method показывает учетную запись claude.ai.
Запустите /web-setup
В Claude Code CLI запустите:
/web-setup
Подтвердите подсказку для отправки вашего токена gh на вашу учетную запись Claude. При успехе Claude Code выводит Connected as <your-github-username> и открывает claude.ai/code в вашем браузере. Если у вас еще нет облачного окружения, /web-setup создает его с доступом в сеть Trusted и без скрипта настройки. Вы можете отредактировать окружение или добавить переменные позже. После завершения /web-setup вы можете запускать облачные сеансы из терминала с помощью --cloud или настроить повторяющиеся задачи с помощью /schedule.
Удалите токен `/web-setup`
Чтобы удалить токен из вашей учетной записи Claude, отключите GitHub в claude.ai/customize/connectors. Отключение удаляет учетные данные GitHub, которые используют ваши облачные сеансы, независимо от того, поступили ли они из браузера или из /web-setup, поэтому облачные сеансы теряют доступ к GitHub до тех пор, пока вы не подключитесь снова. Ваш локальный gh остается вошедшим, и токен остается действительным на GitHub.
Чтобы аннулировать сам токен, отозвите его на GitHub. Если вы вошли в gh через браузер, токен принадлежит записи GitHub CLI в разделе Settings > Applications > Authorized OAuth Apps на GitHub, и отзыв этой записи также выходит из GitHub CLI на ваших машинах. Облачные сеансы затем теряют доступ к GitHub до тех пор, пока вы не запустите gh auth login и /web-setup снова.
Начните задачу
С подключенным GitHub и созданным окружением вы готовы отправлять задачи.
Выберите репозиторий и ветку
На claude.ai/code или на вкладке Code в мобильном приложении Claude нажмите селектор репозитория под полем ввода и выберите репозиторий для работы Claude. Каждый репозиторий показывает селектор ветки. Измените его, чтобы запустить Claude с ветки функции вместо ветки по умолчанию. Вы можете добавить несколько репозиториев для работы с ними в одном сеансе.
Выберите режим разрешений
Раскрывающееся меню режима рядом с вводом показывает режим, в котором будет работать сеанс:
- Auto: классификатор проверяет действия Claude вместо того, чтобы просить вас. Появляется, когда ваша организация разрешает режим auto и выбранная модель его поддерживает
- Accept edits: Claude вносит изменения и отправляет ветку без остановки для одобрения
- Plan: Claude предлагает подход и ждет вашего одобрения перед редактированием файлов
Облачные сеансы не предлагают разрешения Manual или разрешения Bypass. Смотрите полный список режимов разрешений для того, что позволяет каждый из них.
Опишите задачу и отправьте
Введите описание того, что вы хотите, и нажмите Enter. Будьте конкретны:
- Назовите файл или функцию: "Add a README with setup instructions" или "Fix the failing auth test in
tests/test_auth.py" лучше, чем "fix tests" - Вставьте вывод ошибки, если у вас он есть
- Опишите ожидаемое поведение, а не просто симптом
Claude клонирует репозитории, запускает ваш скрипт настройки, если он настроен, и начинает работать. Каждая задача получает свой сеанс и свою ветку, поэтому вам не нужно ждать, пока одна закончится, прежде чем начать другую.
Предварительное заполнение сеансов
Вы можете предварительно заполнить подсказку, репозитории и окружение для нового сеанса, добавив параметры запроса к URL claude.ai/code. Используйте это для создания интеграций, таких как кнопка в вашем трекере проблем, которая открывает Claude Code с описанием проблемы в качестве подсказки.
| Параметр | Описание |
|---|---|
prompt |
Текст подсказки для предварительного заполнения в поле ввода. Также принимается псевдоним q. |
prompt_url |
URL для получения текста подсказки, для подсказок, которые слишком длинные для встраивания в строку запроса. URL должен разрешать кросс-источниковые запросы. Игнорируется, когда также установлен prompt. |
repositories |
Разделенный запятыми список слагов owner/repo для предварительного выбора. Также принимается псевдоним repo. |
environment |
Имя или ID окружения для предварительного выбора. |
URL-кодируйте каждое значение. Пример ниже открывает форму с уже выбранной подсказкой и репозиторием:
https://claude.ai/code?prompt=Fix%20the%20login%20bug&repositories=acme/webapp
Просмотр и итерация
Когда Claude закончит, просмотрите изменения, оставьте отзыв на конкретных строках и продолжайте, пока diff не будет выглядеть правильно.
Откройте представление diff
Индикатор diff показывает добавленные и удаленные строки во всем сеансе, например +42 -18. Выберите его, чтобы открыть представление diff с списком файлов слева и изменениями справа.
Оставляйте встроенные комментарии
Выберите любую строку в diff, введите свой отзыв и нажмите Enter. Комментарии накапливаются до тех пор, пока вы не отправите следующее сообщение, затем они объединяются с ним. Claude видит "at src/auth.ts:47, don't catch the error here" вместе с вашей основной инструкцией, поэтому вам не нужно описывать, где проблема.
Создайте pull request
Когда diff выглядит правильно, выберите Create PR в верхней части представления diff. Вы можете открыть его как полный PR, черновик или перейти на страницу составления GitHub с сгенерированным названием и описанием.
Продолжайте итерацию после PR
Сеанс остается активным после создания PR. Вставьте вывод ошибки CI или комментарии рецензента в чат и попросите Claude их решить. Чтобы Claude автоматически отслеживал PR, смотрите Auto-fix pull requests.
Устранение неполадок при настройке
После подключения GitHub не появляются репозитории
Если вы подключили GitHub в браузере, сеансы могут клонировать любой публичный репозиторий, но приватный репозиторий появляется только когда приложение Claude GitHub установлено на учетной записи или организации, которая его владеет, и доступ к репозиториям в установке включает его. Установите приложение Claude GitHub там или попросите владельца организации установить или одобрить его.
Если вы подключились с помощью /web-setup, сеансы получают доступ к каждому репозиторию, который может видеть ваш токен gh. Запустите gh repo view OWNER/REPO в вашей оболочке, чтобы проверить, что ваш вход GitHub CLI может видеть репозиторий, и запустите /web-setup снова, если вы переключили учетные записи gh с момента подключения.
На странице отображается только кнопка входа GitHub
Облачные сеансы требуют подключенной учетной записи GitHub. Подключитесь через поток браузера выше или запустите /web-setup из терминала, если вы используете GitHub CLI. Если вы предпочитаете вообще не подключать GitHub, смотрите Remote Control для запуска Claude Code на вашей машине и мониторинга его из веб-версии.
"Not available for the selected organization"
Организациям Enterprise может потребоваться администратор для включения Claude Code в веб-версии. Свяжитесь с вашей командой учетных записей Anthropic.
`/web-setup` говорит "Not signed in to Claude"
Если /web-setup отвечает "Not signed in to Claude. Run /login first.", CLI не имеет действительного входа в claude.ai. Это также может произойти, когда предыдущий вход истек. Запустите /login, войдите со своей учетной записью claude.ai, затем снова запустите /web-setup.
`/web-setup` предупреждает, что ваш токен не имеет области `workflow`
Если /web-setup говорит, что ваш токен GitHub CLI не имеет области workflow, вы можете продолжить, но GitHub может отклонить некоторые отправки, сделанные с этим токеном, такие как отправки, которые изменяют файлы рабочих процессов GitHub Actions. Чтобы добавить область, запустите gh auth refresh -s workflow в вашей оболочке, затем снова запустите /web-setup.
`/web-setup` показывает "No commands match" или "Unknown command"
/web-setup работает внутри Claude Code CLI, а не в вашей оболочке. Сначала запустите claude, затем введите /web-setup в подсказке.
Если вы ввели его внутри Claude Code и меню команд показывает No commands match "/web-setup", или отправка возвращает Unknown command: /web-setup, команда скрыта, потому что требование не выполнено. Причина обычно в том, что вы аутентифицированы с помощью ключа API или поставщика третьей стороны вместо подписки claude.ai. Запустите /login для входа со своей учетной записью claude.ai.
На планах Team и Enterprise команда скрыта по умолчанию: переключатель быстрой веб-настройки отключен до тех пор, пока администратор его не включит. Пока он отключен, подключите GitHub из браузера вместо этого. Команда также скрыта, когда администратор отключил Claude Code в веб-версии для вашей организации, или когда ваша организация Enterprise имеет Zero Data Retention включенный, что делает Claude Code в веб-версии недоступным.
"Could not create a cloud environment" или "No cloud environment available" при использовании `--cloud`
Функции удаленного сеанса автоматически создают облачное окружение по умолчанию, если у вас его нет. Если вы видите "Could not create a cloud environment", автоматическое создание не удалось. Если вы видите "No cloud environment available", ваш CLI предшествует автоматическому созданию. В любом случае запустите /web-setup в Claude Code CLI, или добавьте окружение из селектора окружения на claude.ai/code.
Скрипт настройки не удался
Скрипт настройки завершился с ненулевым статусом, что блокирует запуск сеанса. Распространенные причины:
- Установка пакета не удалась, потому что реестр не находится на вашем уровне доступа в сеть.
Trustedохватывает большинство менеджеров пакетов;Noneблокирует их все. - Скрипт ссылается на файл или путь, который не существует в свежем клоне.
- Команда, которая работает локально, требует другого вызова на Ubuntu.
Для отладки добавьте set -x в начало скрипта, чтобы увидеть, какая команда не удалась. Для некритических команд добавьте || true, чтобы они не блокировали запуск сеанса.
Новые сеансы зависают или истекает время ожидания во время настройки
Если новые сеансы зависают на шаге скрипта настройки или не удаются с общей ошибкой контейнера перед завершением скрипта, скрипт, вероятно, превышает примерно пятиминутный бюджет времени для построения кэша окружения. Тяжелые шаги, такие как извлечение больших образов Docker, синхронизация полных деревьев зависимостей или загрузка весов модели, часто превышают лимит, особенно когда они выполняются один за другим.
Чтобы исправить это, обрежьте скрипт так, чтобы он надежно завершался менее чем за пять минут:
- Запускайте независимые установки параллельно с
&и финальнымwaitвместо их последовательного выполнения. - Переместите самые большие загрузки из скрипта настройки в SessionStart hook, который запускает их в фоновом режиме, чтобы сеанс стал пригодным для использования, пока они завершаются.
- Удалите длинные повторные попытки сна из скрипта настройки, так как зависший цикл повторных попыток учитывается в бюджете.
Сеанс продолжает работать после закрытия вкладки
Это сделано специально. Закрытие вкладки или навигация не останавливает сеанс. Он продолжает работать в фоновом режиме до тех пор, пока Claude не закончит текущую задачу, затем переходит в режим ожидания. На боковой панели вы можете архивировать сеанс, чтобы скрыть его из списка, или удалить его, чтобы удалить его навсегда.
Следующие шаги
Теперь, когда вы можете отправлять и просматривать задачи, эти страницы охватывают, что дальше: запуск облачных сеансов из терминала, планирование повторяющейся работы и предоставление Claude постоянных инструкций.
- Использование Claude Code в веб-версии: полный справочник, включая телепортацию сеансов в ваш терминал, совместное использование сеансов и автоматическое исправление pull-запросов
- Настройка облачных окружений: уровни сетевого доступа, переменные окружения и скрипты настройки для облачных сеансов
- Routines: автоматизируйте работу по расписанию, через вызов API или в ответ на события GitHub
- CLAUDE.md: дайте Claude постоянные инструкции и контекст, которые загружаются в начале каждого сеанса
- Установите мобильное приложение Claude для iOS или Android для мониторинга сеансов с телефона. Из Claude Code CLI
/mobileпоказывает QR-код.