Перейти к основному содержанию

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Computer use — это исследовательский предпросмотр на macOS, который требует план Pro или Max. Он недоступен для планов Team или Enterprise. Требуется Claude Code v2.1.85 или позже и интерактивный сеанс, поэтому он недоступен в неинтерактивном режиме с флагом -p.
Computer use позволяет Claude открывать приложения, управлять вашим экраном и работать на вашей машине так же, как вы. Из CLI Claude может скомпилировать приложение Swift, запустить его, кликнуть по каждой кнопке и сделать снимок экрана результата, всё в одном разговоре, где он писал код. На этой странице рассказывается о том, как работает computer use в CLI. Для приложения Desktop см. computer use в Desktop.

​
Что вы можете делать с computer use

Computer use справляется с задачами, требующими GUI: всё, что вам обычно приходится делать вручную, покидая терминал.
  • Создание и проверка нативных приложений: попросите Claude создать приложение меню macOS. Claude пишет Swift, компилирует его, запускает приложение и кликает по каждому элементу управления, чтобы проверить, что всё работает, прежде чем вы его откроете.
  • Сквозное тестирование UI: укажите Claude на локальное приложение Electron и скажите «протестируй поток адаптации». Claude открывает приложение, кликает по регистрации и делает снимки экрана каждого шага. Никакой конфигурации Playwright, никакого тестового каркаса.
  • Отладка визуальных и проблем с макетом: скажите Claude «модальное окно обрезается на маленьких окнах». Claude изменяет размер окна, воспроизводит ошибку, делает снимок экрана, исправляет CSS и проверяет исправление. Claude видит то же, что видите вы.
  • Управление инструментами только с GUI: взаимодействуйте с инструментами дизайна, панелями управления оборудованием, iOS Simulator или собственными приложениями, у которых нет CLI или API.

​
Когда применяется computer use

Claude имеет несколько способов взаимодействия с приложением или сервисом. Computer use — самый широкий и медленный, поэтому Claude сначала пытается использовать наиболее точный инструмент:
  • Если у вас есть MCP server для сервиса, Claude использует его.
  • Если задача — это команда shell, Claude использует Bash.
  • Если задача — это работа в браузере и у вас настроен Claude в Chrome, Claude использует это.
  • Если ничего из вышеперечисленного не применимо, Claude использует computer use.
Управление экраном зарезервировано для вещей, которые ничто другое не может достичь: нативные приложения, симуляторы и инструменты без API.

​
Включение computer use

Computer use доступен как встроенный MCP server под названием computer-use. По умолчанию он отключен, пока вы его не включите.
1

Откройте меню MCP

В интерактивном сеансе Claude Code запустите:
/mcp
Найдите computer-use в списке серверов. Он показывается как отключённый.
2

Включите сервер

Выберите computer-use и выберите Enable. Параметр сохраняется для каждого проекта, поэтому вам нужно сделать это только один раз для каждого проекта, где вы хотите использовать computer use.
3

Предоставьте разрешения macOS

В первый раз, когда Claude попытается использовать ваш компьютер, вы увидите приглашение предоставить два разрешения macOS:
  • Accessibility: позволяет Claude кликать, печатать и прокручивать
  • Screen Recording: позволяет Claude видеть, что находится на вашем экране
Приглашение включает ссылки для открытия соответствующей панели System Settings. Предоставьте оба разрешения, затем выберите Try again в приглашении. macOS может потребовать перезагрузку Claude Code после предоставления разрешения Screen Recording.
После настройки попросите Claude сделать что-то, что требует GUI: 
Build the app target, launch it, and click through each tab to make
sure nothing crashes. Screenshot any error states you find.

​
Одобрение приложений для каждого сеанса

Включение сервера computer-use не предоставляет Claude доступ к каждому приложению на вашей машине. В первый раз, когда Claude нужно конкретное приложение в сеансе, в вашем терминале появляется приглашение, показывающее:
  • Какие приложения Claude хочет контролировать
  • Любые дополнительные запрашиваемые разрешения, такие как доступ к буферу обмена
  • Сколько других приложений будет скрыто, пока Claude работает
Выберите Allow for this session или Deny. Одобрения действуют для текущего сеанса. Вы можете одобрить несколько приложений одновременно, когда Claude запрашивает их вместе. Приложения с широким охватом показывают дополнительное предупреждение в приглашении, чтобы вы знали, что предоставляет одобрение:
ПредупреждениеПрименяется к
Equivalent to shell accessTerminal, iTerm, VS Code, Warp и другие терминалы и IDE
Can read or write any fileFinder
Can change system settingsSystem Settings
Эти приложения не блокируются. Предупреждение позволяет вам решить, оправдывает ли задача такой уровень доступа. Уровень управления Claude также варьируется в зависимости от категории приложения: браузеры и торговые платформы доступны только для просмотра, терминалы и IDE доступны только для клика, а всё остальное получает полный контроль. См. app permissions в Desktop для полного разбора уровней.

​
Как Claude работает на вашем экране

Понимание потока помогает вам предвидеть, что будет делать Claude и как вмешаться.

​
Один сеанс за раз

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

​
Приложения скрыты, пока Claude работает

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

​
Остановитесь в любой момент

Когда Claude получает блокировку, появляется уведомление macOS: ‘Claude is using your computer · press Esc to stop’. Нажмите Esc в любом месте, чтобы немедленно прервать текущее действие, или нажмите Ctrl+C в терминале. В любом случае Claude освобождает блокировку, показывает ваши приложения и возвращает вам управление. Второе уведомление появляется, когда Claude закончит.

​
Безопасность и граница доверия

В отличие от sandboxed Bash tool, computer use работает на вашем реальном рабочем столе с доступом к приложениям, которые вы одобрили. Claude проверяет каждое действие и отмечает потенциальные prompt injection из содержимого на экране, но граница доверия отличается. См. computer use safety guide для лучших практик.
Встроенные защиты снижают риск без необходимости конфигурации:
  • Одобрение для каждого приложения: Claude может управлять только приложениями, которые вы одобрили в текущем сеансе.
  • Предупреждения-дозорные: приложения, которые предоставляют доступ к shell, файловой системе или параметрам системы, отмечаются перед одобрением.
  • Терминал исключён из снимков экрана: Claude никогда не видит окно вашего терминала, поэтому приглашения на экране в вашем сеансе не могут вернуться в модель.
  • Глобальный выход: клавиша Esc прерывает computer use откуда угодно, и нажатие клавиши потребляется, поэтому prompt injection не может использовать его для закрытия диалогов.
  • Файл блокировки: только один сеанс может управлять вашей машиной одновременно.

​
Примеры рабочих процессов

Эти примеры показывают распространённые способы объединения computer use с задачами кодирования.

​
Проверка нативной сборки

После внесения изменений в приложение macOS или iOS попросите Claude скомпилировать и проверить в одном проходе: 
Build the MenuBarStats target, launch it, open the preferences window,
and verify the interval slider updates the label. Screenshot the
preferences window when you're done.
Claude запускает xcodebuild, запускает приложение, взаимодействует с UI и сообщает, что он находит.

​
Воспроизведение ошибки макета

Когда визуальная ошибка появляется только при определённых размерах окна, позвольте Claude найти её: 
The settings modal clips its footer on narrow windows. Resize the app
window down until you can reproduce it, screenshot the clipped state,
then check the CSS for the modal container.
Claude изменяет размер окна, захватывает сломанное состояние и читает соответствующие таблицы стилей.

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

Управляйте iOS Simulator без написания XCTest: 
Open the iOS Simulator, launch the app, tap through the onboarding
screens, and tell me if any screen takes more than a second to load.
Claude управляет симулятором так же, как вы бы это делали с мышью.

​
Различия с приложением Desktop

Поверхности CLI и Desktop используют один и тот же механизм computer use. Несколько элементов управления, специфичных для Desktop, ещё не находятся в CLI:
ФункцияDesktopCLI
EnableToggle in Settings > General (under Desktop app)Enable computer-use in /mcp
Denied apps listConfigurable in SettingsNot yet available
Auto-unhide toggleOptionalAlways on
Dispatch integrationDispatch-spawned sessions can use computer useNot applicable

​
Troubleshooting

​
”Computer use is in use by another Claude session”

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

​
Приглашение разрешений macOS продолжает появляться

macOS иногда требует перезагрузку запрашивающего процесса после предоставления Screen Recording. Полностью закройте Claude Code и начните новый сеанс. Если приглашение сохраняется, откройте System Settings > Privacy & Security > Screen Recording и подтвердите, что ваше приложение терминала указано и включено.

​
computer-use не появляется в /mcp

Сервер появляется только на подходящих установках. Проверьте, что:
  • Вы на macOS. Computer use недоступен на Linux или Windows.
  • Вы запускаете Claude Code v2.1.85 или позже. Запустите claude --version для проверки.
  • Вы на плане Pro или Max. Запустите /status для подтверждения вашей подписки.
  • Вы аутентифицированы через claude.ai. Computer use недоступен с поставщиками третьих сторон, такими как Amazon Bedrock, Google Cloud Vertex AI или Microsoft Foundry. Если вы получаете доступ к Claude исключительно через поставщика третьей стороны, вам нужна отдельная учётная запись claude.ai для использования этой функции.
  • Вы в интерактивном сеансе. Computer use недоступен в неинтерактивном режиме с флагом -p.

​
See also

  • Computer use в Desktop: та же возможность с графической страницей параметров
  • Claude в Chrome: автоматизация браузера для веб-задач
  • MCP: подключите Claude к структурированным инструментам и API
  • Sandboxing: как инструмент Bash Claude изолирует доступ к файловой системе и сети
  • Computer use safety guide: лучшие практики для безопасного использования computer use