46 46
47Перед отправкой первого сообщения настройте четыре параметра в области подсказки:47Перед отправкой первого сообщения настройте четыре параметра в области подсказки:
48 48
49* **Environment**: выберите, где запускается Claude. Выберите **Local** для вашей машины, **Cloud** для [облачного сеанса](#cloud-sessions), который продолжается после закрытия приложения, [**SSH-соединение**](#ssh-sessions) для удалённой машины, которой вы управляете, или на Windows [**WSL-дистрибутив**](/docs/ru/desktop-wsl). См. [конфигурация окружения](#environment-configuration).49* **Environment**: выберите, где запускается Claude. Выберите **Local** для вашей машины, **Cloud** для [облачной сессии](#cloud-sessions), которая продолжается после закрытия приложения, [**SSH-соединение**](#ssh-sessions) для удалённой машины, которой вы управляете, или на Windows [**WSL-дистрибутив**](/docs/ru/desktop-wsl). Задача в SSH-сессии может [продолжать выполняться, пока Desktop отключён](#keep-a-task-running-while-desktop-is-disconnected), но при использовании учётной записи Claude она может остановиться, когда истечёт срок её входа. См. [конфигурация окружения](#environment-configuration).
50* **Project folder**: выберите папку или репозиторий, с которым работает Claude. Для облачных сеансов вы можете добавить [несколько репозиториев](#run-long-running-tasks-in-the-cloud).50* **Project folder**: выберите папку или репозиторий, с которым работает Claude. Для облачных сеансов вы можете добавить [несколько репозиториев](#run-long-running-tasks-in-the-cloud).
51* **Model**: выберите [модель](/docs/ru/model-config#available-models) из раскрывающегося списка рядом с кнопкой отправки. Вы можете изменить это во время сеанса.51* **Model**: выберите [модель](/docs/ru/model-config#available-models) из раскрывающегося списка рядом с кнопкой отправки. Вы можете изменить это во время сеанса.
52* **Permission mode**: выберите, сколько автономности имеет Claude, из [селектора режима](#choose-a-permission-mode). Вы можете изменить это во время сеанса.52* **Permission mode**: выберите, сколько автономности имеет Claude, из [селектора режима](#choose-a-permission-mode). Вы можете изменить это во время сеанса.
236 Запуск команд в терминале236 Запуск команд в терминале
237</h3>237</h3>
238 238
239Интегрированный терминал позволяет вам запускать команды рядом с вашей сессией без переключения на другое приложение. Нажмите **Terminal** в строке заголовка сессии или нажмите **Ctrl+\`** на macOS или Windows. Терминал открывается в рабочем каталоге вашей сессии и делит то же окружение с Claude, поэтому команды, такие как `npm test` или `git status`, видят те же файлы, которые редактирует Claude. Чтобы открыть вторую вкладку терминала, нажмите **+** в заголовке панели терминала или щелкните правой кнопкой мыши на папке в чате, чтобы выбрать **Open in terminal**. Терминал доступен в локальных и [SSH](#ssh-sessions)-сессиях.239Интегрированный терминал позволяет вам запускать команды рядом с вашей сессией без переключения на другое приложение. Нажмите **Terminal** в строке заголовка сессии или нажмите **Ctrl+\`** на macOS или Windows. Терминал открывается в рабочем каталоге вашей сессии и делит то же окружение с Claude, поэтому команды, такие как `npm test` или `git status`, видят те же файлы, которые редактирует Claude. Чтобы открыть вторую вкладку терминала, нажмите **+** в заголовке панели терминала или щелкните правой кнопкой мыши на папке в чате, чтобы выбрать **Open in terminal**.
240
241Терминал доступен в локальных и [SSH](#ssh-sessions)-сессиях, с ограничением на [удалённых машинах Windows](#windows-remote-machines).
240 242
241<h3 id="open-and-edit-files">243<h3 id="open-and-edit-files">
242 Открытие и редактирование файлов244 Открытие и редактирование файлов
468 470
469Подробнее о том, как работают облачные сессии, см. [Использование Claude Code в облаке](/docs/ru/claude-code-on-the-web). Когда для одного объёма работы нужно много облачных сессий, выберите **Projects** в боковой панели, чтобы создать [проект](/docs/ru/claude-projects), в котором Claude запускает и отслеживает сессии за вас из одного диалога.471Подробнее о том, как работают облачные сессии, см. [Использование Claude Code в облаке](/docs/ru/claude-code-on-the-web). Когда для одного объёма работы нужно много облачных сессий, выберите **Projects** в боковой панели, чтобы создать [проект](/docs/ru/claude-projects), в котором Claude запускает и отслеживает сессии за вас из одного диалога.
470 472
473<Note>
474 Задача в [сессии SSH](#ssh-sessions) также может [продолжать выполняться, пока Desktop отключён](#keep-a-task-running-while-desktop-is-disconnected), но при использовании учётной записи Claude она может остановиться, когда истечёт срок действия входа.
475</Note>
476
471<h3 id="continue-in-another-surface">477<h3 id="continue-in-another-surface">
472 Продолжение в другом интерфейсе478 Продолжение в другом интерфейсе
473</h3>479</h3>
772 778
773* **Local**: работает на вашей машине с прямым доступом к вашим файлам779* **Local**: работает на вашей машине с прямым доступом к вашим файлам
774* **Cloud**: работает на облачной инфраструктуре Anthropic по умолчанию. Сеансы продолжают работу даже если вы закроете приложение.780* **Cloud**: работает на облачной инфраструктуре Anthropic по умолчанию. Сеансы продолжают работу даже если вы закроете приложение.
775* **SSH**: работает на удалённой машине, к которой вы подключаетесь через SSH, такой как ваши собственные серверы, облачные виртуальные машины или dev-контейнеры781* **SSH**: работает на удалённой машине, к которой вы подключаетесь через SSH, такой как ваши собственные серверы, облачные виртуальные машины или dev-контейнеры. Запущенная задача может [продолжать выполняться, пока Desktop отключён](#keep-a-task-running-while-desktop-is-disconnected), но при использовании учётной записи Claude она может остановиться, когда истечёт срок действия её входа.
776* **WSL** (Windows): работает внутри [WSL 2 дистрибутива](/docs/ru/desktop-wsl) на вашей машине, используя его Linux toolchain и собственные пути782* **WSL** (Windows): работает внутри [WSL 2 дистрибутива](/docs/ru/desktop-wsl) на вашей машине, используя его Linux toolchain и собственные пути
777 783
778<h3 id="local-sessions">784<h3 id="local-sessions">
812 818
813SSH-сеансы позволяют вам запускать Claude Code на удалённой машине, используя приложение desktop как ваш интерфейс. Это полезно для работы с кодовыми базами, которые находятся на облачных виртуальных машинах, dev-контейнерах или серверах со специфическим оборудованием или зависимостями.819SSH-сеансы позволяют вам запускать Claude Code на удалённой машине, используя приложение desktop как ваш интерфейс. Это полезно для работы с кодовыми базами, которые находятся на облачных виртуальных машинах, dev-контейнерах или серверах со специфическим оборудованием или зависимостями.
814 820
821<Note>
822 Если вы используете Desktop со [сторонним провайдером](/docs/ru/third-party-integrations), SSH-сессии требуют отдельной настройки. См. [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).
823</Note>
824
815Чтобы добавить SSH-соединение, перед запуском сессии откройте раскрывающийся список окружения в поле промпта, затем выберите **SSH > Add SSH connection…** и заполните параметры соединения:825Чтобы добавить SSH-соединение, перед запуском сессии откройте раскрывающийся список окружения в поле промпта, затем выберите **SSH > Add SSH connection…** и заполните параметры соединения:
816 826
817* **Name**: дружественный ярлык для этого соединения827* **Name**: дружественный ярлык для этого соединения
822 832
823После добавления соединение появляется в разделе **SSH** раскрывающегося списка окружения. Выберите его для запуска сессии на этой машине. Claude работает на удалённой машине с доступом к её файлам и инструментам.833После добавления соединение появляется в разделе **SSH** раскрывающегося списка окружения. Выберите его для запуска сессии на этой машине. Claude работает на удалённой машине с доступом к её файлам и инструментам.
824 834
825Удалённая машина должна работать на Linux или macOS. Desktop автоматически устанавливает Claude Code на удалённой машине при первом подключении. После подключения SSH-сеансы поддерживают режимы разрешений, коннекторы, plugins и MCP servers.835Удалённая машина может работать на Linux, macOS или [Windows](#windows-remote-machines). Desktop автоматически устанавливает Claude Code на удалённой машине при первом подключении. После подключения SSH-сессии поддерживают режимы разрешений, коннекторы, плагины и MCP-серверы.
836
837<h4 id="remote-machine-requirements-for-ssh-sessions">
838 Требования к удалённой машине для SSH-сессий
839</h4>
840
841Удалённой машине с Linux или macOS нужны поддерживаемый процессор, SSH-сервер с SFTP, папка установки, не смонтированная с `noexec`, работающая оболочка и доступ к сети. Проверьте каждое требование перед подключением или когда соединение не удаётся после входа:
842
843* **Система**: процессор x86\_64 или arm64. Машина также должна соответствовать [системным требованиям](/docs/ru/setup#system-requirements) Claude Code.
844* **SFTP**: SSH-сервер должен предоставлять подсистему SFTP, которую включает строка `Subsystem sftp` в его `sshd_config`. Чтобы проверить, подключитесь к тому же хосту и порту с помощью `sftp` в терминале на вашем компьютере. Работающий сервер показывает приглашение `sftp>`.
845* **Сессии на одно соединение**: Desktop на macOS и Linux открывает несколько сессий в одном SSH-соединении. Если `sshd_config` сервера задаёт `MaxSessions 1`, увеличьте значение, например до значения OpenSSH по умолчанию, равного 10.
846* **Папка установки**: Desktop устанавливает вспомогательную программу и Claude Code в `~/.claude/remote/` в вашем домашнем каталоге. Он запускает их оттуда, поэтому эта папка не может находиться в файловой системе, смонтированной с `noexec`. Выделите около 1 ГБ дискового пространства в домашнем каталоге каждого подключающегося пользователя.
847* **Оболочка**: оболочка, заданная для вашей учётной записи на удалённой машине, должна выполнять команды, отправленные через SSH, как это делают Bash, Zsh и `sh`
848* **Сеть**: Claude Code работает на удалённой машине и выполняет сетевые запросы оттуда, поэтому машине нужен [доступ к сети, который требуется Claude Code](/docs/ru/network-config#network-access-requirements). Если машина не может загрузить Claude Code, Desktop загружает его на вашем компьютере и выгружает на машину. Остальные запросы Claude Code по-прежнему отправляются с удалённой машины.
849
850<h4 id="use-your-ssh-configuration-on-macos-and-linux">
851 Использование вашей конфигурации SSH на macOS и Linux
852</h4>
853
854На macOS и Linux Desktop подключается, запуская клиент OpenSSH на вашем компьютере, поэтому использует ваш `~/.ssh/config`. Подключение через клиент OpenSSH требует Claude Desktop v1.37937.0 или более поздней версии. Введите имя `Host` из этого файла в поле **SSH host**, чтобы использовать настройки из его записи, такие как `HostName`, `User`, `IdentityFile`, `CertificateFile`, `ProxyJump` и `ProxyCommand`.
855
856Прежде чем добавить соединение, проверьте клиент и запись в терминале на вашем компьютере:
857
858* **Версия клиента**: выполните `ssh -V`. Клиент должен быть OpenSSH 7.6 или более поздней версии.
859* **Запись**: выполните `ssh` с именем `Host`, например `ssh devbox`. Если это не удаётся, сначала исправьте запись.
860
861Поля **SSH port** и **SSH key (optional)** можно оставить пустыми. Если вы заполните одно из них, Desktop использует его вместе с записью:
862
863* **SSH port**: значение здесь переопределяет `Port` записи
864* **SSH key (optional)**: Desktop предлагает выбранный вами файл ключа в дополнение к `IdentityFile` записи и ключам в вашем SSH-агенте
865
866<h5 id="reach-a-machine-behind-a-jump-host">
867 Подключение к машине за jump-хостом
868</h5>
869
870Чтобы подключиться к машине за jump-хостом, также называемым бастионом, задайте `ProxyJump` или `ProxyCommand` в записи. Следующая запись подключается к `devbox.internal.example.com` через `bastion.example.com`:
871
872```text ~/.ssh/config theme={null}
873Host devbox
874 HostName devbox.internal.example.com
875 User alice
876 ProxyJump bastion.example.com
877```
878
879Введите `devbox` в поле **SSH host**.
880
881<h5 id="raise-the-ssh-connection-timeout">
882 Увеличение таймаута SSH-соединения
883</h5>
884
885Если ваша конфигурация SSH не задаёт `ConnectTimeout` для хоста, Desktop даёт `ssh` 30 секунд на подключение. При использовании jump-хоста или `ProxyCommand` это время включает время, необходимое маршруту для подключения. Если вашему маршруту нужно больше времени, добавьте в запись большее значение:
886
887```text ~/.ssh/config theme={null}
888Host devbox
889 HostName devbox.internal.example.com
890 User alice
891 ProxyJump bastion.example.com
892 ConnectTimeout 120
893```
894
895`ssh` использует первое найденное для хоста значение, поэтому размещайте запись выше любой записи `Host *`, которая задаёт `ConnectTimeout`. Чтобы убедиться, выполните `ssh -G devbox` в терминале на вашем компьютере. Его вывод содержит `connecttimeout 120`. После изменения значения закройте и снова откройте Desktop.
896
897<h4 id="windows-remote-machines">
898 Удалённые машины с Windows
899</h4>
900
901Для удалённой машины с Windows требуется Claude Desktop v2.31226.0 или более поздней версии.
902
903Используйте OpenSSH Server от Microsoft. Машина может быть x64 или ARM64. Оболочкой, которую запускает SSH-сервер, может быть `cmd.exe`, Windows PowerShell 5.1 или Git Bash.
904
905Удалённые машины с Windows тестируются меньше, чем машины с Linux. Опробуйте на них свою работу, прежде чем полагаться на них.
906
907На удалённой машине с Windows ожидайте, среди прочего, следующих ограничений:
908
909* **Терминал**: [терминал](#run-commands-in-the-terminal) не открывается в сессии, папкой которой является путь Windows, например `C:/projects/app`
910* **Песочница**: Claude Code работает там в нативной Windows, где выполняет команды без песочницы. См. [где работает песочница](/docs/ru/sandboxing).
911* **Плагины**: Desktop не копирует плагин, содержащий имя файла или папки, которое Windows не может хранить, например имя с `:`. Сессия показывает список плагинов, которые Desktop пропустил.
912* **MCP-серверы**: на некоторых удалённых машинах с Windows вызовы Claude к MCP-серверам из `claude_desktop_config.json` проходят через Desktop, поэтому Claude не может вызывать их инструменты, [пока Desktop отключён](#limits-while-desktop-is-disconnected). До Claude Desktop v2.37337.0 это справедливо для каждой удалённой машины с Windows.
913* **Worktree**: worktree размещаются в `<project-root>/.claude/worktrees/`. Если вы [выберете другую папку](#choose-where-ssh-session-worktrees-go), Desktop её игнорирует.
914* **Более ранние сообщения**: если оболочкой SSH-сервера является `cmd.exe` или Windows PowerShell, вам, возможно, придётся подключиться, прежде чем вы увидите более ранние сообщения сессии
915* **Форки**: если оболочкой SSH-сервера является `cmd.exe` или Windows PowerShell, вы можете создать форк сессии только на её первом сообщении
916* **Работа при отключении**: задача [продолжает выполняться, пока Desktop отключён](#keep-a-task-running-while-desktop-is-disconnected), только если SSH-сервер позволяет программе продолжать работу после закрытия соединения, которое её запустило. Чтобы это выяснить, [протестируйте удалённую машину](#prepare-a-long-task).
917* **Оставшиеся процессы**: после завершения сессии проверьте машину на наличие программ, запущенных Claude Code, потому что они могут продолжать работать. [Фоновый помощник](#keep-a-task-running-while-desktop-is-disconnected), который устанавливает Desktop, там не останавливается сам по себе.
918
919<h4 id="keep-a-task-running-while-desktop-is-disconnected">
920 Продолжение задачи, пока Desktop отключён
921</h4>
922
923Если ваш компьютер переходит в спящий режим, вы теряете сеть или закрываете Desktop, задача продолжается, пока не завершится, не потребует вашего участия или не достигнет одного из [ограничений](#limits-while-desktop-is-disconnected). Закрытие крышки считается спящим режимом. Перезапуск Desktop или вашего компьютера, в том числе для обновления, считается закрытием.
924
925Claude Code работает как процесс на удалённой машине под управлением фонового помощника, который Desktop устанавливает там, поэтому ему не нужно ваше SSH-соединение, чтобы продолжать работу. Поведение, описанное в этом разделе, требует Claude Desktop v2.31226.0 или более поздней версии.
926
927<Warning>
928 Если вы входите в Desktop с учётной записью Claude, не рассчитывайте, что задача будет выполняться всю ночь. Desktop продлевает вход для задачи только пока Desktop запущен и подключён, поэтому срок действия входа задачи может истечь после отключения, и тогда задача остановится. Сколько времени остаётся на момент отключения, бывает по-разному.
929
930 Проделанная работа остаётся на удалённой машине, и, вернувшись, вы можете продолжить, отправив сообщение.
931
932 Если задача должна выполняться всю ночь:
933
934 * [Не давайте компьютеру засыпать](/docs/ru/desktop-scheduled-tasks#how-scheduled-tasks-run) и держите его в сети, с открытой крышкой и запущенным Desktop
935 * Используйте вход, который работает без запроса, например ключ, хранящийся в вашем SSH-агенте, для удалённой машины и для любого jump-хоста на пути к ней. Тогда Desktop сможет самостоятельно переподключиться после обрыва.
936
937 Для задачи, которая должна выполняться, пока ваш компьютер спит или выключен, запустите вместо этого [облачную сессию](#run-long-running-tasks-in-the-cloud).
938</Warning>
939
940* **После спящего режима или потери сети**: вы вернёте выполняющуюся задачу, если процесс [всё ещё работает](#limits-while-desktop-is-disconnected) и Desktop может войти без запроса. Если не может, [отправьте сообщение](#reconnect-after-sleep-or-a-network-loss).
941* **После закрытия, с Desktop на macOS или Linux и учётной записью Claude**: вы вернёте выполняющуюся задачу, если Desktop сможет [снова присоединиться к процессу](#reopen-a-session-after-you-quit-desktop). Если не сможет, задача остановится. Если она так и остаётся остановленной, отправьте сообщение.
942* **После закрытия, с Desktop на Windows или со [сторонним провайдером](/docs/ru/third-party-integrations)**: вы теряете выполняющуюся задачу, потому что Desktop завершает процесс при открытии сессии. Отправьте сообщение, чтобы продолжить.
943
944Когда вы вернётесь, а задача не выполнена, проверьте, нет ли сообщения о том, что Desktop не может переподключиться, ошибки аутентификации или ожидающего запроса:
945
946* **Desktop не может переподключиться**: сессия сообщает причину, и об этом также может сообщить уведомление. Возможно, Desktop [нужно, чтобы вы вошли](#reconnect-after-sleep-or-a-network-loss).
947* **Ошибка аутентификации**: возможно, истёк срок действия [токена входа или учётных данных](#limits-while-desktop-is-disconnected). С учётной записью Claude отправьте сообщение, чтобы продолжить. Со сторонним провайдером см. [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).
948* **Ожидающий запрос**: [ответьте на него](#handle-requests-that-arrive-while-you-are-away)
949* **Ничего из этого**: отправьте сообщение, чтобы продолжить
950
951<a id="prepare-a-long-task" />
952
953<h5 id="prepare-a-long-task">
954 Подготовка длительной задачи
955</h5>
956
957* **Сначала обновитесь**: обновите Desktop перед запуском длительной задачи. На macOS и Windows Desktop может самостоятельно перезапуститься, чтобы установить загруженное обновление. Этот перезапуск ожидает, пока Claude работает над SSH-задачей. На macOS с учётной записью Claude по умолчанию перезапуск всё же может произойти, когда обновление ожидает уже 72 часа.
958* **Не закрывайте Desktop**: если Desktop работает на Windows или использует стороннего провайдера, оставьте его открытым, пока выполняется длительная задача. После закрытия он [завершает выполняющуюся задачу](#reopen-a-session-after-you-quit-desktop) при открытии сессии. Открытый Desktop не защищает запрос, который [ожидает вас](#handle-requests-that-arrive-while-you-are-away).
959* **Сократите число запросов**: выберите режим разрешений, правила или хуки, благодаря которым [задача будет реже ожидать вас](#handle-requests-that-arrive-while-you-are-away)
960* **Проверьте jump-хост**: если ваш jump-хост запрашивает вход, например push-уведомление на телефон, перейдите на вход, который работает без запроса. Иначе Desktop может отправлять новое push-уведомление при каждой попытке переподключения.
961* **Протестируйте удалённую машину**: запустите короткую задачу, закройте Desktop, пока задача ещё выполняется, и снова откройте сессию значительно позже того момента, когда задача должна была завершиться. Если задача не завершена, а сессия не показывает ошибку аутентификации, проверьте на удалённой машине, [что может завершить задачу](#limits-while-desktop-is-disconnected).
962* **Не выполняйте команды в терминале Desktop**: если удалённая машина [завершает сеансы бездействующих терминалов](#limits-while-desktop-is-disconnected), выполняйте свои команды из SSH-входа вне Desktop
963
964<a id="limits-while-desktop-is-disconnected" />
965
966<h5 id="limits-while-desktop-is-disconnected">
967 Ограничения, пока Desktop отключён
968</h5>
969
970Задача, которую вы оставили выполняться, может завершиться, когда истечёт срок действия её входа, когда удалённая машина завершит её или когда помощник остановится или будет заменён:
971
972* **Токен входа или учётные данные**: с учётной записью Claude задача останавливается с ошибкой аутентификации, когда истекает срок действия токена. Со сторонним провайдером то же самое происходит с учётными данными, у которых истекает срок действия, например полученными через единый вход или вспомогательную программу для учётных данных. См. [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions). С учётной записью Claude [держите Desktop запущенным и подключённым](#keep-a-task-running-while-desktop-is-disconnected), чтобы он мог продлевать вход.
973* **Удалённая машина**: если удалённая машина перезапускается или завершает ваши процессы при закрытии SSH-соединения, выполняющаяся задача завершается. Пока Desktop отключён, ничто не запустит её снова. Так завершают ваши процессы машины с Linux, где параметр `KillUserProcesses` в systemd-logind равен `yes` и применяется к вашему пользователю. Чтобы задача продолжала выполняться на такой машине, попросите администратора сделать исключение для вашего пользователя, например с помощью `KillExcludeUsers`.
974* **Бездействующие терминалы**: некоторые удалённые машины с Linux завершают сеанс терминала, в котором никто не вводил текст в течение заданного времени (`StopIdleSessionSec` в systemd-logind). С Desktop на macOS или Linux [терминал](#run-commands-in-the-terminal) сессии и команды `!` по умолчанию используют SSH-соединение Desktop. Тогда такой выход разрывает соединение, пока Desktop подключён, и вместе с ним может завершиться выполняющаяся задача. Закрытие панели терминала этого не предотвращает, поэтому [не выполняйте команды в этом терминале](#prepare-a-long-task).
975* **Обновления Desktop**: если обновление приносит новую версию помощника, Desktop заменяет помощник на удалённой машине при одном из последующих подключений, что может завершить ещё выполняющуюся задачу
976* **Длительное отсутствие**: на удалённой машине с Linux или macOS, если Desktop не подключается в течение 30 дней, помощник останавливается и завершает все процессы Claude Code, работающие под его управлением. Подключитесь до истечения этого срока.
977
978Редактирование файлов и некоторые инструменты могут не работать, пока Desktop отключён. Если они нужны задаче, держите Desktop подключённым:
979
980* **Worktree**: в сессии, использующей [worktree](#work-in-parallel-with-sessions), Desktop проверяет каждое изменение файла, прежде чем Claude его внесёт. Пока Desktop отключён, каждое изменение ожидает около 30 секунд, а затем завершается ошибкой. Shell-команды по-прежнему выполняются. На удалённой машине с Linux или macOS [изменения могут продолжать работать](#worktree-edits-while-disconnected). Если вы не уверены, запустите сессию без worktree.
981* **Ограничения папок**: если ваша организация ограничивает папки, которые могут использовать сессии, Desktop проверяет каждое чтение файла, поиск и изменение, с worktree или без него. Пока Desktop отключён, каждая такая операция ожидает до 10 минут, а затем завершается ошибкой.
982* **Коннекторы**: [коннекторы](#connect-external-tools) и другие инструменты, которые предоставляет Desktop, работают через Desktop, поэтому, пока он отключён, каждый вызов завершается ошибкой примерно через 30 секунд
983* **Workflows**: Desktop проверяет каждый новый [workflow](/docs/ru/workflows) перед его запуском, поэтому, пока Desktop отключён, новый workflow ожидает до 10 минут, а затем завершается ошибкой
984* **MCP-серверы**: MCP-серверы, которые Claude Code запускает на удалённой машине, работают не через Desktop, поэтому Claude по-прежнему может вызывать их инструменты. Серверы из `claude_desktop_config.json` относятся к ним, только если Desktop не использует свой [встроенный SSH-клиент](#worktree-edits-while-disconnected). В противном случае, а также на [некоторых удалённых машинах с Windows](#windows-remote-machines), Claude не может вызывать их инструменты, пока Desktop отключён.
985
986<span id="worktree-edits-while-disconnected" />
987
988<Accordion title="Когда изменения в worktree продолжают работать">
989 На удалённой машине с Linux или macOS проверка не проходит через Desktop, поэтому изменения внутри worktree продолжают работать, пока Desktop отключён. До Claude Desktop v2.37337.0 это справедливо только для удалённой машины с Linux.
990
991 В некоторых случаях изменения всё равно завершаются ошибкой, в том числе в следующих:
992
993 * **Встроенный SSH-клиент**: Desktop использует его, например, при установке из Microsoft Store, на компьютере с Windows без OpenSSH 9.4 или более поздней версии от Microsoft, или по умолчанию на Windows со сторонним провайдером
994 * **Расположение репозитория**: репозиторий — это ваш домашний каталог, папка выше него или `~/.claude`
995 * **Пути macOS**: на удалённой машине с macOS репозиторий находится в `/Volumes`, или имя папки в пути к репозиторию или worktree содержит `~` или символ, не входящий в ASCII
996 * **Ограничения папок**: ваша организация ограничивает папки, которые могут использовать сессии
997 * **Корпоративный лаунчер**: до Claude Desktop v2.37337.0 — вы входите с учётной записью Claude, а ваша организация запускает Claude Code на удалённой машине через [корпоративный лаунчер](/docs/ru/corporate-launcher)
998
999 В сессии без worktree такой проверки нет, если только ваша организация не ограничивает папки, которые могут использовать сессии.
1000</Accordion>
1001
1002<a id="handle-requests-that-arrive-while-you-are-away" />
1003
1004<h5 id="handle-requests-that-arrive-while-you-are-away">
1005 Обработка запросов, поступающих в ваше отсутствие
1006</h5>
1007
1008Если Claude нужно ваше подтверждение или Claude задаёт вам вопрос, пока Desktop отключён, Claude ожидает на удалённой машине. У этого ожидания нет собственного ограничения по времени. Когда Desktop снова присоединяется к процессу, он показывает вам запрос. Если вместо этого Desktop запускает новый процесс, вы теряете запрос.
1009
1010Пока задача ожидает вас, Desktop может самостоятельно перезапуститься, например чтобы установить обновление. Если Desktop работает на Windows или использует стороннего провайдера, после такого перезапуска вы теряете запрос.
1011
1012Если вы потеряли запрос, отправьте сообщение, чтобы продолжить.
1013
1014Чтобы задача реже останавливалась в ожидании вас и чтобы получать от неё весточки в ваше отсутствие, перед уходом настройте что-либо из следующего:
1015
1016* **Авторежим**: выберите [авторежим](#choose-a-permission-mode), если [он вам доступен](#auto-mode-availability). После повторяющихся блокировок вас [снова спросят](/docs/ru/permission-modes#when-auto-mode-falls-back).
1017* **Правила разрешения действий**: в файле пользовательских настроек на удалённой машине, `~/.claude/settings.json`, добавьте [правила allow](/docs/ru/permissions#manage-permissions) для команд, которые нужны задаче. Если ваша организация [принимает правила разрешений только из управляемых настроек](/docs/ru/settings-reference#allowmanagedpermissionrulesonly), попросите администратора добавить их в [управляемые настройки](#managed-settings), которые доходят до удалённой машины. О правилах allow в `.claude/settings.json` проекта см. [Project allow rules and workspace trust](/docs/ru/permissions#project-allow-rules-and-workspace-trust).
1018* **Хук, который отвечает**: настройте [хук `PermissionRequest`](/docs/ru/hooks#permissionrequest) в `~/.claude/settings.json` на удалённой машине, чтобы он разрешал или отклонял запросы вместо вас
1019* **Хук, который оповещает вас**: настройте [хук `Notification`](/docs/ru/hooks#notification) с matcher `permission_prompt` в том же файле, чтобы отправлять себе сообщение, когда запрос ожидает ответа
1020* **Хук, который сообщает, что Claude закончил**: настройте [хук `Stop`](/docs/ru/hooks#stop) в том же файле, чтобы отправлять себе сообщение, когда Claude закончит отвечать. Он не срабатывает, если ход завершается ошибкой API. Для этого случая настройте [хук `StopFailure`](/docs/ru/hooks#stopfailure).
1021
1022Если ваша организация [запускает только управляемые хуки](/docs/ru/settings-reference#allowmanagedhooksonly), попросите администратора добавить хук в [управляемые настройки](#managed-settings), которые доходят до удалённой машины.
1023
1024Claude Code не подтверждает автоматически [некоторые действия](/docs/ru/permission-modes#actions-no-mode-auto-approves) ни в одном режиме разрешений, включая Bypass permissions. В зависимости от режима разрешений Claude Code отклоняет такое действие или спрашивает вас, и тогда задача ожидает вашего ответа.
1025
1026<a id="reconnect-after-sleep-or-a-network-loss" />
1027
1028<h5 id="reconnect-after-sleep-or-a-network-loss">
1029 Переподключение после спящего режима или потери сети
1030</h5>
1031
1032Если к вашему возвращению Desktop не переподключился, отправьте сообщение в сессии. Desktop переподключается самостоятельно только там, где может войти без запроса, например с ключом, хранящимся в вашем SSH-агенте.
1033
1034* **Запомненный пароль**: пароль, который вы разрешили Desktop запомнить, тоже работает без запроса, но для длительного отсутствия предпочтительнее ключ, хранящийся в вашем SSH-агенте. Если входы с этим паролем прерываются или зависают, Desktop может прекратить попытки переподключения и ждать вас.
1035* **Любой другой запрос**: если удалённая машина запрашивает что-то ещё, например одноразовый код, вы можете получить уведомление на компьютере. Нажмите на уведомление или отправьте сообщение в сессии, и Desktop покажет запрос.
1036
1037<Accordion title="Если jump-хост запрашивает вход, перебой длительный, часть вывода отсутствует или процесс исчез">
1038 - **Jump-хост, push-уведомления прекращаются в ваше отсутствие**: это может происходить с Desktop на macOS или Linux, когда никто не отвечает на запрос входа jump-хоста, например push-уведомление на телефон. Тогда Desktop прекращает попытки переподключения, пока за компьютером никого нет. Когда вы разблокируете компьютер или начнёте им пользоваться, вы можете получить ещё одно push-уведомление, потому что Desktop может повторить попытку. После трёх попыток без ответа он ждёт, пока вы не повторите попытку или не отправите сообщение.
1039 - **Jump-хост, push-уведомления продолжают приходить**: там, где Desktop не может определить, что никто не отвечает, как в случае Desktop на Windows, он продолжает попытки, пока у него есть процесс, к которому можно снова присоединиться, независимо от того, работает ли этот процесс. С каждой попыткой вы можете получать новое push-уведомление. Чтобы прекратить попытки, закройте Desktop, что [может стоить вам выполняющейся задачи](#reopen-a-session-after-you-quit-desktop).
1040 - **Длительный перебой**: Desktop замедляется примерно до одной попытки каждые пять минут. Чтобы переподключиться быстрее, повторите попытку в сессии или отправьте сообщение, которое Desktop доставит после подключения.
1041 - **Отсутствующий вывод**: пока Desktop отключён, помощник хранит самый последний вывод Claude Code каждой сессии в буфере размером 16 MiB и отбрасывает более старый вывод. После переподключения Desktop сессия может показывать `Loading recent output from <host>…`. Если Desktop не может загрузить весь вывод, вы увидите строку `Some output produced while you were disconnected may be missing here.` Эта строка не означает, что задача остановилась.
1042 - **Процесс исчез**: если процесс исчез к моменту переподключения Desktop, Desktop может запустить новый на основе сохранённой истории диалога и сказать Claude продолжить задачу. Desktop не продолжает задачу самостоятельно, если процесс продолжает завершаться или если Desktop использует стороннего провайдера. Отправьте сообщение, чтобы продолжить.
1043</Accordion>
1044
1045<a id="reopen-a-session-after-you-quit-desktop" />
1046
1047<h5 id="reopen-a-session-after-you-quit-desktop">
1048 Повторное открытие сессии после закрытия Desktop
1049</h5>
1050
1051После того как вы закроете Desktop, задача продолжает выполняться на удалённой машине, пока не завершится, не потребует вашего участия или не достигнет одного из [ограничений](#limits-while-desktop-is-disconnected).
1052
1053* **Desktop на macOS или Linux, с учётной записью Claude**: запустите Desktop и откройте сессию. Вы вернёте выполняющуюся задачу, если Desktop сможет снова присоединиться к процессу. Это возможно не всегда, например после некоторых обновлений Desktop или после того, как ваша организация изменит свои управляемые настройки.
1054* **На macOS или Linux, когда Desktop не может снова присоединиться**: Desktop завершает процесс и запускает новый на основе сохранённой истории диалога. Ваша выполняющаяся задача останавливается, и вы теряете любое ожидавшее вас подтверждение или вопрос. После обновления Desktop затем может сказать Claude продолжить. Если задача так и остаётся остановленной, отправьте сообщение.
1055* **Desktop на Windows или со сторонним провайдером на любой платформе**: запускайте Desktop снова только тогда, когда ожидаете, что задача уже выполнена. Вы не вернёте выполняющуюся задачу, потому что после закрытия Desktop никогда не присоединяется к процессу снова. Он завершает процесс при открытии сессии, что может произойти при запуске Desktop. Отправьте сообщение, чтобы продолжить.
1056
1057Для сторонних развёртываний см. [SSH remote sessions in Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/ssh-remote-sessions).
1058
1059<Warning>
1060 Пока процесс Claude Code для диалога ещё работает, не выполняйте для него [`claude --resume`](/docs/ru/cli-reference#cli-flags) на удалённой машине. Claude Code вас не остановит, и тогда оба процесса будут писать в один и тот же диалог. Если вы не уверены, добавьте `--fork-session`, который продолжает работу в копии диалога, но оба процесса всё равно работают с одними и теми же файлами.
1061</Warning>
826 1062
827<h4 id="choose-where-ssh-session-worktrees-go">1063<h4 id="choose-where-ssh-session-worktrees-go">
828 Выбор расположения worktree для SSH-сессий1064 Выбор расположения worktree для SSH-сессий
8342. [`worktree.location`](/docs/ru/settings-reference#worktree-location) в `~/.claude/settings.json` на удалённой машине10702. [`worktree.location`](/docs/ru/settings-reference#worktree-location) в `~/.claude/settings.json` на удалённой машине
8353. `<project-root>/.claude/worktrees/` — значение по умолчанию10713. `<project-root>/.claude/worktrees/` — значение по умолчанию
836 1072
837Каждый проект получает собственную подпапку в заданной вами папке, поэтому при `~/worktrees` путь к worktree будет `~/worktrees/<project>-<id>/<worktree-name>`. Если заданная вами папка находится внутри проекта, Desktop игнорирует её для этого проекта и использует значение по умолчанию.1073Каждый проект получает собственную подпапку в заданной вами папке, поэтому при `~/worktrees` путь к worktree будет `~/worktrees/<project>-<id>/<worktree-name>`. Если заданная вами папка находится внутри проекта, Desktop игнорирует её для этого проекта и использует значение по умолчанию. На [удалённой машине с Windows](#windows-remote-machines) Desktop всегда использует значение по умолчанию.
838 1074
839Чтобы задать **Worktree folder** для соединения, добавленного вами ранее, или для соединения, управляемого вашей организацией, наведите на него курсор в раскрывающемся списке окружения и нажмите значок шестерёнки.1075Чтобы задать **Worktree folder** для соединения, добавленного вами ранее, или для соединения, управляемого вашей организацией, наведите на него курсор в раскрывающемся списке окружения и нажмите значок шестерёнки.
840 1076
