AIRGAP StudioAIRGAP Studio

터미널 문제 해결

PowerShell 및 터미널 관련 문제 해결 가이드

PowerShell 실행 정책 오류

증상

터미널에서 스크립트 실행 시 다음과 같은 오류가 발생합니다.

스크립트를 실행할 수 없습니다. ... 이 시스템에서 스크립트를 실행할 수 없으므로 ...

원인

Windows의 기본 PowerShell 실행 정책이 Restricted로 설정되어 있습니다.

해결 방법

# 현재 실행 정책 확인
Get-ExecutionPolicy

# 현재 사용자에 대해 정책 변경
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

조직 정책으로 변경이 불가능한 경우 보안 담당자에게 문의하세요.

셸 통합 문제

증상

터미널 프롬프트 옆에 경고 아이콘이 표시되거나, AIRGAP Assistant가 명령어 실행 결과를 올바르게 감지하지 못합니다.

해결 방법

  1. Ctrl+,로 설정을 엽니다.
  2. terminal.integrated.shellIntegration.enabled를 검색합니다.
  3. 값을 true로 설정합니다.
{
  "terminal.integrated.shellIntegration.enabled": true
}

셸 통합이 정상적으로 활성화되면 프롬프트 왼쪽에 체크 표시가 나타납니다.

PATH 관련 문제

증상

ollama, node, python 등의 명령어를 찾을 수 없다는 오류가 발생합니다.

'ollama'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 배치 파일이 아닙니다.

해결 방법

  1. 프로그램이 실제로 설치되어 있는지 확인합니다.
  2. 시스템 환경 변수 PATH에 프로그램 경로가 포함되어 있는지 확인합니다.
# PATH 확인
$env:PATH -split ';'

# Ollama 경로 확인
Get-Command ollama -ErrorAction SilentlyContinue
  1. PATH를 수정한 경우 AIRGAP Studio를 재시작해야 적용됩니다.

한글 인코딩 문제

증상

터미널에서 한글이 깨져서 표시되거나, 한글 파일명을 인식하지 못합니다.

해결 방법

PowerShell 인코딩 설정

# 출력 인코딩을 UTF-8로 변경
[Console]::OutputEncoding = [System.Text.Encoding]::UTF8
$OutputEncoding = [System.Text.Encoding]::UTF8

이 설정을 매번 입력하지 않으려면 PowerShell 프로필에 추가합니다.

# 프로필 파일 열기 (없으면 생성)
if (!(Test-Path -Path $PROFILE)) {
  New-Item -ItemType File -Path $PROFILE -Force
}
notepad $PROFILE

프로필 파일에 인코딩 설정 두 줄을 추가하고 저장합니다.

터미널 인코딩 설정

AIRGAP Studio 설정에서도 인코딩을 지정할 수 있습니다.

{
  "terminal.integrated.defaultProfile.windows": "PowerShell",
  "terminal.integrated.env.windows": {
    "PYTHONIOENCODING": "utf-8"
  }
}

터미널이 열리지 않는 경우

해결 방법

  1. Ctrl+Shift+P > Terminal: Create New Terminal을 실행합니다.
  2. 기본 셸 설정을 확인합니다.
  3. 셸 실행 파일 경로가 올바른지 확인합니다.
{
  "terminal.integrated.profiles.windows": {
    "PowerShell": {
      "source": "PowerShell",
      "icon": "terminal-powershell"
    }
  }
}
  1. 문제가 지속되면 AIRGAP Studio를 관리자 권한으로 실행해 보세요.

관련 문서