맥 개발 환경 세팅 2026 — 처음 맥을 쓰는 개발자를 위한 앱과 CLI 도구 가이드

xcode-select --install

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

# Apple Silicon — 설치 마지막에 나오는 "Next steps" 두 줄
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

brew doctor   # "Your system is ready to brew." 확인

brew install --cask iterm2 font-jetbrains-mono-nerd-font

brew install \
  git \
  gh \
  starship \
  mise \
  uv \
  direnv \
  fzf \
  ripgrep \
  fd \
  bat \
  eza \
  jq \
  yq \
  tree \
  tmux \
  zoxide \
  btop \
  zsh-autosuggestions \
  zsh-syntax-highlighting

# ~/.zshrc — 2026 맥 개발 환경

# ── Homebrew ─────────────────────────────────────────────
# (.zprofile에 brew shellenv가 있으면 이 줄은 생략해도 됨)
eval "$(/opt/homebrew/bin/brew shellenv)"

# ── 기록 ─────────────────────────────────────────────────
HISTFILE=~/.zsh_history
HISTSIZE=100000
SAVEHIST=100000
setopt SHARE_HISTORY HIST_IGNORE_ALL_DUPS HIST_IGNORE_SPACE HIST_REDUCE_BLANKS

# ── 자동완성 ─────────────────────────────────────────────
autoload -Uz compinit && compinit
zstyle ':completion:*' matcher-list 'm:{a-z}={A-Za-z}'   # 대소문자 무시
zstyle ':completion:*' menu select

# ── 셸 플러그인 (brew로 설치한 경로) ─────────────────────
source "$(brew --prefix)/share/zsh-autosuggestions/zsh-autosuggestions.zsh"
ZSH_AUTOSUGGEST_HIGHLIGHT_STYLE='fg=244'

# ── 도구 활성화 ──────────────────────────────────────────
eval "$(starship init zsh)"          # 프롬프트
eval "$(mise activate zsh)"          # 언어 버전
eval "$(direnv hook zsh)"            # 환경변수
eval "$(zoxide init zsh)"            # 똑똑한 cd
source <(fzf --zsh)                  # Ctrl+R 기록, Ctrl+T 파일, Alt+C 폴더

# fzf에서 파일 찾을 때 fd 사용 (.gitignore 존중, 숨김 파일 포함)
export FZF_DEFAULT_COMMAND='fd --type f --hidden --exclude .git'
export FZF_CTRL_T_COMMAND="$FZF_DEFAULT_COMMAND"
export FZF_ALT_C_COMMAND='fd --type d --hidden --exclude .git'
export FZF_DEFAULT_OPTS='--height 40% --layout=reverse --border'

# ── 별칭 ─────────────────────────────────────────────────
alias ls='eza --icons --group-directories-first'
alias ll='eza -l --icons --git --group-directories-first'
alias la='eza -la --icons --git --group-directories-first'
alias lt='eza --tree --level=2 --icons'
alias cat='bat --paging=never'
alias top='btop'
alias g='git'
alias gs='git status -sb'
alias gl='git log --oneline --graph -20'

# ── 편집기 ───────────────────────────────────────────────
export EDITOR='code --wait'           # vim을 선호하면 'nvim'
export LANG=ko_KR.UTF-8

# ── 마지막: 문법 강조는 반드시 맨 끝에 ─────────────────────
source "$(brew --prefix)/share/zsh-syntax-highlighting/zsh-syntax-highlighting.zsh"

source ~/.zshrc

# ~/.config/starship.toml
add_newline = false

format = """
directorydirectorydirectorygit_branchgitstatusgit_statusgits​tatusnodejspythonpythonpythoncmd_duration
$character"""

[directory]
truncation_length = 3
style = "bold cyan"

[git_branch]
symbol = " "
style = "bold purple"

[git_status]
style = "yellow"

[nodejs]
format = "[symbol(symbol(symbol(version )]($style)"
[python]
format = "[symbol(symbol(symbol(version )]($style)"

[cmd_duration]
min_time = 2000
format = "took [duration](duration](duration](style) "

[character]
success_symbol = "[❯](bold green)"
error_symbol = "[❯](bold red)"

# 전역 기본 버전
mise use --global node@lts
mise use --global python@3.13
mise use --global go@latest      # 필요한 언어만

# 프로젝트 폴더에서 — .mise.toml 또는 .tool-versions 생성
cd ~/work/my-app
mise use node@22

mise ls                          # 설치된 버전
mise doctor                      # 문제 진단

# 새 프로젝트
uv init my-api && cd my-api
uv add fastapi uvicorn           # pyproject.toml + uv.lock 자동
uv run uvicorn main:app --reload # 가상환경 활성화 없이 실행

# 기존 프로젝트 (requirements.txt)
uv venv && uv pip install -r requirements.txt

# 전역 CLI 도구 (pipx 대체)
uv tool install ruff
uv tool install httpie

# 인터프리터
uv python install 3.12
uv python list

cd ~/work/my-app
cat > .envrc <<'EOF'
export DATABASE_URL=postgres://localhost:5432/myapp
export OPENAI_API_KEY=sk-...
dotenv_if_exists .env
EOF
direnv allow                      # 처음 한 번, .envrc가 바뀔 때마다 다시
echo .envrc >> .gitignore         # 비밀값은 절대 커밋하지 않음

brew install colima docker docker-compose

colima start --cpu 4 --memory 8 --disk 60   # 처음 한 번 리소스 지정
docker run --rm hello-world
docker compose up -d

colima stop                                  # 안 쓸 때 끄기
colima start                                 # 이후엔 설정 기억함

cat > ~/.tmux.conf <<'EOF'
set -g prefix C-a            # Ctrl+B 대신 Ctrl+A
unbind C-b
bind C-a send-prefix
set -g mouse on              # 마우스로 창 크기 조절·스크롤
set -g base-index 1          # 창 번호 1부터
set -g history-limit 50000
set -g default-terminal "tmux-256color"
set -ga terminal-overrides ",xterm-256color:Tc"   # 트루컬러
bind | split-window -h -c "#{pane_current_path}"
bind - split-window -v -c "#{pane_current_path}"
bind r source-file ~/.tmux.conf \; display "reloaded"
EOF

git config --global user.name "홍길동"
git config --global user.email "you@example.com"
git config --global init.defaultBranch main
git config --global pull.rebase false
git config --global core.editor "code --wait"
git config --global push.autoSetupRemote true    # 첫 push 때 -u 생략 가능
git config --global rerere.enabled true          # 같은 충돌 자동 재해결
git config --global core.excludesfile ~/.gitignore_global
printf ".DS_Store\n.envrc\n.env\n.idea/\n" > ~/.gitignore_global

# HTTPS — 가장 간단. 브라우저 인증 한 번이면 끝
gh auth login          # GitHub.com → HTTPS → Login with a web browser
gh auth status

# SSH — 서버·CI와 같은 키를 쓰고 싶을 때
ssh-keygen -t ed25519 -C "you@example.com"
gh ssh-key add ~/.ssh/id_ed25519.pub --title "MacBook 2026"
ssh -T git@github.com   # "Hi 아이디! You've successfully authenticated" 확인

brew install --cask tailscale

# Tailscale 공식 서버를 쓸 때: 앱 실행 후 로그인하면 끝
# 회사 Headscale을 쓸 때: 관리자에게 받은 서버 주소로 로그인
tailscale up --login-server https://headscale.example.com

tailscale status                  # 연결된 머신과 IP 목록
ssh user@dev-server               # Tailscale IP 또는 MagicDNS 이름으로 접속

# ~/.ssh/config
Host dev
  HostName dev-server            # Tailscale MagicDNS 이름 또는 100.x.y.z
  User ubuntu
  IdentityFile ~/.ssh/id_ed25519
  ServerAliveInterval 30
  ServerAliveCountMax 3

ssh dev                           # 접속
tmux a || tmux new -s main        # 있으면 붙고 없으면 새로
# ... 작업 → 노트북 덮어도 작업은 계속 ...

brew install --cask \
  visual-studio-code \
  raycast \
  rectangle \
  google-chrome \
  1password

brew install --cask \
  stats \
  maccy \
  shottr \
  tableplus \
  bruno \
  obsidian \
  slack

# 키 반복 속도 — 코드 편집 시 커서 이동이 빨라짐
defaults write NSGlobalDomain KeyRepeat -int 2
defaults write NSGlobalDomain InitialKeyRepeat -int 15

# Finder: 숨김 파일·확장자·경로 표시
defaults write com.apple.finder AppleShowAllFiles -bool true
defaults write NSGlobalDomain AppleShowAllExtensions -bool true
defaults write com.apple.finder ShowPathbar -bool true

# 스크린샷 저장 위치
mkdir -p ~/Screenshots && defaults write com.apple.screencapture location ~/Screenshots

killall Finder

brew install atuin
echo 'eval "$(atuin init zsh)"' >> ~/.zshrc
atuin import auto                 # 기존 zsh 기록 가져오기
# 동기화가 필요하면: atuin register / atuin login

brew bundle dump --file=~/Brewfile --force     # 현재 설치 목록 → Brewfile
cat ~/Brewfile                                  # brew/cask/mas 항목이 한 줄씩

brew bundle install --file=~/Brewfile

brew install chezmoi
chezmoi init                                   # ~/.local/share/chezmoi 저장소 생성

chezmoi add ~/.zshrc ~/.tmux.conf ~/.gitconfig ~/.config/starship.toml ~/Brewfile
chezmoi cd                                     # 저장소로 이동
git remote add origin git@github.com:아이디/dotfiles.git
git add -A && git commit -m "init dotfiles" && git push -u origin main
exit

brew install chezmoi
chezmoi init --apply git@github.com:아이디/dotfiles.git
brew bundle install --file=~/Brewfile