2026 맥북 개발자 세팅 가이드: Homebrew, iTerm2, VS Code 초기 설정 총정리

새 맥북을 샀다면 가장 먼저 해야 할 일은 앱을 이것저것 설치하는 것이 아니다.

개발자라면 먼저 개발환경의 기준점을 잡아야 한다.

• 패키지는 무엇으로 설치하고 관리할 것인가?
• 터미널은 무엇을 쓸 것인가?
• 어떤 폰트와 쉘을 쓸 것인가?
• VS Code는 어떻게 세팅할 것인가?
• GitHub와 SSH는 어떻게 연결할 것인가?
• Node, Python, Git 같은 기본 도구는 어떻게 관리할 것인가?

이 글은 2026년에 맥북, 맥북에어, 맥북프로를 새로 구매한 개발자가 처음부터 끝까지 따라 할 수 있는 개발자 세팅 가이드다.

특히 요즘은 Claude Code, Cursor, ChatGPT, Gemini 같은 AI 코딩툴을 많이 쓰기 때문에 로컬 개발환경이 더 중요해졌다. AI가 코드를 잘 만들어줘도 터미널, Git, Node, Python, VS Code 설정이 꼬여 있으면 결국 생산성이 떨어진다.

관련해서 이전에 작성한 VS Code로 Astro 블로그 관리하는 방법과 Claude Code vs Cursor 비교 정리도 함께 보면 좋다.

전체 세팅 순서

새 맥북을 개발용으로 세팅할 때는 아래 순서를 추천한다.

1. macOS 업데이트와 기본 설정 확인
2. Xcode Command Line Tools 설치
3. Homebrew 설치
4. Git, Node, Python 등 기본 개발 패키지 설치
5. iTerm2 설치와 터미널 세팅
6. 개발자용 폰트 설치
7. zsh, Oh My Zsh, Powerlevel10k 세팅
8. 터미널 alias와 fzf 설정
9. VS Code 설치와 settings.json 설정
10. VS Code 추천 확장 프로그램 설치
11. GitHub CLI와 SSH 연결
12. Node, Python 개발환경 점검
13. Raycast, Rectangle, OrbStack 같은 생산성 도구 설치
14. 실제 프로젝트 빌드 테스트
15. Brewfile과 설정 파일 백업

처음부터 완벽하게 꾸미려고 하기보다, 매일 쓰는 도구를 안정적으로 세팅하는 것이 중요하다.

1. macOS 기본 확인

먼저 macOS를 최신 상태로 업데이트한다.

softwareupdate --list

업데이트가 있다면 시스템 설정에서 먼저 업데이트를 진행한다.

현재 macOS 버전은 아래 명령어로 확인할 수 있다.

sw_vers

Mac의 칩 종류는 아래 명령어로 확인한다.

uname -m

결과가 arm64라면 Apple Silicon 맥이다. M1, M2, M3, M4 계열 맥북은 대부분 여기에 해당한다.

결과가 x86_64라면 Intel Mac이다.

이 차이가 중요한 이유는 Homebrew 기본 설치 경로가 다르기 때문이다.

Mac 종류	Homebrew 기본 경로
Apple Silicon Mac	/opt/homebrew
Intel Mac	/usr/local

요즘 새 맥북 사용자라면 대부분 Apple Silicon 기준으로 보면 된다.

2. Xcode Command Line Tools 설치

Homebrew와 Git을 제대로 사용하려면 먼저 Xcode Command Line Tools를 설치하는 것이 좋다.

xcode-select --install

설치가 끝난 뒤 아래 명령어로 확인한다.

xcode-select -p

정상적으로 설치되었다면 보통 아래와 비슷한 경로가 나온다.

/Library/Developer/CommandLineTools

Git 버전도 확인한다.

git --version

Git 버전이 정상적으로 출력되면 기본 개발 도구 설치가 완료된 것이다.

3. Homebrew 설치

Homebrew는 macOS에서 가장 많이 쓰는 패키지 관리자다. 개발자라면 사실상 필수에 가깝다.

공식 설치 명령어는 다음과 같다.

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

설치가 끝나면 터미널에 Next steps가 표시된다. Apple Silicon 맥북이라면 보통 아래 명령어를 실행하라고 안내된다.

echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

Intel Mac이라면 경로가 다를 수 있다.

echo 'eval "$(/usr/local/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/usr/local/bin/brew shellenv)"

설치 확인:

brew --version

정상적으로 버전이 나오면 설치가 완료된 것이다.

4. Homebrew 기본 관리 명령어

Homebrew를 설치했다면 아래 명령어들은 자주 쓰게 된다.

brew update

Homebrew 패키지 목록을 최신 상태로 업데이트한다.

brew upgrade

설치된 패키지를 최신 버전으로 업그레이드한다.

brew doctor

Homebrew 상태를 점검한다.

brew cleanup

오래된 캐시와 불필요한 파일을 정리한다.

개인적으로는 가끔 아래 순서로 정리한다.

brew update
brew upgrade
brew cleanup
brew doctor

매일 할 필요는 없다. 새 패키지를 설치하거나 문제가 생겼을 때 점검하는 정도면 충분하다.

5. Homebrew로 기본 개발 패키지 설치

이제 개발에 자주 쓰는 기본 패키지를 설치한다.

brew install git
brew install gh
brew install node
brew install python
brew install wget
brew install curl
brew install fzf
brew install ripgrep
brew install bat
brew install eza
brew install jq
brew install tree

각 패키지의 용도는 다음과 같다.

패키지	용도
git	버전 관리
gh	GitHub CLI
node	JavaScript / TypeScript 개발
python	Python 개발
wget	파일 다운로드
curl	HTTP 요청과 API 테스트
fzf	터미널 fuzzy finder
ripgrep	빠른 텍스트 검색
bat	보기 좋은 cat 대체 도구
eza	보기 좋은 ls 대체 도구
jq	JSON 가공
tree	폴더 구조 확인

설치 후 버전을 확인한다.

git --version
node --version
npm --version
python3 --version
gh --version

Node 버전이 잘 출력되면 기본 JavaScript 개발환경은 준비된 것이다.

6. Homebrew로 GUI 앱 설치

Homebrew는 터미널 패키지만 설치하는 도구가 아니다. --cask 옵션을 사용하면 macOS 앱도 설치할 수 있다.

개발자라면 아래 앱들을 추천한다.

brew install --cask iterm2
brew install --cask visual-studio-code
brew install --cask cursor
brew install --cask raycast
brew install --cask rectangle
brew install --cask orbstack
brew install --cask postman
brew install --cask tableplus

각 앱의 용도는 다음과 같다.

앱	용도
iTerm2	기본 터미널 대체
Visual Studio Code	메인 코드 에디터
Cursor	AI 코딩 에디터
Raycast	런처, 스니펫, 생산성 도구
Rectangle	창 정렬
OrbStack	Docker 대체 개발 컨테이너 환경
Postman	API 테스트
TablePlus	DB 클라이언트

Docker Desktop을 선호한다면 OrbStack 대신 아래를 설치해도 된다.

brew install --cask docker

개인 프로젝트 위주라면 OrbStack이 가볍고 편한 경우가 많다. 회사나 팀에서 Docker Desktop을 표준으로 쓴다면 Docker Desktop을 쓰는 편이 좋다.

7. iTerm2 설치와 기본 세팅

iTerm2는 macOS 기본 터미널보다 기능이 많고 개발자에게 익숙한 터미널 앱이다.

Homebrew로 설치했다면 Launchpad나 Spotlight에서 iTerm을 검색해 실행하면 된다.

open -a iTerm

iTerm2에서 가장 먼저 확인할 설정은 다음이다.

7-1. 기본 프로필 설정

iTerm2를 실행한 뒤 아래 경로로 이동한다.

iTerm2 → Settings → Profiles

여기서 기본 프로필을 하나 정해두면 된다. 처음에는 Default 프로필을 그대로 써도 충분하다.

7-2. 개발자용 폰트 설치

개발자용 폰트는 터미널과 에디터의 가독성에 직접 영향을 준다. 특히 Powerlevel10k나 아이콘이 들어간 프롬프트를 쓴다면 Nerd Font 계열을 설치하는 것이 좋다.

먼저 MesloLGS Nerd Font를 설치한다.

brew install --cask font-meslo-lg-nerd-font

JetBrains Mono Nerd Font도 추천한다.

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

선택지는 아래처럼 정리할 수 있다.

폰트	추천 이유
MesloLGS NF	Powerlevel10k와 궁합이 좋음
JetBrains Mono Nerd Font	가독성이 좋고 개발자에게 인기
FiraCode Nerd Font	ligature를 선호하는 사람에게 좋음
SF Mono	macOS 기본 감성과 잘 맞음

Fira Code도 설치하고 싶다면 아래 명령어를 사용한다.

brew install --cask font-fira-code-nerd-font

7-3. iTerm2 폰트 설정

아래 경로로 이동한다.

iTerm2 → Settings → Profiles → Text → Font

설치한 폰트 중 하나를 선택한다.

추천은 다음과 같다.

환경	추천 폰트
Powerlevel10k 사용	MesloLGS NF
VS Code와 통일감	JetBrainsMono Nerd Font
ligature 선호	FiraCode Nerd Font
깔끔한 기본 느낌	SF Mono

7-4. 폰트 크기 추천

개인적으로는 아래 정도를 추천한다.

환경	추천 크기
맥북에어 13인치	13~14
맥북프로 14인치	13~14
맥북프로 16인치	14~15
외부 모니터	14~16

너무 작게 설정하면 오래 코딩할 때 눈이 피곤하다. 처음에는 14 정도로 시작하는 것이 무난하다.

7-5. Natural Text Editing 설정

터미널에서 Option + 방향키로 단어 단위 이동이 되지 않으면 굉장히 불편하다.

iTerm2에서 아래 경로로 이동한다.

iTerm2 → Settings → Profiles → Keys → Key Mappings

여기서 Presets를 눌러 아래 옵션을 선택한다.

Natural Text Editing

이 설정을 적용하면 Option + 좌우 방향키로 단어 단위 이동이 가능해진다.

7-6. Hotkey Window 설정

iTerm2의 좋은 기능 중 하나는 단축키로 터미널을 바로 띄우는 Hotkey Window다.

아래 경로로 이동한다.

iTerm2 → Settings → Keys → Hotkey

여기서 Create a Dedicated Hotkey Window를 설정한다.

추천 단축키는 다음 중 하나다.

단축키	특징
Option + Space	빠르게 열기 좋음
Control + Space	충돌이 적으면 좋음
Command + Option + Space	다른 앱과 충돌이 적음

단축키가 Raycast, Spotlight와 충돌할 수 있으니 본인 환경에 맞게 조정하면 된다.

7-7. iTerm2 최소 추천 설정

아래 설정 정도만 해도 충분히 편하다.

설정	추천
Font	MesloLGS NF 또는 JetBrainsMono Nerd Font
Font Size	14
Cursor	Vertical Bar 또는 Box
Natural Text Editing	On
Hotkey Window	On
Transparency	과하지 않게, 0~10% 수준
Bell Sound	Off

터미널은 예쁘게 꾸미는 것도 좋지만, 오래 써야 하므로 가독성이 가장 중요하다.

8. zsh 확인

macOS는 기본 쉘이 zsh다.

현재 쉘을 확인한다.

echo $SHELL

대부분 아래처럼 나온다.

/bin/zsh

zsh 버전 확인:

zsh --version

기본 쉘이 zsh가 아니라면 아래 명령어로 변경할 수 있다.

chsh -s /bin/zsh

변경 후 터미널을 완전히 종료했다가 다시 연다.

9. Oh My Zsh 설치

Oh My Zsh는 zsh 설정을 쉽게 관리할 수 있게 해주는 프레임워크다.

설치 명령어는 다음과 같다.

sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"

설치가 끝나면 ~/.zshrc 파일이 생성된다.

파일을 열어본다.

code ~/.zshrc

아직 VS Code의 code 명령어를 설정하지 않았다면 아래 명령어를 사용해도 된다.

nano ~/.zshrc

10. Powerlevel10k 설치

Powerlevel10k는 zsh 프롬프트 테마 중 가장 많이 쓰이는 테마 중 하나다.

아래 명령어로 설치한다.

git clone --depth=1 https://github.com/romkatv/powerlevel10k.git \
${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k

~/.zshrc 파일에서 ZSH_THEME 값을 아래처럼 바꾼다.

ZSH_THEME="powerlevel10k/powerlevel10k"

저장 후 터미널을 재시작하거나 아래 명령어를 실행한다.

source ~/.zshrc

처음 실행하면 Powerlevel10k 설정 마법사가 뜬다.

설정 마법사를 다시 실행하고 싶다면 아래 명령어를 사용한다.

p10k configure

추천 설정은 다음과 같다.

항목	추천
Prompt Style	Lean 또는 Classic
Character Set	Unicode
Show Current Time	No 또는 24-hour format
Prompt Height	One line
Prompt Spacing	Sparse
Icons	Many icons

처음에는 너무 화려하게 꾸미기보다, Git 브랜치와 현재 경로가 잘 보이는 정도면 충분하다.

11. zsh 추천 플러그인 설치

터미널 생산성을 올려주는 플러그인도 설치한다.

11-1. zsh-autosuggestions

이전에 입력했던 명령어를 회색으로 추천해주는 플러그인이다.

git clone https://github.com/zsh-users/zsh-autosuggestions \
${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions

11-2. zsh-syntax-highlighting

명령어 문법을 색상으로 표시해주는 플러그인이다. 잘못된 명령어를 입력했을 때 눈에 잘 보인다.

git clone https://github.com/zsh-users/zsh-syntax-highlighting.git \
${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting

11-3. ~/.zshrc 플러그인 설정

~/.zshrc 파일을 연다.

code ~/.zshrc

아래 줄을 찾는다.

plugins=(git)

다음처럼 변경한다.

plugins=(
  git
  gh
  npm
  node
  python
  zsh-autosuggestions
  zsh-syntax-highlighting
)

저장 후 적용한다.

source ~/.zshrc

12. 터미널 alias 설정

자주 쓰는 명령어는 alias로 줄여두면 편하다.

~/.zshrc 맨 아래에 추가한다.

# Git
alias gs="git status"
alias ga="git add"
alias gc="git commit"
alias gp="git push"
alias gl="git log --oneline --graph --decorate --all"

# Directory
alias ll="eza -al --icons"
alias la="eza -a --icons"
alias lt="eza --tree --level=2 --icons"

# Utilities
alias cat="bat"
alias cls="clear"

# Node
alias ni="npm install"
alias nr="npm run"
alias nrd="npm run dev"
alias nrb="npm run build"

# Homebrew
alias bu="brew update && brew upgrade && brew cleanup"

적용한다.

source ~/.zshrc

이제 아래처럼 짧게 사용할 수 있다.

gs
ll
nrd
nrb

다만 회사나 팀에서 공통 스크립트를 쓸 때는 alias에 너무 의존하지 않는 것이 좋다. 내 로컬에서는 편하지만, 다른 사람 환경에서는 동작하지 않을 수 있기 때문이다.

13. fzf 설정

fzf는 터미널에서 파일, 명령어, 경로를 빠르게 찾을 수 있게 도와준다.

Homebrew로 이미 설치했다면 아래 설치 스크립트를 실행한다.

$(brew --prefix)/opt/fzf/install

설치 중에 key bindings와 fuzzy completion을 활성화할지 물어보면 y를 선택한다.

이후 터미널을 재시작한다.

대표적으로 많이 쓰는 단축키는 다음과 같다.

단축키	기능
Ctrl + R	이전 명령어 검색
Ctrl + T	파일 검색
Alt + C	디렉토리 이동

특히 Ctrl + R은 터미널 사용량이 많아질수록 매우 유용하다.

14. Git 기본 설정

새 맥북에서는 Git 사용자 정보를 먼저 설정해야 한다.

git config --global user.name "Your Name"
git config --global user.email "your-email@example.com"

예를 들어 GitHub 이메일이 chailmon@outlook.com이라면 아래처럼 설정할 수 있다.

git config --global user.name "chailmon"
git config --global user.email "chailmon@outlook.com"

기본 브랜치 이름도 설정한다.

git config --global init.defaultBranch main

추천 설정:

git config --global pull.rebase false
git config --global core.editor "code --wait"
git config --global color.ui auto

현재 설정 확인:

git config --global --list

15. GitHub CLI 로그인

GitHub CLI를 설치했다면 터미널에서 GitHub에 로그인할 수 있다.

gh auth login

보통 아래 흐름으로 진행하면 된다.

1. GitHub.com 선택
2. HTTPS 또는 SSH 선택
3. 브라우저 로그인
4. 인증 코드 입력
5. 완료 확인

로그인 상태 확인:

gh auth status

GitHub 저장소를 자주 다룬다면 gh는 꽤 편하다.

저장소를 클론할 때:

gh repo clone username/repository-name

현재 폴더를 GitHub 저장소로 만들고 싶을 때:

gh repo create

16. GitHub SSH 키 생성

GitHub에 HTTPS 비밀번호로 push하려고 하면 인증 문제가 생길 수 있다. 요즘은 SSH 키나 Personal Access Token을 쓰는 것이 일반적이다.

개발용 맥북이라면 SSH 키를 만들어두는 것을 추천한다.

먼저 기존 SSH 키가 있는지 확인한다.

ls -al ~/.ssh

새 키를 만든다.

ssh-keygen -t ed25519 -C "your-email@example.com"

예:

ssh-keygen -t ed25519 -C "chailmon@outlook.com"

중간에 저장 경로를 물어보면 기본값으로 Enter를 누르면 된다.

SSH agent를 실행한다.

eval "$(ssh-agent -s)"

키를 등록한다.

ssh-add ~/.ssh/id_ed25519

공개키를 복사한다.

pbcopy < ~/.ssh/id_ed25519.pub

이제 GitHub에서 아래 경로로 이동한다.

GitHub → Settings → SSH and GPG keys → New SSH key

복사한 키를 붙여넣고 저장한다.

연결 테스트:

ssh -T git@github.com

정상적으로 연결되면 아래와 비슷한 메시지가 나온다.

Hi username! You've successfully authenticated, but GitHub does not provide shell access.

17. VS Code 설치

VS Code는 Homebrew로 설치하는 것이 가장 간단하다.

brew install --cask visual-studio-code

설치 후 앱을 실행한다.

open -a "Visual Studio Code"

터미널에서 code . 명령어를 쓰려면 VS Code 안에서 설정해야 한다.

VS Code를 실행한 뒤:

1. Cmd + Shift + P
2. Shell Command 검색
3. Shell Command: Install 'code' command in PATH 선택
4. 터미널 재시작

이후 프로젝트 폴더에서 아래 명령어를 사용할 수 있다.

code .

확인:

code --version

18. VS Code 기본 설정

VS Code에서 settings.json을 열려면:

1. Cmd + Shift + P
2. Preferences: Open User Settings (JSON) 검색
3. 열기

아래 설정을 기본값으로 추천한다.

{
  "editor.fontFamily": "JetBrainsMono Nerd Font, MesloLGS NF, Menlo, Monaco, 'Courier New', monospace",
  "editor.fontSize": 14,
  "editor.lineHeight": 1.6,
  "editor.tabSize": 2,
  "editor.wordWrap": "on",
  "editor.minimap.enabled": false,
  "editor.renderWhitespace": "boundary",
  "editor.formatOnSave": true,
  "editor.formatOnPaste": false,
  "editor.codeActionsOnSave": {
    "source.fixAll.eslint": "explicit"
  },
  "files.autoSave": "afterDelay",
  "files.autoSaveDelay": 1000,
  "files.trimTrailingWhitespace": true,
  "files.insertFinalNewline": true,
  "terminal.integrated.fontFamily": "MesloLGS NF",
  "terminal.integrated.fontSize": 13,
  "terminal.integrated.defaultProfile.osx": "zsh",
  "workbench.startupEditor": "none",
  "workbench.editor.labelFormat": "short",
  "explorer.confirmDelete": false,
  "explorer.confirmDragAndDrop": false,
  "breadcrumbs.enabled": true,
  "git.confirmSync": false,
  "git.autofetch": true,
  "security.workspace.trust.untrustedFiles": "open"
}

개인적으로는 minimap을 끄는 편을 추천한다. 화면이 좁은 맥북에서는 오른쪽 미니맵보다 실제 코드 영역이 더 중요하다.

19. VS Code 추천 확장 프로그램

VS Code 확장 프로그램은 너무 많이 설치하면 오히려 느려질 수 있다. 처음에는 꼭 필요한 것 위주로 설치하는 것이 좋다.

터미널에서 한 번에 설치하려면 아래 명령어를 사용할 수 있다.

19-1. 공통 개발 확장 프로그램

code --install-extension eamodio.gitlens
code --install-extension usernamehw.errorlens
code --install-extension esbenp.prettier-vscode
code --install-extension dbaeumer.vscode-eslint
code --install-extension wayou.vscode-todo-highlight
code --install-extension gruntfuggly.todo-tree

Extension	용도
GitLens	Git 히스토리와 blame 확인
Error Lens	에러를 코드 줄에 바로 표시
Prettier	코드 포맷팅
ESLint	JavaScript / TypeScript 린팅
TODO Highlight	TODO 주석 강조
Todo Tree	TODO 목록 탐색

19-2. 웹 개발 확장 프로그램

code --install-extension bradlc.vscode-tailwindcss
code --install-extension formulahendry.auto-rename-tag
code --install-extension christian-kohler.path-intellisense
code --install-extension naumovs.color-highlight

Extension	용도
Tailwind CSS IntelliSense	Tailwind 클래스 자동완성
Auto Rename Tag	HTML/JSX 태그 동시 수정
Path Intellisense	파일 경로 자동완성
Color Highlight	색상 코드 미리보기

19-3. Astro / MDX 블로그용 확장 프로그램

Astro 블로그를 운영한다면 아래 확장 프로그램은 거의 필수에 가깝다.

code --install-extension astro-build.astro-vscode
code --install-extension unifiedjs.vscode-mdx
code --install-extension yzhang.markdown-all-in-one

Extension	용도
Astro	Astro 문법 지원
MDX	MDX 문법 지원
Markdown All in One	마크다운 작성 보조

네 블로그가 Astro 기반이라면 이 부분은 꼭 세팅해두는 것이 좋다.

관련 글: VS Code로 Astro 블로그 관리하는 방법

19-4. AI 코딩 확장 프로그램

AI 코딩을 적극적으로 쓴다면 아래도 고려할 수 있다.

code --install-extension github.copilot
code --install-extension github.copilot-chat
code --install-extension continue.continue

Extension	용도
GitHub Copilot	코드 자동완성
GitHub Copilot Chat	VS Code 안에서 AI 채팅
Continue	로컬/외부 LLM 연동 개발 보조

Cursor를 메인으로 쓴다면 VS Code에 AI 확장 프로그램을 너무 많이 설치하지 않아도 된다. VS Code는 일반 개발과 블로그 관리용, Cursor는 AI 코딩용으로 나눠 쓰는 것도 좋은 방식이다.

관련 글: Claude Code vs Cursor 비교 정리

20. VS Code 추천 단축키

맥북에서 자주 쓰는 단축키는 아래 정도만 먼저 익혀도 충분하다.

단축키	기능
Cmd + P	파일 빠르게 열기
Cmd + Shift + P	명령 팔레트
Cmd + B	사이드바 열기/닫기
Cmd + J	터미널 열기/닫기
Cmd + Shift + F	전체 검색
Cmd + /	주석 처리
Option + Shift + F	문서 포맷팅
Control + ~	터미널 포커스 전환

VS Code는 확장 프로그램보다 단축키를 잘 쓰는 것이 생산성에 더 큰 영향을 준다.

21. Node 개발환경 점검

Astro, Next.js, React, Vite 같은 프론트엔드 개발을 한다면 Node 환경이 중요하다.

Homebrew로 Node를 설치했다면 버전을 확인한다.

node --version
npm --version

간단한 테스트 프로젝트를 만들어본다.

mkdir -p ~/Dev/playground
cd ~/Dev/playground
npm create vite@latest test-vite-app
cd test-vite-app
npm install
npm run dev

브라우저에서 안내된 주소를 열어 정상적으로 실행되는지 확인한다.

Astro 프로젝트라면 아래처럼 테스트할 수 있다.

cd ~/Dev/playground
npm create astro@latest test-astro-app
cd test-astro-app
npm install
npm run dev

기존 Astro 블로그를 클론했다면 보통 아래 순서로 확인한다.

git clone git@github.com:사용자명/저장소명.git
cd 저장소명
npm install
npm run build
npm run dev

빌드가 성공하면 기본 개발환경은 정상적으로 잡힌 것이다.

22. Python 개발환경 점검

Python도 기본적으로 설치해둔다.

python3 --version
pip3 --version

테스트용 가상환경을 만든다.

mkdir -p ~/Dev/playground/python-test
cd ~/Dev/playground/python-test
python3 -m venv .venv
source .venv/bin/activate

프롬프트 앞에 (.venv)가 보이면 가상환경이 활성화된 것이다.

간단히 패키지를 설치해본다.

python -m pip install requests
python -c "import requests; print(requests.__version__)"

가상환경 종료:

deactivate

macOS에서는 전역 pip install을 무리하게 쓰기보다 프로젝트마다 가상환경을 만들어 쓰는 편이 안전하다.

23. 개발 폴더 구조 추천

새 맥북에서는 개발 폴더를 하나로 정리해두는 것이 좋다.

개인적으로는 아래 구조를 추천한다.

mkdir -p ~/Dev/projects
mkdir -p ~/Dev/playground
mkdir -p ~/Dev/archive

용도는 다음과 같다.

폴더	용도
~/Dev/projects	실제 운영 프로젝트
~/Dev/playground	테스트, 실험용 프로젝트
~/Dev/archive	예전 프로젝트 백업

예를 들어 블로그 프로젝트는 아래처럼 둘 수 있다.

~/Dev/projects/chailmon-blog

이런 식으로 정리해두면 AI 코딩툴이나 터미널에서도 경로를 찾기 쉽다.

24. Raycast 세팅

Raycast는 Spotlight를 대체할 수 있는 런처 앱이다.

Homebrew로 설치했다면 실행한다.

open -a Raycast

처음 실행하면 macOS 권한을 요청할 수 있다. 안내에 따라 접근성 권한을 부여한다.

추천 단축키는 다음과 같다.

System Settings → Keyboard → Keyboard Shortcuts → Spotlight

기존 Spotlight 단축키인 Cmd + Space를 끄고, Raycast를 Cmd + Space로 설정하는 방식을 많이 쓴다.

Raycast에서 추천하는 기능은 다음과 같다.

• 앱 빠르게 실행
• Clipboard History
• Snippets
• Window Management
• Quicklinks
• Calculator
• GitHub 검색
• Notion / Google Drive 검색

개발자에게는 특히 Clipboard History와 Snippets가 유용하다.

자주 쓰는 명령어를 Snippet으로 저장해두면 좋다.

npm run build

git status
git add .
git commit -m ""
git push

25. Rectangle 세팅

Rectangle은 창 정렬 앱이다.

설치 후 실행한다.

open -a Rectangle

추천 단축키는 기본값을 그대로 써도 충분하다.

자주 쓰는 기능:

기능	용도
Left Half	화면 왼쪽 절반
Right Half	화면 오른쪽 절반
Maximize	창 최대화
Center	중앙 정렬
Next Display	외부 모니터 이동

맥북 화면만 사용할 때도 VS Code와 브라우저를 좌우로 나눌 수 있어 유용하다.

26. OrbStack 또는 Docker Desktop 세팅

백엔드 개발, DB 테스트, 로컬 컨테이너 개발을 한다면 Docker 환경이 필요할 수 있다.

가벼운 대안을 원하면 OrbStack을 추천한다.

brew install --cask orbstack

실행:

open -a OrbStack

Docker CLI가 정상인지 확인한다.

docker --version
docker compose version

간단한 테스트:

docker run hello-world

회사나 팀에서 Docker Desktop을 표준으로 쓰면 아래를 설치한다.

brew install --cask docker

개인 프로젝트 위주라면 OrbStack이 가볍고 편한 경우가 많다.

27. VS Code와 터미널에서 프로젝트 열기

예를 들어 블로그 프로젝트가 아래 경로에 있다고 가정한다.

~/Dev/projects/chailmon-blog

터미널에서 이동한다.

cd ~/Dev/projects/chailmon-blog

VS Code로 연다.

code .

의존성 설치:

npm install

빌드 테스트:

npm run build

개발 서버 실행:

npm run dev

브라우저에서 확인:

http://localhost:4321

Astro 블로그를 운영한다면 이 흐름은 거의 매일 쓰게 된다.

28. 새 맥북 세팅 체크리스트

아래 체크리스트를 보면서 빠진 것이 없는지 확인하면 좋다.

# macOS
sw_vers
uname -m

# Xcode CLI
xcode-select -p

# Homebrew
brew --version
brew doctor

# Git
git --version
git config --global --list

# GitHub CLI
gh --version
gh auth status

# Node
node --version
npm --version

# Python
python3 --version
pip3 --version

# VS Code
code --version

# Docker or OrbStack
docker --version
docker compose version

모두 정상적으로 나오면 기본 개발환경은 꽤 안정적으로 준비된 것이다.

29. Homebrew 설치 목록 백업

새 맥북을 다시 세팅하거나 다른 장비로 옮길 때를 대비해 Homebrew 설치 목록을 백업해두면 좋다.

현재 설치한 패키지 목록:

brew list

Brewfile 생성:

brew bundle dump --file=~/Brewfile --force

나중에 새 맥에서 같은 패키지를 설치하려면:

brew bundle --file=~/Brewfile

Brewfile을 GitHub private repo나 개인 백업 폴더에 보관해두면 장비 교체가 훨씬 쉬워진다.

30. 내가 추천하는 최소 세팅 조합

처음부터 너무 많은 도구를 설치하기 싫다면 아래 조합만 먼저 추천한다.

brew install git gh node python fzf ripgrep bat eza jq tree
brew install --cask iterm2 visual-studio-code raycast rectangle
brew install --cask font-meslo-lg-nerd-font font-jetbrains-mono-nerd-font

AI 코딩까지 고려한다면 추가로:

brew install --cask cursor

컨테이너 개발이 필요하다면:

brew install --cask orbstack

API와 DB 작업이 많다면:

brew install --cask postman tableplus

이 정도면 대부분의 개인 개발, 웹 개발, 블로그 운영, AI 코딩 실험에는 충분하다.

31. 맥북에어와 맥북프로 개발환경 차이

세팅 방식은 맥북에어와 맥북프로가 거의 같다.

다만 사용 경험은 조금 다르다.

항목	맥북에어	맥북프로
휴대성	매우 좋음	좋음
장시간 빌드	팬리스 모델은 발열 관리 필요	더 안정적
외부 모니터	일반 개발에는 충분	멀티 모니터에 더 유리
AI 코딩툴	충분히 가능	더 여유 있음
Docker / VM	가벼운 개발은 가능	더 적합

프론트엔드, 블로그, 일반 웹 개발 중심이라면 맥북에어도 충분하다.

Docker, 로컬 DB, 백엔드, 모바일 빌드, 대규모 프로젝트를 자주 다룬다면 맥북프로가 더 편하다.

개인적으로 2026년 기준 개발용 맥북을 고른다면 최소 RAM은 16GB 이상을 추천한다. 여유가 된다면 24GB 또는 32GB가 더 좋다.

32. 피해야 할 세팅 방식

새 맥북을 세팅할 때 아래는 피하는 것이 좋다.

32-1. 아무 앱이나 수동으로 설치하기

처음에는 편하지만 나중에 새 장비로 옮길 때 귀찮아진다. 가능하면 Homebrew로 설치하고, Brewfile로 백업할 수 있게 만드는 것이 좋다.

32-2. 전역 npm 패키지를 너무 많이 설치하기

전역 패키지가 많아지면 버전 충돌이 생길 수 있다. 가능하면 프로젝트별 package.json에 의존성을 명시하는 편이 좋다.

32-3. 설정 파일을 백업하지 않기

~/.zshrc, VS Code settings.json, Brewfile 정도는 백업해두면 좋다.

추천 백업 대상:

~/.zshrc
~/.p10k.zsh
~/Brewfile
VS Code settings.json

32-4. 터미널을 너무 화려하게 꾸미기

처음에는 재미있지만, 느려지거나 가독성이 떨어지면 오히려 생산성이 떨어진다. 개발환경은 예쁜 것보다 빠르고 안정적인 것이 우선이다.

마무리

새 맥북을 개발용으로 세팅할 때 중요한 것은 “많이 설치하는 것”이 아니다.

중요한 것은 매일 쓰는 흐름을 안정적으로 만드는 것이다.

내 기준에서 핵심은 세 가지다.

1. Homebrew로 설치와 관리를 통일한다.
2. iTerm2와 zsh를 편하게 세팅한다.
3. VS Code를 가볍고 빠르게 유지한다.

여기에 GitHub SSH, Node, Python, Raycast, Rectangle 정도만 잘 잡아도 새 맥북은 꽤 훌륭한 개발 머신이 된다.

AI 코딩툴을 쓰는 시대에도 로컬 개발환경의 중요성은 줄어들지 않는다. 오히려 더 중요해지고 있다.

AI가 코드를 빠르게 만들어줄수록, 개발자는 그 코드를 실행하고, 테스트하고, 배포할 수 있는 안정적인 환경을 갖추고 있어야 한다.

새 맥북을 샀다면 이 글을 체크리스트처럼 보면서 하나씩 세팅해보면 된다.

---

참고한 공식 문서

• Homebrew 공식 사이트
• Homebrew 설치 문서
• iTerm2 공식 사이트
• iTerm2 Hotkey 문서
• VS Code macOS 설치 문서
• VS Code Command Line 문서
• Oh My Zsh 공식 사이트
• Powerlevel10k GitHub
• zsh-autosuggestions 설치 문서
• zsh-syntax-highlighting GitHub