Mac 개발환경 세팅하기

English (N/A)
#mac#homebrew#iterm2#zsh#development-environment

새 Mac을 받으면 개발 환경을 처음부터 세팅해야 한다. 매번 할 때마다 뭘 설치했는지 까먹어서 정리해둔다.

시스템 설정

언어 설정

시스템 언어 우선순위를 영어로 변경해두면 좋다. 간혹 locale 설정 때문에 발생하는 오류를 방지할 수 있고, 영어로 된 오류 메시지가 구글 검색에 훨씬 잘 걸린다.

System Settings > General > Language & Region > Preferred Languages 에서 English를 한국어보다 위로 드래그해서 순서를 조정한다.

키보드 설정

코드 작성할 때 자동 수정 기능이 오히려 방해가 될 때가 많다. 다음 설정들을 꺼두면 편하다.

System Settings > Keyboard > Text Input > Input Sources > Edit 에서 다음 항목들을 끈다.

  • Correct spelling automatically
  • Capitalize words automatically

Caps Lock 키와 Control 키를 서로 바꿔두면 터미널이나 Vim 사용할 때 훨씬 편하다. Control 키를 자주 쓰는데 새끼손가락으로 구석에 있는 Control을 누르는 건 손목에 무리가 간다. Caps Lock 위치에 Control이 있으면 자연스럽게 누를 수 있다.

System Settings > Keyboard > Keyboard Shortcuts > Modifier Keys 에서 다음과 같이 변경한다.

  • Caps Lock key → Control
  • Control key → Caps Lock

트랙패드 설정

트랙패드를 꾹 누르지 않고 톡톡 터치만으로 클릭되도록 설정하면 손의 피로를 줄일 수 있다.

System Settings > Trackpad > Point & Click 에서 Tap to click 을 체크한다.

세 손가락으로 드래그하는 기능도 켜두면 편하다. 이 설정은 Accessibility에 숨겨져 있다.

System Settings > Accessibility > Pointer Control > Trackpad Options 에서 Use trackpad for dragging 을 켜고 Dragging style 을 Three Finger Drag 로 선택한다.

구름입력기 설치

구름입력기는 macOS용 오픈소스 한글 입력기다. 기본 한글 입력기 대신 사용하면 몇 가지 장점이 있다.

  • 한글 상태에서 백틱()을 입력하면 ₩ 대신 가 입력된다
  • 한/영 전환이 더 빠르고 안정적이다
  • 두벌식, 세벌식, 로마자 등 다양한 자판을 지원한다

설치 방법

구름입력기 GitHub 릴리즈 페이지에서 최신 버전의 .pkg 파일을 다운로드한다.

다운로드한 .pkg 파일을 실행하면 설치가 진행된다. 설치가 완료되면 로그아웃 후 다시 로그인하거나 재부팅한다.

입력 소스 추가

System Settings > Keyboard > Text Input > Input Sources > Edit 에서 좌측 하단의 + 버튼을 클릭한다.

검색창에 "gureum" 또는 "구름"을 입력하면 구름 입력기 가 나타난다. 두벌식 과 옛한글 입력기(클래식) 를 선택하고 Add 를 클릭한다.

기존 macOS 한글 입력기는 - 버튼으로 제거하면 된다.

Node.js 설치 (nvm)

Node.js를 설치할 때는 nvm(Node Version Manager)을 사용하는 것을 권장한다. 공식 홈페이지에서 직접 설치하거나 Homebrew로 설치하면 버전 관리가 불편하고, 프로젝트마다 다른 Node.js 버전이 필요할 때 대응하기 어렵다.

자세한 설치 방법은 nvm으로 Node.js 설치하기 포스트를 참고한다.

Claude Code로 설치하기

Claude Code를 설치하면 터미널에서 실행되는 것들은 자연어로 요청하면 알아서 해준다.

  • "Homebrew 설치해줘"
  • "iTerm2 설치해줘"
  • "Git 설치하고 user.name은 Hong Gildong, email은 hong@example.com으로 설정해줘"
  • "Zsh 설치해줘"
  • "Oh My Zsh 설치해줘"
  • "zsh-syntax-highlighting이랑 zsh-autosuggestions 플러그인 설치해줘"
  • "powerlevel10k 설치해줘"
  • "zsh-completions 설치해줘"
  • "한글 입력할 때 백틱 나오게 설정해줘"

iTerm2 설정

iTerm2 GUI 설정은 직접 해야 한다.

Unicode 설정

macOS에서 한글 파일명이나 디렉토리명을 다루다 보면 자음과 모음이 분리되는 현상이 발생할 수 있다. NFD(Normalization Form Decomposed)로 저장되기 때문인데, iTerm2에서 NFC(Normalization Form Composed)로 바꿔주면 해결된다.

iTerm2의 Settings (⌘,) > Profiles > Text 탭 하단에 Unicode normalization form 드롭다운이 있다. 여기서 NFC 를 선택한다.

단축키 변경

기본 설정으로는 Option + ← 또는 → 키로 단어 단위 이동이 안 된다. Natural Text Editing 프리셋을 적용하면 일반 텍스트 에디터처럼 동작한다.

iTerm2의 Settings (⌘,) > Profiles > Keys > Key Bindings 에서 하단의 Presets 드롭다운을 클릭하고 Natural Text Editing 을 선택한다.

테마 설정

iTerm2 Color Schemes에서 다양한 테마를 미리보고 다운로드할 수 있다. Dracula, Snazzy, Solarized Dark, Material Design 등이 인기 있다.

다운로드한 .itermcolors 파일을 더블클릭하면 자동으로 iTerm2에 import된다. 그 다음 iTerm2의 Settings (⌘,) > Profiles > Colors 에서 하단의 Color Presets 드롭다운을 클릭하고 import된 테마를 선택하면 적용된다.

참고