Skip to content

windows install tips_ko

Jump to bottom
garlicvread edited this page Jun 6, 2026 · 2 revisions

Windows 설치 팁: PowerShell 7, 관리자 터미널, 인코딩

언어: 🇺🇸 English | 🇰🇷 한국어

이 페이지는 Windows에서 Ghost-ALICE OS를 설치할 때 자주 부딪히는 마찰 지점을 모은다. 빠른 copy-and-run 설치 경로는 Team onboarding을 사용한다. Windows 환경을 더 편하게 만들 때 이 페이지를 본다.

Contents

0. Scope

이 페이지는 아래 항목만 다룬다.

  • PowerShell 7을 기본 shell로 사용하는 방법
  • Windows Terminal 기본 profile을 PowerShell 7로 설정하는 방법
  • 필요할 때 관리자 terminal을 안전하게 여는 방법
  • Windows PowerShell 5.1 또는 cmd에서 현지화된 출력이 깨질 때 우회하는 방법

전체 설치 명령은 이미 Team onboarding에 있다.

1. Recommended Environment

권장 Windows 설정은 다음과 같다.

Item Recommended Reason
Shell PowerShell 7 (pwsh) Windows PowerShell 5.1보다 encoding 동작과 최신 명령 호환성이 좋다
Terminal app Windows Terminal PowerShell 7 profile, 관리자 실행, 폴더 시작 처리가 쉽다
Install entrypoint .\install.ps1 이 project의 기본 Windows 설치 경로다

installer는 Python 3.11 이상을 사용한다. Python 3.11+가 감지되지 않으면 winget, choco, scoop 순서로 Python 준비를 시도한다. 그래도 Python이 없으면 installer는 멈춘다. 대부분의 사용자는 Python을 먼저 설치할 필요가 없지만, package manager가 막힌 회사 PC에서는 관리자 또는 maintainer와 설치 권한을 확인한다.

2. Install PowerShell 7 First

기본 Windows shell은 Windows PowerShell 5.1인 경우가 많다. 이 project는 5.1도 지원하지만 실제 사용에서는 PowerShell 7이 보통 더 부드럽다.

공식 Microsoft 문서를 먼저 따른다.

아래 명령으로 설치를 확인한다.

pwsh -v
where pwsh

pwsh가 발견되면 shell 준비가 끝난 것이다.

3. Set PowerShell 7 As The Windows Terminal Default Profile

PowerShell 7을 설치해도 Windows Terminal 기본 profile은 자동으로 바뀌지 않는다. 기본 profile을 먼저 바꾼다.

Change It In The UI

  1. Windows Terminal을 연다.
  2. Ctrl + ,를 눌러 Settings를 연다.
  3. startup settings로 이동한다.
  4. 기본 profile을 PowerShell 7 또는 PowerShell로 설정한다.
  5. 저장한다.

Change It In settings.json

파일은 보통 아래 위치에 있다.

C:\Users\<username>\AppData\Local\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json

공식 Windows Terminal profile 문서는 다음에 있다.

defaultProfile 값은 환경마다 다르다. 특정 GUID를 그대로 복사하지 않는다. profiles.list에서 PowerShell 7 profile guid를 찾은 뒤 그 값을 defaultProfile에 넣는다.

4. Run Installation Through install.ps1

권장 flow는 PowerShell 7 또는 Windows Terminal에서 아래 명령을 실행하는 것이다.

cd ~\Desktop
git clone https://github.com/AidALL/ghost-alice.git
cd .\ghost-alice
.\install.ps1

platform을 대화형으로 선택하려면 다음을 사용한다.

.\install.ps1 -PromptPlatform

Codex만 설치하려면 다음을 사용한다.

.\install.ps1 -Platform codex

설치를 확인하려면 다음을 사용한다.

.\install.ps1 -Status

Command Prompt에서 시작하더라도 install.cmd는 결국 pwsh.exe 또는 powershell.exe를 호출한다. 가능하면 PowerShell 7에서 직접 시작하는 편이 더 단순하다. 회사 PC에서 ExecutionPolicy가 script를 막으면 먼저 Team onboarding의 install.cmd 경로를 사용한다.

5. Add A Right-Click Administrator Terminal Entry

  • Windows Terminal을 자주 쓰면 폴더에서 right-click terminal 항목을 여는 것이 편하다.
  • 기본 right-click 메뉴는 관리자 실행이 쉽지 않을 수 있으므로 필요할 때 별도 메뉴 항목을 추가할 수 있다.
  • 기본 right-click terminal 항목이 항상 관리자로 실행되게 만들지 않는다. 일반 terminal과 관리자 terminal을 분리하는 편이 더 안전하다.

Simplest Existing Method

  • Start menu에서 Windows Terminal을 검색한다.
  • right-click한다.
  • Run as administrator를 선택한다.

그 방법은 기본 위치에서 시작한다. 특정 폴더에서 관리자 terminal을 바로 열고 싶다면 아래 script로 별도 context-menu 항목을 추가한다.

$base1 = "HKCU:\Software\Classes\Directory\Background\shell\OpenAdminTerminalHere"
$base2 = "HKCU:\Software\Classes\Directory\shell\OpenAdminTerminalHere"

New-Item -Path $base1 -Force | Out-Null
Set-ItemProperty -Path $base1 -Name "(default)" -Value "Open administrator terminal here"
Set-ItemProperty -Path $base1 -Name "Icon" -Value "wt.exe"
New-Item -Path "$base1\command" -Force | Out-Null
Set-ItemProperty -Path "$base1\command" -Name "(default)" -Value 'powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "Start-Process wt.exe -Verb RunAs -ArgumentList ''-d'',''\"%V\"''"'

New-Item -Path $base2 -Force | Out-Null
Set-ItemProperty -Path $base2 -Name "(default)" -Value "Open administrator terminal here"
Set-ItemProperty -Path $base2 -Name "Icon" -Value "wt.exe"
New-Item -Path "$base2\command" -Force | Out-Null
Set-ItemProperty -Path "$base2\command" -Name "(default)" -Value 'powershell.exe -NoProfile -ExecutionPolicy Bypass -Command "Start-Process wt.exe -Verb RunAs -ArgumentList ''-d'',''\"%1\"''"'

이 메뉴는 현재 사용자의 HKCU 아래에만 추가된다. 현재 Windows profile의 right-click 메뉴에만 나타난다. 기본 profile이 PowerShell 7이면 이 항목으로 열린 Windows Terminal도 PowerShell 7로 시작한다.

Undo

Remove-Item "HKCU:\Software\Classes\Directory\Background\shell\OpenAdminTerminalHere" -Recurse -Force
Remove-Item "HKCU:\Software\Classes\Directory\shell\OpenAdminTerminalHere" -Recurse -Force

6. Move To PowerShell 7 First If Localized Output Is Garbled In Windows PowerShell 5.1

일부 project script와 설정은 현지화된 문자열을 출력할 수 있다. Windows PowerShell 5.1은 BOM 없는 UTF-8 파일이나 console 출력을 잘못 표시할 수 있다.

증상은 보통 다음과 같다.

  • 현지화된 메시지가 깨져 보인다.
  • script 문자열이 잘못 출력된다.
  • install.ps1 실행 중 메시지가 비정상적으로 보인다.

첫 대응은 파일을 다시 저장하는 것이 아니라 PowerShell 7에서 다시 실행하는 것이다.

pwsh
cd ~\Desktop\ghost-alice
.\install.ps1

정말 editor에서 파일을 다시 저장해야 한다면 먼저 UTF-8 계열 encoding인지 확인한다. local encoding 편집은 공유 project 변경이 될 수 있으므로 원인을 확인하기 전에 commit하지 않는다.

7. FAQ

Can Installation Work With Only Windows PowerShell 5.1?

가능하다. .\install.ps1은 Windows PowerShell 5.1에서 실행된다. Python 3.11+는 여전히 필요하고 installer가 가능한 경우 자동 준비를 시도한다. 실제 사용에서는 PowerShell 7이 더 안정적이다.

Do I Need To Install Python First?

보통 필요 없다. installer가 Python 3.11+를 찾지 못하면 가능한 경우 자동으로 준비한다. 자동 준비에 실패하면 installer는 수동으로 실행할 설치 명령을 보여준다.

Should I Use install.cmd Or install.ps1?

가능하면 install.ps1을 사용한다. install.cmd는 내부에서 pwsh.exe 또는 powershell.exe를 호출하는 wrapper다. 회사 PC에서 ExecutionPolicy가 script를 막으면 install.cmd가 더 쉬운 entrypoint일 수 있다.

Must I Always Run As Administrator?

아니다. 대부분의 설치와 업데이트에는 일반 권한으로 충분하다. 시스템 전역 변경이나 UAC가 필요한 경우에만 별도 관리자 terminal을 연다.

AidALL/ghost-alice | This wiki stores design documents only. Runtime files live in the main repository.

Home / 홈

🇺🇸 English

🇰🇷 한국어

Main repo

Clone this wiki locally