← Все гайды AI Release
EN Подписаться на @ai_release1

Claude Code Desktop: установка, лимиты и чем отличается от терминала

Обновлено: 02.11.2026 · AI Release · @ai_release1
Claude Code Desktop: установка, лимиты и чем отличается от терминала

TL;DR

Важное ограничение по фактам: отдельного продукта «Claude Code Desktop» в наших разборах нет. Десктопный запуск Claude Code без терминала описан в источнике как сторонняя обёртка Capri-AI (Capri-Setup.exe, Windows 10+, MIT). Все шаги по самой десктопной сборке Claude Code, которой нет в источниках, помечены как «сверьтесь с документацией».

Требования и подготовка

Иллюстрация к разделу «Требования и подготовка»
Иллюстрация к разделу «Требования и подготовка»

Чем десктопная обёртка отличается от терминала по фактам источников:

ЧтоClaude Code в терминалеДесктоп-обёртка (Capri-AI)
ЗапускКоманда в шелле`Capri-Setup.exe`, ярлык в меню «Пуск», без терминала
Исполнитель задачиСам Claude CodeClaude Code, Codex или Antigravity — на выбор
АвторизацияАккаунт/ключ Claude CodeСвой аккаунт или API-ключ
Доступ к файлам и shellПрямой, из шеллаЧерез подтверждение в интерфейсе
Хуки и прелоады (`BUN_OPTIONS`, `~/.claude/skills/…`)РаботаютВ источнике не описаны — сверьтесь с документацией

Пример: в терминале скилл кладётся симлинком в ~/.claude/skills/threat-model, и агент подхватывает его как локальную инструкцию; в GUI-обёртке такого пути в источниках не описано.

Шаг 1. Зафиксировать сборку и проверить окружение

Что сделать: узнать версию CLI, убедиться, что она в диапазоне, где проверены обходы, и не равна уязвимой 2.1.313.

Зачем: поведение фонового агента статус-строки включено по умолчанию с 2.1.232, а прелоад-обход тестировали на 2.1.257–2.1.312. Вы должны знать, в какой точке вы находитесь, иначе любые замеры расхода бессмысленны.

Как проверить:

claude --version

Пример ожидаемого вывода: 2.1.312 — верхняя граница протестированного диапазона. Если видите 2.1.313 или новее, считайте, что обход не гарантирован: после обновления хук может отвалиться.

Проверка целостности SSH-ключей — быстрый способ поймать последствия бэкдора из 2.1.313:

ls -ld ~/.ssh
grep -c 'ssh-ed25519' ~/.ssh/authorized_keys

Ожидаемо: права каталога 0700, файла 0600, а список ключей — только те, что вы добавляли сами. Любой незнакомый ключ Ed25519 — повод разбираться, а не «перезайти».

Шаг 2. Установить десктопную обёртку и подключить аккаунт

Иллюстрация к разделу «Шаг 2. Установить десктопную обёртку и подключить аккаунт»
Иллюстрация к разделу «Шаг 2. Установить десктопную обёртку и подключить аккаунт»

Что сделать: скачать Capri-Setup.exe из релизов проекта на GitHub, установить, запустить и в настройках выбрать, куда уходят задачи: Claude Code, Codex или Antigravity. Затем подключить аккаунт или API-ключ.

Зачем: это единственный описанный в источниках способ запускать Claude Code без терминала на Windows. Проверка файла перед запуском — базовая гигиена: проект молодой, открытый, MIT.

Get-Item .\Capri-Setup.exe | Select-Object Name, Length, LastWriteTime

Пример: Name: Capri-Setup.exe, Length: <размер из релиза>. Если LastWriteTime свежее даты релиза, который вы скачали, — файл пересобран, берите заново из релиза.

Почему это работает: обёртка не заменяет Claude Code, а вызывает его как исполнителя задачи, поэтому ваш лимит расходуется так же, как в терминале.

Первый запуск задачи обязательно пройдёт через подтверждение доступа к файлам и shell — не отключайте его: именно этот слой отделяет GUI от «молча выполни любую команду».

Пример первого запроса: «Прочитай README.md в C:\work\project и перечисли разделы» → появится запрос на доступ к папке → после подтверждения в чате появится список разделов.

Шаг 3. Проверить работу и поставить учёт лимитов

Иллюстрация к разделу «Шаг 3. Проверить работу и поставить учёт лимитов»
Иллюстрация к разделу «Шаг 3. Проверить работу и поставить учёт лимитов»

Что сделать: убедиться, что задача реально ушла в Claude Code, и настроить подсчёт остатка лимита.

Зачем: /usage показывает остаток только внутри открытой сессии и только для одного аккаунта. У Claude Code при этом два ограничения — пятичасовое окно и недельное, считать нужно оба. Без внешнего счётчика вы узнаете об исчерпании квоты по факту отказа.

Как проверить:

/usage

Ожидаемый результат: цифры по текущей сессии. Пусто или «нет данных» вне сессии — норма, а не поломка.

Дальше — один из двух вариантов:

1) Spark HUD (Mel0nidas/spark-hud, открытый код) — анимированная панель над терминалом: живое контекст-окно, лимиты плана Max (5-часовые и 7-дневные) с прогнозом темпа расхода, стоимость, субагенты и все открытые окна Claude.

2) Ручной расчёт по методике из разбора на Habr: считаете расход на пятичасовое окно и отдельно на недельное, прогнозируете до момента сброса.

Пример: вы израсходовали 60% пятичасового окна за 90 минут — при том же темпе остаток кончится раньше сброса; HUD покажет это как растущий прогноз, а не как «ещё есть запас».

Если работаете субагентами на нескольких подписках, aaronyi97/claude-pro-pool раздаёт задачи по остатку лимита и меняет аккаунт при упоре в квоту, продолжая с того же места. Что именно запускать в субагентах, разобрано в гайде Claude Code Agent Teams: команда агентов от задачи до релиза.

Возможные проблемы и решения

Проблема. Расход токенов растёт без ваших запросов, в панели агентов меняется подпись из 3–5 слов

BUN_OPTIONS="--preload ./<ваш-прелоад>.ts" claude

Работает на Linux. В десктопной обёртке применение прелоада не описано — сверьтесь с документацией.

Проблема. /usage не показывает остаток

Проблема. После установки расширения из маркетплейса появился чужой SSH-доступ

Резюме и следующие шаги

Вы получили рабочую связку «десктоп-обёртка + терминал для проверок» и счётчик двух окон лимита вместо одного индикатора /usage. Дальше настройте бюджет пятичасового и недельного окна и выберите, чем закрывать задачи — одиночным агентом или командой субагентов.

FAQ

Чем Claude Code Desktop отличается от терминала?

В источниках «Claude Code Desktop» как отдельный продукт не описан. Десктопный запуск без терминала реализует сторонняя обёртка Capri-AI: Capri-Setup.exe, Windows 10+, задачи уходят в Claude Code, Codex или Antigravity со своим аккаунтом или API-ключом, доступ к файлам и shell — через подтверждение.

Сколько у Claude Code лимитов и где смотреть остаток?

Два ограничения: пятичасовое окно и недельное. Встроенный /usage показывает остаток только внутри открытой сессии и только для одного аккаунта, поэтому остаток считается внешним инструментом — например, Spark HUD с прогнозом темпа расхода.

Можно ли отключить фонового агента, который тратит токены на подпись статус-строки?

Тумблера нет: с 2.1.232 фича включена по умолчанию. Обход — Bun-прелоад примерно на 80 строк через BUN_OPTIONS=--preload, проверялся на Linux и сборках 2.1.257–2.1.312.

Какие сборки Claude Code безопасны?

Сборка 2.1.313 расширения для VS Code содержала SSH-бэкдор и была снята с маркетплейса, из NPM и реестра VS Code. Держите версию в протестированном диапазоне и сверяйте актуальный список проблемных версий с документацией; общий обзор помощников для кода — в гайде ИИ для программистов: помощники для кода в 2026.

🤖 Кратко для ИИ

Связанные посты

📚 Связанные гайды

ИИ для программистов: помощники для кода в 2026

Claude Code, Copilot и другие ИИ-помощники: что умеют, сколько стоят и как ускоряют разработку.

Claude Code Agent Teams: команда агентов от задачи до релиза

Как включить Agent Teams, раздать роли через .claude/agents и провести задачу от бэклога до релиза: лимиты токенов, конф

ChatGPT, Claude, Gemini, DeepSeek: сравнение ИИ-ассистентов

Прямое сравнение популярных ИИ-ассистентов: качество ответов, цена, лимиты и для кого что лучше.