Windows Server Bootstrap Kit

Памятка для меня, как использовать этот набор файлов при настройке нового Windows-сервера/ноутбука под разработку с Claude Code.

Что в папке

Файл	Что это	Когда использовать
01-setup-server.md	Рецепт для Claude — первоначальная настройка сервера	Один раз на каждый новый сервер
02-add-project.md	Рецепт для Claude — добавление проекта на готовый сервер	Каждый раз на новый сайт
np.sh	Bash-скрипт, который Claude поставит мне в ~/bin/np	Сам не запускаю, используется внутри 02-add-project.md
README.md	Этот файл	Когда забыл порядок

---

Workflow 1: Новый сервер с нуля

Время: 30–60 минут. Большая часть — скачивание Scoop/mise/vcredist.

Что делаю я сам (10 минут)

1. Подключаюсь по RDP под Administrator
2. Ставлю Git for Windows с https://git-scm.com/download/win
   • ⚠️ Критичная галка: Checkout as-is, commit Unix-style line endings (вторая опция в Line endings) — иначе .sh хуки упадут
   • Все остальные настройки — см. 01-setup-server.md §0.1
3. Ставлю GitHub CLI с https://cli.github.com/ → .msi → Next/Install/Finish
4. Перезапускаю Claude Code (через трей → Quit, проверить Task Manager что нет Claude.exe, открыть заново)

Что делает Claude (всё остальное)

5. Открываю Claude Code, кидаю в чат два файла:
   • 01-setup-server.md
   • np.sh
6. Claude всё ставит сам. На одном шаге попросит у меня:
   • GitHub-логин и email для git config
   • В какой-то момент: "открой Git Bash, выполни gh auth login, вот ответы..." — делаю в Git Bash, в браузере подтверждаю
7. После сообщения "сервер готов" — перезапускаю Git Bash один раз

Готово. Дальше — добавление проектов.

---

Workflow 2: Добавить проект на готовый сервер

Время: 2–10 минут (зависит от размера зависимостей).

1. Открываю Claude Code в любой папке (можно прямо C:\)
2. Кидаю в чат 02-add-project.md
3. Claude сразу спрашивает:
   • Сценарий: A (новый сайт из шаблона) / B (клон своего репо) / C (чужой репо как collaborator)
   • Имя сайта в kebab-case (clinic-landing, migrator)
4. Claude делает всё через np (создание/клон репо, mise install, pnpm install, pnpm approve-builds)
5. В конце выдаёт Windows-путь к папке + готовый промпт для новой сессии Claude Code
6. Открываю Claude Code → Select folder → копирую промпт → поехали

---

Кто что делает (шпаргалка)

Действие	Кто
Установка Git for Windows	Я
Установка GitHub CLI (.msi)	Я
Установка Scoop, mise, vcredist2022	Claude
Настройка ~/.bashrc, git identity, SSH-ключ	Claude
CLAUDE_CODE_GIT_BASH_PATH	Claude
gh auth login (браузер + код)	Я (Claude диктует ответы)
Установка np в ~/bin	Claude
Создание/клон репо проекта, установка зависимостей	Claude (через np)
Открытие проекта в Claude Code, первое сообщение	Я

---

Грабли, на которые наступал

• Claude упёрся в "Permission denied" при скачивании Scoop installer — это auto-mode классификатор. Решение: выйти из auto-mode (/auto → off) или подтвердить разрешение в окне permissions, потом сказать Claude "попробуй еще раз"
• mise --version молчит после установки — это известная проблема под Administrator, Claude знает фикс в 01-setup-server.md §6.1
• np не находится по команде — файл скопирован с расширением (np.sh вместо np). Должен лежать как ~/bin/np без расширения
• Git Bash ломается после eval "$(mise activate bash)" — никогда не делать на Windows. В .bashrc использовать только shims-режим из §2.1

---

Где хранить этот kit для будущих серверов

Лучший вариант — приватный GitHub-репо, например tem11134v2-cmd/windows-bootstrap-kit:

• На любом новом сервере после §3 setup'а: gh repo clone tem11134v2-cmd/windows-bootstrap-kit — и все 4 файла под рукой
• История изменений: если поправлю инструкции после нового опыта, не потеряется
• Не зависит от облаков, USB-флешек и доступа к старому компу

Альтернативы: Google Drive / iCloud / OneDrive — синхронизируется на любой сервер, проще для разовой передачи.

---

🏁 Если кит работает — на новый сервер уходит ~1 час, из которых ~10 минут моего активного времени.