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

> AI Release · @ai_release1 · https://ai-release.org/guides/claude-code-desktop-ustanovka.html

## TL;DR
- Время выполнения: 20–25 минут
- Уровень сложности: Basic
- Понадобится: Windows 10 или новее (для десктопной обёртки), установленный Claude Code CLI, аккаунт с подпиской Pro/Max либо API-ключ, Git, доступ к терминалу для проверок.

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

## Требования и подготовка
![Иллюстрация к разделу «Требования и подготовка»](https://ai-release.org/guides/img/claude-code-desktop-ustanovka-ru-1.jpg?v=1793608954)

- ОС: Windows 10 или новее — только под неё есть готовый установщик десктоп-обёртки из источника.
- Доступ к Claude Code в терминале — он остаётся источником истины для проверок версии, лимитов и хуков.
- Аккаунт с подпиской Pro/Max или собственный API-ключ: обёртка работает «со своим аккаунтом или API-ключом».
- Linux-шелл (WSL или отдельная машина) — если планируете обход фонового агента статус-строки: прелоад тестировали на Linux.
- Git и ~5 минут на чтение репозитория: у Capri-AI открытый код под MIT, но в репозитории всего 5 коммитов — оценивайте риски доступа к файлам и shell.
- Не устанавливать сборку `2.1.313` расширения Claude Code для VS Code: в неё был вшит SSH-бэкдор, релиз снят с маркетплейса, из NPM и реестра VS Code.

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

| Что | Claude Code в терминале | Десктоп-обёртка (Capri-AI) |
|---|---|---|
| Запуск | Команда в шелле | `Capri-Setup.exe`, ярлык в меню «Пуск», без терминала |
| Исполнитель задачи | Сам Claude Code | Claude 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`. Вы должны знать, в какой точке вы находитесь, иначе любые замеры расхода бессмысленны.

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

```bash
claude --version
```

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

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

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

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

## Шаг 2. Установить десктопную обёртку и подключить аккаунт
![Иллюстрация к разделу «Шаг 2. Установить десктопную обёртку и подключить аккаунт»](https://ai-release.org/guides/img/claude-code-desktop-ustanovka-ru-2.jpg?v=1793608958)


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

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

```powershell
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. Проверить работу и поставить учёт лимитов»](https://ai-release.org/guides/img/claude-code-desktop-ustanovka-ru-3.jpg?v=1793608963)


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

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

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

```text
/usage
```

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

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

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

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

Если работаете субагентами на нескольких подписках, `aaronyi97/claude-pro-pool` раздаёт задачи по остатку лимита и меняет аккаунт при упоре в квоту, продолжая с того же места. Что именно запускать в субагентах, разобрано в гайде [Claude Code Agent Teams: команда агентов от задачи до релиза](https://ai-release.org/guides/claude-code-agent-teams-komanda-agentov.html?utm_source=tg&utm_medium=channel&utm_campaign=guide_inline&utm_content=guide_to_guide).

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

**Проблема. Расход токенов растёт без ваших запросов, в панели агентов меняется подпись из 3–5 слов**
- Ошибка: `claude --version` показывает сборку новее `2.1.312`; в фоне каждые ~30 секунд уходит полный транскрипт фонового агента.
- Причина: фича подписи статус-строки включена по умолчанию с `2.1.232`, тумблера нет. По замерам авторов разбора: 16,4% всех расходов Claude Code, 19,7% API-запросов, 96% суммы — на Opus.
- Решение: обход — Bun-прелоад (~80 строк) через переменную окружения:

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

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

**Проблема. `/usage` не показывает остаток**
- Ошибка: `/usage` пуст вне сессии и учитывает только один аккаунт.
- Причина: встроенный индикатор ограничен рамками открытой сессии; недельное окно он не покрывает.
- Решение: поставить Spark HUD либо считать оба окна вручную; для нескольких подписок — пул `claude-pro-pool`.

**Проблема. После установки расширения из маркетплейса появился чужой SSH-доступ**
- Ошибка: в `~/.ssh/authorized_keys` лишняя строка `ssh-ed25519 …` с правами `0600`.
- Причина: сборка `2.1.313` расширения Claude Code для VS Code с вшитым бэкдором, срабатывавшим до `activate`; релиз снят с Cursor Marketplace, из NPM и реестра VS Code.
- Решение: удалить строку ключа, сменить ключи, поставить сборку не `2.1.313`, проверить `ls -l ~/.ssh/authorized_keys`.

## Резюме и следующие шаги
Вы получили рабочую связку «десктоп-обёртка + терминал для проверок» и счётчик двух окон лимита вместо одного индикатора `/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](https://ai-release.org/guides/ii-dlya-koda.html?utm_source=tg&utm_medium=channel&utm_campaign=guide_inline&utm_content=guide_to_guide).