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

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

Download for macOS

Universal build for Intel and Apple Silicon

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

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

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

Начните сложные задачи в Plan mode, чтобы Claude наметил подход перед внесением изменений. После одобрения плана переключитесь на Auto accept edits или Ask permissions для его выполнения. См. explore first, then plan, then code для получения дополнительной информации об этом рабочем процессе.

Удалённые сеансы поддерживают 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.

Мониторинг PR требует установки и аутентификации GitHub CLI (gh) на вашей машине. Если gh не установлен, Desktop предложит вам установить его в первый раз, когда вы попытаетесь создать PR.

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

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

Макет панели, терминал, редактор файлов и режимы просмотра в этом разделе требуют Claude Desktop v1.2581.0 или более поздней версии. Откройте Claude → Check for Updates на macOS или Help → Check for Updates на Windows для обновления.

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

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

Режим	Что показывается
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.

Использование компьютера — это исследовательский предпросмотр на macOS и Windows, который требует плана Pro или Max. Он недоступен на планах Team или Enterprise. Приложение Claude Desktop должно быть запущено.

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

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

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

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

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

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

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

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

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

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

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

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

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

Изоляция сеанса требует Git. На большинстве Mac Git включен по умолчанию. Запустите git --version в Terminal для проверки. На Windows Git требуется для работы вкладки Code: загрузите Git для Windows, установите его и перезагрузите приложение. Если вы столкнулись с ошибками Git, попросите Claude в вкладке Cowork помочь вам устранить неполадки вашей установки.

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

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

Боковой чат позволяет вам задать 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
Multiple servers
Node.js script

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

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

Для монорепо с фронтенд и API-сервером определите несколько конфигураций. Фронтенд использует autoPort: true, поэтому он выбирает свободный порт, если 3000 занят, в то время как API-сервер требует порт 8080 точно:

{
  "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
    }
  ]
}

Чтобы запустить скрипт Node.js напрямую вместо использования команды менеджера пакетов, используйте поле program:

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

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

Окружение, которое вы выбираете при запуске сеанса, определяет, где 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, где хранятся соединения, добавленные через диалог.

Ограничение 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: предотвратите пользователей в вашей организации от включения режима bypass permissions

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

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

Ключ	Описание
`permissions.disableBypassPermissionsMode`	установите на `"disable"`, чтобы предотвратить пользователей от включения режима bypass permissions.
`disableAutoMode`	установите на `"disable"`, чтобы предотвратить пользователей от включения режима Auto. Удаляет Auto из селектора режима. Также принимается под `permissions`.
`autoMode`	настройте, что классификатор auto mode доверяет и блокирует во всей вашей организации. См. Configure auto mode.
`sshConfigs`	предварительно настройте SSH-соединения, которые появляются в раскрывающемся списке окружения. Пользователи не могут редактировать или удалять управляемые соединения.
`sshHostAllowlist`	ограничьте SSH-сеансы хостами, чьё разрешённое имя хоста совпадает с одним из этих шаблонов. Пустой массив отключает SSH-сеансы. Читается только из управляемых параметров.
`managedMcpServers`	отправьте конфигурации MCP-сервера всем пользователям в развёртывании третьей стороны. Каждая запись указывает транспорт `"http"`, `"sse"` или `"stdio"`, детали подключения и опционально карту `toolPolicy`, которая ограничивает, какие инструменты на этом сервере пользователи могут вызывать. Доступно только в развёртываниях Desktop третьей стороны (3P).

Управляемый файл параметров, развёрнутый на диск на каждой машине, применяется к сеансам 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.

Когда использовать Desktop vs CLI: используйте Desktop, когда вы хотите управлять параллельными сеансами в одном окне, организовать панели рядом или просмотреть изменения визуально. Используйте CLI, когда вам нужны скрипты, автоматизация или вы предпочитаете рабочий процесс терминала.

Эквиваленты флагов 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 выберите модель из раскрывающегося списка рядом с кнопкой отправки. Вы можете изменить модель во время сеанса из того же раскрывающегося списка.

MCP servers: приложение desktop chat vs Claude Code: MCP servers настроенные для приложения Claude Desktop chat в claude_desktop_config.json отделены от Claude Code и не будут появляться на вкладке Code. Чтобы использовать MCP servers в Claude Code, настройте их в ~/.claude.json или файле .mcp.json вашего проекта. См. конфигурация MCP для получения подробной информации.

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

Эта таблица сравнивает основные возможности между 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:

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

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

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

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

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

Поищите или подайте отчёт об ошибке на GitHub Issues
Посетите центр поддержки Claude

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

Начало работы

Основные концепции

Использовать Claude Code

Платформы и интеграции

Documentation Index

Download for macOS

Download for Windows

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

​Сеансы из Dispatch

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

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

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

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

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

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

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

Когда использовать program vs runtimeExecutable

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

​Примеры

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

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

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

​SSH-сеансы

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

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

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

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

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

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

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

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

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

​Переход с CLI?

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

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

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

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

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

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

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

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

​”Failed to load session”

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

​Ошибки Git и Git LFS

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

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

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

​”Branch doesn’t exist yet” при открытии в CLI

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Сеансы из Dispatch

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

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

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

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

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

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

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

Когда использовать `program` vs `runtimeExecutable`

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

Примеры

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

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

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

SSH-сеансы

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

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

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

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

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

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

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

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

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

Переход с CLI?

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

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

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

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

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

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

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

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

”Failed to load session”

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

Ошибки Git и Git LFS

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

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

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

”Branch doesn’t exist yet” при открытии в CLI

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