iTerm2 설치와 기본 설정
iTerm2를 설치하고 자신만의 개발 환경으로 설정하는 방법을 단계별로 알아보겠습니다. 이 시리즈에서는 이미 Homebrew를 설치했다고 가정하고, 이후 도구 설치도 모두 Homebrew 기준으로 진행합니다.
이 글에서 할 것
- Homebrew로 iTerm2 설치하기
- 폰트와 테마 설정하기
- 기본 동작 설정하기
시작하기 전에 확인할 것
필요한 것:
- 맥북
- 인터넷 연결
- 관리자 권한
- Homebrew 설치 완료
소요 시간: 약 10-15분
Step 1: Homebrew로 iTerm2 설치
설치 명령어
brew install --cask iterm2
왜 이 방법을 쓰나요?
- 이후 업데이트도
brew upgrade --cask iterm2 한 줄이면 끝납니다.
- 삭제도
brew uninstall --cask iterm2로 깔끔하게 처리됩니다.
- 나중에 새 맥북으로 옮길 때도 같은 명령으로 다시 설치할 수 있습니다.
설치 확인
brew list --cask | grep iterm2
정상이라면 iterm2가 보입니다.
Step 2: 첫 실행
또는 응용 프로그램 폴에서 iTerm2를 더블클릭합니다.
대부분의 경우 Homebrew로 설치한 앱은 바로 실행됩니다.
만약 macOS 보안 경고가 뜬다면 열기를 눌러 진행하면 됩니다. 드물게 버튼이 다르게 보일 수 있으니, 화면에 보이는 안내 문구에 맞춰 허용해 주세요.
Step 3: 기본 설정 (Preferences)
설정 창 열기:
Command + , (콤마)
기본 프로필 확인
Preferences → Profiles → Default
💡 프로필이 뭔가요? 여러 설정 세트를 저장핛 수 있습니다. 예: "개발용" 프로필, "서버관리용" 프로필 등
폰트 변경하기
Preferences → Profiles → Default → Text 탭
개발용 폰트 설치 (선택):
설치 후 iTerm2 설정에서 "Font"를 "Fira Code"로 변경하고 크기를 14pt로 설정합니다.
폰트 크기 조정 단축키 (설정 후):
Command + + → 폰트 크기 증가
Command + - → 폰트 크기 감소
Command + 0 → 기본 크기로 복귀
⚠️ 실수 대처법: 폰트가 너무 작게/크게 보인다면 Command + 0을 누릅시다. 기본 크기로 돌아갑니다.
Step 4: 테마(색상) 설정
어두운 테마를 권장합니다. 장시간 코딩 시 눈의 피로가 적습니다.
내장 테마 적용 (간단 방법)
Preferences → Profiles → Default → Colors 탭
Color Presets 드롭다운:
- "Dark" 선택 (기본 다크 테마)
- 또는 "Solarized Dark" 선택 (개발자들이 많이 쓰는 테마)
Solarized Dark 테마 직접 가져오기 (추천)
더 정확한 Solarized 테마를 위해 파일을 직접 가져옵니다.
1. 브라우저에서 https://github.com/mbadolato/iTerm2-Color-Schemes 접속
2. "Code" → "Download ZIP" 클릭
3. ZIP 파일 압축 해제
4. 폴 열기: iTerm2-Color-Schemes-master/schemes/
iTerm2에 테마 가져오기:
Preferences → Profiles → Default → Colors 탭
↓
"Color Presets" 드롭다운 → "Import..." 클릭
↓
다운로드한 폴에서 "Solarized Dark.itermcolors" 선택
↓
"Color Presets" → "Solarized Dark" 선택
💡 왜 Solarized인가?
- 눈의 피로가 적음
- ANSI 색상이 명확하게 구분됨
- 대부분의 개발 도구에서 호환
투명도/블러 설정 (선택)
Preferences → Profiles → Default → Window 탭
설정값:
Transparency: 10~20% 정도 (완전 투명하지 않게)
Blur: 10~20 (맥의 느낌 살리기)
⚠️ 실수 대처법: 배경이 너무 투명해서 글씨가 안 보인다면 Transparency를 0%로 설정하세요.
Step 5: 기본 동작 설정
시작 시 동작
Preferences → Profiles → Default → General 탭
↓
"Working Directory" 섹션
체크 권장:
☑ Reuse previous session's directory
(새 탭/창 열 때 이전 디렉토리 유지)
왜 체크하나요?
/Users/username/Documents/project/src에서 작업 중- 새 탭 열기
- 같은 위치(
/Users/username/Documents/project/src)에서 시작
창 크기 기억
Preferences → Profiles → Default → Window 탭
↓
Settings for New Windows
추천 설정:
Columns: 120
Rows: 35
💡 적절한 크기: 너무 작으면 출력이 잘리고, 너무 크면 화면을 많이 차지합니다.
Step 6: 단축키 확인하기
핵심 단축키들을 미리 알아두세요.
| 단축키 |
기능 |
Command + T |
새 탭 |
Command + N |
새 창 |
Command + W |
탭/패널 닫기 |
Command + D |
화면 수평 분할 |
Command + Shift + D |
화면 수직 분할 |
Command + [ |
이전 패널로 이동 |
Command + ] |
다음 패널로 이동 |
Command + ; |
자동완성 |
Command + F |
검색 |
Command + + |
폰트 크게 |
Command + - |
폰트 작게 |
설치가 잘 되었는지 확인
설정 완료 체크리스트:
동작 테스트:
- iTerm2 실행
cd Documents 입력- Command+T로 새 탭 열기
- 새 탭의 경로가 Documents로 시작하는지 확인
AI 코딩 도구와 함께 쓰는 프롬프트
iTerm2는 GUI 설정이 많아서 AI가 직접 클릭하기보다, 현재 목표에 맞는 체크리스트와 되돌리는 방법을 같이 받는 식이 좋습니다. 중요: 프로필 삭제나 초기화는 명시적으로 동의하기 전에는 진행하지 마세요.
iTerm2를 처음 설정하려고 해.
폰트, 색상, 기본 프로필, 단축키에서 무엇을 확인해야 하는지 순서대로 체크리스트를 만들어줘.
설정 변경 전에는 원래 값도 적어 두라고 알려줘.
iTerm2에서 화면 분할과 검색을 연습하고 싶어.
내가 눌러야 할 단축키를 단계별로 알려주고, 실수했을 때 닫기/되돌리기 방법도 같이 설명해줘.
설정 파일이나 프로필을 삭제하라는 요청은 피하고, 먼저 “현재 설정을 백업하거나 스크린샷으로 남기는 방법”을 물어보세요.
자주 생기는 실수
실수 1: iTerm2가 안 열림
증상: "손상된 애플리케이션"이라는 메시지
해결:
brew uninstall --cask iterm2
brew install --cask iterm2
실수 2: 한글이 깨짐
해결:
Preferences → Profiles → Default → Text 탭
↓
☑ Treat ambiguous-width characters as double width ← 체크
실수 3: 폰트가 뭉개짐
해결:
Preferences → Profiles → Default → Text 탭
↓
☑ Anti-aliased ← 체크 확인
☑ Draw bold text in bold font ← 체크 확인
실수 4: 설정이 저장되지 않음
해결:
Preferences → General → Preferences
↓
"Load preferences from a custom folder or URL"이 체크되어 있다면 해제
실수 5: 다운로드한 파일을 못 찾겠어요
해결:
# 다운로드 폴 열기
open ~/Downloads
여기까지 했으면 성공
완료 기준:
추천 다음 단계:
- iTerm2를 기본 터미널로 사용핵 보기
- Command+D로 화면 분할 사용핵 보기
- Command+;로 자동완성 사용핵 보기
다음 편 안내
iTerm2 설치와 기본 설정을 완료하셨다면, 이제 화면 분할, 검색, 고급 단축키를 배워봅시다.
iTerm2 시리즈 3편: 화면 분할, 검색, 단축키에서는 iTerm2의 핵심 기능들을 실제로 사용핵 보는 방법을 실습합니다.
💬 댓글
이 글에 대한 의견을 남겨주세요