개발자 맥북 초기 셋업 체크리스트 2026 — Homebrew·dotfiles·CLI 도구·VS Code 완전 정리

macOS 개발자 기본 설정
# Finder에서 숨김 파일 표시
defaults write com.apple.finder AppleShowAllFiles YES

# 키 반복 속도 최대화 (재시작 필요)
defaults write NSGlobalDomain KeyRepeat -int 1
defaults write NSGlobalDomain InitialKeyRepeat -int 10

# Dock 자동 숨기기
defaults write com.apple.dock autohide -bool true
killall Dock

# 스크린샷 저장 위치 변경 (Desktop → ~/Screenshots)
mkdir -p ~/Screenshots
defaults write com.apple.screencapture location ~/Screenshots

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

# M-series 맥에서 PATH 추가 (설치 후 안내 메시지 따라하기)
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

# 설치 확인
brew --version

Oh My Zsh + Starship 설치
# Oh My Zsh 설치
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

# 유용한 플러그인 설치
git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions
git clone https://github.com/zsh-users/zsh-syntax-highlighting ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting

# ~/.zshrc 플러그인 활성화
# plugins=(git zsh-autosuggestions zsh-syntax-highlighting)

# Starship 설치 (프롬프트)
brew install starship
echo 'eval "$(starship init zsh)"' >> ~/.zshrc

mise 설치 및 기본 사용
# mise 설치
brew install mise

# 셸 통합 (~/.zshrc에 추가)
echo 'eval "$(mise activate zsh)"' >> ~/.zshrc
source ~/.zshrc

# Node.js LTS 설치
mise install node@lts
mise use -g node@lts

# Python 설치
mise install python@3.12
mise use -g python@3.12

# 특정 프로젝트에서 버전 고정
cd my-project
mise use node@20.11.0  # .mise.toml 파일 자동 생성

# 설치된 버전 확인
mise list

필수 CLI 도구 일괄 설치
brew install \
  git \          # 최신 git (macOS 기본보다 최신 버전)
  gh \           # GitHub CLI — PR, issue, 인증 관리
  fzf \          # 퍼지 검색 — Ctrl+R 히스토리 검색이 극적으로 개선됨
  bat \          # cat 대체 — 문법 하이라이팅, 줄번호
  eza \          # ls 대체 — 색상, 아이콘, Git 상태 표시
  ripgrep \      # grep 대체 — 엄청나게 빠름
  fd \           # find 대체 — 직관적인 문법
  jq \           # JSON 처리 — API 응답 파싱에 필수
  httpie \       # curl 대체 — 사람이 읽기 좋은 HTTP 클라이언트
  tldr           # man 대체 — 실용적인 예제 중심 도움말

~/.zshrc alias 추가
# ~/.zshrc에 추가
alias ls='eza --icons'
alias ll='eza -la --icons --git'
alias cat='bat'
alias grep='rg'
alias find='fd'

# fzf 통합 (설치 후 자동 설정 스크립트 실행)
$(brew --prefix)/opt/fzf/install

VS Code 설치 + code 명령어 등록
# VS Code 설치
brew install --cask visual-studio-code

# 'code' 명령어 (VS Code Command Palette에서 실행)
# CMD + Shift + P → "Shell Command: Install 'code' command in PATH"

# 자주 쓰는 확장 CLI 설치
code --install-extension esbenp.prettier-vscode
code --install-extension ms-python.python
code --install-extension dbaeumer.vscode-eslint
code --install-extension eamodio.gitlens
code --install-extension bradlc.vscode-tailwindcss
code --install-extension GitHub.copilot

settings.json 핵심 설정
{
  "editor.fontFamily": "JetBrains Mono, Menlo, monospace",
  "editor.fontSize": 14,
  "editor.lineHeight": 1.6,
  "editor.tabSize": 2,
  "editor.formatOnSave": true,
  "editor.defaultFormatter": "esbenp.prettier-vscode",
  "editor.bracketPairColorization.enabled": true,
  "terminal.integrated.defaultProfile.osx": "zsh",
  "files.trimTrailingWhitespace": true,
  "git.autofetch": true
}

Git 전역 설정 + SSH 키 생성
# Git 전역 사용자 설정
git config --global user.name "Your Name"
git config --global user.email "you@example.com"
git config --global core.editor "code --wait"
git config --global init.defaultBranch main
git config --global pull.rebase false

# SSH 키 생성 (ED25519 권장)
ssh-keygen -t ed25519 -C "you@example.com"

# SSH agent에 키 추가
eval "$(ssh-agent -s)"
ssh-add --apple-use-keychain ~/.ssh/id_ed25519

# 공개 키를 클립보드에 복사 → GitHub Settings에 붙여넣기
pbcopy < ~/.ssh/id_ed25519.pub

# GitHub 연결 테스트
ssh -T git@github.com

GNU Stow로 dotfiles 관리
# stow 설치
brew install stow

# dotfiles 저장소 구조 예시
# ~/dotfiles/
#   zsh/.zshrc
#   git/.gitconfig
#   starship/.config/starship.toml

# 심볼릭 링크 생성 (~/dotfiles에서 실행)
cd ~/dotfiles
stow zsh    # ~/.zshrc → ~/dotfiles/zsh/.zshrc 링크 생성
stow git    # ~/.gitconfig → ~/dotfiles/git/.gitconfig 링크 생성

# GitHub에 올리기
git init && git add . && git commit -m "init dotfiles"
git remote add origin git@github.com:username/dotfiles.git
git push -u origin main

Brewfile 생성 및 재설치
# 현재 설치된 모든 패키지를 Brewfile로 저장
brew bundle dump --file ~/dotfiles/Brewfile

# Brewfile 예시 내용
# brew "git"
# brew "gh"
# brew "fzf"
# brew "ripgrep"
# cask "visual-studio-code"
# cask "iterm2"

# 새 맥에서 Brewfile로 일괄 설치
brew bundle install --file ~/dotfiles/Brewfile