Глобальная настройка 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, создаст нужные папки, выдаст права и пропишет системные пути. Кодировка исправлена для корректного отображения кириллицы.
Создайте на рабочем столе файл setup_claude_global.bat.
Скопируйте в него код ниже.
Нажмите на файл правой кнопкой мыши и выберите «Запуск от имени администратора».
@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 AppData[СТАТУС] администратора.Настройка 1.прав Подготовкадоступа системыдля группы 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 от администратора и выполните Безопасное обновление 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.
Резюме путей
C:\ProgramData\npmC:\ProgramData\claude-codeCLAUDE_CONFIG_DIR пользователей.