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

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

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

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

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

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

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

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

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

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

Чтобы очистить сохранённые данные сеанса или полностью отключить Browser, используйте переключатели в Settings → Claude Code.

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

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

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

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

Одобрение действий Claude на сайте

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

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

Выбор между Browser и Chrome extension

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

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

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

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

Просмотр изменений с помощью diff view

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

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

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

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

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

Проверка вашего кода

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

Проверка сосредоточена на высокозначимых проблемах: ошибки компиляции, определённые логические ошибки, уязвимости безопасности и очевидные ошибки. Она не отмечает стиль, форматирование, существующие проблемы или что-либо, что поймал бы linter.

Мониторинг статуса pull request

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

• Auto-fix: когда включено, Claude автоматически пытается исправить сбои CI, читая вывод ошибки и итерируя.
• Auto-merge: когда включено, Claude объединяет PR после прохождения всех проверок. Метод слияния — squash. Auto-merge должен быть включен в параметрах вашего репозитория GitHub для работы.

Используйте переключатели Auto-fix и Auto-merge в строке статуса CI для включения любой опции. Claude Code также отправляет уведомление рабочего стола при завершении CI. Чтобы архивировать сеанс автоматически после слияния или закрытия PR, включите auto-archive в Settings → Claude Code.

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

Вкладка Code построена вокруг панелей, которые вы можете организовать в любой макет: чат, diff, браузер, терминал, файл, план, задачи и подагент, а также iOS Simulator на macOS. Перетащите панель за её заголовок, чтобы переместить её, или перетащите край панели, чтобы изменить её размер. Нажмите Cmd+\ на macOS или Ctrl+\ на Windows, чтобы закрыть сфокусированную панель. Откройте дополнительные панели из меню Views в панели инструментов сеанса.

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

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

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

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

Нажмите на путь файла в чате или средстве просмотра различий, чтобы открыть его в панели файлов. 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 в просматриваемом вами сеансе.

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

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

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

Эти сочетания клавиш применяются только к вкладке Code. Сочетания клавиш интерактивного режима на основе терминала, такие как Shift+Tab для циклирования режимов, не применяются в Desktop.

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

Нажмите на кольцо использования рядом с выбором модели, чтобы увидеть текущее использование окна контекста и использование вашего плана за период. Использование контекста — это за сеанс; использование плана — это общее для всех ваших поверхностей 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, показывают дополнительное предупреждение в подсказке, чтобы вы знали, что даёт одобрение.

Вы можете настроить два параметра в Settings > General (под Desktop app):

• 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/ по умолчанию. Вы можете изменить это на пользовательский каталог в Settings → Claude Code под "Worktree location". Вы также можете установить префикс ветви, который добавляется в начало каждого имени ветви worktree, что полезно для организации веток, созданных Claude. Чтобы удалить worktree после завершения, наведите курсор на сеанс в боковой панели и нажмите значок архива. Чтобы сеансы архивировали себя, когда их pull request объединяется или закрывается, включите Auto-archive after PR merge or close в Settings → Claude Code. Auto-archive применяется только к локальным сеансам, которые завершили работу.

Чтобы включить gitignored файлы, такие как .env, в новые worktrees, создайте .worktreeinclude файл в корне вашего проекта.

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

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

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

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

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

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

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

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

Панель задач показывает фоновую работу, выполняемую внутри текущего сеанса: подагентов, фоновые команды shell и динамические рабочие процессы. Откройте её из меню Views или перетащите её в ваш макет.

Нажмите на любую запись, чтобы увидеть её вывод в панели подагента или остановить её. Чтобы увидеть, что делают другие сеансы, используйте боковую панель, или попросите 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 сначала спрашивает вас. Вы видите карточку одобрения в каждом режиме разрешений, включая режимы Auto и Bypass.
• Через этот интерфейс 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 запускает и отслеживает сеансы для вас из одного разговора.

Продолжение на другой поверхности

Меню Continue in, доступное из значка VS Code в нижнем правом углу панели инструментов сеанса, позволяет вам переместить ваш сеанс на другую поверхность:

• Claude Code на веб-сайте: отправляет ваш локальный сеанс для продолжения удалённого запуска. Desktop отправляет вашу ветвь, генерирует сводку разговора и создаёт новый облачный сеанс с полным контекстом. Затем вы можете выбрать архивирование локального сеанса или его сохранение. Это требует чистого рабочего дерева и недоступно для SSH-сеансов.
• Ваша IDE: открывает ваш проект в поддерживаемой IDE в текущем рабочем каталоге.

Сеансы из 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 работает, так же как любое другое сообщение, и сеанс вернётся в режим ожидания после завершения хода. До версии 2.1.206 команда, отправленная во время хода, могла оставить сеанс в состоянии выполнения, и сообщения, которые вы отправили впоследствии, не доставлялись.

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

Локальные и облачные сеансы также загружают skills, включённые для вашей учётной записи claude.ai. Облачные сеансы загружают их вместо ~/.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, недоступны для облачных сеансов. Облачный сеанс также не устанавливает плагины, которые объявляет .claude/settings.json репозитория, как описано в Что переносится из вашей установки. Плагины недоступны в WSL сеансах. Для полного справочника плагинов, включая создание собственных плагинов, см. plugins.

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

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

Чтобы настроить, как запускается ваш сервер, например использовать yarn dev вместо npm run dev или изменить порт, отредактируйте файл вручную или нажмите Edit configuration в раскрывающемся списке сервера, чтобы открыть его в вашем редакторе кода. Файл поддерживает 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, или переключите его из меню раскрывающегося списка сервера.

{
  "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-контейнеры
• 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-серверов. См. переменные окружения для полного списка поддерживаемых переменных.

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

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

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

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

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

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

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

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

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

SSH-сеансы

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

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

• Name: дружественный ярлык для этого соединения
• SSH Host: user@hostname или хост, определённый в ~/.ssh/config
• SSH Port: по умолчанию 22, если оставлено пусто, или использует порт из вашего SSH config
• Identity File: путь к вашему приватному ключу, такой как ~/.ssh/id_rsa. Оставьте пусто, чтобы использовать ключ по умолчанию или ваш SSH config.

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

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

Предварительная конфигурация SSH-соединений для вашей команды

Администраторы могут распространять SSH-соединения членам команды, добавляя sshConfigs в файл управляемых параметров. Соединения, определённые таким образом, появляются в раскрывающемся списке окружения каждого пользователя автоматически и отображаются как управляемые, поэтому пользователи могут выбирать их, но не могут редактировать или удалять их в приложении.

Следующий пример предварительно конфигурирует одно соединение:

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

Каждая запись требует id, name и sshHost. Поля sshPort и sshIdentityFile являются необязательными. Пользователи также могут добавить sshConfigs в свой собственный ~/.claude/settings.json, где хранятся соединения, добавленные через диалог.

Ограничение SSH-хостов, к которым могут подключаться пользователи

Администраторы могут ограничить SSH-сеансы Desktop утверждённым набором хостов, добавляя sshHostAllowlist в файл управляемых параметров. Когда это установлено, пользователи могут подключаться только к хостам, разрешённое имя хоста которых совпадает с одним из шаблонов. Установите его в пустой массив, чтобы полностью отключить SSH-сеансы.

Следующий пример разрешает соединения с любым хостом под devboxes.example.com и с одним именованным хостом-бастионом:

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

Шаблоны не чувствительны к регистру. * совпадает с любым хостом, и *.example.com совпадает с example.com и любым поддоменом. Всё остальное — это точное совпадение. Проверка выполняется для имени хоста после разрешения ~/.ssh/config через ssh -G, поэтому псевдонимы Host и записи ProxyCommand/ProxyJump разрешены, пока разрешённое HostName совпадает.

sshHostAllowlist читается только из управляемых параметров; значения в параметрах пользователя или проекта игнорируются. Только приложение Claude Desktop соблюдает этот параметр; Claude Code CLI и расширения IDE не читают его, и он не ограничивает команды ssh, выполняемые через инструмент Bash. Он управляет тем, к каким хостам подключается приложение Desktop, а не сетевым исходящим трафиком, поэтому объедините его с сетевыми элементами управления вашей организации или элементами управления с нулевым доверием, если вам нужна жёсткая граница.

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

Организации на планах Team или Enterprise могут управлять поведением приложения desktop через элементы управления консоли администратора, управляемые файлы параметров и политики управления устройствами.

Элементы управления консоли администратора

Эти параметры настраиваются через консоль параметров администратора:

• Code in the desktop: контролируйте, могут ли пользователи в вашей организации получать доступ к Claude Code в приложении desktop
• Code in the web: включите или отключите облачные сеансы для вашей организации
• Remote Control: включите или отключите Remote Control для вашей организации
• Disable Bypass permissions mode: предотвратите пользователей в вашей организации от включения режима обхода разрешений

Управляемые параметры

Управляемые параметры переопределяют параметры проекта и пользователя и применяются к сеансам Claude Code в Desktop. Вы можете установить эти ключи в файле управляемых параметров вашей организации или отправить их удалённо через консоль администратора.

Какие управляемые параметры достигают сеанса Desktop, зависит от того, где этот сеанс работает. Ограничения модели, такие как availableModels, применяются в сеансах Claude Code Desktop так же, как в CLI терминала; см. охват поверхности.

• Локальные сеансы на этой машине: применяется файл управляемых параметров, развёрнутый на диск. Управляемые параметры, отправленные удалённо через консоль администратора, также достигают эти сеансы на API Anthropic, когда сеанс аутентифицируется с помощью подходящего входа или ключа, следуя тому же приоритету параметров, что и CLI терминала.
• Облачные сеансы: получают параметры, управляемые сервером; развёрнутые на устройстве файлы не достигают их, потому что они работают на управляемых Anthropic виртуальных машинах. Сеансы, маршрутизированные в самостоятельно размещённую среду, также читают файл управляемых параметров в образе runner. Как Claude Code объединяет управляемые источники говорит, когда этот файл применяется.
• SSH-сеансы: сеанс читает файл управляемых параметров с удалённого хоста. Desktop сам читает sshConfigs, sshHostAllowlist и disableDesktopLocalSessions из управляемых параметров локальной машины.
• Cowork сеансы: в сеансе Cowork на этой машине Claude Code никогда не получает параметры консоли администратора, даже когда пользователь входит с учётной записью Team или Enterprise, и читает политику, развёрнутую на машине, если только ваша конфигурация Claude Desktop не устанавливает requireCoworkFullVmSandbox. Удалённые сеансы Cowork не получают ни то, ни другое. См. где и когда применяется политика для того, какие файлы устройства достигают Cowork, и правила разрешений MCP для того, как правила Bash и WebFetch применяются к инструментам Cowork.

В локальных и SSH-сеансах приложение desktop доставляет каждого подключённого пользователя claude.ai connectors непосредственно в Claude Code. Никакой параметр MCP или managed-mcp.json не достигает этих connectors, независимо от того, какой источник параметров или расположение файла вы используете. Чтобы заблокировать инструменты connector в этих сеансах, используйте элементы управления инструментами connector вашей организации. Как connectors достигают Claude Code показывает, какие параметры управляют connectors в каждом виде сеанса.

permissions.disableBypassPermissionsMode и disableAutoMode также работают в параметрах пользователя и проекта, но размещение их в управляемых параметрах предотвращает пользователей от их переопределения.

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

Политики управления устройствами

IT-команды могут управлять приложением desktop через MDM на macOS или групповую политику на Windows. Доступные политики включают включение или отключение функции Claude Code, контроль автоматических обновлений и установку пользовательского URL развёртывания.

• macOS: настройте через домен предпочтений com.anthropic.claudefordesktop, используя инструменты, такие как Jamf или Kandji
• Windows: настройте через реестр в SOFTWARE\Policies\Claude

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

Desktop загружает код приложения и содержимое пользователя с хостов CDN Anthropic.

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

Трафик использует HTTPS на порту 443, если вы не настроите пользовательский порт для OTLP, шлюза LLM или MCP-сервера.

Для прокси-серверов, пользовательских центров сертификации, mTLS и доменов, которые требуются автономному CLI, см. конфигурация сети.

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

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
a-cdn.claude.ai
assets.claude.ai
downloads.claude.ai
*.livepreview.claude.ai
claude.com
platform.claude.com
*.livepreview.claude.app
*.claudeusercontent.com
*.claudemcpcontent.com

Если ваша организация имеет IP allowlisting включённый для Claude, маршрутизируйте bridge.claudeusercontent.com через тот же выход прокси, что и claude.ai и api.anthropic.com. Если вы не можете маршрутизировать это таким образом, добавьте адрес выхода, который ваш прокси использует для этого хоста, в список разрешённых IP вашей организации, но только когда этот адрес выделен для вашей организации: общий диапазон выхода прокси также допускает других клиентов поставщика прокси.

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

Артефакт, который загружает шрифт из Google Fonts, также запрашивает fonts.googleapis.com и fonts.gstatic.com. Оба хоста являются необязательными. Если вы их блокируете, артефакты отображаются в резервных шрифтах. Блокируйте с быстрым отклонением, а не с молчаливым отбросом, чтобы запрос шрифта не удался немедленно, вместо того чтобы задержать первый рендер страницы.

Артефакты также могут загружать библиотеки JavaScript, такие как React или пакет диаграмм, из cdnjs.cloudflare.com, cdn.jsdelivr.net, cdn.tailwindcss.com, code.jquery.com и unpkg.com, и ни откуда больше. Если вы блокируете эти хосты, части артефакта, которые зависят от библиотеки, не работают, и в отличие от заблокированного шрифта, заблокированная библиотека не имеет резервного варианта. Блокируйте с быстрым отклонением и здесь, чтобы заблокированный запрос библиотеки не удался сразу, вместо того чтобы зависнуть до истечения времени ожидания.

Аутентификация и SSO

Организации предприятия могут требовать SSO для всех пользователей. См. аутентификация для деталей уровня плана и Setting up SSO для конфигурации SAML; настройка OIDC рассматривается в Claude Enterprise Administrator Guide.

Обработка данных

Claude Code обрабатывает ваш код локально в локальных сеансах или в облачных сеансах на управляемой Anthropic инфраструктуре, если только ваша организация не маршрутизирует их в самостоятельно размещённую среду. Облачные сеансы, включая в самостоятельно размещённую среду, отправляют разговоры и контекст кода в API Anthropic для обработки; локальные и SSH-сеансы отправляют их в какого бы поставщика модели ваше развёртывание не настраивало, по умолчанию в API Anthropic. См. обработка данных для получения подробной информации о сохранении данных, конфиденциальности и соответствии.

Развёртывание

Desktop можно распространять через инструменты развёртывания предприятия:

• macOS: распространяйте через MDM, такой как Jamf или Kandji, используя установщик .dmg
• Windows: развёртывайте через пакет MSIX. См. Deploy Claude Desktop for Windows для опций развёртывания предприятия, включая автоматическую установку

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

Для полного справочника конфигурации предприятия см. руководство конфигурации предприятия.

Переход с CLI?

Если вы уже используете Claude Code CLI, Desktop запускает тот же базовый механизм с графическим интерфейсом. Вы можете запускать оба одновременно на одной машине, даже на одном проекте. Каждый поддерживает отдельную историю сеансов, и вы можете перенести сеанс CLI в Desktop. Они делят конфигурацию и память проекта через файлы CLAUDE.md.

Чтобы переместить сеанс CLI в Desktop, запустите /desktop в терминале. Claude сохраняет ваш сеанс и открывает его в приложении desktop, затем выходит из CLI. Эта команда доступна на macOS и x64 Windows, когда вы вошли с подпиской Claude. Она недоступна при аутентификации по ключу API или на Amazon Bedrock, Google Cloud's Agent Platform или Microsoft Foundry.

Чтобы продолжить сеанс CLI из Desktop, введите /resume в поле подсказки. Desktop выводит список сеансов, которые вы запустили из CLI, и вы можете искать их по названию, папке или ветке и просмотреть, где каждый из них остановился. Выберите сеанс, и он продолжится в приложении с полной историей разговора и контекстом.

Эквиваленты флагов CLI

Эта таблица показывает эквивалент приложения desktop для общих флагов CLI. Флаги, не указанные, не имеют эквивалента desktop, потому что они предназначены для скриптов или автоматизации.

Общая конфигурация

Desktop и CLI читают одни и те же файлы конфигурации, поэтому ваша установка переносится:

• CLAUDE.md и CLAUDE.local.md файлы в вашем проекте используются обоими
• MCP servers настроенные в ~/.claude.json или .mcp.json работают в обоих
• Hooks и skills определённые в параметрах применяются к обоим
• Settings в ~/.claude.json и ~/.claude/settings.json общие. Правила разрешений, разрешённые инструменты и другие параметры в settings.json применяются к сеансам Desktop.
• Models: те же модели доступны в обоих. В Desktop выберите модель из раскрывающегося списка рядом с кнопкой отправки. Вы можете изменить модель во время сеанса из того же раскрывающегося списка.

MCP servers из приложения Claude Desktop chat

Приложение Desktop загружает MCP servers из claude_desktop_config.json в сеансы вкладки Code, наряду с серверами из ~/.claude.json и .mcp.json. Сервер, определённый в claude_desktop_config.json, доступен как в поверхности Desktop chat, так и в локальных сеансах вкладки Code.

Если вы определяете одно и то же имя сервера в claude_desktop_config.json и в ~/.claude.json или .mcp.json, вкладка Code в локальных сеансах подключается один раз и использует определение claude_desktop_config.json.

Приложение также повторно доставляет stdio серверы из ~/.claude.json встроенному CLI в локальных сеансах. Когда верхний уровень ~/.claude.json (область пользователя) и .mcp.json определяют одно и то же имя stdio сервера, вкладка Code использует определение ~/.claude.json, отступая от иерархии области видимости CLI.

Сравнение функций

Эта таблица сравнивает основные возможности между CLI и Desktop. Для полного списка флагов CLI см. справочник CLI.

Что недоступно в Desktop

Следующие функции недоступны в Desktop, кроме случаев, указанных ниже:

• Сторонние провайдеры: Desktop подключается к API Anthropic по умолчанию. Для маршрутизации Desktop через шлюз или для запуска вкладки Code на Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry или самостоятельно размещённом шлюзе LLM, следуйте ссылкам в строке Third-party providers.
• Linux (бета): Computer Use ещё недоступна в приложении desktop Linux. См. Claude Desktop на Linux.
• Встроенные предложения кода: Desktop не предоставляет предложения в стиле автодополнения. Это работает через разговорные подсказки и явные изменения кода.
• Команды агентов: координируемые команды, где Claude как лидер команды назначает задачи товарищам по команде из общего списка задач, доступны в CLI, а не в Desktop. Для многоагентной работы внутри одного сеанса используйте динамические рабочие процессы, которые работают в Desktop; Claude также может отправлять сообщения и управлять вашими другими сеансами напрямую.
• Команды диалога терминала: встроенные команды, которые открывают интерактивную панель в терминале, ведут себя иначе на вкладке Code. Отредактируйте файлы параметров напрямую, чтобы управлять правилами разрешений и конфигурацией, или запустите команды из автономного CLI.
  • Команды без формы аргумента, такие как /permissions, отвечают с isn't available in this environment.
  • /config открывает Settings → Claude Code. Текст после команды игнорируется, поэтому /config theme=dark не устанавливает тему.

Устранение неполадок

Разделы ниже охватывают проблемы, специфичные для приложения desktop. Для ошибок API времени выполнения, которые появляются в чате, такие как API Error: 500, 529 Overloaded, 429 или Prompt is too long, см. справочник ошибок. Эти ошибки и их исправления одинаковы для CLI, desktop и веб.

Проверка вашей версии

Чтобы увидеть, какую версию приложения desktop вы запускаете:

• macOS: нажмите Claude в строке меню, затем About Claude
• Windows: нажмите Help, затем About

Нажмите на номер версии, чтобы скопировать его в буфер обмена.

Ошибки 403 или аутентификации на вкладке Code

Если вы видите Error 403: Forbidden или другие сбои аутентификации при использовании вкладки Code:

1. Выйдите и снова войдите из меню приложения. Это наиболее частое исправление.
2. Проверьте, что у вас есть активная платная подписка: Pro, Max, Team или Enterprise.
3. Если CLI работает, но Desktop нет, полностью закройте приложение desktop, не просто закрывайте окно, затем снова откройте и войдите.
4. Проверьте ваше интернет-соединение и параметры прокси.

Пустой или зависший экран при запуске

Если приложение открывается, но показывает пустой или неответный экран:

1. Перезагрузите приложение.
2. Проверьте наличие ожидающих обновлений. На macOS и Windows приложение автоматически обновляется при запуске; на Linux обновите через apt, как описано в Claude Desktop на Linux.
3. На управляемой сети убедитесь, что ваш брандмауэр разрешает хосты CDN в требованиях к сетевому доступу.
4. На Windows проверьте Event Viewer на логи сбоев под Windows Logs → Application.

"Failed to load session"

Если вы видите Failed to load session, выбранная папка может больше не существовать, Git-репозиторий может требовать Git LFS, который не установлен, или разрешения файлов могут предотвратить доступ. Попробуйте выбрать другую папку или перезагрузить приложение.

Сеанс не находит установленные инструменты

Если Claude не может найти инструменты, такие как npm, node или другие команды CLI, проверьте, что инструменты работают в вашем обычном терминале, проверьте, что ваш профиль оболочки правильно устанавливает PATH, и перезагрузите приложение desktop для перезагрузки переменных окружения.

Ошибки Git и Git LFS

Сеансы, которые работают в собственном worktree, требуют Git. Если вы видите "Git is required," установите Git, или Git для Windows на Windows, и попробуйте снова. На Windows версии Claude Desktop до 1.49585.0 запрашивали Git перед запуском любого локального сеанса; если вы видите это приглашение и не используете worktrees, обновите приложение.

Если вы видите "Git LFS is required by this repository but is not installed," установите Git LFS из git-lfs.com, запустите git lfs install и перезагрузите приложение.

MCP servers не работают на Windows

Если переключатели MCP server не реагируют или серверы не подключаются на Windows, проверьте, что сервер правильно настроен в ваших параметрах, перезагрузите приложение, проверьте, что процесс сервера работает в Task Manager, и проверьте логи сервера на ошибки подключения.

Приложение не закрывается

• macOS: нажмите Cmd+Q. Если приложение не реагирует, используйте Force Quit с Cmd+Option+Esc, выберите Claude и нажмите Force Quit.
• Windows: используйте Task Manager с Ctrl+Shift+Esc, чтобы завершить процесс Claude.

Проблемы, специфичные для Windows

• PATH не обновлён после установки: откройте новое окно терминала. Обновления PATH применяются только к новым сеансам терминала.
• Ошибка одновременной установки: если вы видите ошибку о другой установке в процессе, но её нет, попробуйте запустить установщик от имени администратора.

"Branch doesn't exist yet" при открытии в CLI

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

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

Всё ещё застряли?

• Откройте Help → Get Support в приложении desktop или посетите центр поддержки Claude напрямую
• Для проблем, которые также воспроизводятся в автономном CLI claude, поищите или подайте отчёт об ошибке на GitHub Issues

При подаче отчёта об ошибке включите версию приложения desktop, вашу операционную систему, точное сообщение об ошибке и соответствующие логи. На macOS проверьте Console.app. На Windows проверьте Event Viewer → Windows Logs → Application. Просмотрите отрывки логов перед их публикацией в открытую задачу; они могут включать пути к файлам и другие детали из вашей среды.