claude-guest 0.2.0 → 0.3.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 +69 -38
- package/index.js +315 -124
- package/mac/probe.sh +47 -0
- package/mac/setup.sh +340 -0
- package/mac.sh +53 -0
- package/package.json +5 -2
- package/server/verify.sh +4 -3
- package/ui.js +2 -2
- package/win/setup.ps1 +4 -28
package/README.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# claude-guest
|
|
2
2
|
|
|
3
|
-
Пускает Claude с вашего сервера в гости на ПК с Windows. Claude получает свою папку
|
|
3
|
+
Пускает Claude с вашего сервера в гости на ПК с Windows или на Mac. Claude получает свою папку
|
|
4
4
|
и доступ к видеокарте, а остальные диски для него закрыты. Неофициальный инструмент.
|
|
5
5
|
|
|
6
6
|
Зачем: сервер слабый, а на ПК мощный процессор, видеокарта и ваши файлы. Claude на сервере
|
|
@@ -9,100 +9,131 @@
|
|
|
9
9
|
|
|
10
10
|
## Запуск
|
|
11
11
|
|
|
12
|
-
На
|
|
12
|
+
Одна команда для обеих систем, Windows или macOS скрипт определяет сам. На Windows - в «Командной
|
|
13
|
+
строке» (Пуск → `cmd`), на Mac - в Терминале:
|
|
13
14
|
|
|
14
|
-
```
|
|
15
|
-
|
|
15
|
+
```
|
|
16
|
+
npx claude-guest
|
|
16
17
|
```
|
|
17
18
|
|
|
18
|
-
Нужно, чтобы на
|
|
19
|
-
установщиком [claude-server-setup](https://www.npmjs.com/package/claude-server-setup).
|
|
19
|
+
Нужно, чтобы на компьютере уже был VS Code, подключённый к серверу, и Node.js. Проще всего
|
|
20
|
+
поставить сервер установщиком [claude-server-setup](https://www.npmjs.com/package/claude-server-setup).
|
|
20
21
|
|
|
21
22
|
Что вы делаете сами:
|
|
22
23
|
|
|
23
24
|
1. вставляете команду выше;
|
|
24
|
-
2.
|
|
25
|
+
2. подтверждаете изменения: на Windows - «Да» в окне «Разрешить изменения?», на Mac - пароль
|
|
26
|
+
от Mac в системном окне;
|
|
25
27
|
3. закрываете и снова открываете VS Code.
|
|
26
28
|
|
|
27
29
|
Остальное скрипт делает сам: этапы идут списком с галочками и общей полосой, в конце - итог
|
|
28
|
-
в рамке и что Claude видит на
|
|
30
|
+
в рамке и что Claude видит на компьютере. Посмотреть, как это выглядит, ничего не меняя в системе:
|
|
29
31
|
|
|
30
|
-
```
|
|
32
|
+
```
|
|
31
33
|
npx claude-guest --demo
|
|
32
34
|
```
|
|
33
35
|
|
|
36
|
+
Без Node.js на компьютере - загрузчики, которые скачают свою копию Node.js в папку пользователя:
|
|
37
|
+
|
|
38
|
+
```
|
|
39
|
+
irm https://unpkg.com/claude-guest/win.txt | iex # Windows, PowerShell
|
|
40
|
+
curl -fsSL https://unpkg.com/claude-guest/mac.sh | sh # Mac, Терминал
|
|
41
|
+
```
|
|
42
|
+
|
|
34
43
|
## Папка Claude
|
|
35
44
|
|
|
36
|
-
|
|
45
|
+
Ссылка на неё появляется на рабочем столе:
|
|
37
46
|
|
|
38
47
|
```
|
|
39
|
-
D:\Claude\
|
|
40
|
-
|
|
41
|
-
|
|
48
|
+
Windows: D:\Claude\ (на диске, где больше всего места)
|
|
49
|
+
Mac: /Users/Shared/Claude/
|
|
50
|
+
inbox/ - сюда вы кладёте файлы для Claude: он их читает, но изменить или удалить не может
|
|
51
|
+
work/ - здесь Claude работает: проекты, рендеры, готовые результаты
|
|
42
52
|
```
|
|
43
53
|
|
|
44
|
-
Файлы в `inbox` переносите сами.
|
|
45
|
-
|
|
46
|
-
на кириллических путях.
|
|
54
|
+
Файлы в `inbox` переносите сами. Имена латиницей намеренно: в этих папках Claude запускает
|
|
55
|
+
программы, часть из них ломается на кириллических путях.
|
|
47
56
|
|
|
48
57
|
## Что именно делается
|
|
49
58
|
|
|
50
|
-
**На
|
|
59
|
+
**На Windows:**
|
|
51
60
|
|
|
52
|
-
- пользователь
|
|
61
|
+
- пользователь `claude-guest`: без прав администратора, скрыт с экрана входа.
|
|
53
62
|
Пароль случайный, он записан в файле на рабочем столе. Для работы пароль не нужен;
|
|
54
63
|
- SSH-сервер Windows, который слушает только `127.0.0.1`. Вход только по ключу, только для гостя,
|
|
55
64
|
пробросы запрещены. Из сети, в том числе из домашней, его не видно;
|
|
56
65
|
- папка `Claude` (см. выше): `inbox` гость только читает, в `work` читает и пишет;
|
|
57
66
|
- запрет для гостя на все остальные диски и на папки в корне `C:`, кроме системных:
|
|
58
|
-
без системных папок не запустится ни одна
|
|
59
|
-
|
|
60
|
-
|
|
67
|
+
без системных папок не запустится ни одна программа.
|
|
68
|
+
|
|
69
|
+
**На Mac:**
|
|
70
|
+
|
|
71
|
+
- пользователь `claude-guest`: без прав администратора, скрыт с экрана входа, пароль - как на Windows;
|
|
72
|
+
- свой SSH-сервер гостя (системный `sshd` со своими настройками, служба launchd
|
|
73
|
+
`local.claude-guest.sshd`): только `127.0.0.1`, только ключ, только гость. Системный
|
|
74
|
+
«Удалённый вход» скрипт не включает и не перенастраивает, только запрещает в нём гостя;
|
|
75
|
+
- папка `/Users/Shared/Claude`: права через ACL с наследованием - `inbox` гость читает,
|
|
76
|
+
в `work` пишут и гость, и вы;
|
|
77
|
+
- запрет для гостя (запись ACL `deny`) на домашние папки всех пользователей, на содержимое
|
|
78
|
+
`/Users/Shared` и на диски в `/Volumes`. Программы и системные папки гость видит, как любой
|
|
79
|
+
пользователь Mac.
|
|
80
|
+
|
|
81
|
+
**На обеих системах** в `~/.ssh/config` для подключения к серверу добавляется строка
|
|
82
|
+
`RemoteForward`. Пока VS Code подключён к серверу, сервер достаёт до SSH на компьютере.
|
|
83
|
+
Закрыли VS Code - связи нет.
|
|
61
84
|
|
|
62
85
|
**На сервере:**
|
|
63
86
|
|
|
64
87
|
- ключ `~/.ssh/claude-guest` и адрес `ssh pc`;
|
|
65
|
-
- памятка для Claude в `~/.claude/CLAUDE.md`: как работать с
|
|
88
|
+
- памятка для Claude в `~/.claude/CLAUDE.md`: как работать с компьютером и чего не делать;
|
|
66
89
|
- проверка связи с клиентом (`ClientAliveInterval`), если её не было и есть sudo без пароля.
|
|
67
90
|
|
|
68
91
|
## Отключение
|
|
69
92
|
|
|
70
|
-
```
|
|
71
|
-
|
|
93
|
+
```
|
|
94
|
+
npx claude-guest --remove
|
|
72
95
|
```
|
|
73
96
|
|
|
74
|
-
Команда снимает запреты, удаляет пользователя, выключает SSH-сервер (
|
|
75
|
-
настройки, если он стоял до скрипта) и убирает ключ и памятку на сервере. Папка `Claude`
|
|
76
|
-
с вашими файлами остаётся на месте, удалите её сами, если не нужна.
|
|
97
|
+
Команда снимает запреты, удаляет пользователя, выключает SSH-сервер (на Windows - возвращает ему
|
|
98
|
+
прежние настройки, если он стоял до скрипта) и убирает ключ и памятку на сервере. Папка `Claude`
|
|
99
|
+
с вашими файлами остаётся на месте, удалите её сами, если не нужна. На Mac файлы, созданные
|
|
100
|
+
гостем, переходят вам.
|
|
77
101
|
|
|
78
102
|
## Ограничения
|
|
79
103
|
|
|
80
|
-
-
|
|
104
|
+
- Windows 10 1809+ и 11, macOS 11+.
|
|
81
105
|
- Флешки и диски в exFAT или FAT32 закрыть нельзя: у этих файловых систем нет прав доступа.
|
|
106
|
+
На Mac то же самое с дисками, где стоит галочка «Игнорировать владельцев на этом томе».
|
|
82
107
|
Скрипт о них предупреждает.
|
|
83
|
-
-
|
|
84
|
-
|
|
85
|
-
-
|
|
86
|
-
«только для Claude»: входы на ПК по SSH с других устройств перестанут работать.
|
|
87
|
-
|
|
88
|
-
|
|
108
|
+
- Новое, что появится потом, гостю открыто: на Windows - папки в корне `C:`, на Mac - новые диски
|
|
109
|
+
и папки в `/Users/Shared`. Запустите команду ещё раз: она закроет новые.
|
|
110
|
+
- На Windows: если на ПК уже работал SSH-сервер, скрипт спросит разрешение перевести его в режим
|
|
111
|
+
«только для Claude»: входы на ПК по SSH с других устройств перестанут работать. Закрыть диск
|
|
112
|
+
с сотнями тысяч файлов (игры, Steam) - до получаса: Windows проставляет запрет на каждый файл.
|
|
113
|
+
- На Mac файл, перенесённый в `inbox` с закрытыми правами (600), гость не прочитает - копируйте,
|
|
114
|
+
а не переносите.
|
|
89
115
|
|
|
90
116
|
## Для продвинутых
|
|
91
117
|
|
|
92
|
-
Открыть гостю на чтение свою папку, не перенося файлы в `inbox
|
|
118
|
+
Открыть гостю на чтение свою папку, не перенося файлы в `inbox` (пока только Windows):
|
|
93
119
|
|
|
94
|
-
```
|
|
120
|
+
```
|
|
95
121
|
npx claude-guest --folder "D:\Видео"
|
|
96
122
|
```
|
|
97
123
|
|
|
98
124
|
Ключ можно повторить несколько раз. Весь диск, системные папки, профиль целиком, `AppData`
|
|
99
125
|
и `.ssh` открыть нельзя - скрипт откажет.
|
|
100
126
|
|
|
127
|
+
Показ на другой системе: `npx claude-guest --demo mac` или `--demo win`. На Mac без системного
|
|
128
|
+
окна (например, по SSH) пароль спросит `sudo` в терминале, принудительно - ключ `--sudo`.
|
|
129
|
+
|
|
101
130
|
## Проверка
|
|
102
131
|
|
|
103
132
|
```bash
|
|
104
133
|
npm test
|
|
105
134
|
```
|
|
106
135
|
|
|
107
|
-
Без Windows: чистые функции, серверные скрипты на временном `HOME`, разбор PowerShell-скриптов
|
|
108
|
-
парсером из Docker-образа `mcr.microsoft.com/powershell
|
|
136
|
+
Без Windows и Mac: чистые функции, серверные скрипты на временном `HOME`, разбор PowerShell-скриптов
|
|
137
|
+
парсером из Docker-образа `mcr.microsoft.com/powershell` и прогон `mac/setup.sh` на заглушках
|
|
138
|
+
команд macOS в bash 3.2 (Docker-образ `bash:3.2`), если образы есть. Поведение настоящей macOS
|
|
139
|
+
(ACL, launchd, sshd) этим не проверяется.
|