claude-guest 0.0.0-stage → 0.1.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 +102 -2
- package/index.js +576 -0
- package/off.txt +3 -0
- package/package.json +30 -4
- package/server/finish.sh +32 -0
- package/server/prepare.sh +47 -0
- package/server/remove.sh +15 -0
- package/server/verify.sh +12 -0
- package/win/probe.ps1 +38 -0
- package/win/setup.ps1 +393 -0
- package/win.txt +61 -0
package/README.md
CHANGED
|
@@ -1,3 +1,103 @@
|
|
|
1
|
-
#
|
|
1
|
+
# claude-guest
|
|
2
2
|
|
|
3
|
-
|
|
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
|
+
Остальное скрипт делает сам и в конце показывает, что Claude видит на ПК.
|
|
28
|
+
|
|
29
|
+
## Папка Claude
|
|
30
|
+
|
|
31
|
+
На диске, где больше всего места, появляется папка `Claude`, ярлык на неё - на рабочем столе:
|
|
32
|
+
|
|
33
|
+
```
|
|
34
|
+
D:\Claude\
|
|
35
|
+
inbox\ - сюда вы кладёте файлы для Claude: он их читает, но изменить или удалить не может
|
|
36
|
+
work\ - здесь Claude работает: проекты, рендеры, готовые результаты
|
|
37
|
+
```
|
|
38
|
+
|
|
39
|
+
Файлы в `inbox` переносите сами. С того же диска перенос мгновенный при любом размере.
|
|
40
|
+
Имена латиницей намеренно: в этих папках Claude запускает программы, часть из них ломается
|
|
41
|
+
на кириллических путях.
|
|
42
|
+
|
|
43
|
+
## Что именно делается
|
|
44
|
+
|
|
45
|
+
**На ПК:**
|
|
46
|
+
|
|
47
|
+
- пользователь Windows `claude-guest`: без прав администратора, скрыт с экрана входа.
|
|
48
|
+
Пароль случайный, он записан в файле на рабочем столе. Для работы пароль не нужен;
|
|
49
|
+
- SSH-сервер Windows, который слушает только `127.0.0.1`. Вход только по ключу, только для гостя,
|
|
50
|
+
пробросы запрещены. Из сети, в том числе из домашней, его не видно;
|
|
51
|
+
- папка `Claude` (см. выше): `inbox` гость только читает, в `work` читает и пишет;
|
|
52
|
+
- запрет для гостя на все остальные диски и на папки в корне `C:`, кроме системных:
|
|
53
|
+
без системных папок не запустится ни одна программа;
|
|
54
|
+
- в `~/.ssh/config` для подключения к серверу добавляется строка `RemoteForward`. Пока VS Code
|
|
55
|
+
подключён к серверу, сервер достаёт до SSH на ПК. Закрыли VS Code - связи нет.
|
|
56
|
+
|
|
57
|
+
**На сервере:**
|
|
58
|
+
|
|
59
|
+
- ключ `~/.ssh/claude-guest` и адрес `ssh pc`;
|
|
60
|
+
- памятка для Claude в `~/.claude/CLAUDE.md`: как работать с ПК и чего не делать;
|
|
61
|
+
- проверка связи с клиентом (`ClientAliveInterval`), если её не было и есть sudo без пароля.
|
|
62
|
+
|
|
63
|
+
## Отключение
|
|
64
|
+
|
|
65
|
+
```powershell
|
|
66
|
+
irm https://unpkg.com/claude-guest/off.txt | iex
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
Команда снимает запреты, удаляет пользователя, выключает SSH-сервер (или возвращает ему прежние
|
|
70
|
+
настройки, если он стоял до скрипта) и убирает ключ и памятку на сервере. Папка `Claude`
|
|
71
|
+
с вашими файлами остаётся на месте, удалите её сами, если не нужна.
|
|
72
|
+
|
|
73
|
+
## Ограничения
|
|
74
|
+
|
|
75
|
+
- Только Windows 10 1809+ и 11.
|
|
76
|
+
- Флешки и диски в exFAT или FAT32 закрыть нельзя: у этих файловых систем нет прав доступа.
|
|
77
|
+
Скрипт о них предупреждает.
|
|
78
|
+
- Новые папки, созданные потом прямо в корне `C:`, будут открыты для гостя. Заводите папки
|
|
79
|
+
внутри своих или запустите команду ещё раз: она закроет новые.
|
|
80
|
+
- Если на ПК уже работал SSH-сервер, скрипт спросит разрешение перевести его в режим
|
|
81
|
+
«только для Claude»: входы на ПК по SSH с других устройств перестанут работать.
|
|
82
|
+
- Закрыть диск с сотнями тысяч файлов (игры, Steam) - до получаса: Windows проставляет
|
|
83
|
+
запрет на каждый файл.
|
|
84
|
+
|
|
85
|
+
## Для продвинутых
|
|
86
|
+
|
|
87
|
+
Открыть гостю на чтение свою папку, не перенося файлы в `inbox`:
|
|
88
|
+
|
|
89
|
+
```powershell
|
|
90
|
+
npx claude-guest --folder "D:\Видео"
|
|
91
|
+
```
|
|
92
|
+
|
|
93
|
+
Ключ можно повторить несколько раз. Весь диск, системные папки, профиль целиком, `AppData`
|
|
94
|
+
и `.ssh` открыть нельзя - скрипт откажет.
|
|
95
|
+
|
|
96
|
+
## Проверка
|
|
97
|
+
|
|
98
|
+
```bash
|
|
99
|
+
npm test
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
Без Windows: чистые функции, серверные скрипты на временном `HOME`, разбор PowerShell-скриптов
|
|
103
|
+
парсером из Docker-образа `mcr.microsoft.com/powershell`, если он есть.
|