Windows 터미널 환경
Windows 기본 전통 콘솔(cmd.exe / conhost)은 기본 폰트에 emoji와 Nerd Font 아이콘 글리프가 없고 트루컬러도 지원하지 않습니다. 그래서 zqagent는 여기서 간이 표시로 전환됩니다: ✅는 [OK], 표 테두리는 ASCII로 퇴화하고 색도 칙칙합니다. 기능에는 영향이 없지만 Linux / macOS와 비교하면 아쉽습니다.
이 페이지에서는 권장 구성과 zqagent 내장 자동 안내를 설명합니다.
권장 구성
| 계층 | 권장 | 설명 |
|---|---|---|
| 터미널 | Windows Terminal | 트루컬러, GPU 가속, 탭과 분할. cmd / PowerShell / WSL 동시 사용 가능 |
| 폰트 | Nerd Font(고정폭) | 아이콘 글리프 보완. 예: JetBrainsMono Nerd Font |
| Shell | PowerShell 7 또는 Git Bash | 스크립트 경험이 Linux에 가까움 |
| 프롬프트 | oh-my-posh / starship | 아이콘 프롬프트와 git 상태 |
1. Windows Terminal 설치
방법 A(권장, Win10 1809+는 winget 내장):
winget install --id Microsoft.WindowsTerminal -e --accept-source-agreements --accept-package-agreements방법 B: 'Microsoft Store'를 열고 Windows Terminal을 검색해 설치.
2. Nerd Font 설치
winget install --id DEVCOM.JetBrainsMonoNerdFont -e --accept-source-agreements --accept-package-agreements동등한 폰트는 아무거나 가능(패키지 이름은 winget search nerd로 확인): CaskaydiaCove Nerd Font, FiraCode Nerd Font, Hack Nerd Font. Nerd Fonts 공식 사이트에서 내려받아 압축을 푼 뒤 폰트 파일을 우클릭 → '모든 사용자용으로 설치'해도 됩니다.
주의: Nerd Font는 일반
JetBrains Mono와 다릅니다. 설치 후 터미널에서Nerd Font가 붙은 것을 선택하지 않으면 아이콘이 네모로 남습니다.
3. 기본 터미널로 설정
Windows Terminal → 설정 → 시작 → '기본 터미널 응용 프로그램' → Windows Terminal 선택. 이후 cmd.exe / PowerShell에서 시작해도 Windows Terminal로 들어갑니다.
4. Windows Terminal에서 폰트 선택
설정 → 프로필 → 기본값 → 모양 → 글꼴 → JetBrainsMono Nerd Font 선택.
settings.json을 직접 수정해도 됩니다:
{
"profiles": {
"defaults": {
"font": { "face": "JetBrainsMono Nerd Font", "size": 11 }
}
}
}5. shell을 더 편하게(선택)
winget install --id Microsoft.PowerShell -e # PowerShell 7
winget install --id JanDeDobbeleer.OhMyPosh -e # oh-my-posh 프롬프트zqagent의 동작
- 시작 시 터미널 능력을 감지해 emoji / Unicode 미지원이면 자체 출력을 자동으로 ASCII 표기로 전환합니다 (
✅→[OK],❌→[x],⚠️→[!]). Markdown 표도 ASCII 테두리로 바뀝니다. - 전통 콘솔을 감지하면 적극적으로 안내합니다: 먼저 agent가 winget으로 자동 설치할지 묻습니다 (Windows Terminal과 Nerd Font. 명령은 하나씩 승인을 거칩니다). 설치할 수 없거나 LLM 연결이 아직 없으면 수동 설치 안내를 출력합니다.
- 관련 환경 변수:
| 변수 | 역할 |
|---|---|
ZQAGENT_TERM_SETUP=0 | 시작 시 터미널 환경 안내 끄기 |
ZQAGENT_TERM_SETUP=1 | 안내 강제 표시(튜토리얼 미리보기용) |
ZQAGENT_EMOJI=1/0 | emoji와 Unicode 표 강제 켜기 / 끄기 |
ZQAGENT_ASCII=1 | ASCII 표기로 강제 전환 |
문제 해결
| 현상 | 처리 |
|---|---|
winget이 없음 | 'Microsoft Store'에서 '앱 설치 관리자'(App Installer)를 검색해 설치하거나 위의 방법 B 사용 |
| 아이콘이 네모로 남음 | 터미널에서 선택한 폰트가 Nerd Font가 아님 |
emoji가 ?로 보임 | Windows Terminal에서 실행 중인지, ZQAGENT_EMOJI가 0이 아닌지 확인 |
| 색이 칙칙함 | conhost는 트루컬러 미지원. Windows Terminal로 전환 |