本文へ移動
cccskills
無料GitHub で公開

claude-repair

Diagnose and restore the Claude Desktop app when it will not start, crashes, or runs with no visible window. Use for Windows MSIX launch failures, 'Not main instance', stale AppX job containers, NeedsRemediation or 0x80070020 errors. Separates Desktop from the CLI, reads fresh logs, picks a narrow fix and proves a visible working window. Triggers: /claude-repair, Claude Desktop won't open, Claude app crashed.

インストール方法を見る

含まれるファイル(2)

  • SKILL.md13.3 KB
  • references/windows-stale-container.md11.5 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

Claude Desktop: диагностика и восстановление

Результат: приложение доступно пользователю, исходный сценарий повторён. Сам факт PID или успешного запуска команды недостаточен.

Портируемость: Windows MSIX проверен на a test Windows machine 04–05.10.2026. На macOS адаптировать пути и штатный запуск; этот путь не проверен. Для иных ОС сначала установить, какое именно приложение/обёртка используется. PowerShell/MSIX-команды не переносить на другие ОС. Рельса: локальные команды и UI, без платного API. Независимое ревью изменения скриптов: доступный другой вендор через штатную рельсу.

1. Сначала различить продукт и симптом

  • RECALL: прошлый ремонт, текущая версия, актуальные логи. Предыдущая причина является гипотезой до свежей улики.
  • Различать Claude Desktop, Claude Code CLI и веб-сайт. Этот скилл ремонтирует Desktop; для CLI сначала установить его собственный текст ошибки.
  • Windows: записать Get-AppxPackage *Claude* (Name, PackageFullName, PackageFamilyName, Version, Status), процессы с путями, PID, временем создания и SessionId, видимые окна. Проверить свежесть main.log в обоих местах: $env:APPDATA\Claude\logs и $env:LOCALAPPDATA\Claude\logs; при отсутствии проверить LocalCache установленного пакета. После обновления лог может переехать, старый хвост не описывает новую попытку.
  • Не завершать все процессы с именем claude: рядом могут жить независимые CLI-сессии и remote control. Путь и command line помогают различить роли, но не доказывают принадлежность к AppX Job. GetPackageFullName=APPMODEL_ERROR_NO_PACKAGE тоже не исключает унаследованный Job. Для остановки потомков нужны фактический список участников Job и оценка их работы; сырые командные строки могут содержать секреты.
  • До перезапуска проверить незавершённые задачи и несохранённые данные. Закрывать штатно только нужный Desktop-процесс. Не удалять профиль, чаты или учётные данные ради диагностики.

2. Выбрать ветку по свежим данным

MSIX установлен, окна нет: прочитать существующий $HOME/.claude/scripts/desktop_app_launch.ps1, если он есть. На проверенной машине он активирует зарегистрированное приложение через ApplicationActivationManager. Запустить его штатно, затем проверить окно и журнал. Если скрипта нет, использовать штатную активацию установленного приложения, не придумывать путь к exe из старой версии.

Not main instance, returning early from app ready: это признак отказа второго экземпляра, не доказательство повреждения профиля или stale lock. Сопоставить процессы, интерактивную сессию и окно. Успешная активация может восстановить доступ без доказательства первоначальной причины.

Процесс живёт в Session 0: проверить источник запуска и principal задачи планировщика. Процесс в служебной сессии не подтверждает окно у пользователя. Менять запуск только после подтверждения этой причины, с бэкапом исходной задачи.

Обновление/пакет/служба: текущий пакет и свежие логи должны подтвердить неисправность. Старые события staging или CoworkVMService не достаточны. Не запускать исторические heal/reset-скрипты до чтения их действий; переустановка и сброс данных не являются первым шагом.

Modified, NeedsRemediation / 0x80073CFC: отделить повреждение регистрации от блокировки запуска. Штатный winget repair --name Claude --exact --source winget --silent --disable-interactivity может вернуть успех, не восстановив запуск; повторно читать статус и пробовать активацию. Если winget отсутствует в PATH, проверить установленный Microsoft.DesktopAppInstaller, а не объявлять инструмент отсутствующим. Регистрация существующего manifest не возвращает потерянные файлы. При необходимости восстановления пакета: сохранить конфигурацию, взять официальный подписанный MSIX, проверить издателя и установить поверх без удаления профиля. CodeIntegrity.cat отсутствует / событие 3010 есть — это улика для проверки, не доказанный корень. После каждой попытки ветку выбирает новая ошибка; не крутить перерегистрацию по кругу.

Status: Ok, но 0x80070020 + AppModel-Runtime 215/208, converting the job: сразу читать ветку старого контейнера. Старый пользовательский Job может удерживаться python, WSL, shell, git или сервером, когда самого Claude уже нет. Сначала read-only перечисление участников, при AccessDenied узкая проверка с повышением прав. Затем оценить побочные эффекты, завершить только разрешённые и повторно проверенные процессы, подтвердить уничтожение старого контейнера событием 217 и запуск нового событием 201. Не останавливать службы, всю WSL, все Python/Claude или хаб наугад.

Окно открывается, но падает при действии: сохранить свежий crash/log и воспроизведение; исследовать именно действие. Ошибки сети/авторизации не лечить сбросом MSIX наугад.

3. Доказать результат и оставить откат

  1. Проверить видимое окно в пользовательской сессии, Responding и UI. В журнале найти новые boot/input/renderer-ready события после попытки, не старые строки.
  2. Вторым способом проверить пользовательский сценарий. Для отказа запуска: повторная активация плюс видимое доступное окно. Для отказа сообщений: новая сессия с коротким безопасным ответом без инструментов, если это входит в задачу.
  3. Не объявлять холодный запуск проверенным, если проверена только повторная активация. Не закрывать рабочие задачи ради дополнительного теста.
  4. Если менялись файлы/задачи: сохранить до/после, хэши и точную обратную операцию. Если ничего не менялось, написать «откат файлов не требуется».
  5. Итог: симптом; доказанная причина либо UNKNOWN; действие; две проверки; непроверенное. Записать результат в существующий журнал ремонта/изменений с ts, node, actor, event, outcome. Документ не создаёт нового фонового сторожа.
  6. Отдельно перечислить прерванные фоновые задачи и проверить нужных потребителей после восстановления. Окно Claude не доказывает сохранность WSL-приложения, локальных серверов или авторизации. Если UI-инструмент остановлен, больше не посылать через него ввод; окно/Responding + свежие логи дают ограниченное подтверждение, а отсутствие визуальной проверки назвать прямо.

Запрос «срочно открой / доведи до конца» означает продолжать доступный безопасный ремонт после неудачного перезапуска. Не отдавать пользователю промежуточную диагностику как финал при наличии следующего шага. Реальный блок на правах или рискованном действии назвать конкретно.

Проверенный прецедент 04.10.2026

Claude Desktop 1.37937.3.0: лог отказа второго экземпляра, видимого Desktop не было; две живые CLI-сессии сохранены. Штатная AAM-активация дала видимое responsive-окно, input/renderer ready и завершение boot; повторная активация сохранила рабочее окно. Профиль не сбрасывали. Первопричина исходного отказа и холодный запуск остались непроверенными.

Проверенный прецедент 05.10.2026

После восстановления пакета статус стал Ok, но старый пользовательский Job продолжал блокировать запуск. Очистка подтверждённых участников восстановила активацию; подробные улики, побочные эффекты и границы доказанного находятся в единственном описании прецедента.

<!--kit-footer-->

Like this skill? It is one of 100 in second-brain-starter-kit: the second brain we built for ourselves and run every day at Palo Alto AI Research Lab. Install the whole set with npx skills add tonydzi/second-brain-starter-kit. Everything is open source and free, so take what you need.

Flagships worth a look on their own: secondop-panel (a second opinion from a panel of external models), claude-memory-tidy (stop your agent's memory from rotting), telegram-mcp-kit (your own Telegram over MCP in about 15 minutes).

Author: Anton Dziatkovskii, Palo Alto AI Research Lab. Telegram @tonydzi - WhatsApp +1 341 222 9178 - X @Tony_Stef_

Engineers: want to test-drive this setup? Message me. I hand out free starter seeds to engineers who test and report back, and custom skill requests are welcome.

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

03

無料

Run an autonomous consensus round between agent peers on several machines: they negotiate a decision over a shared channel and execute it without a human relaying messages. Use when multiple machines must agree on a change. Triggers: "/03", "work it out among yourselves", "find consensus". Wakes the human only for irreversible actions or a deadlock.

日本語の概要は準備中です。原文の説明を表示しています。

tonydzi/second-brain-starter-kit82026年10月12日 更新

1

無料

Recover a session after a hard crash (app died, machine rebooted, context lost mid-work): replay the turn-state ledger for the last requests, files and decisions, run a green/red health ping over the system map, file sync and MCP connectors, then rebuild the previous session history for pickup. Triggers: "/1", "resume after crash", "wake".

日本語の概要は準備中です。原文の説明を表示しています。

tonydzi/second-brain-starter-kit82026年10月12日 更新

agenda

無料

Show the operator's day: today's calendar plus what needs them personally (leads due, people awaiting a reply, deadlines), pulled from Calendar and Telegram and ranked. Read-only: sends and commits nothing. Triggers: "/agenda", "what's on today", "my agenda".

日本語の概要は準備中です。原文の説明を表示しています。

tonydzi/second-brain-starter-kit82026年10月12日 更新

ai-slop

無料

Rewrite machine-written text so it reads like a busy human wrote it: cut 50-70%, break the even rhythm, drop AI-tell words and filler, keep facts and protected terms. Use before publishing any post, reply or email drafted by a model. Triggers: /ai-slop, /slop, humanize, anti-slop, make it shorter and alive.

日本語の概要は準備中です。原文の説明を表示しています。

tonydzi/second-brain-starter-kit82026年10月12日 更新

Decision protocol for strategic work: recall the knowledge vault, run a gap analysis, emit a deep-research prompt for external tools, then synthesize the returned reports into a decision memo. Use before any new product, feature, market, pricing, GTM or architecture call, where local recall alone is not enough. Triggers: "/alfa-search-recall-deepresearch", "alpha protocol", "R+DR".

日本語の概要は準備中です。原文の説明を表示しています。

tonydzi/second-brain-starter-kit82026年10月12日 更新

- КРЕДИТ АВТОРУ ИДЕИ: совет из комментария (TG @ClawRus / @ClawInga, комменты под постами Антона в FB, треды и issue на… Триггеры: “/alpha-credit“, “/credit“, “кто нам это посоветовал“, “запиши совет“, “поблагодари советчиков“, “кому мы должны спасибо“, “кредит автору“, “чей это был совет“, “credit the author“

日本語の概要は準備中です。原文の説明を表示しています。

tonydzi/second-brain-starter-kit82026年10月12日 更新

tonydzi のスキルをすべて見る

このスキルの問題を報告する