SpyBara
Go Premium

desktop.md 2026-05-02 18:14 UTC to 2026-05-04 22:58 UTC

761 added, 0 removed.

2026
Sun 31 06:39 Sat 30 06:23 Fri 29 06:38 Thu 28 06:37 Wed 27 06:42 Tue 26 06:33 Sun 24 06:25 Sat 23 06:18 Fri 22 06:33 Thu 21 06:36 Wed 20 06:35 Tue 19 06:34 Mon 18 23:59 Sun 17 01:01 Fri 15 22:58 Thu 14 17:02 Wed 13 23:01 Tue 12 22:57 Mon 11 23:00 Sun 10 23:03 Sat 9 04:57 Fri 8 22:00 Thu 7 22:59 Tue 5 23:00 Mon 4 22:58 Sat 2 18:14 Fri 1 18:19

Использование Claude Code Desktop

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

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

apple Download for macOS

Universal build for Intel and Apple Silicon
windows Download for Windows

For x64 processors

For Windows ARM64, download the ARM64 installer. The desktop app is not available on Linux; use the CLI instead.

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

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

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

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

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

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

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

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

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

Использование поля подсказки

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

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

Добавление файлов и контекста к подсказкам

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

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

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

Режимы разрешений контролируют, сколько автономности имеет Claude во время сеанса: спрашивает ли он перед редактированием файлов, запуском команд или обоих. Вы можете переключать режимы в любое время, используя селектор режима рядом с кнопкой отправки. Начните с Ask permissions, чтобы увидеть ровно то, что делает Claude, затем переходите к Auto accept edits или Plan mode по мере того, как вы становитесь более уверены.

Режим Ключ параметров Поведение
Ask permissions default Claude спрашивает перед редактированием файлов или запуском команд. Вы видите различия и можете принять или отклонить каждое изменение. Рекомендуется для новых пользователей.
Auto accept edits acceptEdits Claude автоматически принимает редактирование файлов и общие команды файловой системы, такие как mkdir, touch и mv, но всё ещё спрашивает перед запуском других команд терминала. Используйте это, когда вы доверяете изменениям файлов и хотите более быструю итерацию.
Plan mode plan Claude читает файлы и запускает команды для исследования, затем предлагает план без редактирования вашего исходного кода. Хорошо для сложных задач, где вы хотите сначала проверить подход.
Auto auto Claude выполняет все действия с фоновыми проверками безопасности, которые проверяют соответствие вашему запросу. Снижает подсказки разрешений при сохранении надзора. Включите в Settings → Claude Code. См. требования доступности ниже.
Bypass permissions bypassPermissions Claude работает без каких-либо подсказок разрешений, эквивалентно --dangerously-skip-permissions в CLI. Включите в Settings → Claude Code под "Allow bypass permissions mode". Используйте только в изолированных контейнерах или виртуальных машинах. Администраторы предприятия могут отключить эту опцию.

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

Auto mode — это исследовательский предпросмотр, доступный на планах Max, Team, Enterprise и API. Он недоступен на планах Pro или у сторонних провайдеров. На планах Team, Enterprise и API требуется Claude Sonnet 4.6, Opus 4.6 или Opus 4.7. На планах Max требуется Claude Opus 4.7.

Удалённые сеансы поддерживают Auto accept edits и Plan mode. Ask permissions недоступен, потому что удалённые сеансы автоматически принимают редактирование файлов по умолчанию, и Bypass permissions недоступен, потому что удалённое окружение уже изолировано.

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

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

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

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

Из панели предпросмотра вы можете:

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

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

Чтобы очистить сохранённые данные сеанса, переключите Persist preview sessions в Settings → Claude Code. Чтобы полностью отключить предпросмотр, переключите Preview в Settings → Claude Code.

Просмотр изменений с помощью 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, предпросмотр, терминал, файл, план, задачи и подагент. Перетащите панель за её заголовок, чтобы переместить её, или перетащите край панели, чтобы изменить её размер. Нажмите Cmd+\ на macOS или Ctrl+\ на Windows, чтобы закрыть сфокусированную панель. Откройте дополнительные панели из меню Views в панели инструментов сеанса.

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

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

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

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

Режим Что показывается
Normal Вызовы инструментов свёрнуты в сводки, с полными текстовыми ответами
Verbose Каждый вызов инструмента, чтение файла и промежуточный шаг, который делает Claude
Summary Только финальные ответы Claude и сделанные им изменения

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

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

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

Сочетание клавиш Действие
Cmd / Показать сочетания клавиш
Cmd N Новый сеанс
Cmd W Закрыть сеанс
Ctrl Tab / Ctrl Shift Tab Следующий или предыдущий сеанс
Cmd Shift ] / Cmd Shift [ Следующий или предыдущий сеанс
Esc Остановить ответ Claude
Cmd Shift D Переключить панель diff
Cmd Shift P Переключить панель предпросмотра
Cmd Shift S Выбрать элемент в предпросмотре
Ctrl ` Переключить панель терминала
Cmd \ Закрыть сфокусированную панель
Cmd ; Открыть боковой чат
Ctrl O Циклически переходить через режимы просмотра
Cmd Shift M Открыть меню режима разрешений
Cmd Shift I Открыть меню модели
Cmd Shift E Открыть меню усилия
1–9 Выбрать элемент в открытом меню

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

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

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

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

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

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

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

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

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

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

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

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

1

Обновление приложения desktop

Убедитесь, что у вас есть последняя версия Claude Desktop. Загрузите или обновите на claude.com/download, затем перезагрузите приложение.

2

Включение переключателя

В приложении desktop перейдите в Settings > General (под Desktop app). Найдите переключатель Computer use и включите его. На Windows переключатель вступает в силу немедленно и настройка завершена. На macOS продолжите к следующему шагу.

Если вы не видите переключатель, подтвердите, что вы на macOS или Windows с планом Pro или Max, затем обновите и перезагрузите приложение.

3

Предоставление разрешений macOS

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

  • Accessibility: позволяет Claude кликать, печатать и прокручивать
  • Screen Recording: позволяет Claude видеть, что на вашем экране

На странице Settings показан текущий статус каждого разрешения. Если какое-либо из них отклонено, нажмите на значок, чтобы открыть соответствующую панель System Settings.

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

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

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

Уровень Что может делать Claude Применяется к
View only Видеть приложение на скриншотах Браузеры, торговые платформы
Click only Кликать и прокручивать, но не печатать или использовать сочетания клавиш Терминалы, IDE
Full control Кликать, печатать, перетаскивать и использовать сочетания клавиш Всё остальное

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

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

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

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

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

Работа параллельно с сеансами

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

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

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

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

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

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

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

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

Запуск долгосрочных задач удалённо

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

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

См. Claude Code на веб-сайте для получения дополнительной информации о том, как работают удалённые сеансы.

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

Меню 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, когда вы находитесь вдали от своего терминала. См. Платформы и интеграции для сравнения с Remote Control, Channels, Slack и запланированными задачами.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

{
  "version": "0.0.1",
  "autoVerify": false,
  "configurations": [...]
}

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

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

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

Поле Тип Описание
name string Уникальный идентификатор для этого сервера
runtimeExecutable string Команда для запуска, такая как npm, yarn или node
runtimeArgs string[] Аргументы, передаваемые runtimeExecutable, такие как ["run", "dev"]
port number Порт, на котором слушает ваш сервер. По умолчанию 3000
cwd string Рабочий каталог относительно корня вашего проекта. По умолчанию корень проекта. Используйте ${workspaceFolder} для явной ссылки на корень проекта
env object Дополнительные переменные окружения как пары ключ-значение, такие как { "NODE_ENV": "development" }. Не помещайте сюда секреты, так как этот файл фиксируется в вашем репо. Чтобы передать секреты вашему dev-серверу, установите их в локальном редакторе окружения вместо этого.
autoPort boolean Как обрабатывать конфликты портов. См. ниже
program string Скрипт для запуска с node. См. когда использовать program vs runtimeExecutable
args string[] Аргументы, передаваемые program. Используется только когда установлен program
Когда использовать program vs runtimeExecutable

Используйте runtimeExecutable с runtimeArgs для запуска dev-сервера через менеджер пакетов. Например, "runtimeExecutable": "npm" с "runtimeArgs": ["run", "dev"] запускает npm run dev.

Используйте program, когда у вас есть автономный скрипт, который вы хотите запустить с node напрямую. Например, "program": "server.js" запускает node server.js. Передавайте дополнительные флаги с args.

Конфликты портов

Поле autoPort контролирует, что происходит, когда ваш предпочтительный порт уже используется:

  • true: Claude находит и использует свободный порт автоматически. Подходит для большинства dev-серверов.
  • false: Claude выходит с ошибкой. Используйте это, когда ваш сервер должен использовать конкретный порт, например для обратных вызовов OAuth или списков разрешений CORS.
  • Не установлено (по умолчанию): Claude спрашивает, нужен ли серверу этот точный порт, затем сохраняет ваш ответ.

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

Примеры

Эти конфигурации показывают общие установки для разных типов проектов:

Эта конфигурация запускает приложение Next.js, используя Yarn на порту 3000:

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

Конфигурация окружения

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

  • Local: работает на вашей машине с прямым доступом к вашим файлам
  • Remote: работает на облачной инфраструктуре Anthropic. Сеансы продолжают работу даже если вы закроете приложение.
  • SSH: работает на удалённой машине, к которой вы подключаетесь через SSH, такой как ваши собственные серверы, облачные виртуальные машины или dev-контейнеры

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

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

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

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

Удалённые сеансы

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

Вы можете создавать пользовательские облачные окружения с разными уровнями доступа к сети и переменными окружения. Выберите раскрывающийся список окружения при запуске удалённого сеанса и выберите Add environment. См. облачное окружение для получения подробной информации о конфигурации доступа к сети и переменных окружения.

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-сеансы поддерживают режимы разрешений, коннекторы, плагины и MCP servers.

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

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

Следующий пример предварительно конфигурирует одно соединение, которое открывается в ~/projects на удалённом хосте:

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

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

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

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

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

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

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

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

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

Ключ Описание
permissions.disableBypassPermissionsMode установите на "disable", чтобы предотвратить пользователей от включения режима bypass permissions.
disableAutoMode установите на "disable", чтобы предотвратить пользователей от включения режима Auto. Удаляет Auto из селектора режима. Также принимается под permissions.
autoMode настройте, что классификатор auto mode доверяет и блокирует во всей вашей организации. См. Configure auto mode.
sshConfigs предварительно настройте SSH-соединения, которые появляются в раскрывающемся списке окружения. Пользователи не могут редактировать или удалять управляемые соединения.

Управляемый файл параметров, развёрнутый на диск на каждой машине, применяется к сеансам Desktop. Управляемые параметры, отправленные удалённо через консоль администратора, в настоящее время достигают только сеансов CLI и IDE, поэтому для развёртываний Desktop либо распространяйте файл через MDM, либо используйте элементы управления консоли администратора выше.

permissions.disableBypassPermissionsMode и disableAutoMode также работают в параметрах пользователя и проекта, но размещение их в управляемых параметрах предотвращает пользователей от их переопределения. autoMode читается из параметров пользователя, .claude/settings.local.json и управляемых параметров, но не из проверенного .claude/settings.json: клонированный репо не может внедрить свои собственные правила классификатора. Для полного списка управляемых параметров, включая allowManagedPermissionRulesOnly и allowManagedHooksOnly, см. managed-only settings.

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

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

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

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

Организации предприятия могут требовать SSO для всех пользователей. См. аутентификация для деталей уровня плана и Настройка SSO для конфигурации SAML и OIDC.

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

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

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

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

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

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

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

Переход с CLI?

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

Чтобы переместить сеанс CLI в Desktop, запустите /desktop в терминале. Claude сохраняет ваш сеанс и открывает его в приложении desktop, затем выходит из CLI. Эта команда доступна только на macOS и Windows.

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

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

CLI Эквивалент Desktop
--model sonnet Раскрывающийся список модели рядом с кнопкой отправки
--resume, --continue Нажмите на сеанс в боковой панели
--permission-mode Селектор режима рядом с кнопкой отправки
--dangerously-skip-permissions Режим Bypass permissions. Включите в Settings → Claude Code → "Allow bypass permissions mode". Администраторы предприятия могут отключить этот параметр.
--add-dir Добавьте несколько репо с кнопкой + в удалённых сеансах
--allowedTools, --disallowedTools Нет эквивалента для каждого сеанса. Правила разрешений в файлах параметров по-прежнему применяются.
--verbose Verbose view mode в раскрывающемся списке Transcript view
--print, --output-format Недоступно. Desktop только интерактивный.
ANTHROPIC_MODEL переменная окружения Раскрывающийся список модели рядом с кнопкой отправки
MAX_THINKING_TOKENS переменная окружения Установите в локальном редакторе окружения. См. конфигурация окружения.

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

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: Sonnet, Opus и Haiku доступны в обоих. В Desktop выберите модель из раскрывающегося списка рядом с кнопкой отправки. Вы можете изменить модель во время сеанса из того же раскрывающегося списка.

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

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

Функция CLI Desktop
Режимы разрешений Все режимы, включая dontAsk Ask permissions, Auto accept edits, Plan mode, Auto и Bypass permissions через Settings
--dangerously-skip-permissions Флаг CLI Режим Bypass permissions. Включите в Settings → Claude Code → "Allow bypass permissions mode"
Сторонние провайдеры Bedrock, Vertex, Foundry Anthropic's API по умолчанию. Развёртывания предприятия могут конфигурировать Vertex AI и провайдеров шлюза. См. руководство конфигурации предприятия.
MCP servers Настройте в файлах параметров UI Connectors для локальных и SSH-сеансов, или файлы параметров
Plugins Команда /plugin UI менеджера плагинов
@mention файлы Текстовые С автодополнением; локальные и SSH-сеансы только
Вложения файлов Недоступно Изображения, PDF
Изоляция сеанса Флаг --worktree Автоматические worktrees
Несколько сеансов Отдельные терминалы Вкладки боковой панели
Повторяющиеся задачи Cron jobs, CI pipelines Запланированные задачи
Использование компьютера Включение через /mcp на macOS Управление приложениями и экраном на macOS и Windows
Dispatch интеграция Недоступно Сеансы Dispatch в боковой панели
Скрипты и автоматизация --print, Agent SDK Недоступно

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

Следующие функции доступны только в CLI или расширении VS Code:

  • Сторонние провайдеры: Desktop подключается к API Anthropic по умолчанию. Развёртывания предприятия могут конфигурировать Vertex AI и провайдеров шлюза через управляемые параметры. Для Bedrock или Foundry используйте CLI.
  • Linux: приложение desktop доступно только на macOS и Windows. На Linux используйте CLI.
  • Встроенные предложения кода: Desktop не предоставляет предложения в стиле автодополнения. Это работает через разговорные подсказки и явные изменения кода.
  • Команды агентов: оркестровка мультиагентов доступна через CLI и Agent SDK, не в Desktop.

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

Разделы ниже охватывают проблемы, специфичные для приложения 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. Проверьте наличие ожидающих обновлений. Приложение автоматически обновляется при запуске.
  3. На 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

На Windows Git требуется для запуска локальных сеансов на вкладке Code. Если вы видите "Git is required," установите Git для Windows и перезагрузите приложение.

Если вы видите "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>

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

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