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) и настраиваем соответствующие права доступа.

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

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

      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
      

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

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

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

        Введите 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

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

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

          PowerShell
          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\npm Данные авторизации C:\ProgramData\claude-code Переменная конфига CLAUDE_CONFIG_DIR

             пользователей.