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 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
- На ПК, в PowerShell:
12
+ Одна команда для обеих систем, Windows или macOS скрипт определяет сам. На Windows - в «Командной
13
+ строке» (Пуск → `cmd`), на Mac - в Терминале:
13
14
 
14
- ```powershell
15
- irm https://unpkg.com/claude-guest/win.txt | iex
15
+ ```
16
+ npx claude-guest
16
17
  ```
17
18
 
18
- Нужно, чтобы на ПК уже был VS Code, подключённый к серверу. Проще всего поставить сервер
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. нажимаете «Да» в окне Windows «Разрешить изменения?»;
25
+ 2. подтверждаете изменения: на Windows - «Да» в окне «Разрешить изменения?», на Mac - пароль
26
+ от Mac в системном окне;
25
27
  3. закрываете и снова открываете VS Code.
26
28
 
27
29
  Остальное скрипт делает сам: этапы идут списком с галочками и общей полосой, в конце - итог
28
- в рамке и что Claude видит на ПК. Посмотреть, как это выглядит, ничего не меняя в системе:
30
+ в рамке и что Claude видит на компьютере. Посмотреть, как это выглядит, ничего не меняя в системе:
29
31
 
30
- ```powershell
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
- На диске, где больше всего места, появляется папка `Claude`, ярлык на неё - на рабочем столе:
45
+ Ссылка на неё появляется на рабочем столе:
37
46
 
38
47
  ```
39
- D:\Claude\
40
- inbox\ - сюда вы кладёте файлы для Claude: он их читает, но изменить или удалить не может
41
- work\ - здесь Claude работает: проекты, рендеры, готовые результаты
48
+ Windows: D:\Claude\ (на диске, где больше всего места)
49
+ Mac: /Users/Shared/Claude/
50
+ inbox/ - сюда вы кладёте файлы для Claude: он их читает, но изменить или удалить не может
51
+ work/ - здесь Claude работает: проекты, рендеры, готовые результаты
42
52
  ```
43
53
 
44
- Файлы в `inbox` переносите сами. С того же диска перенос мгновенный при любом размере.
45
- Имена латиницей намеренно: в этих папках Claude запускает программы, часть из них ломается
46
- на кириллических путях.
54
+ Файлы в `inbox` переносите сами. Имена латиницей намеренно: в этих папках Claude запускает
55
+ программы, часть из них ломается на кириллических путях.
47
56
 
48
57
  ## Что именно делается
49
58
 
50
- **На ПК:**
59
+ **На Windows:**
51
60
 
52
- - пользователь Windows `claude-guest`: без прав администратора, скрыт с экрана входа.
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
- - в `~/.ssh/config` для подключения к серверу добавляется строка `RemoteForward`. Пока VS Code
60
- подключён к серверу, сервер достаёт до SSH на ПК. Закрыли VS Code - связи нет.
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
- ```powershell
71
- irm https://unpkg.com/claude-guest/off.txt | iex
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
- - Только Windows 10 1809+ и 11.
104
+ - Windows 10 1809+ и 11, macOS 11+.
81
105
  - Флешки и диски в exFAT или FAT32 закрыть нельзя: у этих файловых систем нет прав доступа.
106
+ На Mac то же самое с дисками, где стоит галочка «Игнорировать владельцев на этом томе».
82
107
  Скрипт о них предупреждает.
83
- - Новые папки, созданные потом прямо в корне `C:`, будут открыты для гостя. Заводите папки
84
- внутри своих или запустите команду ещё раз: она закроет новые.
85
- - Если на ПК уже работал SSH-сервер, скрипт спросит разрешение перевести его в режим
86
- «только для Claude»: входы на ПК по SSH с других устройств перестанут работать.
87
- - Закрыть диск с сотнями тысяч файлов (игры, Steam) - до получаса: Windows проставляет
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
- ```powershell
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) этим не проверяется.