Настольное приложение

Получите больше возможностей от Claude Code Desktop: параллельные сеансы с изоляцией Git, макет панелей с перетаскиванием, интегрированный терминал и редактор файлов, боковые чаты, использование компьютера, отправка сеансов со своего телефона, визуальный просмотр различий, предпросмотр приложений, мониторинг PR, коннекторы и конфигурация для предприятий.

Приложение Claude Desktop имеет три вкладки: Chat для разговоров, Cowork для Dispatch и более длительной агентивной работы и Code для разработки программного обеспечения. Эта страница является справочником для вкладки Code.

Для Windows ARM64 скачайте установщик ARM64. На Linux установите с помощью apt; см. Claude Desktop на Linux.

После установки запустите Claude, войдите в систему и нажмите на вкладку Code. Для пошагового руководства вашего первого сеанса см. Руководство по началу работы.

На вкладке Code каждый разговор является сеансом: он имеет свою историю чата и папку проекта, независимые от любого другого сеанса. Боковая панель отображает ваши сеансы и позволяет запускать несколько параллельно. В рамках сеанса вы можете:

• Просматривать и комментировать различия, а затем отслеживать полученный PR через CI
• Просматривать ваше работающее приложение в панели браузера, пока Claude проверяет свои собственные изменения, и открывать внешние сайты рядом с ним
• Смотреть, как Claude запускает и тестирует ваше приложение iOS в панели iOS Simulator
• Организовать панели для чата, различий, браузера, терминала и редактора файлов рядом друг с другом
• Задать боковой вопрос, который использует контекст сеанса без отклонения от основного потока
• Позволить Claude проверять, отправлять сообщения или архивировать ваши другие сеансы
• Подключить внешние инструменты такие как GitHub, Slack и Linear
• Позволить Claude открывать приложения и управлять вашим экраном
• Запускать на вашей машине, в облаке или через SSH

Для запланированной повторяющейся работы, сочетаний клавиш или отправки задач со своего телефона см. связанные страницы и разделы. Если вы уже используете терминальный CLI, см. сравнение CLI для того, что переносится.

Начало сеанса

Перед отправкой первого сообщения настройте четыре параметра в области подсказки:

• Environment: выберите, где запускается Claude. Выберите Local для вашей машины, Cloud для облачной сессии, которая продолжается после закрытия приложения, SSH-соединение для удалённой машины, которой вы управляете, или на Windows WSL-дистрибутив. Задача в SSH-сессии может продолжать выполняться, пока Desktop отключён, но при использовании учётной записи Claude она может остановиться, когда истечёт срок её входа. См. конфигурация окружения.
• Project folder: выберите папку или репозиторий, с которым работает Claude. Для облачных сеансов вы можете добавить несколько репозиториев.
• Model: выберите модель из раскрывающегося списка рядом с кнопкой отправки. Вы можете изменить это во время сеанса.
• Permission mode: выберите, сколько автономности имеет Claude, из селектора режима. Вы можете изменить это во время сеанса.

Введите вашу задачу и нажмите Enter для начала. Каждый сеанс отслеживает свой собственный контекст и изменения независимо.

Работа с кодом

Предоставьте Claude правильный контекст, контролируйте, сколько он делает самостоятельно, и проверяйте внесённые им изменения.

Используйте поле промпта

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

Кнопка + рядом с полем промпта даёт вам доступ к вложениям файлов, скиллам, коннекторам и плагинам.

Примите предложенный промпт

После ответа Claude вкладка Code может показать предложенный следующий промпт серым текстом в пустом поле промпта. Claude Code генерирует каждое предложение на основе вашего диалога с помощью короткого фонового запроса, который учитывается в лимитах использования вашего плана или в ваших расходах на API.

• Использовать предложение: нажмите Tab или Стрелку вправо, чтобы поместить его в поле промпта, при желании отредактируйте, затем нажмите Enter для отправки. Нажатие Enter до того, как вы примете предложение, не отправляет его.
• Написать собственный промпт: начните вводить текст. Предложение отображается, только пока поле промпта пустое и в нём нет вложенных файлов.

Перейдите в Settings > Claude Code и отключите Prompt suggestions в разделе Sessions, чтобы предложения перестали появляться в каждой сессии со следующего её запуска или возобновления.

Добавляйте файлы и контекст в промпты

Поле промпта поддерживает два способа добавления внешнего контекста:

• @mention файлов: введите @ и имя файла, чтобы добавить файл в контекст диалога. Claude сможет затем читать и ссылаться на этот файл. @mention недоступен в облачных сессиях и сессиях WSL.
• Вложение файлов: вложите изображения, PDF-файлы и другие файлы в ваш промпт, используя кнопку вложения, или перетащите файлы прямо в поле промпта. Это полезно для обмена скриншотами ошибок, макетами дизайна или справочными документами.

Выберите режим разрешений

Режимы разрешений контролируют, насколько автономно Claude действует во время сессии: спрашивает ли он перед редактированием файлов, выполнением команд или обоим. Вы можете переключать режимы разрешений в любой момент, используя селектор режима рядом с кнопкой отправки. Чтобы подтверждать каждое изменение самостоятельно, переключитесь на Manual.

Чтобы установить режим по умолчанию для новых локальных сессий, добавьте permissions.defaultMode в ваш файл настроек. Приложение для рабочего стола читает те же файлы настроек, что и CLI. Режим, который вы выбираете в селекторе, запоминается для каждой папки и имеет приоритет над defaultMode для этой папки, за исключением Plan, который применяется только к текущей сессии.

Более ранние версии вкладки Code обозначали эти режимы как Ask permissions, Auto accept edits и Plan mode.

Режим разрешений dontAsk доступен только в CLI.

Облачные сессии поддерживают Accept edits, Plan и Auto. Accept edits соответствует режиму default: облачные сессии предварительно одобряют редактирование файлов, поэтому селектор показывает Accept edits вместо Manual. Bypass permissions недоступен в облачных сессиях, включая сессии в самостоятельно размещённой среде.

Администраторы Enterprise могут ограничить, какие режимы разрешений доступны. См. конфигурация enterprise для получения подробной информации.

Доступность авторежима

Авторежим доступен всем пользователям на Anthropic API и требует Claude Opus 4.6 или новее, Sonnet 4.6 или новее, Haiku 5.5 или модель Fable. Администраторы организации могут отключить авторежим с помощью ключа disableAutoMode в управляемых настройках.

В развёртываниях Enterprise, которые маршрутизируют Desktop на Google Cloud's Agent Platform, авторежим также доступен по умолчанию; см. Авторежим на Bedrock, Agent Platform или Foundry для поддерживаемых моделей.

Предпросмотр вашего приложения

Claude может запустить dev сервер и открыть его в панели Browser для проверки своих изменений. Это работает как для фронтенд веб-приложений, так и для бэкенд серверов: Claude может тестировать API-эндпоинты, просматривать логи сервера и итерировать по найденным проблемам. В большинстве случаев Claude автоматически запускает сервер после редактирования файлов проекта. Вы также можете попросить Claude выполнить предпросмотр в любой момент. По умолчанию Claude автоматически проверяет изменения после каждого редактирования.

Панель Browser также может открывать статические HTML файлы, PDF-файлы, изображения и видео из вашего проекта. Нажмите на путь HTML, PDF, изображения или видео в чате, чтобы открыть его там.

Из панели Browser вы можете:

• Взаимодействовать с вашим запущенным приложением прямо в панели Browser
• Смотреть, как Claude автоматически проверяет свои собственные изменения: он делает скриншоты, проверяет DOM, нажимает на элементы, заполняет формы и исправляет найденные проблемы
• Запускать или останавливать серверы либо останавливать все сразу из меню Dev servers в заголовке панели Browser
• Выбирать, сохраняет ли Browser cookies после выхода из приложения, с помощью Keep cookies в меню ⋮ панели Browser, чтобы вам не приходилось повторно входить во время разработки

Claude создаёт начальную конфигурацию сервера на основе вашего проекта. Если ваше приложение использует пользовательскую команду dev, отредактируйте .claude/launch.json в соответствии с вашей конфигурацией. См. Configure preview servers для полного справочника.

Чтобы очистить сохранённые данные Browser, выберите Clear browsing data в меню ⋮ панели Browser. Чтобы полностью отключить Browser, выключите Browser tools в Settings > Claude Code.

Просмотр внешних сайтов

Панель Browser — это браузер с вкладками, поэтому вы можете открывать документацию, трекеры задач или любой другой сайт рядом с вашим запущенным приложением. Чтобы открыть Browser, нажмите Cmd+Shift+B на macOS или Ctrl+Shift+B на Windows либо нажмите Browser в строке заголовка сессии. Вы можете войти на сайты в панели, включая всплывающие окна входа, такие как Google OAuth.

Когда вы впервые нажимаете на внешнюю ссылку в чате, диалоговое окно спрашивает, открывать ли ссылки в панели Browser или в вашем браузере по умолчанию. Чтобы позже изменить выбор, используйте Open links in built-in browser в меню ⋮ панели Browser. Нажатие с Cmd на macOS или с Ctrl на Windows открывает ссылку сразу в вашем браузере по умолчанию.

Claude может читать и взаимодействовать с внешними страницами, используя те же инструменты, которые он использует для проверки вашего приложения, с двумя дополнительными проверками безопасности:

• Классификаторы безопасности проверяют действия Claude по записи на внешних страницах, такие как нажатие и ввод текста, в каждом режиме разрешений. Это те же классификаторы, которые использует авторежим, и когда они помечают действие, вы получаете запрос разрешения независимо от режима.
• В режимах разрешений, отличных от Auto и Bypass permissions, проверка списка разрешённых доменов также применяется перед тем, как Claude переходит на новый сайт.

Подтвердите действия Claude на сайте

Когда Claude впервые действует на внешнем сайте, появляется карточка разрешения и Claude ждёт вашего выбора: Allow once, Always allow или Deny. Allow once подтверждает действие без сохранения чего-либо. Always allow сохраняет подтверждение для этого сайта на вашем устройстве, и вы можете отозвать его в Settings. Каждый сайт требует собственного подтверждения, включая поддомены. Ваши локальные dev серверы и файлы проекта не требуют подтверждения, поэтому auto-verify продолжает работать без запросов разрешения.

Даже на одобренном сайте Claude не будет покупать товары, создавать учётные записи или обходить CAPTCHA без вашего ввода. Просмотр в панели Browser использует ту же модель безопасности, что и Claude в расширении Chrome. См. Using Claude in Chrome safely для получения информации о том, как Claude обрабатывает чувствительные сайты и рискованные действия.

Выберите между Browser и расширением Chrome

Панель Browser использует чистый профиль браузера, отдельный от вашего личного браузера, без ваших сохранённых входов или истории. Используйте его для создания и тестирования вашего приложения и для сайтов, которые не требуют вашей личности. Когда вы хотите, чтобы Claude действовал как вы в ваших сессиях с выполненным входом, используйте вместо этого Claude в расширении Chrome, которое делится состоянием входа вашего браузера.

Ограничьте внешний просмотр для вашей организации

Browser следует тем же элементам управления списком разрешённых и заблокированных сайтов, что и расширение Claude в Chrome. Если ваша организация уже настроила эти списки для расширения, Browser их автоматически соблюдает. Администраторы также могут отключить инструменты Claude на внешних страницах с помощью управляемой настройки browserExternalPageTools. С отключёнными инструментами пользователи всё ещё могут посещать внешние сайты; инструменты Claude не могут их читать или действовать на них.

Чтобы полностью отключить внешний просмотр, установите управляемую настройку disableBrowserExternalNavigation в true. Это блокирует всю внешнюю навигацию в Browser, включая сайты в списке разрешённых вашей организации; локальные dev серверы и предпросмотры файлов продолжают работать. Используйте browserExternalPageTools, чтобы позволить пользователям продолжать просмотр внешних сайтов без инструментов Claude, и disableBrowserExternalNavigation, чтобы заблокировать внешние сайты как для пользователей, так и для Claude.

Проверьте изменения с помощью представления diff

После того как Claude вносит изменения в ваш код, представление diff позволяет вам проверить изменения файл за файлом перед созданием pull request.

Когда Claude изменяет файлы, появляется индикатор статистики diff, показывающий количество добавленных и удалённых строк, например +12 -1. Нажмите на этот индикатор, чтобы открыть средство просмотра diff, которое отображает список файлов слева и изменения для каждого файла справа.

Чтобы прокомментировать определённые строки, нажмите на любую строку в diff, чтобы открыть поле комментария. Введите ваш отзыв и нажмите Enter для добавления комментария. После добавления комментариев к нескольким строкам отправьте все комментарии сразу:

• macOS: нажмите Cmd+Enter
• Windows: нажмите Ctrl+Enter

Claude прочитает ваши комментарии и внесёт запрошенные изменения, которые появятся как новый diff, который вы можете проверить.

Проверьте ваш код

Чтобы Claude проверил ваши изменения перед тем, как вы сделаете коммит, введите /code-review в поле промпта. Результаты появятся в диалоге, когда код-ревью завершится.

В локальных сессиях, сессиях SSH и WSL результаты отображаются в карточке Code review, сгруппированные по файлам. Используйте карточку, чтобы работать с ними:

• Нажмите Walk through in diff, чтобы открыть представление diff и пройти по результатам по одному. Результат, относящийся к текущему diff, отображается у соответствующей строки, где вы можете нажать Fix this one или отклонить его.
• Нажмите Apply fixes, чтобы попросить Claude исправить результаты, которые всё ещё открыты.

В любой сессии вы также можете попросить Claude в поле промпта исправить то, что обнаружило код-ревью. О том, что ищет /code-review и какие аргументы принимает, см. Локальное код-ревью с помощью /code-review.

Мониторьте статус pull request

После того как вы откроете pull request, в сессии появляется строка статуса CI. Claude Code использует GitHub CLI для опроса результатов проверок и выявления сбоев.

• Auto-fix CI & address comments: когда включено, Claude автоматически пытается исправить неудачные проверки CI, читая вывод ошибки и итерируя. В локальной сессии Claude также обрабатывает новые комментарии ревью, оставленные кем-то кроме вас, если автор является владельцем репозитория, членом организации, соавтором (collaborator) или GitHub App.
• Auto-merge when ready: когда включено, Claude выполняет слияние PR после того, как все проверки пройдены. Метод слияния — squash. Сначала включите auto-merge в настройках вашего репозитория GitHub; без этого Claude не может выполнить слияние PR.

Чтобы включить эти функции, нажмите CI в строке статуса. Чтобы автоматически архивировать сессию после слияния или закрытия PR, включите auto-archive в Settings > Claude Code.

Организация рабочей области

Вкладка Code построена вокруг панелей, которые вы можете организовать в любой макет: чат, diff, браузер, терминал, файл, план, задачи и субагент, а также iOS Simulator на macOS. Перетащите панель за её заголовок, чтобы переместить её, или перетащите край панели, чтобы изменить её размер. Нажмите Cmd+\ на macOS или Ctrl+\ на Windows, чтобы закрыть сфокусированную панель. Нажмите Terminal, Changes или Browser в строке заголовка сессии, чтобы открыть панель терминала, diff или браузера. Меню ⋮ рядом с ними открывает дополнительные панели, такие как Files, и содержит эти кнопки, когда окно слишком узкое, чтобы их отобразить.

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

Запуск команд в терминале

Интегрированный терминал позволяет вам запускать команды рядом с вашей сессией без переключения на другое приложение. Нажмите Terminal в строке заголовка сессии или нажмите Ctrl+` на macOS или Windows. Терминал открывается в рабочем каталоге вашей сессии и делит то же окружение с Claude, поэтому команды, такие как npm test или git status, видят те же файлы, которые редактирует Claude. Чтобы открыть вторую вкладку терминала, нажмите + в заголовке панели терминала или щелкните правой кнопкой мыши на папке в чате, чтобы выбрать Open in terminal.

Терминал доступен в локальных и SSH-сессиях, с ограничением на удалённых машинах Windows.

Открытие и редактирование файлов

Нажмите на путь файла в чате или средстве просмотра различий, чтобы открыть его в панели файлов. HTML, PDF, пути изображений и видео открываются в панели браузера вместо этого. Сделайте точечные правки и нажмите Save, чтобы записать их обратно. Если файл изменился на диске с момента его открытия, панель предупредит вас и позволит вам переопределить или отклонить. Нажмите Discard, чтобы отменить ваши правки, или нажмите на путь в заголовке панели, чтобы скопировать абсолютный путь.

Панель файлов доступна в локальных и SSH-сессиях. Для облачных сессий попросите Claude сделать изменение.

Открытие файлов в других приложениях

Щелкните правой кнопкой мыши на любом пути файла в чате, средстве просмотра различий или панели файлов, чтобы открыть контекстное меню:

• Attach as context: добавьте файл к вашему следующему промпту
• Open in: откройте файл в установленном редакторе, таком как VS Code, Cursor или Zed
• Show in Finder на macOS, Show in Explorer на Windows: откройте содержащую папку
• Copy path: скопируйте абсолютный путь в буфер обмена

Переключение режимов просмотра

Режимы просмотра контролируют, сколько деталей появляется в транскрипте чата. Чтобы переключить режим просмотра, откройте меню сессии с помощью значка-стрелки рядом с названием сессии и выберите Transcript view, или нажмите Ctrl+O на macOS или Windows, чтобы циклически переходить через них. Режим Thinking появляется в меню только после того, как Claude выдал размышления в просматриваемой вами сессии.

Используйте Thinking, чтобы следить за рассуждениями Claude с вызовами инструментов, всё ещё свёрнутыми. Используйте Verbose при отладке того, почему Claude предпринял конкретное действие. Версии Claude Desktop до 1.46388.1 также содержат режим Summary, и сессия, всё ещё установленная на Summary, открывается в Normal после обновления.

Сочетания клавиш

Нажмите Cmd+/ на macOS или Ctrl+/ на Windows, чтобы увидеть все доступные сочетания клавиш на вкладке Code. На Windows используйте Ctrl вместо Cmd для сочетаний клавиш ниже. Циклическое переключение сессий, переключение терминала и переключение режима просмотра используют Ctrl на каждой платформе.

Эти сочетания клавиш применяются к вкладке Code. В Desktop Shift+Tab не переключает режимы разрешений по кругу, как это происходит в интерактивном режиме терминала.

Проверка использования

Нажмите на кольцо использования рядом с выбором модели, чтобы увидеть текущее использование контекстного окна и использование вашего плана за период. Использование контекста считается для каждой сессии; использование плана — общее для всех ваших интерфейсов Claude Code.

Позвольте Claude использовать ваш компьютер

Использование компьютера позволяет Claude открывать ваши приложения, управлять вашим экраном и работать непосредственно на вашей машине так, как вы бы это делали. Попросите Claude взаимодействовать с инструментом рабочего стола, который не имеет CLI, или автоматизировать что-то, что работает только через GUI. Для запуска и тестирования приложений iOS Desktop открывает выделенную панель iOS Simulator вместо управления вашим экраном; панель работает без включения использования компьютера.

Использование компьютера отключено по умолчанию. Включите его в Settings перед тем, как Claude сможет управлять вашим экраном. На macOS вам также нужно предоставить разрешения Accessibility и Screen Recording.

На macOS использование компьютера также может работать в фоновом режиме: Claude работает в приложениях, которые вы одобрили, пока вы продолжаете работать.

Когда применяется использование компьютера

Claude имеет несколько способов взаимодействия с приложением или сервисом, и использование компьютера — самый широкий и медленный. Он пытается использовать наиболее точный инструмент в первую очередь:

• Если у вас есть коннектор для сервиса, Claude использует коннектор.
• Если задача — это команда shell, Claude использует Bash.
• Если задача — это работа в браузере и у вас есть Claude в Chrome установлен, Claude использует это.
• Если задача — это запуск или тестирование приложения iOS, Claude использует панель iOS Simulator, которая не использует управление экраном.
• Если ничего из этого не применяется, Claude использует использование компьютера.

Уровни доступа для каждого приложения усиливают это: браузеры ограничены только просмотром, а терминалы и IDE — только кликом, направляя Claude к выделенному инструменту даже когда использование компьютера активно. Управление экраном зарезервировано для вещей, которые ничто другое не может достичь, таких как нативные приложения, панели управления оборудованием или собственные инструменты без API.

Включение использования компьютера

Использование компьютера отключено по умолчанию. Если вы попросите Claude сделать что-то, что нуждается в этом, пока это отключено, Claude скажет вам, что он мог бы сделать задачу, если вы включите использование компьютера в Settings.

Разрешения приложений

В первый раз, когда Claude нужно использовать приложение, в вашем сеансе появляется подсказка. Нажмите Allow for this session или Deny. Одобрения действуют для текущего сеанса, или 30 минут в сеансах, порождённых Dispatch.

Подсказка также показывает, какой уровень управления получает Claude для этого приложения. Эти уровни фиксированы по категории приложения и не могут быть изменены:

Приложения с широким охватом, такие как терминалы, Finder или File Explorer и System Settings или Settings, показывают дополнительное предупреждение в подсказке, чтобы вы знали, что даёт одобрение.

Раздел Computer use в Settings > This computer > System включает следующие параметры:

• Denied apps: добавьте приложения сюда, чтобы отклонить их без подсказки. Claude может всё ещё косвенно влиять на отклонённое приложение через действия в разрешённом приложении, но не может взаимодействовать с отклонённым приложением напрямую.
• Unhide apps when Claude finishes: когда использование компьютера не работает в фоновом режиме, Claude скрывает ваши другие окна, пока он работает, чтобы он взаимодействовал только с одобренным приложением. Когда Claude заканчивает, скрытые окна восстанавливаются, если вы не отключите этот параметр.

Управление сессиями

Каждая сессия — это независимый диалог со своим собственным контекстом и изменениями. Вы можете запускать несколько сессий параллельно, создавать боковые чаты, позволить Claude проверять ваши другие сессии и отправлять им сообщения, отправлять работу в облако или позволить Dispatch запускать сессии для вас с вашего телефона.

Параллельная работа с сессиями

Нажмите + New session в боковой панели или нажмите Cmd+N на macOS или Ctrl+N на Windows, чтобы работать над несколькими задачами параллельно. Нажимайте Ctrl+Tab и Ctrl+Shift+Tab, чтобы циклически переключаться между сессиями в боковой панели. Для Git-репозиториев выберите опцию worktree рядом с названием ветки, чтобы дать сессии собственную изолированную копию вашего проекта с помощью Git worktrees.

Чтобы просматривать две сессии одновременно, удерживайте Cmd на macOS или Ctrl на Windows и нажмите на сессию в боковой панели. Сессия откроется во второй панели рядом с той, которая у вас уже открыта. Пока разделение активно, нажатие на другую сессию в боковой панели заменяет ту панель, которая находится в фокусе. Нажмите Cmd+\ на macOS или Ctrl+\ на Windows, чтобы закрыть панель в фокусе и вернуться к одной сессии.

Worktrees по умолчанию хранятся в <project-root>/.claude/worktrees/. Вы можете изменить это на пользовательский каталог:

• Локальные сессии: задайте Worktree location в Settings > Claude Code
• Сессии SSH: задайте Worktree folder в SSH-подключении

Вы также можете задать Branch prefix в Settings > Claude Code. Desktop добавляет его в начало имени каждой ветки worktree, что полезно для упорядочивания веток, созданных Claude.

Чтобы удалить worktree после завершения работы, наведите курсор на сессию в боковой панели и нажмите значок архива. Чтобы сессии автоматически архивировались при слиянии или закрытии их pull request, включите Auto-archive after PR merge or close в Settings > Claude Code. Автоархивирование применяется только к локальным сессиям, которые завершили работу.

Чтобы включить файлы из gitignore, такие как .env, в новые worktrees, создайте файл .worktreeinclude в корне вашего проекта. Сведения о том, откуда сессия в worktree читает настройки проекта, хуки и скиллы, см. в разделе Что worktrees разделяют с основной рабочей копией.

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

Чтобы проверить использование контекста, см. Проверка использования. Когда контекст заполняется, Claude автоматически суммирует диалог и продолжает работу. Вы также можете ввести /compact, чтобы запустить суммирование раньше и освободить место в контексте. Подробнее о том, как работает сжатие контекста, см. в разделе контекстное окно.

Приложение для рабочего стола отправляет уведомление ОС, когда сессия Code завершает задачу, а вы в данный момент не просматриваете эту сессию. Для сессий, которые принадлежат проекту, вместо этого вы получаете уведомления проекта.

Задайте побочный вопрос, не сбивая сессию

Боковой чат позволяет задать Claude вопрос, который использует контекст вашей сессии, но ничего не добавляет обратно в основной диалог. Используйте его, когда хотите разобраться в фрагменте кода, проверить предположение или исследовать идею, не сбивая сессию с курса.

Нажмите Cmd+; на macOS или Ctrl+; на Windows, чтобы открыть боковой чат, или введите /btw в поле промпта. Боковой чат может читать всё в основном потоке до этого момента. Когда закончите, закройте боковой чат и продолжите основную сессию с того места, где остановились.

Боковые чаты доступны в локальных сессиях, а также в сессиях SSH и WSL. Приложение для рабочего стола не сохраняет боковые чаты на диск, поэтому вы не сможете вернуться к ним после закрытия приложения.

Наблюдение за фоновыми задачами

Панель задач показывает фоновую работу, выполняемую внутри текущей сессии: субагентов, фоновые shell-команды и динамические рабочие процессы. Когда в сессии появляется фоновая работа, откройте панель с помощью пункта Background tasks в меню ⋮ строки заголовка.

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

Работа между сессиями

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

Через этот интерфейс Claude видит только сессии, которые запускает само приложение для рабочего стола: локальные сессии, а также сессии SSH и WSL на вкладке Code. Claude не видит облачные сессии или сессии, которые вы запустили из CLI в терминале или из расширения VS Code, даже в worktrees того же проекта, поэтому при девяти открытых worktrees в терминале и двух сессиях в приложении для рабочего стола Claude, отвечающий в одной из них, сообщит об одной другой сессии в приложении. Claude никогда не включает в список сессию, из которой вы спрашиваете. По умолчанию он видит 20 последних активных сессий и пропускает архивированные сессии, если вы их не запросите. Обмен сообщениями между сессиями отдельно позволяет Claude отправлять сообщения вашим другим сессиям Claude Code, включая сессии в терминале.

Когда Claude отправляет сообщение другой сессии через этот интерфейс, Claude Code показывает его там в виде карточки с названием отправляющей сессии и обратной ссылкой, поэтому вы всегда можете определить, откуда пришло сообщение. Если получающая сессия находится в процессе выполнения задачи, Claude Code придерживает сообщение, и Claude прочитает его после завершения текущей работы. Получающий Claude может ответить, и Claude Code доставит ответ обратно через этот интерфейс. Claude не может доставить сообщение в архивированную сессию и сообщает вам, если сообщение не прошло.

Claude Code применяет четыре механизма безопасности между сессиями:

• Перед тем как Claude архивирует сессию, вы видите карточку подтверждения, кроме авторежима и режима Bypass permissions, в которых Claude может архивировать сессию без неё. Чтобы получать запрос, переключитесь в режим Manual.
• Через этот интерфейс Claude не может отправлять сообщения между сессиями из сессии, за которой никто не наблюдает, например из запуска запланированной задачи, и не может доставлять сообщения в такую сессию.
• Claude Code проверяет каждое сообщение из этого интерфейса на соответствие настройкам входящих сообщений получающей сессии, даже если в самой получающей сессии нет обмена сообщениями между сессиями. Если вы задали для crossSessionInbound значение refuse в получающей сессии, Claude Code отбрасывает сообщения из этого интерфейса. Claude Code сообщает об отказе приложению Claude для рабочего стола. До версии 2.1.234 Claude Code отбрасывал каждое сообщение из этого интерфейса, адресованное получающей сессии без обмена сообщениями между сессиями.
• Claude Code цитирует каждое входящее сообщение и указывает сессию, которая его отправила, а Claude при действиях по такому сообщению по-прежнему следует собственным настройкам разрешений получающей сессии.

Claude также может предлагать новые сессии. Когда он замечает что-то, что стоит исправить, но что выходит за рамки текущей задачи, он предлагает эту работу в виде чипа задачи в чате. Нажмите на чип, чтобы начать эту работу в новой сессии с собственным worktree; Claude продолжит вашу текущую сессию без перерыва.

Запуск долгих задач в облаке

Для крупных рефакторингов, наборов тестов, миграций или других долгих задач выберите Cloud вместо Local при запуске сессии. Облачные сессии по умолчанию работают на инфраструктуре, управляемой Anthropic, и продолжают работу, даже если вы закроете приложение или выключите компьютер. Возвращайтесь в любое время, чтобы проверить прогресс или направить Claude в другую сторону. Вы также можете отслеживать облачные сессии из claude.ai/code или мобильного приложения Claude.

Облачные сессии также поддерживают несколько репозиториев. После выбора облачного окружения нажмите кнопку + рядом с выбранным репозиторием, чтобы добавить в сессию дополнительные репозитории. Каждый репозиторий получает собственный селектор ветки. Это полезно для задач, охватывающих несколько кодовых баз, например при обновлении общей библиотеки и её потребителей.

Подробнее о том, как работают облачные сессии, см. Использование Claude Code в облаке. Когда для одного объёма работы нужно много облачных сессий, выберите Projects в боковой панели, чтобы создать проект, в котором Claude запускает и отслеживает сессии за вас из одного диалога.

Продолжение в другом интерфейсе

Чтобы продолжить сессию в другом месте, откройте меню сессии с помощью стрелки рядом с названием сессии или из строки сессии в боковой панели, затем выберите Open in:

• Выберите Cloud, чтобы продолжить сессию как облачную сессию, при этом ваш диалог будет перенесён в виде сводки. Перед подтверждением в диалоговом окне указано, будут ли перенесены и ваши файлы, и будет ли эта сессия архивирована, когда облачная будет готова. Таким способом нельзя перенести сессию, которая работает через SSH или в WSL.
• Выберите установленный редактор или файловый менеджер, чтобы открыть в нём папку сессии на диске.

Управление тем, какие сессии отображаются на других ваших устройствах

Локальная сессия появляется на других ваших устройствах после того, как Remote Control подключит её. Подключённая сессия отображается в списке сессий на claude.ai/code и в приложениях Claude на устройствах, на которых выполнен вход в вашу учётную запись claude.ai.

Локальная сессия подключается, когда вы включаете для неё Remote Control или когда она подключается автоматически при запуске:

• Вы включаете его для этой сессии: с помощью переключателя Remote Control сессии или введя /remote-control в её поле промпта.
• Она подключается при запуске: новые сессии подключаются автоматически, пока включён параметр Connect new sessions to Remote Control в Settings > Claude Code. Если вы никогда не меняли эту настройку, Desktop следует remoteControlAtStartup в ваших пользовательских или управляемых настройках, а затем значению по умолчанию вашей организации.

Чтобы узнать, подключена ли сессия, посмотрите на значок ноутбука перед названием сессии в панели инструментов. Значок подсвечивается, пока сессия подключена или подключается. Нажмите на него, чтобы открыть переключатель Remote Control сессии.

Чтобы сессии не появлялись на других ваших устройствах, отключите Remote Control на нужном уровне:

• Одна сессия: отключите её переключатель Remote Control. В сессии, которая подключилась при запуске, ввод /remote-control оставляет Remote Control включённым и показывает Remote Control is already on. This session connected automatically when it started. Нажмите Turn off в этой строке, чтобы отключиться.
• Новые сессии Desktop на этом компьютере: отключите Connect new sessions to Remote Control в Settings > Claude Code. Если параметр уже отображается отключённым, включите его, а затем отключите, чтобы Desktop сохранил ваш выбор. После сохранения он имеет приоритет над remoteControlAtStartup и значениями по умолчанию.
• Любая сессия на этом компьютере, включая CLI: задайте для disableRemoteControl значение true в ~/.claude/settings.json, чтобы сессии не подключались. Сессия, которая уже была подключена, когда вы сохранили файл, остаётся подключённой, пока вы не отключите для неё Remote Control.

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

Сессии из Dispatch

Dispatch — это постоянный диалог с Claude, который находится на вкладке Cowork. Вы отправляете Dispatch задачу, и он решает, как её обработать.

Задача может превратиться в сессию Code двумя способами: вы прямо просите об этом, например "открой сессию Claude Code и исправь ошибку входа", или Dispatch решает, что задача относится к разработке, и сам создаёт сессию. Задачи, которые обычно направляются в Code, включают исправление ошибок, обновление зависимостей, запуск тестов или открытие pull requests. Исследования, редактирование документов и работа с электронными таблицами остаются в Cowork.

В любом случае сессия Code появляется в боковой панели вкладки Code со значком Dispatch. Вы получаете push-уведомление на телефон, когда она завершится или потребует вашего подтверждения.

Если у вас включено использование компьютера, сессии Code, созданные Dispatch, тоже могут его использовать. Подтверждения для приложений в этих сессиях истекают через 30 минут и запрашиваются повторно, а не действуют всю сессию, как в обычных сессиях Code.

Сведения о настройке, сопряжении и параметрах Dispatch см. в статье справки Dispatch. Dispatch требует плана Pro или Max и недоступен на планах Team или Enterprise.

Dispatch — это один из нескольких способов работы с Claude, когда вы находитесь вдали от своего терминала. Сравнение с другими вариантами см. в разделе Платформы и интеграции.

Расширение Claude Code

Подключайте внешние сервисы, добавляйте повторно используемые рабочие процессы, настраивайте поведение Claude и конфигурируйте серверы предпросмотра. Чтобы управлять коннекторами, skills и плагинами в одном месте, нажмите Customize на боковой панели. Вкладка Cowork в приложении Desktop получает свои skills, плагины и коннекторы из этой конфигурации Customize, которая синхронизируется через вашу учётную запись claude.ai, а не из директории ~/.claude CLI.

Claude Code также загружает skills и плагины, включённые для вашей учётной записи claude.ai в сеансах терминала, где вы входите с той же учётной записью. См. Skills синхронизированные из claude.ai и Plugins синхронизированные из claude.ai.

Подключение внешних инструментов

Для локальных и SSH сеансов нажмите кнопку + рядом с полем подсказки и выберите Connectors, чтобы добавить интеграции, такие как Google Calendar, Slack, GitHub, Linear, Notion и другие. Вы можете добавлять коннекторы до или во время сеанса. Кнопка + недоступна в облачных или WSL сеансах, но routines конфигурируют коннекторы во время создания routine.

Чтобы управлять или отключать коннекторы, перейдите в Settings → Connectors в приложении desktop, или выберите Manage connectors из меню Connectors в поле подсказки.

После подключения Claude может читать ваш календарь, отправлять сообщения, создавать проблемы и взаимодействовать с вашими инструментами напрямую. Вы можете спросить Claude, какие коннекторы настроены в вашем сеансе.

Коннекторы — это MCP servers с графическим потоком установки. Используйте их для быстрой интеграции с поддерживаемыми сервисами. Для интеграций, не указанных в Connectors, добавьте MCP servers вручную через файлы параметров. Вы также можете создать пользовательские коннекторы.

Использование skills

Skills расширяют возможности Claude. Claude загружает их автоматически, когда они релевантны, или вы можете вызвать один напрямую: введите / в поле подсказки или нажмите кнопку + и выберите Slash commands, чтобы просмотреть доступные. Это включает встроенные команды, ваши пользовательские skills, skills проекта из вашей кодовой базы и skills из любых установленных плагинов. Выберите один, и он появится выделенным в поле ввода. Введите вашу задачу после него и отправьте как обычно.

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

Локальные сеансы загружают ваши личные skills из ~/.claude/skills/. Сеанс SSH читает ~/.claude/skills/ из домашней директории удалённого хоста, а не с вашей машины.

Локальные и облачные сеансы также загружают skills, включённые для вашей учётной записи claude.ai, за исключением локальных сеансов, когда ваша организация устанавливает disableSideloadFlags. Облачные сеансы загружают их вместо ~/.claude/skills/, как описано в Skills в сеансах Cowork и облачных сеансах.

Установка плагинов

Plugins — это повторно используемые пакеты, которые добавляют skills, agents, hooks, MCP servers и конфигурации LSP в Claude Code. Вы можете устанавливать плагины из приложения desktop без использования терминала.

Для локальных и SSH сеансов нажмите кнопку + рядом с полем подсказки и выберите Plugins, чтобы увидеть ваши установленные плагины и их skills. Чтобы добавить плагин, выберите Add plugin из подменю, чтобы открыть браузер плагинов, который показывает доступные плагины из ваших настроенных marketplaces, включая официальный marketplace Anthropic. Выберите Manage plugins, чтобы включить, отключить или удалить плагины.

Вы можете ограничить плагины вашей учётной записью пользователя, конкретным проектом или только локально. Если ваша организация управляет плагинами централизованно, эти плагины доступны в сеансах desktop так же, как они есть в CLI, за исключением тех, которые приложение desktop скрывает под disableSideloadFlags.

Браузер плагинов недоступен в облачных сеансах, и плагины, которые вы устанавливаете из приложения desktop, недоступны для облачных сеансов. Облачный сеанс также не устанавливает плагины, которые объявляет .claude/settings.json репозитория, как описано в Что переносится из вашей установки. Плагины недоступны в WSL сеансах. Для полного справочника плагинов, включая создание собственных плагинов, см. plugins.

Конфигурация серверов предпросмотра

Claude автоматически обнаруживает вашу установку dev-сервера и сохраняет конфигурацию в .claude/launch.json в корне папки, которую вы выбрали при запуске сеанса. Preview использует эту папку как свой рабочий каталог, поэтому если вы выбрали родительскую папку, подпапки с их собственными dev-серверами не будут обнаружены автоматически. Чтобы работать с сервером подпапки, либо запустите сеанс в этой папке напрямую, либо добавьте конфигурацию вручную.

Чтобы настроить, как запускается ваш сервер, например использовать yarn dev вместо npm run dev или изменить порт, отредактируйте .claude/launch.json. Файл поддерживает JSON с комментариями.

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "my-app",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "dev"],
      "port": 3000
    }
  ]
}

Вы можете определить несколько конфигураций для запуска разных серверов из одного проекта, таких как фронтенд и API. См. примеры ниже.

Автоматическая проверка изменений

Когда autoVerify включен, Claude автоматически проверяет изменения кода после редактирования файлов. Он делает скриншоты, проверяет ошибки и подтверждает работу изменений перед завершением своего ответа.

Auto-verify включен по умолчанию. Отключите его для каждого проекта, добавив "autoVerify": false в .claude/launch.json, или отключите Auto-verify changes в меню ⋮ панели Browser.

{
  "version": "0.0.1",
  "autoVerify": false,
  "configurations": [
    {
      "name": "my-app",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "dev"],
      "port": 3000
    }
  ]
}

Когда отключено, инструменты предпросмотра всё ещё доступны, и вы можете попросить Claude проверить в любое время. Auto-verify делает это автоматическим после каждого редактирования.

Поля конфигурации

Каждая запись в массиве configurations принимает следующие поля:

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "my-app",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "dev"],
      "port": 8443,
      "url": "https://localhost:8443"
    }
  ]
}

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "my-app",
      "url": "https://app.localhost:3000"
    }
  ]
}

{
"version": "0.0.1",
"configurations": [
{
"name": "web",
"runtimeExecutable": "yarn",
"runtimeArgs": ["dev"],
"port": 3000
}
]
}

{
"version": "0.0.1",
"configurations": [
{
"name": "frontend",
"runtimeExecutable": "npm",
"runtimeArgs": ["run", "dev"],
"cwd": "apps/web",
"port": 3000,
"autoPort": true
},
{
"name": "api",
"runtimeExecutable": "npm",
"runtimeArgs": ["run", "start"],
"cwd": "server",
"port": 8080,
"env": { "NODE_ENV": "development" },
"autoPort": false
}
]
}

{
"version": "0.0.1",
"configurations": [
{
"name": "server",
"program": "server.js",
"args": ["--verbose"],
"port": 4000
}
]
}

Окружение, которое вы выбираете при запуске сеанса, определяет, где Claude выполняется и как вы подключаетесь:

• Local: работает на вашей машине с прямым доступом к вашим файлам
• Cloud: работает на облачной инфраструктуре Anthropic по умолчанию. Сеансы продолжают работу даже если вы закроете приложение.
• SSH: работает на удалённой машине, к которой вы подключаетесь через SSH, такой как ваши собственные серверы, облачные виртуальные машины или dev-контейнеры. Запущенная задача может продолжать выполняться, пока Desktop отключён, но при использовании учётной записи Claude она может остановиться, когда истечёт срок действия её входа.
• WSL (Windows): работает внутри WSL 2 дистрибутива на вашей машине, используя его Linux toolchain и собственные пути

Локальные сеансы

Приложение desktop не всегда наследует полное окружение shell. На macOS, когда вы запускаете приложение из Dock или Finder, оно читает ваш профиль shell, такой как ~/.zshrc или ~/.bashrc, для извлечения PATH и фиксированного набора переменных Claude Code, но другие переменные, которые вы экспортируете там, не подхватываются. На Windows приложение наследует переменные окружения пользователя и системы, но не читает профили PowerShell.

Чтобы установить переменные окружения для локальных сеансов и dev-серверов на любой платформе, откройте раскрывающийся список окружения в поле подсказки, наведите курсор на Local и нажмите значок шестерёнки, чтобы открыть локальный редактор окружения. Переменные, которые вы сохраняете здесь, хранятся в зашифрованном виде на вашей машине и применяются к каждому локальному сеансу и серверу предпросмотра, который вы запускаете. Вы также можете добавить переменные к ключу env в вашем файле ~/.claude/settings.json, хотя они достигают только сеансов Claude, а не dev-серверов. См. переменные окружения для полного списка поддерживаемых переменных.

Расширенное мышление включено по умолчанию, что улучшает производительность на сложных задачах рассуждения, но использует дополнительные токены. На API Anthropic установите MAX_THINKING_TOKENS на 0 в локальном редакторе окружения, чтобы отключить мышление; это не влияет на Opus 5.5, Sonnet 5.5, Haiku 5.5 или модели Fable, которые всегда используют расширенное мышление. С отключённым мышлением на API Anthropic Claude Code отправляет effort high вместо более высокого уровня моделям, которые, как известно, не принимают эту комбинацию, таким как Opus 5.

На моделях с адаптивным рассуждением Claude Code игнорирует само число в положительном значении MAX_THINKING_TOKENS, потому что глубиной мышления вместо этого управляет адаптивное рассуждение. На Opus 4.6 и Sonnet 4.6 установите CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING на 1, чтобы использовать фиксированный бюджет мышления; модели Fable, Sonnet 5 и более поздние версии, Haiku 5.5, а также Opus 4.7 и более поздние версии всегда используют адаптивное рассуждение и не имеют режима фиксированного бюджета.

Локальные сеансы на управляемых устройствах

Ваш администратор может отключить локальные сеансы с помощью управляемого параметра disableDesktopLocalSessions. Когда это сделано, Local остаётся в раскрывающемся списке окружения, но становится серым и не может быть выбран, с подсказкой, говорящей, что ваша организация его отключила, и на Windows запись WSL, доступность которой на управляемых устройствах регулируется отдельно, становится серой таким же образом. Новые сеансы по умолчанию используют первое SSH-соединение, если оно настроено, и Desktop показывает сообщение, что локальные сеансы недоступны на этом устройстве, если вы попытаетесь продолжить существующий. Выберите вместо этого окружение SSH или cloud, или свяжитесь с вашей IT-командой.

Облачные сеансы

Облачные сеансы продолжают работу в фоне даже если вы закроете приложение. Использование считается в пределах лимитов вашего плана подписки без отдельных расходов на вычисления.

Вы можете создавать пользовательские облачные окружения с разными уровнями доступа к сети и переменными окружения. Для управления ими откройте раскрывающийся список окружения в поле подсказки и выберите Cloud:

• Add an environment: выберите Add cloud environment
• Edit or archive one of your own environments: наведите курсор на него и нажмите значок шестерёнки

См. Configure cloud environments для получения подробной информации о конфигурации доступа к сети и переменных окружения.

SSH-сеансы

SSH-сеансы позволяют вам запускать Claude Code на удалённой машине, используя приложение desktop как ваш интерфейс. Это полезно для работы с кодовыми базами, которые находятся на облачных виртуальных машинах, dev-контейнерах или серверах со специфическим оборудованием или зависимостями.

Чтобы добавить SSH-соединение, перед запуском сессии откройте раскрывающийся список окружения в поле промпта, затем выберите SSH > Add SSH connection… и заполните параметры соединения:

• Name: дружественный ярлык для этого соединения
• SSH host: user@hostname или хост, определённый в ~/.ssh/config
• SSH port: по умолчанию 22, если оставлено пустым, или используется порт из вашей конфигурации SSH
• SSH key (optional): путь к вашему приватному ключу, такой как ~/.ssh/id_ed25519. Оставьте пустым, чтобы использовать вашу конфигурацию SSH или SSH-агент.
• Worktree folder: папка на удалённой машине, такая как ~/worktrees, в которой новые сессии создают свои worktree. Оставьте пустым, чтобы использовать значение по умолчанию удалённой машины.

После добавления соединение появляется в разделе SSH раскрывающегося списка окружения. Выберите его для запуска сессии на этой машине. Claude работает на удалённой машине с доступом к её файлам и инструментам.

Удалённая машина может работать на Linux, macOS или Windows. Desktop автоматически устанавливает Claude Code на удалённой машине при первом подключении. После подключения SSH-сессии поддерживают режимы разрешений, коннекторы, плагины и MCP-серверы.

Требования к удалённой машине для SSH-сессий

Удалённой машине с Linux или macOS нужны поддерживаемый процессор, SSH-сервер с SFTP, папка установки, не смонтированная с noexec, работающая оболочка и доступ к сети. Проверьте каждое требование перед подключением или когда соединение не удаётся после входа:

• Система: процессор x86_64 или arm64. Машина также должна соответствовать системным требованиям Claude Code. На Linux для Claude Code требуется glibc 2.17 или более поздней версии либо musl. Чтобы узнать, что используется на машине, выполните там ldd --version. В дистрибутиве на основе musl, например Alpine Linux, также установите пакеты, которые нужны Claude Code.
• SFTP: SSH-сервер должен предоставлять подсистему SFTP, которую включает строка Subsystem sftp в его sshd_config. Чтобы проверить, подключитесь к тому же хосту и порту с помощью sftp в терминале на вашем компьютере. Работающий сервер показывает приглашение sftp>.
• Сессии на одно соединение: Desktop на macOS и Linux открывает несколько сессий в одном SSH-соединении. Если sshd_config сервера задаёт MaxSessions 1, увеличьте значение, например до значения OpenSSH по умолчанию, равного 10.
• Папка установки: Desktop устанавливает вспомогательную программу и Claude Code в ~/.claude/remote/ в вашем домашнем каталоге. Он запускает их оттуда, поэтому эта папка не может находиться в файловой системе, смонтированной с noexec. Выделите около 1 ГБ дискового пространства в домашнем каталоге каждого подключающегося пользователя. О том, что хранится в этой папке, см. Файлы и процессы на удалённой машине.
• Оболочка: оболочка, заданная для вашей учётной записи на удалённой машине, должна выполнять команды, отправленные через SSH, как это делают Bash, Zsh и sh
• Сеть: Claude Code работает на удалённой машине и выполняет сетевые запросы оттуда, поэтому машине нужен доступ к сети, который требуется Claude Code. Если машина не может загрузить Claude Code, Desktop загружает его на вашем компьютере и выгружает на машину. Остальные запросы Claude Code по-прежнему отправляются с удалённой машины. Если на удалённой машине с Linux этим запросам нужен прокси, задайте его для SSH-сессий.

Настройка прокси или сертификата CA для SSH-сессий

Если удалённая машина с Linux выходит в интернет через прокси или ей нужен сертификат CA, добавьте переменные прокси и CA в раздел env файла ~/.claude/settings.json на этой машине. Добавьте их, даже если вы уже экспортируете их в ~/.profile, ~/.bash_profile, ~/.zprofile или ~/.zshrc на этой машине.

SSH-сессия не получает их из этих файлов, даже если claude в терминале на этой машине их получает. Тогда сессия может зависнуть или показать The connection from … to the API failed или Authentication failed, и повторный вход не помогает.

{
"env": {
"HTTPS_PROXY": "http://proxy.example.com:8080",
"NODE_EXTRA_CA_CERTS": "/etc/ssl/certs/example-ca.pem"
}
}

Поиск переменной прокси или CA, заданной в другом месте на удалённой машине

Проверьте, не задаёт ли удалённая машина с Linux переменную прокси или CA в другом месте, потому что сессии используют это значение и игнорируют значение из любого файла настроек:

Использование вашей конфигурации SSH на macOS и Linux

На macOS и Linux Desktop подключается, запуская клиент OpenSSH на вашем компьютере, поэтому использует ваш ~/.ssh/config. Подключение через клиент OpenSSH требует Claude Desktop v1.37937.0 или более поздней версии. Введите имя Host из этого файла в поле SSH host, чтобы использовать настройки из его записи, такие как HostName, User, IdentityFile, CertificateFile, ProxyJump и ProxyCommand.

Прежде чем добавить соединение, проверьте клиент и запись в терминале на вашем компьютере:

• Версия клиента: выполните ssh -V. Клиент должен быть OpenSSH 7.6 или более поздней версии.
• Запись: выполните ssh с именем Host, например ssh devbox. Если это не удаётся, сначала исправьте запись.

Поля SSH port и SSH key (optional) можно оставить пустыми. Если вы заполните одно из них, Desktop использует его вместе с записью:

• SSH port: значение здесь переопределяет Port записи
• SSH key (optional): Desktop предлагает выбранный вами файл ключа в дополнение к IdentityFile записи и ключам в вашем SSH-агенте

Подключение к машине за jump-хостом

Чтобы подключиться к машине за jump-хостом, также называемым бастионом, задайте ProxyJump или ProxyCommand в записи. Следующая запись подключается к devbox.internal.example.com через bastion.example.com:

Host devbox
  HostName devbox.internal.example.com
  User alice
  ProxyJump bastion.example.com

Введите devbox в поле SSH host.

Подключение к контейнеру на удалённой машине

Чтобы запустить сессию внутри контейнера, который не публикует SSH-порт, подключайтесь к нему через ProxyCommand, потому что Desktop не выполняет RemoteCommand записи, к которой вы подключаетесь. Если ваша запись использует RemoteCommand для входа в контейнер, сессия работает на машине, на которую входит запись, а не в контейнере.

Host devbox-container
User dev
ProxyCommand ssh build.example.com docker exec -i devbox /usr/sbin/sshd -i

Использование переменных из вашей оболочки в `ProxyCommand`

Чтобы использовать собственную переменную окружения в команде ProxyCommand или Match exec, экспортируйте её в файле запуска оболочки, например ~/.zshrc, затем закройте и снова откройте Desktop. При запуске Desktop считывает то, что экспортирует ваша оболочка входа, и хранит эти значения, пока вы его не закроете.

Для этого требуется Claude Desktop v2.37337.0 или более поздней версии и команда env, которая принимает -0; это можно проверить, выполнив env -0 в терминале на вашем компьютере.

[profile corp]
region = us-east-1
credential_process = /full/path/to/your-credential-helper

Host i-*
ProxyCommand sh -c "aws ssm start-session --profile corp --target %h --document-name AWS-StartSSHSession --parameters 'portNumber=%p'"

Увеличение таймаута SSH-соединения

Если ваша конфигурация SSH не задаёт ConnectTimeout для хоста, Desktop даёт ssh 30 секунд на подключение. При использовании jump-хоста или ProxyCommand это время включает время, необходимое маршруту для подключения. Если вашему маршруту нужно больше времени, добавьте в запись большее значение:

Host devbox
  HostName devbox.internal.example.com
  User alice
  ProxyJump bastion.example.com
  ConnectTimeout 120

ssh использует первое найденное для хоста значение, поэтому размещайте запись выше любой записи Host *, которая задаёт ConnectTimeout. Чтобы убедиться, выполните ssh -G devbox в терминале на вашем компьютере. Его вывод содержит connecttimeout 120. После изменения значения закройте и снова откройте Desktop.

Если сама удалённая машина ожидает подтверждения на вашем телефоне, подтвердите в течение 45 секунд, какое бы значение ConnectTimeout вы ни задали. Этот лимит нельзя увеличить, потому что Desktop сам задаёт ServerAliveInterval и ServerAliveCountMax, и тогда ssh закрывает вход, во время которого удалённая машина ничего не отправляет в течение этого времени. Если вместо этого вас ожидает jump-хост или ProxyCommand, увеличьте ConnectTimeout в записи удалённой машины, чтобы покрыть это время.

Исправление блока `Match host`, который применяет только Desktop

Если Desktop использует настройку, которую не использует ssh devbox в терминале, найдите блок Match host выше строки HostName записи. В терминале ssh читает расположенный там блок до строки HostName, поэтому сравнивает блок с devbox. Desktop передаёт ssh значение HostName в командной строке, поэтому ssh сравнивает блок с этим значением.

Чтобы проверить, выполните ssh -G в терминале на вашем компьютере со значениями HostName и User записи в командной строке, как это делает Desktop:

ssh -G -o HostName=devbox.internal.example.com -l alice devbox

Сравните вывод с выводом ssh -G devbox. Если настройки блока, например proxycommand, появляются только в первом выводе, блок действует только в Desktop. Чтобы Desktop тоже его пропускал, добавьте !originalhost devbox в его строку Match:

Match host *.internal.example.com !originalhost devbox

Чтобы убедиться, снова выполните первую команду. Настройки блока больше не появляются в её выводе.

Настройки переадресации, которые Desktop оставляет выключенными

В своём соединении с удалённой машиной Desktop оставляет ForwardAgent, ForwardX11, LocalForward, RemoteForward, DynamicForward и Tunnel выключенными, даже если ваша конфигурация SSH их включает. В терминале или команде ! ваши настройки переадресации будут применяться лишь иногда, потому что Desktop может запустить там отдельный ssh, который им следует.

• Чтобы получить доступ к порту на удалённой машине: перенаправьте его самостоятельно
• Чтобы использовать собственные ключи с удалённой машины: настройте учётные данные на самой удалённой машине, например для git push

Чтобы Desktop не перенаправлял ваш SSH-агент или порт, выполните ssh -G devbox в терминале на вашем компьютере. Затем выполните команду снова так, как её может выполнить Desktop, со значениями hostname и user, которые она выводит, например ssh -G -o HostName=devbox.internal.example.com -l alice devbox. Второй вывод может показать настройки из блока Match, которые первый пропускает.

Найдите в обоих выводах строку forwardagent с любым значением, кроме no, и строки, начинающиеся с localforward, remoteforward или dynamicforward. Если найдёте такую, удалите эту настройку из вашей конфигурации SSH. Сделайте то же самое для хоста, к которому ваш ProxyCommand подключается с помощью ssh.

Доступ к порту на удалённой машине

Чтобы открыть сервер, работающий на удалённой машине, например dev-сервер на порту 3000, перенаправьте порт самостоятельно. В терминале на вашем компьютере выполните ssh с -L и хостом, к которому вы подключаетесь, например devbox:

ssh -N -L 3000:localhost:3000 devbox

Если в соединении вы заполнили SSH port или SSH key (optional), добавьте -p или -i с тем же значением. Оставьте эту команду работающей и откройте http://localhost:3000 в браузере на вашем компьютере, чтобы получить доступ к порту 3000 удалённой машины. Если ssh выводит open failed: administratively prohibited, попросите администратора машины разрешить TCP-переадресацию, которой управляет AllowTcpForwarding в sshd_config SSH-сервера.

Удалённые машины с Windows

Для удалённой машины с Windows требуется Claude Desktop v2.31226.0 или более поздней версии.

Используйте OpenSSH Server от Microsoft. Машина может быть x64 или ARM64. Оболочкой, которую запускает SSH-сервер, может быть cmd.exe, Windows PowerShell 5.1 или Git Bash.

Удалённые машины с Windows тестируются меньше, чем машины с Linux. Опробуйте на них свою работу, прежде чем полагаться на них.

На удалённой машине с Windows ожидайте, среди прочего, следующих ограничений:

• Терминал: терминал не открывается в сессии, папкой которой является путь Windows, например C:/projects/app
• Песочница: Claude Code работает там в нативной Windows, где выполняет команды без песочницы. См. где работает песочница.
• Плагины: Desktop не копирует плагин, содержащий имя файла или папки, которое Windows не может хранить, например имя с :. Сессия показывает список плагинов, которые Desktop пропустил.
• MCP-серверы: на некоторых удалённых машинах с Windows вызовы Claude к MCP-серверам из claude_desktop_config.json проходят через Desktop, поэтому Claude не может вызывать их инструменты, пока Desktop отключён. До Claude Desktop v2.37337.0 это справедливо для каждой удалённой машины с Windows.
• Worktree: worktree размещаются в <project-root>/.claude/worktrees/. Если вы выберете другую папку, Desktop её игнорирует.
• Более ранние сообщения: если оболочкой SSH-сервера является cmd.exe или Windows PowerShell, вам, возможно, придётся подключиться, прежде чем вы увидите более ранние сообщения сессии
• Форки: если оболочкой SSH-сервера является cmd.exe или Windows PowerShell, вы можете создать форк сессии только на её первом сообщении
• Работа при отключении: задача продолжает выполняться, пока Desktop отключён, только если SSH-сервер позволяет программе продолжать работу после закрытия соединения, которое её запустило. Чтобы это выяснить, протестируйте удалённую машину.
• Оставшиеся процессы: после завершения сессии проверьте машину на наличие программ, запущенных Claude Code, потому что они могут продолжать работать. Фоновый помощник, который устанавливает Desktop, там не останавливается сам по себе.

Продолжение задачи, пока Desktop отключён

Если ваш компьютер переходит в спящий режим, вы теряете сеть или закрываете Desktop, задача продолжается, пока не завершится, не потребует вашего участия или не достигнет одного из ограничений. Закрытие крышки считается спящим режимом. Перезапуск Desktop или вашего компьютера, в том числе для обновления, считается закрытием.

Claude Code работает как процесс на удалённой машине под управлением фонового помощника, который Desktop устанавливает там, поэтому ему не нужно ваше SSH-соединение, чтобы продолжать работу. Поведение, описанное в этом разделе, требует Claude Desktop v2.31226.0 или более поздней версии.

• После спящего режима или потери сети: вы вернёте выполняющуюся задачу, если процесс всё ещё работает и Desktop может войти без запроса. Если не может, отправьте сообщение.
• После закрытия, с Desktop на macOS или Linux и учётной записью Claude: вы вернёте выполняющуюся задачу, если Desktop сможет снова присоединиться к процессу. Если не сможет, задача остановится. Если она так и остаётся остановленной, отправьте сообщение.
• После закрытия, с Desktop на Windows или со сторонним провайдером: вы теряете выполняющуюся задачу, потому что Desktop завершает процесс при открытии сессии. Отправьте сообщение, чтобы продолжить.

Когда вы вернётесь, а задача не выполнена, проверьте, нет ли сообщения о том, что Desktop не может переподключиться, ошибки аутентификации или ожидающего запроса:

• Desktop не может переподключиться: сессия сообщает причину, и об этом также может сообщить уведомление. Возможно, Desktop нужно, чтобы вы вошли.
• Ошибка аутентификации: возможно, истёк срок действия токена входа или учётных данных. С учётной записью Claude отправьте сообщение, чтобы продолжить. Со сторонним провайдером см. SSH remote sessions in Claude Desktop on 3P.
• Ожидающий запрос: ответьте на него
• Ничего из этого: отправьте сообщение, чтобы продолжить

• Сначала обновитесь: обновите Desktop перед запуском длительной задачи. На macOS и Windows Desktop может самостоятельно перезапуститься, чтобы установить загруженное обновление. Этот перезапуск ожидает, пока Claude работает над SSH-задачей. На macOS с учётной записью Claude по умолчанию перезапуск всё же может произойти, когда обновление ожидает уже 72 часа.
• Не закрывайте Desktop: если Desktop работает на Windows или использует стороннего провайдера, оставьте его открытым, пока выполняется длительная задача. После закрытия он завершает выполняющуюся задачу при открытии сессии. Открытый Desktop не защищает запрос, который ожидает вас.
• Сократите число запросов: выберите режим разрешений, правила или хуки, благодаря которым задача будет реже ожидать вас
• Проверьте jump-хост: если ваш jump-хост запрашивает вход, например push-уведомление на телефон, перейдите на вход, который работает без запроса. Иначе Desktop может отправлять новое push-уведомление при каждой попытке переподключения.
• Протестируйте удалённую машину: запустите короткую задачу, закройте Desktop, пока задача ещё выполняется, и снова откройте сессию значительно позже того момента, когда задача должна была завершиться. Если задача не завершена, а сессия не показывает ошибку аутентификации, проверьте на удалённой машине, что может завершить задачу.
• Не выполняйте команды в терминале Desktop: если удалённая машина завершает сеансы бездействующих терминалов, выполняйте свои команды из SSH-входа вне Desktop

• Токен входа или учётные данные: с учётной записью Claude задача останавливается с ошибкой аутентификации, когда истекает срок действия токена. Со сторонним провайдером то же самое происходит с учётными данными, у которых истекает срок действия, например полученными через единый вход или вспомогательную программу для учётных данных. См. SSH remote sessions in Claude Desktop on 3P. С учётной записью Claude держите Desktop запущенным и подключённым, чтобы он мог продлевать вход.
• Удалённая машина: если удалённая машина перезапускается или завершает ваши процессы при закрытии SSH-соединения, выполняющаяся задача завершается. Пока Desktop отключён, ничто не запустит её снова. Так завершают ваши процессы машины с Linux, где параметр KillUserProcesses в systemd-logind равен yes и применяется к вашему пользователю. Чтобы задача продолжала выполняться на такой машине, попросите администратора сделать исключение для вашего пользователя, например с помощью KillExcludeUsers.
• Бездействующие терминалы: некоторые удалённые машины с Linux завершают сеанс терминала, в котором никто не вводил текст в течение заданного времени (StopIdleSessionSec в systemd-logind). С Desktop на macOS или Linux терминал сессии и команды ! по умолчанию используют SSH-соединение Desktop. Тогда такой выход разрывает соединение, пока Desktop подключён, и вместе с ним может завершиться выполняющаяся задача. Закрытие панели терминала этого не предотвращает, поэтому не выполняйте команды в этом терминале.
• Обновления Desktop: если обновление приносит новую версию помощника, Desktop заменяет помощник на удалённой машине при одном из последующих подключений, что может завершить ещё выполняющуюся задачу
• Длительное отсутствие: на удалённой машине с Linux или macOS, если Desktop не подключается в течение 30 дней, помощник останавливается и завершает все процессы Claude Code, работающие под его управлением. Подключитесь до истечения этого срока.

Редактирование файлов и некоторые инструменты могут не работать, пока Desktop отключён. Если они нужны задаче, держите Desktop подключённым:

• Worktree: в сессии, использующей worktree, Desktop проверяет каждое изменение файла, прежде чем Claude его внесёт. Пока Desktop отключён, каждое изменение ожидает около 30 секунд, а затем завершается ошибкой. Shell-команды по-прежнему выполняются. На удалённой машине с Linux или macOS изменения могут продолжать работать. Если вы не уверены, запустите сессию без worktree.
• Ограничения папок: если ваша организация ограничивает папки, которые могут использовать сессии, Desktop проверяет каждое чтение файла, поиск и изменение, с worktree или без него. Пока Desktop отключён, каждая такая операция ожидает до 10 минут, а затем завершается ошибкой.
• Коннекторы: коннекторы и другие инструменты, которые предоставляет Desktop, работают через Desktop, поэтому, пока он отключён, каждый вызов завершается ошибкой примерно через 30 секунд
• Workflows: Desktop проверяет каждый новый workflow перед его запуском, поэтому, пока Desktop отключён, новый workflow ожидает до 10 минут, а затем завершается ошибкой
• MCP-серверы: MCP-серверы, которые Claude Code запускает на удалённой машине, работают не через Desktop, поэтому Claude по-прежнему может вызывать их инструменты. Серверы из claude_desktop_config.json относятся к ним, только если Desktop не использует свой встроенный SSH-клиент. В противном случае, а также на некоторых удалённых машинах с Windows, Claude не может вызывать их инструменты, пока Desktop отключён.

drop connection #0 from [203.0.113.7]:51234 on [192.0.2.10]:22 penalty: connections without attempting authentication

fail2ban-regex -o ip lines.log "sshd[mode=aggressive]"

claude://code/new?ssh_host=dev%40build.example.com&ssh_port=2222&ssh_folder=/srv/payments&q=Investigate%20the%20failed%20deploy

{
  "sshConfigs": [
    {
      "id": "shared-dev-vm",
      "name": "Shared Dev VM",
      "sshHost": "user@dev.example.com",
      "sshPort": 22,
      "sshIdentityFile": "~/.ssh/id_ed25519"
    }
  ]
}

{
  "sshHostAllowlist": ["*.devboxes.example.com", "bastion.example.com"]
}

{
  "disableDesktopLocalSessions": true,
  "sshConfigs": [
    {
      "id": "shared-dev-vm",
      "name": "Shared Dev VM",
      "sshHost": "dev.example.com"
    }
  ],
  "sshHostAllowlist": ["dev.example.com"]
}

anthropic.com
*.anthropic.com
claude.ai
*.claude.ai
claude.com
*.claude.com
claude.app
*.claude.app
*.claudeusercontent.com
*.claudemcpcontent.com

anthropic.com
api.anthropic.com
a-api.anthropic.com
a-cdn.anthropic.com
s-cdn.anthropic.com
assets-proxy.anthropic.com
claude.ai
a.claude.ai
assets.claude.ai
downloads.claude.ai
*.livepreview.claude.ai
claude.com
platform.claude.com
*.livepreview.claude.app
*.claudeusercontent.com
*.claudemcpcontent.com

claude --desktop --resume <session-id>

git fetch origin <branch-name>
git checkout <branch-name>