Глобальная настройка Claude Code на Windows Server

Ниже приведена полная и окончательная инструкция по развертыванию Claude Code на Windows Server 2025. Она объединяет весь наш опыт решения проблем с правами доступа (EPERM), путями Git Bash и системными переменными, гарантируя, что авторизация будет доступна всем пользователям системы.

Руководство по глобальной настройке Claude Code (Multi-User)

По умолчанию Claude Code устанавливается в личный профиль пользователя и хранит авторизацию там же. Чтобы сделать программу и аккаунт общими для всех пользователей (например, для администратора и пользователя David), мы переносим исполняемые файлы и конфигурацию в общую системную директорию C:\ProgramData и настраиваем соответствующие права доступа.

Архитектура решения

Вариант 1: Автоматическая настройка (Рекомендуется)

Этот .bat файл самостоятельно найдет (или установит) Git, создаст нужные папки, выдаст права и пропишет системные пути. Кодировка исправлена для корректного отображения кириллицы.

@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: Подготовка папок и прав

$dirs = @("C:\ProgramData\npm", "C:\ProgramData\claude-code")
foreach ($dir in $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: Настройка системных переменных

[Environment]::SetEnvironmentVariable("CLAUDE_CONFIG_DIR", "C:\ProgramData\claude-code", "Machine")
[Environment]::SetEnvironmentVariable("CLAUDE_CODE_GIT_BASH_PATH", "C:\Program Files\Git\bin\bash.exe", "Machine")

$oldPath = [Environment]::GetEnvironmentVariable("Path", "Machine")
if ($oldPath -notlike "*C:\ProgramData\npm*") {
    [Environment]::SetEnvironmentVariable("Path", "$oldPath;C:\ProgramData\npm", "Machine")
}

Шаг 3: Установка программы

npm config set prefix "C:\ProgramData\npm" --global
npm install -g @anthropic-ai/claude-code

Финальный шаг: Первичная авторизация

Независимо от выбранного метода установки, после его завершения:

Инструкция для пользователей (например, David)

Для любого пользователя сервера процесс теперь максимально прост:

Руководство по решению проблем (Troubleshooting)

Безопасное обновление Claude Code

Поскольку программа теперь находится в общей системной папке, обновлять ее должен только Администратор.

В терминале от имени Администратора введите:

npm install -g @anthropic-ai/claude-code@latest

Ваши ключи авторизации не пострадают, а новые файлы автоматически унаследуют права доступа для всех пользователей.