Вкладка Code в приложении Claude Desktop позволяет использовать Claude Code через графический интерфейс вместо терминала.
Desktop добавляет эти возможности к стандартному опыту Claude Code:
Новичок в Desktop? Начните с Быстрого старта, чтобы установить приложение и сделать первое редактирование. Начало сеанса
Перед отправкой первого сообщения настройте четыре параметра в области подсказки:
- 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 автоматически принимает редактирование файлов, но всё ещё спрашивает перед запуском команд терминала. Используйте это, когда вы доверяете изменениям файлов и хотите более быструю итерацию. |
| Plan mode | plan | Claude анализирует ваш код и создаёт план без изменения файлов или запуска команд. Хорошо для сложных задач, где вы хотите сначала проверить подход. |
| Auto | auto | Claude выполняет все действия с фоновыми проверками безопасности, которые проверяют соответствие вашему запросу. Снижает подсказки разрешений при сохранении надзора. В настоящее время исследовательский предпросмотр. Доступно на планах Team (Enterprise выкатывается в ближайшее время). Требует Claude Sonnet 4.6 или Opus 4.6. Включите в Settings → Claude Code. |
| Bypass permissions | bypassPermissions | Claude работает без каких-либо подсказок разрешений, эквивалентно --dangerously-skip-permissions в CLI. Включите в Settings → Claude Code под “Allow bypass permissions mode”. Используйте только в изолированных контейнерах или виртуальных машинах. Администраторы предприятия могут отключить эту опцию. |
dontAsk доступен только в CLI.
Начните сложные задачи в Plan mode, чтобы Claude наметил подход перед внесением изменений. После одобрения плана переключитесь на Auto accept edits или Ask permissions для его выполнения. См. explore first, then plan, then code для получения дополнительной информации об этом рабочем процессе. Предпросмотр вашего приложения
Claude может запустить dev-сервер и открыть встроенный браузер для проверки своих изменений. Это работает как для фронтенд-веб-приложений, так и для бэкенд-серверов: Claude может тестировать конечные точки API, просматривать логи сервера и итерировать по найденным проблемам. В большинстве случаев Claude автоматически запускает сервер после редактирования файлов проекта. Вы также можете попросить Claude предпросмотр в любое время. По умолчанию Claude автоматически проверяет изменения после каждого редактирования.
Из панели предпросмотра вы можете:
- Взаимодействовать с вашим запущенным приложением прямо во встроенном браузере
- Смотреть, как 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 требует установки и аутентификации GitHub CLI (gh) на вашей машине. Если gh не установлен, Desktop предложит вам установить его в первый раз, когда вы попытаетесь создать PR. Позвольте Claude использовать ваш компьютер
Использование компьютера позволяет Claude открывать ваши приложения, управлять вашим экраном и работать непосредственно на вашей машине так, как вы бы это делали. Попросите Claude протестировать нативное приложение в симуляторе iOS, взаимодействовать с инструментом рабочего стола, который не имеет CLI, или автоматизировать что-то, что работает только через GUI.
Использование компьютера — это исследовательский предпросмотр на macOS, который требует плана Pro или Max. Он недоступен на планах Team или Enterprise. Приложение Claude Desktop должно быть запущено.
Когда применяется использование компьютера
Claude имеет несколько способов взаимодействия с приложением или сервисом, и использование компьютера — самый широкий и медленный. Он пытается использовать наиболее точный инструмент в первую очередь:
- Если у вас есть коннектор для сервиса, Claude использует коннектор.
- Если задача — это команда shell, Claude использует Bash.
- Если задача — это работа в браузере и у вас есть Claude в Chrome установлен, Claude использует это.
- Если ничего из этого не применяется, Claude использует использование компьютера.
Уровни доступа для каждого приложения усиливают это: браузеры ограничены только просмотром, а терминалы и IDE — только кликом, направляя Claude к выделенному инструменту даже когда использование компьютера активно. Управление экраном зарезервировано для вещей, которые ничто другое не может достичь, таких как нативные приложения, панели управления оборудованием, симулятор iOS или собственные инструменты без API.
Включение использования компьютера
Использование компьютера отключено по умолчанию. Если вы попросите Claude сделать что-то, что нуждается в этом, пока это отключено, Claude скажет вам, что он мог бы сделать задачу, если вы включите использование компьютера в Settings. Чтобы включить его, откройте Settings > Desktop app > General и переключите Computer use на включено. Прежде чем переключатель вступит в силу, вам нужно предоставить два разрешения системы 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 | Кликать, печатать, перетаскивать и использовать сочетания клавиш | Всё остальное |
- Denied apps: добавьте приложения сюда, чтобы отклонить их без подсказки. Claude может всё ещё косвенно влиять на отклонённое приложение через действия в разрешённом приложении, но не может взаимодействовать с отклонённым приложением напрямую.
- Unhide apps when Claude finishes: пока Claude работает, ваши другие окна скрыты, чтобы он взаимодействовал только с одобренным приложением. Когда Claude заканчивает, скрытые окна восстанавливаются, если вы не отключите этот параметр.
Управление сеансами
Каждый сеанс — это независимый разговор со своим собственным контекстом и изменениями. Вы можете запускать несколько сеансов параллельно, отправлять работу в облако или позволить Dispatch запускать сеансы для вас со своего телефона.
Работа параллельно с сеансами
Нажмите + New session в боковой панели, чтобы работать над несколькими задачами параллельно. Для Git-репозиториев каждый сеанс получает свою собственную изолированную копию вашего проекта, используя Git worktrees, поэтому изменения в одном сеансе не влияют на другие сеансы до тех пор, пока вы их не зафиксируете.
Worktrees хранятся в <project-root>/.claude/worktrees/ по умолчанию. Вы можете изменить это на пользовательский каталог в Settings → Claude Code под “Worktree location”. Вы также можете установить префикс ветви, который добавляется в начало каждого имени ветви worktree, что полезно для организации веток, созданных Claude. Чтобы удалить worktree после завершения, наведите курсор на сеанс в боковой панели и нажмите значок архива.
Изоляция сеанса требует Git. На большинстве Mac Git включен по умолчанию. Запустите git --version в Terminal для проверки. На Windows Git требуется для работы вкладки Code: загрузите Git для Windows, установите его и перезагрузите приложение. Если вы столкнулись с ошибками Git, попробуйте сеанс Cowork для помощи в устранении неполадок вашей установки. /compact для запуска суммирования раньше и освобождения пространства контекста. См. context window для получения подробной информации о том, как работает компактирование.
Запуск долгосрочных задач удалённо
Для больших рефакторингов, наборов тестов, миграций или других долгосрочных задач выберите 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 и конфигурируйте серверы предпросмотра.
Подключение внешних инструментов
Для локальных и SSH сеансов нажмите кнопку + рядом с полем подсказки и выберите Connectors, чтобы добавить интеграции, такие как Google Calendar, Slack, GitHub, Linear, Notion и другие. Вы можете добавлять коннекторы до или во время сеанса. Кнопка + недоступна в удалённых сеансах, но запланированные задачи конфигурируют коннекторы во время создания задачи.
Чтобы управлять или отключать коннекторы, перейдите в 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, чтобы увидеть ваши установленные плагины и их команды. Чтобы добавить плагин, выберите Add plugin из подменю, чтобы открыть браузер плагинов, который показывает доступные плагины из ваших настроенных marketplaces, включая официальный marketplace Anthropic. Выберите Manage plugins, чтобы включить, отключить или удалить плагины.
Плагины могут быть ограничены вашей учётной записью пользователя, конкретным проектом или только локально. Плагины недоступны для удалённых сеансов. Для полного справочника плагинов, включая создание собственных плагинов, см. 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
}
]
}
Автоматическая проверка изменений
Когда autoVerify включен, Claude автоматически проверяет изменения кода после редактирования файлов. Он делает скриншоты, проверяет ошибки и подтверждает работу изменений перед завершением своего ответа.
Auto-verify включен по умолчанию. Отключите его для каждого проекта, добавив "autoVerify": false в .claude/launch.json, или переключите его из меню Preview.
{
"version": "0.0.1",
"autoVerify": false,
"configurations": [...]
}
Поля конфигурации
Каждая запись в массиве configurations принимает следующие поля:
| Поле | Тип | Описание |
|---|
name | string | Уникальный идентификатор для этого сервера |
runtimeExecutable | string | Команда для запуска, такая как npm, yarn или node |
runtimeArgs | string[] | Аргументы, передаваемые runtimeExecutable, такие как ["run", "dev"] |
port | number | Порт, на котором слушает ваш сервер. По умолчанию 3000 |
cwd | string | Рабочий каталог относительно корня вашего проекта. По умолчанию корень проекта. Используйте ${workspaceFolder} для явной ссылки на корень проекта |
env | object | Дополнительные переменные окружения как пары ключ-значение, такие как { "NODE_ENV": "development" }. Не помещайте сюда секреты, так как этот файл фиксируется в вашем репо. Секреты, установленные в вашем профиле оболочки, наследуются автоматически. |
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 Code offers three ways to schedule recurring work:
| Cloud | Desktop | /loop |
|---|
| Runs on | Anthropic cloud | Your machine | Your machine |
| Requires machine on | No | Yes | Yes |
| Requires open session | No | No | Yes |
| Persistent across restarts | Yes | Yes | No (session-scoped) |
| Access to local files | No (fresh clone) | Yes | Yes |
| MCP servers | Connectors configured per task | Config files and connectors | Inherits from session |
| Permission prompts | No (runs autonomously) | Configurable per task | Inherits from session |
| Customizable schedule | Via /schedule in the CLI | Yes | Yes |
| Minimum interval | 1 hour | 1 minute | 1 minute |
Use cloud tasks for work that should run reliably without your machine. Use Desktop tasks when you need access to local files and tools. Use /loop for quick polling during a session.
- Local tasks: работают на вашей машине. Они имеют прямой доступ к вашим локальным файлам и инструментам, но приложение desktop должно быть открыто и ваш компьютер должен быть включен для их запуска.
- Remote tasks: работают на облачной инфраструктуре, управляемой Anthropic. Они продолжают работу даже когда ваш компьютер выключен, но работают против свежего клона вашего репозитория, а не вашей локальной копии.
Оба вида появляются в одной сетке задач. Нажмите New task, чтобы выбрать, какой вид создать. Остальная часть этого раздела охватывает локальные задачи; для удалённых задач см. Cloud scheduled tasks.
См. Как работают запланированные задачи для получения подробной информации о пропущенных запусках и поведении наверстывания для локальных задач.
По умолчанию локальные запланированные задачи работают против любого состояния вашего рабочего каталога, включая незафиксированные изменения. Включите переключатель worktree в ввод подсказки, чтобы дать каждому запуску свой собственный изолированный Git worktree, так же как параллельные сеансы. | Поле | Описание |
|---|
| Name | Идентификатор для задачи. Преобразуется в нижний регистр kebab-case и используется как имя папки на диске. Должно быть уникальным среди ваших задач. |
| Description | Краткая сводка, показанная в списке задач. |
| Prompt | Инструкции, отправляемые Claude при запуске задачи. Напишите это так же, как вы бы написали любое сообщение в поле подсказки. Ввод подсказки также включает элементы управления для модели, режима разрешений, рабочей папки и worktree. |
| Frequency | Как часто запускается задача. См. опции частоты ниже. |
Опции частоты
- Manual: нет расписания, запускается только когда вы нажимаете Run now. Полезно для сохранения подсказки, которую вы запускаете по требованию
- Hourly: запускается каждый час. Каждая задача получает фиксированное смещение до 10 минут от начала часа для распределения трафика API
- Daily: показывает выбор времени, по умолчанию 9:00 AM местное время
- Weekdays: то же самое, что Daily, но пропускает субботу и воскресенье
- Weekly: показывает выбор времени и выбор дня
Для интервалов, которые выбор не предлагает (каждые 15 минут, первое число каждого месяца и т. д.), попросите Claude в любом сеансе Desktop установить расписание. Используйте простой язык; например, “запланировать задачу для запуска всех тестов каждые 6 часов.”
Как работают запланированные задачи
Локальные запланированные задачи работают на вашей машине. Desktop проверяет расписание каждую минуту, пока приложение открыто, и запускает свежий сеанс, когда задача наступает, независимо от любых ручных сеансов, которые у вас открыты. Каждая задача получает фиксированную задержку до 10 минут после запланированного времени для распределения трафика API. Задержка детерминирована: одна и та же задача всегда запускается с одинаковым смещением.
Когда задача запускается, вы получаете уведомление рабочего стола и новый сеанс появляется под разделом Scheduled в боковой панели. Откройте его, чтобы увидеть, что сделал Claude, проверить изменения или ответить на подсказки разрешений. Сеанс работает как любой другой: Claude может редактировать файлы, запускать команды, создавать коммиты и открывать pull requests.
Задачи работают только пока приложение desktop работает и ваш компьютер включен. Если ваш компьютер спит в запланированное время, запуск пропускается. Чтобы предотвратить переход в режим ожидания, включите Keep computer awake в Settings под Desktop app → General. Закрытие крышки ноутбука всё ещё переводит его в режим сна. Для задач, которые нужно запускать даже когда ваш компьютер выключен, используйте удалённую задачу вместо этого.
Пропущенные запуски
Когда приложение запускается или ваш компьютер просыпается, Desktop проверяет, пропустила ли каждая задача какие-либо запуски за последние семь дней. Если да, Desktop запускает ровно один наверстывающий запуск для самого недавно пропущенного времени и отбрасывает всё более старое. Ежедневная задача, которая пропустила шесть дней, запускается один раз при пробуждении. Desktop показывает уведомление при запуске наверстывающего запуска.
Имейте это в виду при написании подсказок. Задача, запланированная на 9 утра, может запуститься в 11 вечера, если ваш компьютер спал весь день. Если время имеет значение, добавьте защиты в саму подсказку, например: “Проверяйте только сегодняшние коммиты. Если сейчас после 17:00, пропустите проверку и просто опубликуйте сводку того, что было пропущено.”
Разрешения для запланированных задач
Каждая задача имеет свой собственный режим разрешений, который вы устанавливаете при создании или редактировании задачи. Правила разрешения из ~/.claude/settings.json также применяются к сеансам запланированных задач. Если задача работает в режиме Ask и нужно запустить инструмент, для которого у неё нет разрешения, запуск зависает до тех пор, пока вы его не одобрите. Сеанс остаётся открытым в боковой панели, чтобы вы могли ответить позже.
Чтобы избежать зависания, нажмите Run now после создания задачи, следите за подсказками разрешений и выберите “always allow” для каждой. Будущие запуски этой задачи автоматически одобряют те же инструменты без подсказок. Вы можете проверить и отозвать эти одобрения со страницы деталей задачи.
Управление запланированными задачами
Нажмите на задачу в списке Schedule, чтобы открыть её страницу деталей. Отсюда вы можете:
- Run now: запустить задачу немедленно без ожидания следующего запланированного времени
- Toggle repeats: приостановить или возобновить запланированные запуски без удаления задачи
- Edit: изменить подсказку, частоту, папку или другие параметры
- Review history: увидеть каждый прошлый запуск, включая те, которые были пропущены, потому что ваш компьютер спал
- Review allowed permissions: увидеть и отозвать сохранённые одобрения инструментов для этой задачи из панели Always allowed
- Delete: удалить задачу и архивировать все сеансы, которые она создала
Вы также можете управлять задачами, попросив Claude в любом сеансе Desktop. Например, “приостановить мою задачу dependency-audit”, “удалить задачу standup-prep” или “показать мне мои запланированные задачи.”
Чтобы отредактировать подсказку задачи на диске, откройте ~/.claude/scheduled-tasks/<task-name>/SKILL.md (или под CLAUDE_CONFIG_DIR, если установлено). Файл использует YAML frontmatter для name и description, с подсказкой как тело. Изменения вступают в силу при следующем запуске. Расписание, папка, модель и включённое состояние не в этом файле: измените их через форму Edit или попросите Claude.
Конфигурация окружения
Окружение, которое вы выбираете при запуске сеанса, определяет, где Claude выполняется и как вы подключаетесь:
- Local: работает на вашей машине с прямым доступом к вашим файлам
- Remote: работает на облачной инфраструктуре Anthropic. Сеансы продолжают работу даже если вы закроете приложение.
- SSH: работает на удалённой машине, к которой вы подключаетесь через SSH, такой как ваши собственные серверы, облачные виртуальные машины или dev-контейнеры
Локальные сеансы
Локальные сеансы наследуют переменные окружения из вашей оболочки. Если вам нужны дополнительные переменные, установите их в вашем профиле оболочки, такие как ~/.zshrc или ~/.bashrc, и перезагрузите приложение desktop. См. переменные окружения для полного списка поддерживаемых переменных.
Extended thinking включен по умолчанию, что улучшает производительность на сложных задачах рассуждения, но использует дополнительные токены. Чтобы полностью отключить thinking, установите MAX_THINKING_TOKENS=0 в вашем профиле оболочки. На Opus MAX_THINKING_TOKENS игнорируется, кроме 0, потому что адаптивное рассуждение контролирует глубину thinking вместо этого.
Удалённые сеансы
Удалённые сеансы продолжают работу в фоне даже если вы закроете приложение. Использование считается в пределах лимитов вашего плана подписки без отдельных расходов на вычисления.
Вы можете создавать пользовательские облачные окружения с разными уровнями доступа к сети и переменными окружения. Выберите раскрывающийся список окружения при запуске удалённого сеанса и выберите 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 работает на удалённой машине с доступом к её файлам и инструментам.
Claude Code должен быть установлен на удалённой машине. После подключения SSH-сеансы поддерживают режимы разрешений, коннекторы, плагины и MCP servers.
Конфигурация предприятия
Организации на планах Teams или 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 the auto mode classifier. |
permissions.disableBypassPermissionsMode и disableAutoMode также работают в параметрах пользователя и проекта, но размещение их в управляемых параметрах предотвращает пользователей от их переопределения. autoMode читается из параметров пользователя, .claude/settings.local.json и управляемых параметров, но не из проверенного .claude/settings.json: клонированный репо не может внедрить свои собственные правила классификатора. Для полного списка управляемых параметров, включая allowManagedPermissionRulesOnly и allowManagedHooksOnly, см. managed-only settings.
Удалённые управляемые параметры, загруженные через консоль администратора, в настоящее время применяются только к сеансам CLI и IDE. Для ограничений, специфичных для Desktop, используйте элементы управления консоли администратора выше.
Политики управления устройствами
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 | недоступно в Desktop |
--verbose | недоступно. Проверьте системные логи: Console.app на macOS, Event Viewer → Windows Logs → Application на Windows |
--print, --output-format | недоступно. Desktop только интерактивный. |
ANTHROPIC_MODEL переменная окружения | раскрывающийся список модели рядом с кнопкой отправки |
MAX_THINKING_TOKENS переменная окружения | установите в профиле оболочки; применяется к локальным сеансам. См. конфигурация окружения. |
Общая конфигурация
Desktop и CLI читают одни и те же файлы конфигурации, поэтому ваша установка переносится:
- CLAUDE.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 | Недоступно. Desktop подключается к API Anthropic напрямую. |
| MCP servers | Настройте в файлах параметров | UI Connectors для локальных и SSH-сеансов, или файлы параметров |
| Plugins | Команда /plugin | UI менеджера плагинов |
| @mention файлы | Текстовые | С автодополнением; локальные и SSH-сеансы только |
| Вложения файлов | Недоступно | Изображения, PDF |
| Изоляция сеанса | Флаг --worktree | Автоматические worktrees |
| Несколько сеансов | Отдельные терминалы | Вкладки боковой панели |
| Повторяющиеся задачи | Cron jobs, CI pipelines | Запланированные задачи |
| Использование компьютера | Недоступно | Управление приложениями и экраном на macOS |
| Dispatch интеграция | Недоступно | Сеансы Dispatch в боковой панели |
| Скрипты и автоматизация | --print, Agent SDK | Недоступно |
Что недоступно в Desktop
Следующие функции доступны только в CLI или расширении VS Code:
- Сторонние провайдеры: Desktop подключается к API Anthropic напрямую. Используйте CLI с Bedrock, Vertex или Foundry вместо этого.
- Linux: приложение desktop доступно только на macOS и Windows.
- Встроенные предложения кода: Desktop не предоставляет предложения в стиле автодополнения. Это работает через разговорные подсказки и явные изменения кода.
- Команды агентов: оркестровка мультиагентов доступна через CLI и Agent SDK, не в Desktop.
Устранение неполадок
Проверка вашей версии
Чтобы увидеть, какую версию приложения desktop вы запускаете:
- macOS: нажмите Claude в строке меню, затем About Claude
- Windows: нажмите Help, затем About
Нажмите на номер версии, чтобы скопировать его в буфер обмена.
Ошибки 403 или аутентификации на вкладке Code
Если вы видите Error 403: Forbidden или другие сбои аутентификации при использовании вкладки Code:
- Выйдите и снова войдите из меню приложения. Это наиболее частое исправление.
- Проверьте, что у вас есть активная платная подписка: Pro, Max, Teams или 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 применяются только к новым сеансам терминала.
- Ошибка одновременной установки: если вы видите ошибку о другой установке в процессе, но её нет, попробуйте запустить установщик от имени администратора.
- ARM64: устройства Windows ARM64 полностью поддерживаются.
Вкладка Cowork недоступна на Intel Mac
Вкладка Cowork требует Apple Silicon (M1 или позже) на macOS. На Windows Cowork доступен на всех поддерживаемых аппаратных средствах. Вкладки Chat и Code работают нормально на Intel Mac.
”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. 
