Глобальная настройка Claude Code на Windows Server
Ниже приведставлена итпоговлная пи ошкончаговтельная инструкция дляпо развертыванастройкию Claude Code на Windows Server 2025. ЭтОна объединяет весь наш опыт решения проблем с правами доступа (EPERM), путями Git Bash и системными переметоднными, гарантируетя, что программа и авторизация будует доступны сразу всем пользователям системы (включая новых).
Руководство по глобальной настройке Claude Code (Multi-User)
ЭПо умолчанию Claude Code устанавливается в личный профиль пользователя и хранит авторизацию там же. Чтобы сделать программу и аккаунт общими для всех пользователей (например, для администратора инс пользоватрукциеля David), мы переноситм исполняемые файлы и конфигурацию в общую системную директорию C:\ProgramData и настраиваем соответствующие права доступа.
Архитектура решения
-
Исполняемые файлы: Переносятся в
C:\ProgramData\npm. -
Сессия и авторизаци
ия: Переносятся вобC:\ProgramData\claude-code. -
Связующее звено: Системные переменные
PATH,CLAUDE_CONFIG_DIRиCLAUDE_CODE_GIT_BASH_PATHна уровне машины (Machine).
Вариант 1: Автоматическая настройка (Рекомендуется)
Этот .bat файл самостоятельно найдет (или установит) Git, создаст нужные папки, выдаст права и пропишет системные пути. Кодировка испкиравлена (C:\ProgramData), снимадля корректного отобраничжения кириллицы.
-
Создайте на рабочем столе файл
setup_claude_global.bat. -
Скопируйте в него код ниже.
-
Нажмите на файл прав
доступай кнопкойпмыши и выберите «Запуск от имени администратора».AppData1.
@echo off
:: Установка скодисровки для корректемыного (от имображения Арусского языка
chcp 866 >nul
setlocal enabledelayedexpansion
title Claude Code Global Setup
echo ========================================================
echo Claude Code: Глобальная настройка (Multi-User)
echo ========================================================
:: 1. Проверка прав администратора
net session >nul 2>&1
if %errorLevel% neq 0 (
echo [ОШИБКА] Запустите этот файл ОТ ИМЕНИ АДМИНИСТРАТОРА.
pause
exit /b
)
:: 2. Поиск или установка Git Bash
set "BASH_PATH=C:\Program Files\Git\bin\bash.exe"
if not exist "!BASH_PATH!" (
set "BASH_PATH=C:\Program Files (x86)\Git\bin\bash.exe"
)
if not exist "!BASH_PATH!" (
where bash.exe >temp_path.txt 2>nul
set /p BASH_PATH=<temp_path.txt
del temp_path.txt
)
if "!BASH_PATH!"=="" (
echo [СТАТУС] Git Bash не найден. Запуск установки через winget...
winget install --id Git.Git -e --source winget --accept-source-agreements --accept-package-agreements
set "BASH_PATH=C:\Program Files\Git\bin\bash.exe"
)
:: 3. Настройка общих папок
set "NPM_GLOBAL=C:\ProgramData\npm"
set "CLAUDE_CONFIG=C:\ProgramData\claude-code"
if not exist "%NPM_GLOBAL%" mkdir "%NPM_GLOBAL%"
if not exist "%CLAUDE_CONFIG%" mkdir "%CLAUDE_CONFIG%"
:: 4. Настройка прав доступа (icacls)
echo [СТАТУС] Настройка прав доступа для группы Users...
icacls "%NPM_GLOBAL%" /grant Users:(OI)(CI)M /T /C /Q >nul
icacls "%CLAUDE_CONFIG%" /grant Users:(OI)(CI)M /T /C /Q >nul
:: 5. Системные переменные (Machine level)
setx CLAUDE_CONFIG_DIR "%CLAUDE_CONFIG%" /M >nul
setx CLAUDE_CODE_GIT_BASH_PATH "!BASH_PATH!" /M >nul
:: 6. Перенос NPM и установка Claude
call npm config set prefix "%NPM_GLOBAL%" --global >nul
echo [СТАТУС] Установка Claude Code (пожалуйста, подождите)...
call npm install -g @anthropic-ai/claude-code >nul
:: 7. Обновление системного PATH
set "NEW_PATH=%NPM_GLOBAL%"
echo %PATH% | findstr /I /C:"%NEW_PATH%" >nul
if %errorlevel% neq 0 (
setx /M PATH "%PATH%;%NEW_PATH%" >nul
)
echo.
echo ========================================================
echo УСТАНОВКА ЗАВЕРШЕНА УСПЕШНО!
echo ========================================================
echo Перезапустите терминал и введите 'claude auth'.
pause
Вариант 2: Ручная настройка (PowerShell)
ОЕсли вы хотите выполнить все шаги вручную, откройте PowerShell от имени Администратора:
Шаг 1: Подготовыполните команду для создания общей структуры папок: и прав
# Создание папок для программ и конфигов
$npmGlobaldirs = @("C:\ProgramData\npm"
$claudeConfig =, "C:\ProgramData\claude-code")
foreach ($dir in @($npmGlobal, $claudeConfig))dirs) {
if (!(Test-Path $dir)) { New-Item -ItemType Directory -Path $dir }
# Даем всем пользователям права на изменение (для работы сессий)
$acl = Get-Acl $dir
$rule = New-Object System.Security.AccessControl.FileSystemAccessRule("Users", "Modify", "ContainerInherit, ObjectInherit", "None", "Allow")
$acl.AddAccessRule($rule)
Set-Acl $dir $acl
}
2.Шаг Перенос2: NPM в общее меНастро
йка Чсистобемны избежать ошибок EPERM, нужнох переустаменовить Claude вне профиля администратора:
# Настройка npm на общую папку
npm config set prefix "C:\ProgramData\npm" --global
# Глобальная установка Claude Code
npm install -g @anthropic-ai/claude-code
3. Настройка системных переменных окружения
Это самый важный этап, который делает авторизацию «сквозной» для всех:
# 1. Путь к общей авторизации
[Environment]::SetEnvironmentVariable("CLAUDE_CONFIG_DIR", "C:\ProgramData\claude-code", "Machine")
# 2. Путь к Git Bash (необходим для работы Claude)
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_GIT_BASH_PATH", "C:\Program Files\Git\bin\bash.exe", "Machine")
# 3. Добавление пути к программе в системный PATH
$currentPatholdPath = [Environment]::GetEnvironmentVariable("Path", "Machine")
if ($currentPatholdPath -notlike "*C:\ProgramData\npm*") {
[Environment]::SetEnvironmentVariable("Path", "$currentPath;oldPath;C:\ProgramData\npm", "Machine")
}
4.Шаг Ед3: Установка программы
npm config set prefix "C:\ProgramData\npm" --global
npm install -g @anthropic-ai/claude-code
Финоальный шаг: Перазовичная авторизация
ТНезависимо от выбранного метода установки, после его завершения:
-
Откройте новое окно терминала.
-
Введите
claude auth. -
Пройдите процесс авторизации в браузере. Файл сессии сохранится в общую папку.
Инструкция для пользователей (например, David)
Для любого пользователя сервера процесс теперь вымаксимально прост:
-
Пол
ньзователь заходитевхсвою учетную запись. -
Открывает терминал (PowerShell, CMD или терминал в IDE).
-
Вводит
claude. -
Программа запускается сразу под вашим аккаунтом.
Руководство по решению проблем (Troubleshooting)
| Симптом | Причина | Решение |
Ошибка: Command 'claude' not found у нового пользователя. |
Windows еще не обновила системный PATH для текущей сессии пользователя. |
Пользователю нужно выйти из системы (Log off) и зайти снова, либо перезагрузить сервер. |
Ошибка: EPERM: operation not permitted при запуске claude. |
Программа все еще пытается получить доступ к папке AppData администратора. |
Убедитесь, что шаг с npm config set prefix "C:\ProgramData\npm" --global был выполнен, и переустановите Claude. |
Ошибка: Unable to find CLAUDE_CODE_GIT_BASH_PATH. |
Неверный путь к bash.exe или Git не установлен. |
Проверьте фактическое расположение файла bash.exe и обновите системную переменную CLAUDE_CODE_GIT_BASH_PATH. |
Требует claude auth у второго пользователя. |
Переменная CLAUDE_CONFIG_DIR установлена как "User", а не "Machine". |
Запустите PowerShell от администратора и выполните команду из Шага 2 ручной настройки. |
Безопасное обновление Claude Code
Поскольку программа теперь находится в общей системной папке, обновлять ее должен только Администратор.
В терминале от имени Администратора введите:
claudenpm authinstall -g @anthropic-ai/claude-code@latest
ПВаши ключи авторизации не послетрадают, успеша ного входа в браузерые файлы савтоматичессики унасохраниледуются в C:\ProgramData\claude-code. Благодаря правам доступа, установленным на Шаге 1, этот файл станет доступенля всем.
5. Проверка длях пользователей
Любой другой пользователь (например, David) теперь может:
Открыть терминал (PowerShell/CMD).Ввестиclaude.Программа запуститсясразу с вашей авторизацией, не запрашивая логин.
Важно:Если после настройки пользователь всё еще видит ошибку "команда не найдена", ему нужно один раз перезайти в систему (Log out / Log in) или перезагрузить сервер, чтобы обновился системныйPATH.
Резюме путей
| |
| |
|