[iTerm2 시리즈 2편] 설치와 기본 설정

한국어 버전

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 실행 zsh · ~/workspace
Ready. Press Replay to run the scripted session.

또는 응용 프로그램 폴에서 iTerm2를 더블클릭합니다.

대부분의 경우 Homebrew로 설치한 앱은 바로 실행됩니다.

만약 macOS 보안 경고가 뜬다면 열기를 눌러 진행하면 됩니다. 드물게 버튼이 다르게 보일 수 있으니, 화면에 보이는 안내 문구에 맞춰 허용해 주세요.

Step 3: 기본 설정 (Preferences)

설정 창 열기:

Command + , (콤마)

기본 프로필 확인

Preferences → Profiles → Default

💡 프로필이 뭔가요? 여러 설정 세트를 저장핛 수 있습니다. 예: "개발용" 프로필, "서버관리용" 프로필 등

폰트 변경하기

Preferences → Profiles → Default → Text 탭

개발용 폰트 설치 (선택):

개발용 폰트 설치 zsh · ~/workspace
Ready. Press Replay to run the scripted session.

설치 후 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 + - 폰트 작게

설치가 잘 되었는지 확인

설정 완료 체크리스트:

  • brew install --cask iterm2가 정상 완료됨
  • iTerm2가 정상 실행됨
  • 폰트가 14pt로 변경됨
  • Solarized Dark 테마가 적용됨
  • 새 탭을 열어도 이전 디렉토리 유지됨
  • Command+T로 새 탭이 열림

동작 테스트:

  1. iTerm2 실행
  2. cd Documents 입력
  3. Command+T로 새 탭 열기
  4. 새 탭의 경로가 Documents로 시작하는지 확인

자주 생기는 실수

실수 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를 Applications 폴에 복사함
  • iTerm2가 정상적으로 실행됨
  • 기본 프로필 설정을 확인함
  • 폰트를 변경함 (선택)
  • Solarized Dark 테마를 적용함
  • 새 탭을 열어도 이전 디렉토리가 유지됨
  • 주요 단축키를 확인함

추천 다음 단계:

  1. iTerm2를 기본 터미널로 사용핵 보기
  2. Command+D로 화면 분할 사용핵 보기
  3. Command+;로 자동완성 사용핵 보기

다음 편 안내

iTerm2 설치와 기본 설정을 완료하셨다면, 이제 화면 분할, 검색, 고급 단축키를 배워봅시다.

iTerm2 시리즈 3편: 화면 분할, 검색, 단축키에서는 iTerm2의 핵심 기능들을 실제로 사용핵 보는 방법을 실습합니다.

💬 댓글

이 글에 대한 의견을 남겨주세요