Десктопное приложение (Desktop)
📚 Навигация по серии: В предыдущей статье 09 · Интеграция с JetBrains мы встроили Claude Code в экосистему IntelliJ. В этой статье мы поговорим об интерфейсе, который многие недооценивают — официальное десктопное приложение. Это самостоятельное окно, в котором можно запускать Claude Code без терминала и без IDE.
Многие говорят, что командная строка — это «единственный истинный способ» использования Claude Code, а десктопное приложение — это всего лишь упрощенная версия для новичков. Честно говоря, это утверждение уже устарело.
Сначала и я так думал. Но стоит столкнуться с необходимостью одновременного выполнения трех независимых задач — например, в трех вкладках терминала вы пытаетесь исправить ошибку авторизации, добавить тесты и отрефакторить слой данных — как начинается хаос. Вы постоянно путаетесь, в какой вкладке какая задача выполняется. Если попробовать сделать то же самое в десктопном приложении, всё меняется: на боковой панели отображаются три сессии, каждая автоматически изолирована с помощью Git worktree, изменения не пересекаются, и вы можете переключаться между ними в один клик. В этот момент приходит понимание: десктопное приложение — это не "упрощенный CLI", это совершенно другой подход к работе.
Самое важное: десктопное приложение, расширение для VS Code и командная строка используют один и тот же базовый движок, разделяя один и тот же файл CLAUDE.md и настройки. Таким образом, это не переход на "более слабый инструмент", а выбор интерфейса, который лучше подходит для многозадачности и визуального контроля изменений.
Когда стоит использовать приложение, а когда лучше вернуться в терминал — разберем в этой статье.
Прочитав эту статью, вы получите:
- Подробную инструкцию по установке десктопного приложения на macOS и Windows, а также четкий ответ на вопрос, "почему приложения нет на Linux".
- Понимание трех главных преимуществ приложения: параллельные сессии с изоляцией в Git, встроенный терминал/редактор файлов и удобный интерфейс для визуального просмотра diff.
- Сравнительную таблицу "Десктопное приложение vs Терминал vs Расширение для IDE", чтобы легко выбирать подходящий инструмент. А также команду, позволяющую перенести терминальную сессию в десктопное приложение в один клик.
01 Для начала: Что такое десктопное приложение
У многих первая реакция на слова «десктопное приложение» такая: это просто веб-версия claude.ai в виде отдельного окна, верно?
Нет. Сразу к делу: Десктопное приложение — это полноценный Claude Code с графическим интерфейсом, созданный специально для "одновременного ведения нескольких сессий". Внутри него работает тот же самый движок, что и в терминальном claude. Приложение может читать и редактировать ваши локальные файлы, изменять код, запускать команды, но всё это упаковано в удобное окно с боковой панелью и блочной компоновкой.
Аналогия: Один и тот же автомобиль с другой панелью приборов. Командная строка — это приборная панель гоночного болида: всё на виду, мгновенная реакция, но вам нужно уметь читать все эти цифры. Десктопное приложение — это большой мультимедийный дисплей обычного автомобиля: параллельные задачи, просмотр изменений, превью приложений — всё красиво, интуитивно и визуально понятно. Двигатель в обоих случаях одинаковый, и результат работы будет идентичным, разница лишь в том, насколько вам комфортно.
Здесь есть важный нюанс: когда вы открываете десктопное приложение, сверху есть три вкладки. Не перепутайте их.
| Вкладка | Назначение | Имеет ли доступ к вашим файлам |
|---|---|---|
| Chat | Обычный чат, как в claude.ai | ❌ Нет |
| Cowork | Функция Dispatch и длительные агентские задачи | Выполняется на облачной виртуальной машине, к локальным файлам доступа нет |
| Code | Интерактивное программирование, прямое чтение и запись локальных файлов | ✅ Да, каждый шаг требует вашего одобрения |
В этой статье речь пойдет только о вкладке Code — именно она представляет собой «Claude Code в десктопе». Вкладки Chat и Cowork относятся к другим возможностям Claude Desktop и не связаны напрямую с нашей задачей написания кода.
💡 Краткий итог: Десктопное приложение — это не просто окно чата. Это полноценный Claude Code с графическим интерфейсом; для работы с кодом всегда выбирайте вкладку Code.
02 Установка: Три платформы, три разные истории
Сразу проясним самую важную деталь: Для Linux десктопного приложения нет.
Это не баг и не упущение в статье — разработчики официально не поддерживают Linux. Пользователям Linux следует использовать только CLI-версию (инструкция по установке есть в статье 02). Поэтому ниже мы будем говорить только о macOS и Windows.
Блок-схема выше показывает весь путь от скачивания до отправки первой команды. Обратите внимание на два частых препятствия: необходимость платной подписки (при переходе на вкладку Code на бесплатном аккаунте появится страница оплаты) и обязательная установка Git в Windows (после которой требуется перезапуск приложения). Справа также добавлено напоминание, что версии для Linux не существует. Давайте разберем шаги по каждой платформе.
Перед установкой: Убедитесь, что у вас есть платная подписка
Это частая ошибка. Для работы с вкладкой Code в десктопном приложении требуется подписка Pro, Max, Team или Enterprise. При использовании бесплатного аккаунта вас перекинет на страницу обновления тарифа. Новички часто думают, что приложение сломалось, когда видят это, но причина просто в отсутствии нужной подписки.
macOS
Скачайте с официального сайта версию Universal (подходит для чипов Intel и Apple Silicon), скачайте .dmg файл, перетащите его в папку "Программы" (Applications). Запустите, авторизуйтесь через аккаунт Anthropic и нажмите на вкладку Code в центре верхней панели.
В macOS обычно уже установлен Git, который необходим для изоляции параллельных сессий. На всякий случай, можете проверить в терминале:
git --versionОжидаемый вывод будет выглядеть примерно так (номер версии не критичен, главное, чтобы команда работала):
git version 2.39.5 (Apple Git-154)Windows
Для процессоров x64 скачивайте .exe установщик; если у вас Windows на ARM64, обязательно скачайте специальный пакет ARM64, не перепутайте.
В Windows есть жесткое требование, которого нет на Mac: Для локальных сессий на вкладке Code обязательно нужен Git for Windows. Это частая ошибка на свежеустановленных системах Windows: вы нажимаете на вкладку Code без установленного Git, и приложение выдает красную ошибку Git is required, не давая запустить сессию. После установки Git обязательно перезапустите приложение, иначе оно его не обнаружит.
Также для некоторых проектов на Windows может понадобиться Git LFS. Если вы видите ошибку типа Git LFS is required by this repository but is not installed, перейдите на git-lfs.com, установите его, выполните git lfs install в терминале и перезапустите приложение.
Важное примечание: десктопное приложение уже содержит в себе Claude Code, вам не нужно отдельно устанавливать Node.js или CLI. Но если вы захотите параллельно использовать терминальную команду
claude, этот CLI нужно будет установить отдельно (см. статью 02) — это две разные программы, хотя они и делят общую конфигурацию.
💡 Краткий итог: Для Linux приложения нет; бесплатным аккаунтам функционал недоступен. В macOS версия Universal работает из коробки, а в Windows нужно обязательно установить Git и перезапустить приложение.
03 Главный плюс: Параллельные сессии и автоматическая изоляция через Git
Это самая веская причина использовать десктопное приложение.
В чем проблема терминала при многозадачности
Вы наверняка с этим сталкивались: у вас есть три задачи — исправить баг при логине, написать тесты и отрефакторить утилиты. В терминале вам приходится открывать три вкладки и запускать в каждой claude. Но все они работают в одной и той же рабочей директории и меняют одни и те же файлы. Если Сессия А изменит utils.js, Сессия Б может в то же время попытаться его изменить, и возникнет конфликт.
Как это решает десктопное приложение
Решение элегантное: при создании новой сессии через кнопку + New session на боковой панели, если ваш проект является Git-репозиторием, приложение автоматически создаст для нее отдельный Git worktree.
Аналогия: Отдельные читальные залы в библиотеке. Вы и два ваших коллеги изучаете один и тот же свод документов (репозиторий). Каждому выделяют изолированную комнату (worktree), где он может читать, делать свои заметки и вносить изменения, не мешая остальным. Пока вы не закончите работу и не сдадите её (не сделаете коммит), изменения в одной сессии никак не повлияют на другую.
На боковой панели отображаются все ваши текущие сессии. Переключаться между ними можно с помощью Ctrl+Tab или Ctrl+Shift+Tab (обратите внимание, на всех платформах используется Ctrl, а не Cmd). Хотите видеть две сессии одновременно? На Mac зажмите Cmd, а на Windows — Ctrl, и кликните по другой сессии на боковой панели, она откроется в режиме разделенного экрана.
Несколько полезных деталей
- Где хранятся worktree: По умолчанию в
<корень проекта>/.claude/worktrees/. Это можно изменить в настройках: "Settings → Claude Code → Worktree location". - Как перенести файлы из gitignore (например,
.env) в worktree: Создайте в корне проекта файл.worktreeincludeи перечислите в нем файлы, которые нужно копировать (подробнее см. официальную документацию). - Как удалять завершенные сессии: Наведите курсор на сессию в боковой панели и нажмите на иконку архивации (Archive). Соответствующий worktree будет удален.
- Автоматическая архивация после слияния PR: Включите настройку Auto-archive after PR merge or close в "Settings → Claude Code", и завершенные локальные сессии будут удаляться сами.
Отличная привычка: одна сессия — один PR. Внесли изменения, закоммитили, открыли PR, смержили — сессия архивируется, рабочее пространство остается чистым. Это гораздо проще, чем помнить, в какой из вкладок терминала выполняется какая задача.
💡 Краткий итог: Каждая сессия автоматически работает в изолированном Git worktree. Вы можете работать над несколькими задачами одновременно, не боясь конфликтов — это самое большое преимущество десктопного приложения перед терминалом.
04 Преимущество второе: Встроенный терминал и редактор файлов
Вкладка Code в десктопном приложении построена на основе панелей (panes): чат, diff, превью, терминал, файлы, план, задачи... Вы можете располагать их как угодно. Перетаскивайте заголовки панелей, меняйте их размер, как блоки конструктора.
Обратите внимание: такие возможности, как настройка панелей, встроенный терминал и редактор, требуют версии Claude Desktop v1.2581.0 или выше. Если ваша версия ниже, зайдите в "Check for Updates" и обновите приложение (проверяйте актуальные версии в документации).
Встроенный терминал: общая среда с Claude
Вы можете открыть терминал через меню Views или комбинацией Ctrl+` (снова Ctrl для всех платформ).
Его главная фишка: Терминал открывается в той же рабочей директории, в которой работает текущая сессия Claude. Если вы запускаете в нем npm test или git status, вы проверяете именно те файлы, которые сейчас изменяет Claude. У вас никогда не возникнет ситуации, когда «Claude внес изменения, но в терминале я вижу старую версию».
Это решает проблему, часто возникавшую при работе с расширением VS Code: вам больше не нужно вручную следить за тем, в правильную ли директорию вы перешли в терминале — он уже открыт где нужно.
Примечание: встроенный терминал доступен только в локальных сессиях, для удаленных (remote) сессий он не работает.
Редактор файлов: открывайте и редактируйте одним кликом
Кликните по любому пути к файлу в чате или в окне просмотра diff, и этот файл откроется в панели редактора. Вы можете внести правки и сохранить их, нажав Save.
Если файл был изменен на диске (например, Claude снова его отредактировал, пока он был у вас открыт), панель редактора выведет предупреждение и предложит либо перезаписать изменения, либо отказаться от своих правок. Так вы случайно не затрете работу Claude.
Нюанс: При клике на HTML, PDF, изображения или видео, они откроются не в редакторе кода, а в панели превью (Preview) — о ней мы поговорим позже. Редактор файлов доступен для локальных сессий и SSH-сессий. При работе с удаленными сессиями (Cowork) вам придется просить Claude вносить изменения самостоятельно.
На заметку: Режимы просмотра
По умолчанию чат скрывает вызовы инструментов в виде кратких сводок (режим Normal). Если вы хотите увидеть все детали действий Claude, нажимайте Ctrl+O для переключения в режим Verbose; если вас интересуют только окончательные результаты и изменения — режим Summary. Режим Verbose полезен для отладки («почему он так сделал?»), а режим Summary — для быстрого просмотра результатов параллельных сессий.
💡 Краткий итог: Встроенный терминал делит с Claude общую рабочую директорию, а файлы можно редактировать по клику. Все необходимые инструменты разработки собраны в одном окне, нет необходимости переключаться между разными программами.
05 Преимущество третье: Визуальный diff и построчное комментирование
Это самое очевидное улучшение графического интерфейса по сравнению с командной строкой.
В терминале diff выводится сплошным потоком зеленого и красного текста. Десктопное приложение превращает его в наглядный интерфейс, где можно кликать, оставлять комментарии и просить Claude самостоятельно перепроверить код.
Как смотреть diff
После изменения файла Claude появляется индикатор вроде +12 -1 (добавлено 12 строк, удалена 1). Нажмите на него, чтобы открыть окно просмотра diff: слева список измененных файлов, справа — детальные изменения по каждому из них.
Комментирование конкретной строки
Это лучшая функция при проверке diff: вы можете кликнуть на любую строку в diff и оставить комментарий прямо там. Введите ваш комментарий в появившемся поле и нажмите Enter. Если хотите прокомментировать несколько строк, просто кликайте и пишите. Когда закончите, отправьте все комментарии разом:
- macOS:
Cmd+Enter - Windows:
Ctrl+Enter
Claude прочитает ваши замечания, исправит код и выдаст вам новый diff для проверки. Такой цикл обратной связи гораздо эффективнее, чем пытаться объяснить словами в терминале: «Измени имя переменной в строке 23» — вы просто указываете прямо на строку.
Функция Review code (Самопроверка Claude)
В правом верхнем углу окна просмотра diff есть кнопка Review code. Если вы её нажмете, Claude сам просмотрит свои изменения перед тем, как вы их примете, и оставит комментарии прямо в diff, на которые вы сможете ответить или попросить его исправить код.
Обратите внимание, что при самопроверке Claude фокусируется на высокоприоритетных проблемах: ошибках компиляции, очевидных логических багах, уязвимостях. Он не будет придираться к стилю кода, форматированию или вещам, которые обычно отлавливает линтер — это задача для линтера.
Запуск CI и работа с PR
После создания PR (Pull Request) в сессии появится панель статуса CI. Claude Code будет использовать GitHub CLI для отслеживания результатов проверок. Два важных переключателя:
- Auto-fix (Автоматическое исправление): Если CI не прошел, Claude автоматически прочитает логи с ошибками и попытается исправить код.
- Auto-merge (Автослияние): После успешного прохождения всех проверок PR будет автоматически слит (используется метод squash; для этого в настройках репозитория на GitHub должно быть включено auto-merge).
Важно: Для мониторинга PR на вашем компьютере должен быть установлен и авторизован GitHub CLI (
gh). Если он не установлен, десктопное приложение предложит вам это сделать при первой попытке создать PR.
На практике комбинация построчного комментирования и самопроверки (Review code) заменяет большую часть работы по "первичному ручному код-ревью". Раньше вам приходилось проверять файлы за Claude самостоятельно, теперь вы просите его найти грубые ошибки, а сами лишь просматриваете выделенные им фрагменты.
💡 Краткий итог: Окно diff позволяет кликать и оставлять комментарии к каждой строке, а также запускать самопроверку (Review code) и автоматически исправлять ошибки CI. Контроль за качеством кода становится визуальным и интуитивным.
06 Десктопное приложение vs Терминал vs Расширение для IDE: Что выбрать?
К этому моменту вы можете окончательно запутаться: у вас есть терминальный claude, есть расширение для VS Code, а теперь еще и десктопное приложение. Что из этого использовать?
Приведем цитату из официальной документации:
Если вы хотите управлять параллельными сессиями в одном окне, располагать панели по своему вкусу и визуально проверять изменения кода — используйте Desktop. Если вам нужны скрипты, автоматизация или вы предпочитаете работать исключительно в терминале — используйте CLI.
Давайте сравним эти три инструмента, чтобы вам было проще выбрать:
| Важный для вас критерий | Терминал (CLI) | Расширение VS Code / JetBrains | Десктопное приложение (Desktop) |
|---|---|---|---|
| Параллельные сессии + изоляция Git | Нужно вручную создавать табы и worktree | В целом нет | ✅ Автоматические worktree, переключение на боковой панели |
| Визуальный diff, построчные комментарии | Только текстовый diff | ✅ Встроенный (inline) diff | ✅ diff + комментарии + самопроверка |
| Написание кода в любимом редакторе | ❌ | ✅ Прямо внутри вашей IDE | Есть встроенный редактор, но это не полноценная IDE |
| Скрипты / Автоматизация / Работа без интерфейса | ✅ --print, Agent SDK | Частично | ❌ Только интерактивный режим |
Горячие клавиши !bash, автодополнение Tab | ✅ | Частично | ❌ (нет привычного удобства терминала) |
| Превью приложений, CI, планировщик задач | Нужно настраивать самому | Частично | ✅ Встроенный графический интерфейс |
| Поддержка Linux | ✅ | ✅ | ❌ Не поддерживается |
| Сторонние модели (Bedrock/Vertex/Foundry) | ✅ | ✅ | По умолчанию только Anthropic API (в корпоративных версиях настраивается Vertex / шлюзы) |
Как видите, они не заменяют друг друга, у каждого инструмента есть своя сильная сторона:
- Скрипты, CI пайплайны, локальные модели → Используйте CLI, десктопное приложение для этого не подходит.
- Основная работа по написанию кода → Используйте расширение для IDE, когда вы хотите, чтобы ИИ был интегрирован в привычную среду разработки.
- Работа с несколькими независимыми задачами одновременно, визуальная проверка сложных изменений → Это стихия десктопного приложения.
И самое главное: их можно использовать одновременно, даже в рамках одного проекта — они разделяют CLAUDE.md, настройки MCP серверов, хуки, навыки и settings.json. Идеальный рабочий процесс может выглядеть так: ежедневное написание кода — в VS Code; если нужно раскидать 3-4 разные задачи — открываем десктопное приложение; для автоматизации сборки — пишем скрипт для терминала.
⚠️ Внимание: Команды вроде /permissions, /config, /agents, /doctor, которые вызывают интерактивные панели в терминале, в десктопном приложении на вкладке Code не работают, и вы увидите сообщение isn't available in this environment. Для изменения настроек или прав доступа придется редактировать settings.json вручную или возвращаться в CLI.
💡 Краткий итог: CLI для автоматизации, расширения IDE для кодинга, десктопное приложение для многозадачности и визуализации — они делят общие настройки и отлично дополняют друг друга. Используйте их по ситуации.
07 Практика: Установка приложения и запуск первой сессии
Практика лучше теории. Давайте пройдем путь от установки до первого успешного запуска сессии.
Шаг 1: Установка и открытие вкладки Code
Установите приложение в соответствии с инструкциями в разделе 02 (версия Universal для macOS, для Windows — обязательно предварительная установка Git). Запустите приложение, авторизуйтесь и перейдите на вкладку Code в центре верхней панели.
✅ Проверка: Если вы видите боковую панель слева и поле для ввода запроса по центру, значит, вкладка Code работает. Если вас перекинуло на страницу оплаты → у вас бесплатный аккаунт, необходимо обновить подписку до Pro/Max.
Шаг 2: Выбор окружения и папки проекта
Прежде чем написать первое сообщение, необходимо настроить четыре параметра над полем ввода:
- Окружение (Environment): Выберите Local (выполнение на вашем компьютере с прямым доступом к файлам). Есть также Remote (в облаке) и SSH (на удаленном сервере), но Local — самый простой вариант для старта.
- Папка проекта (Folder): Нажмите Select folder и выберите небольшой знакомый проект — не стоит сразу брать гигантский корпоративный монорепозиторий.
- Модель: Выберите модель (Opus / Sonnet / Haiku) из выпадающего списка рядом с кнопкой отправки. Модель можно менять прямо во время сессии.
- Режим прав (Permissions): Оставьте по умолчанию "Спрашивать разрешение" (default). Это самый безопасный вариант для новичков.
Шаг 3: Отправка первого запроса
Введите в текстовое поле небольшую задачу. Например, официальный пример:
Найди комментарий TODO в коде и исправь егоИли:
Создай CLAUDE.md для этого репозитория и добавь туда описание проектаНажмите Enter для отправки.
Шаг 4: Проверка и принятие изменений
Поскольку у вас включен режим "Спрашивать разрешение", Claude не изменит файл сразу, а покажет вам diff. Вы увидите:
- Окно просмотра diff, показывающее, что именно изменится в файлах.
- Кнопки Accept (Принять) / Reject (Отклонить).
- Текущий прогресс обработки.
✅ Ожидаемый результат: До того, как вы нажмете Accept, файлы на вашем диске не изменятся. В этом и заключается безопасность режима default — вы всё контролируете. Если вы нажмете Reject, Claude спросит вас, что нужно изменить.
Шаг 5 (Дополнительно): Перенос сессии из терминала в десктоп
Если вы начали диалог в терминальном claude и решили продолжить в десктопном приложении, вам не нужно начинать всё заново. Прямо в терминале введите:
/desktopClaude сохранит текущую сессию, откроет её в десктопном приложении и завершит работу в CLI.
Примечание: команда
/desktopработает только на macOS и Windows, и только при авторизации по подписке Claude. Вход по API ключу или через корпоративные развертывания (Bedrock / Vertex / Foundry) не поддерживается (сверяйтесь с официальной документацией).
08 Заключение
В этой статье мы подробно рассмотрели десктопное приложение Claude Code, третий способ взаимодействия с ИИ.
- Это полноценный графический Claude Code, а не просто веб-интерфейс: он использует тот же движок, те же настройки
CLAUDE.md, что и терминал. Ищите вкладку Code. - Процесс установки отличается по платформам: Linux не поддерживается; бесплатные аккаунты не работают (нужен тариф от Pro/Max); на Windows обязательно сначала нужно установить Git и перезапустить приложение.
- Три главных преимущества: Параллельные сессии с изоляцией в Git worktree, встроенный терминал/редактор файлов (с общим контекстом), и визуальный diff с возможностью построчных комментариев и самопроверки Claude.
- Разделение труда: CLI для автоматизации, расширения IDE для кодинга, десктопное приложение для многозадачности и визуального контроля. Их можно использовать одновременно.
Теперь вы знаете, как установить десктопное приложение на macOS и Windows, как вести параллельные сессии и понимать, что они изолированы друг от друга через worktree, как проверять изменения через визуальный diff, комментировать их и когда лучше вернуться в терминал. Освоив параллельную работу, вы перестанете путаться в терминальных вкладках, даже ведя несколько задач одновременно.
В следующей статье 11 · Веб-версия и облако (Web / Телефон) мы разберемся с окружением Remote в десктопном приложении и узнаем, как следить за прогрессом с мобильного телефона. Мы посмотрим, как заставить Claude Code работать в облаке, даже если вы выключили компьютер или отошли от рабочего места.