새 맥 초기 설정 — 셋업 순서

새 맥을 받으면 대략 이 순서로 개발 환경을 세팅한다. 매번 처음부터 헤매지 않도록 큰 순서와 각 단계의 핵심 명령만 짚고, 깊이 들어가는 주제는 심화 글로 연결한다.

1. 시스템·환경 설정

독 위치, 세벌식 입력, 트랙패드, 앱 접근 권한 등 macOS 자체 설정부터 맞춘다. 손보는 항목 전체는 macOS 시스템 설정에 모아 두었다.

2. Homebrew 설치와 패키지

1. 새 맥에서 Homebrew 설치

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

설치 후 환경변수 설정이 필요한 경우가 있다 → Apple Silicon(M1 이상) 맥은 /opt/homebrew/bin을 PATH에 추가해야 한다.

1. 패키지는 Brewfile로 선언해 두고 brew bundle 한 번에 재설치한다. dump·bundle·cleanup·check로 패키지를 선언적으로 관리하는 자세한 방법은 Homebrew Brewfile로 패키지 선언적으로 관리하기에 정리해 두었다.

어떤 도구를 담는지 — cat·ls·find·grep을 대체하는 모던 CLI, fzf·lazygit 같은 실제 툴킷은 macOS CLI 개발 도구 모음 참고.

3. dotfiles 이관

기존에 사용하던 설정파일(.xxx dotfile)은 dotfiles 저장소처럼 별도 git 저장소로 관리하는 것이 좋다. 저장소를 clone한 뒤, 설정 원본을 홈 디렉터리로 심볼릭 링크하면 원본은 git으로 추적되고 수정은 즉시 반영된다.

저장소 구조·멱등 링크 헬퍼·bootstrap.sh 오케스트레이션·시크릿 분리까지 dotfiles 관리 방법 전체는 dotfiles를 git 저장소 + 심볼릭 링크로 관리하기에 정리했다.

4. Git 환경 설정

1. GitHub 접근에 필요한 SSH 키 생성

ssh-keygen

1. 생성된 공개키를 GitHub에 등록 (Settings → SSH and GPG keys → SSH keys)

2. 개인·회사 계정을 한 PC에서 함께 쓴다면 ~/.ssh/config의 Host 별칭으로 키를 분리하고, .gitconfig의 includeIf로 디렉터리별 커밋 이메일까지 자동 전환할 수 있다. 자세한 방법은 GitHub 다중 계정 관리 Cheat Sheet에 정리했다.

---

부록 — Linux에서 별도 설치가 필요한 프로그램

맥이 아닌 Linux 환경을 함께 쓰는 경우, 아래 도구들은 직접 설치해야 한다.

sudo apt-get install tmux       # tmux
sudo apt-get install neovim     # neovim
sudo apt-get install git        # git
sudo apt-get install zsh        # zsh
# oh-my-zsh
sh -c "$(curl -fsSL https://raw.githubusercontent.com/robbyrussell/oh-my-zsh/master/tools/install.sh)"
sudo apt-get install autojump   # autojump (zoxide로 대체 가능 — /posts/shell/2026-07-03-zoxide-directory-jump/)
# zsh 플러그인
sudo apt-get install zsh-autosuggestions      # git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions
sudo apt-get install zsh-syntax-highlighting  # git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting

zsh 플러그인 설치 후 ~/.zshrc에 설정파일을 읽어오는 부분을 추가해야 한다.

source ~/.oh-my-zsh/custom/plugins/zsh-syntax-highlighting/zsh-syntax-highlighting.zsh
source ~/.oh-my-zsh/custom/plugins/zsh-autosuggestions/zsh-autosuggestions.zsh