WINDOWS TERMINAL · POWER SHELL · NERD FONTS
Windows Terminal Nerd Font 설치 및 설정 가이드: 터미널 아이콘 깨짐 해결하기
Antigravity CLI, Oh My Posh, Starship을 사용하다가 화살표나 아이콘이 네모(□)로 표시된다면 글꼴 설정을 확인해 보세요. Windows 11에서 PowerShell로 Nerd Font를 다운로드하고 설치한 뒤 Windows Terminal에 적용하는 방법을 단계별로 설명합니다.
작성 기준일: 2026년 10월 24일
핵심 요약
- 터미널 아이콘이 깨진다면 Nerd Font 지원 여부와 현재 글꼴 설정부터 확인합니다.
- 공식 배포본인 CaskaydiaCove Nerd Font를 설치 예제로 사용합니다.
- 글꼴 파일을 복사하는 것만으로 설치가 완료되는 것은 아닙니다. Windows 글꼴 설치 절차를 진행해야 합니다.
- Windows Terminal에서 실제로 사용하는 프로필의 글꼴을 변경합니다.
- 설정 후에도 문제가 남으면 CLI 프로그램 자체의 출력 설정과 글리프 지원 여부를 확인합니다.
1. Nerd Font란 무엇인가요?
Nerd Font는 개발자가 사용하는 프로그래밍 글꼴에 다양한 아이콘과 특수 기호를 추가한 글꼴 모음입니다. 파일 탐색기 아이콘, Git 상태 표시, Powerline 화살표, 개발 도구의 상태 기호 등을 터미널에서 표시할 때 활용할 수 있습니다.
예를 들어 Antigravity CLI나 Oh My Posh 같은 도구가 특정 아이콘을 출력하는데 현재 글꼴에 해당 문자가 없다면 네모 상자나 대체 기호로 보일 수 있습니다.
문제가 발생하는 일반적인 상황
CLI 프로그램이 특수 문자를 출력함 → 터미널 글꼴이 해당 문자를 지원하지 않음 → 아이콘이 깨져 보이거나 다른 문자로 대체됨
다만 모든 깨진 아이콘의 원인이 글꼴인 것은 아닙니다. 문자 인코딩, 터미널 렌더링, 프로그램의 출력 설정도 함께 확인해야 합니다.
2. 어떤 Nerd Font를 설치할까요?
이번 가이드에서는 Cascadia Code를 기반으로 특수 기호를 추가한 CaskaydiaCove Nerd Font를 사용합니다.
| 글꼴 | 특징 | 추천 용도 |
|---|---|---|
| CaskaydiaCove Nerd Font | Cascadia Code 기반 Nerd Font | Windows Terminal, CLI 아이콘 |
| CaskaydiaMono Nerd Font | Cascadia Mono 기반 Nerd Font | 고정폭 글꼴을 선호하는 환경 |
글꼴 이름과 배포 파일은 공식 배포 페이지에서 확인하세요.
주의: 아래 스크립트는 공식 GitHub의 최신 릴리스 파일을 사용합니다. 최신 릴리스의 버전과 파일 구성이 바뀔 수 있으므로 설치 전에 다운로드 주소와 파일명을 확인하세요.
3. PowerShell에서 Nerd Font 다운로드 및 압축 해제
Step 1. PowerShell 실행
Windows Terminal에서 PowerShell을 열거나 시작 메뉴에서 PowerShell을 실행합니다. 사용자 글꼴로 설치하는 방식은 일반적으로 관리자 권한 없이 진행할 수 있습니다.
Step 2. 다운로드 및 압축 해제
다음 스크립트는 공식 GitHub 릴리스에서 ZIP 파일을 다운로드한 뒤 임시 폴더에 압축을 풉니다. 글꼴을 설치하는 단계는 다음 절에서 별도로 진행합니다.
$ErrorActionPreference = "Stop"
$zipUrl = "https://github.com/ryanoasis/nerd-fonts/releases/latest/download/CascadiaCode.zip"
$workDir = Join-Path $env:TEMP "CascadiaCodeNerdFont"
$zipPath = Join-Path $env:TEMP "CascadiaCode.zip"
$extractPath = Join-Path $workDir "Extracted"
New-Item -ItemType Directory -Path $extractPath -Force |
Out-Null
try {
Write-Host "Nerd Font 다운로드 중..." -ForegroundColor Cyan
Invoke-WebRequest -Uri $zipUrl -OutFile $zipPath
Write-Host "압축 해제 중..." -ForegroundColor Cyan
Expand-Archive -Path $zipPath -DestinationPath $extractPath -Force
$fontFiles = Get-ChildItem -Path $extractPath -Recurse -File |
Where-Object {
$_.Extension -in @(".ttf", ".otf") -and
$_.Name -match "CaskaydiaCove"
}
if (-not $fontFiles) {
throw "CaskaydiaCove 글꼴 파일을 찾지 못했습니다. 공식 릴리스의 파일 구성을 확인하세요."
}
Write-Host "찾은 글꼴 파일:" -ForegroundColor Green
$fontFiles | Select-Object FullName
Write-Host "압축 해제 완료. 다음 단계에서 글꼴을 설치하세요." -ForegroundColor Green
}
catch {
Write-Error "작업 실패: $($_.Exception.Message)"
}
finally {
# 설치 여부를 확인하기 전에는 임시 파일을 삭제하지 않습니다.
Write-Host "임시 파일 위치: $workDir"
}
예상 결과: 압축 해제된 폴더에서 CaskaydiaCove 관련 글꼴 파일 목록이 출력됩니다. 이 단계에서는 글꼴을 Windows에 설치한 것이 아닙니다.
TIP
다운로드가 실패하면 네트워크 연결, GitHub 접속 여부, 프록시 및 보안 프로그램 정책을 확인하세요. 회사 PC에서는 외부 파일 다운로드가 제한될 수 있습니다.
4. Windows 글꼴 폴더에서 정식 설치하기
앞 단계에서 ZIP 파일을 풀었다면 이제 글꼴을 Windows에 설치해야 합니다. 글꼴 파일을 폴더에 복사하는 것만으로는 Windows의 글꼴 등록이 완료되지 않을 수 있습니다.
Step 1. 압축 해제 폴더 열기
PowerShell에서 다음 명령을 실행합니다.
explorer "$env:TEMP\CascadiaCodeNerdFont\Extracted"
압축 해제된 폴더와 하위 폴더에서 CaskaydiaCove 관련 .ttf 파일을 찾습니다. 글꼴 파일 이름은 릴리스 버전에 따라 달라질 수 있습니다.
Step 2. 글꼴 설치
- 설치할 글꼴 파일을 선택합니다.
- 마우스 오른쪽 버튼을 누릅니다.
- Windows 메뉴에 표시되는 설치 또는 모든 사용자용으로 설치 항목을 선택합니다. 표시되는 항목은 Windows 버전과 권한에 따라 달라질 수 있습니다.
- 여러 글꼴 스타일을 사용할 계획이라면 필요한 Regular, Bold 등 해당 패밀리의 글꼴 파일도 설치합니다.
Windows 글꼴 폴더를 직접 확인하려면 Win + R을 누르고 아래 경로를 입력합니다.
%LOCALAPPDATA%\Microsoft\Windows\Fonts
이 경로는 현재 사용자에게 설치된 글꼴을 확인할 때 사용할 수 있습니다. 글꼴 설치는 이 폴더에 파일을 복사하는 작업과 동일하지 않으므로, 설치 메뉴를 통해 등록하는 방법을 우선 권장합니다.
Step 3. Windows Terminal 재실행
글꼴 설치를 마쳤다면 Windows Terminal을 완전히 종료한 뒤 다시 실행합니다. 글꼴 목록에 표시되는지 확인하세요.
5. Windows Terminal에 글꼴 적용하기
Step 1. 설정 열기
- Windows Terminal을 실행합니다.
- 상단 탭 옆의 드롭다운 메뉴에서 설정을 선택합니다.
- 또는
Ctrl + ,단축키를 사용합니다.
Step 2. 사용할 프로필 선택
왼쪽 메뉴에서 PowerShell 등 실제로 사용하는 프로필을 선택합니다. 프로필별 모양 설정은 서로 다를 수 있으므로, Antigravity CLI를 실행하는 셸의 프로필을 변경해야 합니다.
Step 3. 모양에서 글꼴 지정
- 선택한 프로필의 모양(Appearance) 설정으로 이동합니다.
- 글꼴(Font face) 항목을 찾습니다.
- 설치한 CaskaydiaCove Nerd Font 패밀리를 선택합니다.
- 저장 버튼을 눌러 설정을 적용합니다.
글꼴 이름이 목록에 보이지 않는다면 Windows 글꼴 설치가 완료됐는지, 터미널을 재실행했는지 확인하세요. 글꼴 목록에 표시되는 정확한 이름은 설치한 글꼴 파일의 패밀리 이름에 따라 달라질 수 있습니다.
선택 사항: settings.json으로 설정하기
Windows Terminal 설정 파일을 직접 수정하는 방법도 있습니다. 다만 이미 존재하는 JSON 설정을 유지하면서 해당 프로필에 글꼴 설정만 추가해야 합니다.
{
"profiles": {
"defaults": {
"font": {
"face": "CaskaydiaCove Nerd Font"
}
}
}
}
위 설정은 프로필 기본값에 글꼴을 적용하는 예시입니다. 이미 profiles 또는 defaults 항목이 있다면 중복으로 만들지 말고 기존 JSON 구조에 병합하세요. 실제 글꼴 이름이 목록과 다르면 설치된 글꼴의 정확한 이름을 사용해야 합니다.
공식 문서: Microsoft Learn - Windows Terminal 프로필 모양 설정
6. 설치 결과 확인하기
설정이 완료되면 PowerShell에서 Antigravity CLI, Oh My Posh, Starship 등 사용 중인 도구를 다시 실행합니다.
확인할 항목
- 아이콘이 네모 상자 대신 정상적으로 표시되는가?
- Powerline 화살표와 구분 기호가 깨지지 않는가?
- Git 상태나 파일 아이콘이 정상적으로 표시되는가?
- 굵은 글꼴이나 다른 스타일에서도 문자가 올바르게 표시되는가?
이 항목들은 설치 후 직접 확인해야 하는 테스트 목록입니다. 실제 실행 결과를 확인하지 않은 상태에서 모든 아이콘이 정상적으로 표시된다고 단정할 수는 없습니다.
7. 문제가 해결되지 않을 때
| 증상 | 확인할 사항 | 조치 |
|---|---|---|
| 글꼴 목록에 없음 | 글꼴 설치 및 등록 여부 | 글꼴 설치를 다시 확인하고 터미널 재실행 |
| 일부 아이콘만 깨짐 | 사용 중인 글리프와 글꼴 지원 범위 | 다른 Nerd Font로 비교 테스트 |
| PowerShell에서는 정상, 다른 셸에서는 깨짐 | 프로필별 글꼴 설정 | 실제로 사용하는 프로필의 글꼴 변경 |
| 글꼴 변경 후에도 아이콘이 깨짐 | CLI의 출력 설정, 문자 인코딩, 렌더링 | 프로그램 설정과 터미널 환경 추가 확인 |
8. 자주 묻는 질문(FAQ)
Q1. Nerd Font를 설치하면 모든 터미널 아이콘이 정상적으로 표시되나요?
반드시 그렇지는 않습니다. 글꼴이 필요한 문자를 지원해야 하며, 터미널과 CLI 도구가 해당 문자를 올바르게 출력해야 합니다. 일부 아이콘만 깨진다면 다른 원인도 확인해야 합니다.
Q2. Windows Terminal만 다시 실행하면 되나요?
일반적으로 글꼴 설치 후 Windows Terminal을 완전히 종료하고 다시 실행하는 것부터 시도하면 됩니다. 그래도 목록에 나타나지 않으면 Windows의 글꼴 설치 상태를 확인하세요.
Q3. 관리자 권한으로 설치해야 하나요?
현재 사용자에게 설치하는 방식은 보통 관리자 권한이 필요하지 않습니다. 모든 사용자에게 설치하는 방식은 권한이 필요할 수 있으며, 회사 PC에서는 조직의 정책을 따라야 합니다.
Q4. 기본 글꼴인 Cascadia Mono를 계속 사용해도 되나요?
일반적인 터미널 사용에는 문제가 없을 수 있지만, Nerd Font 전용 아이콘이 필요한 CLI 환경에서는 해당 글리프를 포함한 글꼴을 선택하는 것이 좋습니다.
9. 최종 체크리스트
- □ 공식 Nerd Fonts 릴리스에서 글꼴 파일을 다운로드했다.
- □ 압축을 해제하고 필요한 글꼴 파일을 확인했다.
- □ Windows에 글꼴을 정식으로 설치했다.
- □ Windows Terminal을 완전히 종료한 후 다시 실행했다.
- □ 실제로 사용하는 셸 프로필의 글꼴을 변경했다.
- □ Antigravity CLI 등에서 아이콘 출력 상태를 직접 확인했다.
마무리
Windows Terminal에서 아이콘이 네모 상자로 표시되는 문제는 Nerd Font 설치와 프로필 글꼴 설정을 확인하는 것부터 시작하면 됩니다. CaskaydiaCove Nerd Font를 설치한 뒤 실제로 사용하는 PowerShell 프로필에 적용하고, CLI 도구를 다시 실행해 결과를 확인하세요.
핵심은 다운로드 → 압축 해제 → Windows 글꼴 설치 → Windows Terminal 프로필 적용 → 실제 출력 확인의 순서입니다. 문제가 남는다면 글꼴만의 문제라고 단정하지 말고 CLI 설정과 터미널 환경도 함께 점검하는 것이 좋습니다.
공식 출처
- Nerd Fonts 공식 GitHub 저장소
- Nerd Fonts 최신 릴리스
- Nerd Fonts 공식 다운로드 페이지
- Microsoft Learn - Windows Terminal 프로필 모양 설정
- Microsoft 공식 Cascadia Code 저장소
업데이트 안내: Nerd Fonts의 최신 버전, 다운로드 파일 및 Windows Terminal 메뉴는 변경될 수 있습니다. 실제 설치 전 공식 문서를 확인하세요. 본문은 일반적인 Windows 사용자 설치 절차를 안내하며, 특정 PC에서의 실행 성공을 보증하거나 실측 결과로 주장하지 않습니다.
#WindowsTerminal #NerdFont #CaskaydiaCove #PowerShell #AntigravityCLI #OhMyPosh #Starship #Windows11 #개발환경설정
댓글
댓글 쓰기