Skip to main content

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

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


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

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

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

  1. Исполняемые файлы: Переносятся в C:\ProgramData\npm.

  2. Сессия и авторизациия: Переносятся в обC:\ProgramData\claude-code.

  3. Связующее звено: Системные переменные PATH, CLAUDE_CONFIG_DIR и CLAUDE_CODE_GIT_BASH_PATH на уровне машины (Machine).


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

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

  1. Создайте на рабочем столе файл setup_claude_global.bat.

  2. Скопируйте в него код ниже.

  3. Нажмите на файл прав доступай кнопкой пмыши и выберите «Запуск от име AppDataни администратора».

    1.

  4. П
Фрагмент кодгоа
@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: Подготовыполните команду для создания общей структуры папок:

 и прав

PowerShell
# Создание папок для программ и конфигов
$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 вне профиля администратора:

ых
PowerShell
# Настройка npm на общую папку
npm config set prefix "C:\ProgramData\npm" --global

# Глобальная установка Claude Code
npm install -g @anthropic-ai/claude-code

3. Настройка системных переменных окружения

Это самый важный этап, который делает авторизацию «сквозной» для всех:

PowerShell
# 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: Установка программы

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

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

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

  1. Откройте новое окно терминала.

  2. Введите claude auth.

  3. Пройдите процесс авторизации в браузере. Файл сессии сохранится в общую папку.


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

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

  1. Полньзователь заходите вх свою учетную запись.

  2. Открывает терминал (PowerShell, CMD или терминал в IDE).

  3. Вводит claude.

  4. Программа запускается сразу под вашим аккаунтом.


Руководство по решению проблем (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

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

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

PowerShell
claudenpm authinstall -g @anthropic-ai/claude-code@latest

ПВаши ключи авторизации не послетрадают, успеша ного входа в браузерые файлы савтоматичессики унасохраниледуются в C:\ProgramData\claude-code. Благодаря правам доступа, установленным на Шаге 1, этот файл станет доступенля всем.


5. Проверка длях пользователей

Любой другой пользователь (например, David) теперь может:

  1. Открыть терминал (PowerShell/CMD).

  2. Ввести claude.

  3. Программа запустится сразу с вашей авторизацией, не запрашивая логин.

Важно: Если после настройки пользователь всё еще видит ошибку "команда не найдена", ему нужно один раз перезайти в систему (Log out / Log in) или перезагрузить сервер, чтобы обновился системный PATH.


Резюме путей

КомпонентПуть в системе
Исполняемые файлыC:\ProgramData\npm
Данные авторизацииC:\ProgramData\claude-code
Переменная конфигаCLAUDE_CONFIG_DIR