claude-guest 0.0.0-stage → 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -1,3 +1,108 @@
1
- # Temporary Holding Version
1
+ # claude-guest
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ Пускает Claude с вашего сервера в гости на ПК с Windows. Claude получает свою папку на ПК
4
+ и доступ к видеокарте, а остальные диски для него закрыты. Неофициальный инструмент.
5
+
6
+ Зачем: сервер слабый, а на ПК мощный процессор, видеокарта и ваши файлы. Claude на сервере
7
+ сможет рендерить видео, распознавать речь, гонять нейросети на видеокарте ПК и забирать
8
+ результат себе.
9
+
10
+ ## Запуск
11
+
12
+ На ПК, в PowerShell:
13
+
14
+ ```powershell
15
+ irm https://unpkg.com/claude-guest/win.txt | iex
16
+ ```
17
+
18
+ Нужно, чтобы на ПК уже был VS Code, подключённый к серверу. Проще всего поставить сервер
19
+ установщиком [claude-server-setup](https://www.npmjs.com/package/claude-server-setup).
20
+
21
+ Что вы делаете сами:
22
+
23
+ 1. вставляете команду выше;
24
+ 2. нажимаете «Да» в окне Windows «Разрешить изменения?»;
25
+ 3. закрываете и снова открываете VS Code.
26
+
27
+ Остальное скрипт делает сам: этапы идут списком с галочками и общей полосой, в конце - итог
28
+ в рамке и что Claude видит на ПК. Посмотреть, как это выглядит, ничего не меняя в системе:
29
+
30
+ ```powershell
31
+ npx claude-guest --demo
32
+ ```
33
+
34
+ ## Папка Claude
35
+
36
+ На диске, где больше всего места, появляется папка `Claude`, ярлык на неё - на рабочем столе:
37
+
38
+ ```
39
+ D:\Claude\
40
+ inbox\ - сюда вы кладёте файлы для Claude: он их читает, но изменить или удалить не может
41
+ work\ - здесь Claude работает: проекты, рендеры, готовые результаты
42
+ ```
43
+
44
+ Файлы в `inbox` переносите сами. С того же диска перенос мгновенный при любом размере.
45
+ Имена латиницей намеренно: в этих папках Claude запускает программы, часть из них ломается
46
+ на кириллических путях.
47
+
48
+ ## Что именно делается
49
+
50
+ **На ПК:**
51
+
52
+ - пользователь Windows `claude-guest`: без прав администратора, скрыт с экрана входа.
53
+ Пароль случайный, он записан в файле на рабочем столе. Для работы пароль не нужен;
54
+ - SSH-сервер Windows, который слушает только `127.0.0.1`. Вход только по ключу, только для гостя,
55
+ пробросы запрещены. Из сети, в том числе из домашней, его не видно;
56
+ - папка `Claude` (см. выше): `inbox` гость только читает, в `work` читает и пишет;
57
+ - запрет для гостя на все остальные диски и на папки в корне `C:`, кроме системных:
58
+ без системных папок не запустится ни одна программа;
59
+ - в `~/.ssh/config` для подключения к серверу добавляется строка `RemoteForward`. Пока VS Code
60
+ подключён к серверу, сервер достаёт до SSH на ПК. Закрыли VS Code - связи нет.
61
+
62
+ **На сервере:**
63
+
64
+ - ключ `~/.ssh/claude-guest` и адрес `ssh pc`;
65
+ - памятка для Claude в `~/.claude/CLAUDE.md`: как работать с ПК и чего не делать;
66
+ - проверка связи с клиентом (`ClientAliveInterval`), если её не было и есть sudo без пароля.
67
+
68
+ ## Отключение
69
+
70
+ ```powershell
71
+ irm https://unpkg.com/claude-guest/off.txt | iex
72
+ ```
73
+
74
+ Команда снимает запреты, удаляет пользователя, выключает SSH-сервер (или возвращает ему прежние
75
+ настройки, если он стоял до скрипта) и убирает ключ и памятку на сервере. Папка `Claude`
76
+ с вашими файлами остаётся на месте, удалите её сами, если не нужна.
77
+
78
+ ## Ограничения
79
+
80
+ - Только Windows 10 1809+ и 11.
81
+ - Флешки и диски в exFAT или FAT32 закрыть нельзя: у этих файловых систем нет прав доступа.
82
+ Скрипт о них предупреждает.
83
+ - Новые папки, созданные потом прямо в корне `C:`, будут открыты для гостя. Заводите папки
84
+ внутри своих или запустите команду ещё раз: она закроет новые.
85
+ - Если на ПК уже работал SSH-сервер, скрипт спросит разрешение перевести его в режим
86
+ «только для Claude»: входы на ПК по SSH с других устройств перестанут работать.
87
+ - Закрыть диск с сотнями тысяч файлов (игры, Steam) - до получаса: Windows проставляет
88
+ запрет на каждый файл.
89
+
90
+ ## Для продвинутых
91
+
92
+ Открыть гостю на чтение свою папку, не перенося файлы в `inbox`:
93
+
94
+ ```powershell
95
+ npx claude-guest --folder "D:\Видео"
96
+ ```
97
+
98
+ Ключ можно повторить несколько раз. Весь диск, системные папки, профиль целиком, `AppData`
99
+ и `.ssh` открыть нельзя - скрипт откажет.
100
+
101
+ ## Проверка
102
+
103
+ ```bash
104
+ npm test
105
+ ```
106
+
107
+ Без Windows: чистые функции, серверные скрипты на временном `HOME`, разбор PowerShell-скриптов
108
+ парсером из Docker-образа `mcr.microsoft.com/powershell`, если он есть.