맥북 처음 쓰는 개발자를 위한 세팅 가이드

🍎 macOS Setup Guide

맥북 처음 쓰는 개발자를 위한
완벽 세팅 가이드

Homebrew부터 터미널 커스터마이징, VS Code, Git까지 — 개발 환경을 처음부터 끝까지 한 번에 잡아보세요.

⏱ 읽는 시간 약 10분 🎯 대상: 맥북 입문 개발자 🗓 2025년 기준

📋 목차

1. 맥북 구매 후 가장 먼저 할 설정
2. Homebrew 설치 — 맥의 필수 패키지 매니저
3. 터미널 업그레이드 — iTerm2 + Oh My Zsh
4. Git 설정
5. VS Code 설치 & 추천 익스텐션
6. 개발 언어별 환경 설정 (Python / Node.js / Java)
7. 개발자 필수 앱 추천
8. 맥북 꿀팁 단축키 모음

01

맥북 구매 후 가장 먼저 할 설정

처음 맥북을 켜면 설정해야 할 것들이 많아 막막할 수 있어요. 개발 환경을 쾌적하게 만들기 위해 아래 순서대로 진행해보세요.

• 1
  macOS 최신 버전으로 업데이트 시스템 환경설정 → 소프트웨어 업데이트에서 최신 버전으로 올려줍니다. 보안 패치와 성능 개선이 포함되어 있어요.
• 2
  Xcode Command Line Tools 설치 터미널을 열고 아래 명령어를 실행하세요. Homebrew를 비롯한 대부분의 개발 도구가 이걸 필요로 해요.

Terminal

xcode-select --install

• 3
  트랙패드 & 키보드 설정 최적화 시스템 설정 → 트랙패드에서 탭하여 클릭을 켜고, 스크롤 방향은 취향에 맞게 조정하세요. 키보드는 키 반복 속도를 최대로 올려두면 코딩할 때 훨씬 편해요.
• 4
  파일 확장자 & 숨김 파일 표시 Finder에서 Cmd + Shift + . 을 누르면 숨김 파일이 보여요. 개발할 때 .env, .gitignore 같은 숨김 파일을 자주 확인하게 됩니다.

💡

Finder 설정 꿀팁: Finder 환경설정 → 고급에서 "모든 파일 확장자 보기"를 체크해두세요. 파일 종류를 한눈에 구별하기 훨씬 쉬워집니다.

02

Homebrew 설치 — 맥의 필수 패키지 매니저

윈도우에 winget이 있다면, 맥에는 Homebrew가 있어요. 거의 모든 개발 도구를 터미널 명령어 한 줄로 설치할 수 있게 해주는 패키지 매니저입니다. 맥북 개발 환경의 시작점이라고 볼 수 있어요.

Terminal — Homebrew 설치

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

# M1/M2/M3 칩 맥북은 설치 후 PATH 추가 필수!
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"

# 설치 확인
brew --version

📦 Homebrew 자주 쓰는 명령어

명령어	설명
brew install 패키지명	패키지 설치
brew uninstall 패키지명	패키지 삭제
brew update	Homebrew 자체 업데이트
brew upgrade	설치된 패키지 전체 업데이트
brew list	설치된 패키지 목록 확인
brew install --cask 앱이름	GUI 앱 설치 (예: VS Code, Chrome)

✅

M1/M2/M3 칩 주의: 인텔 맥은 /usr/local에, Apple Silicon 맥은 /opt/homebrew에 설치돼요. PATH 설정을 빠뜨리면 brew: command not found 오류가 나니 꼭 챙겨주세요.

03

터미널 업그레이드 — iTerm2 + Oh My Zsh

기본 터미널도 쓸 수 있지만, iTerm2와 Oh My Zsh를 함께 쓰면 자동완성, 컬러 테마, Git 상태 표시 등이 추가되어 생산성이 크게 올라가요.

Terminal — iTerm2 + Oh My Zsh 설치

# 1. iTerm2 설치 (Homebrew로 한 방에)
brew install --cask iterm2

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

# 3. 인기 테마 Powerlevel10k 설치
git clone --depth=1 https://github.com/romkatv/powerlevel10k.git \
  ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k

# 4. ~/.zshrc 에서 테마 변경
ZSH_THEME="powerlevel10k/powerlevel10k"

🔌 유용한 Oh My Zsh 플러그인

🔍

zsh-autosuggestions

이전에 입력했던 명령어를 흐릿하게 미리 보여줘요. Tab으로 바로 완성!

무료

🌈

zsh-syntax-highlighting

명령어가 올바르면 초록색, 틀리면 빨간색으로 보여줘요.

무료

📁

z

자주 가는 폴더를 기억해서 z 폴더명만으로 이동 가능해요.

무료

~/.zshrc — 플러그인 추가

# 플러그인 설치
brew install zsh-autosuggestions zsh-syntax-highlighting

# ~/.zshrc의 plugins 줄을 아래처럼 수정
plugins=(git z zsh-autosuggestions zsh-syntax-highlighting)

# 적용
source ~/.zshrc

04

Git 설정

맥에는 기본 Git이 설치되어 있지만, Homebrew로 최신 버전을 따로 설치하는 걸 추천해요. 그 다음 기본 사용자 정보와 SSH 키를 설정해두면 GitHub 연동이 훨씬 편해집니다.

Terminal — Git 설정

# 최신 Git 설치
brew install git

# 사용자 정보 등록 (GitHub 계정 정보와 동일하게)
git config --global user.name "Your Name"
git config --global user.email "your@email.com"

# 기본 브랜치명 main으로 설정
git config --global init.defaultBranch main

# SSH 키 생성 (GitHub 연동용)
ssh-keygen -t ed25519 -C "your@email.com"

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

🔑

SSH 키 등록 방법: GitHub 로그인 → Settings → SSH and GPG keys → New SSH key에서 복사한 키를 붙여넣으면 돼요. 이후엔 매번 비밀번호 없이 push/pull이 가능해집니다.

05

VS Code 설치 & 추천 익스텐션

VS Code는 현재 가장 많이 쓰이는 코드 에디터예요. Homebrew로 간단하게 설치할 수 있고, 터미널에서 바로 열 수 있도록 code 명령어도 등록해두세요.

Terminal — VS Code 설치

# VS Code 설치
brew install --cask visual-studio-code

# 터미널에서 'code .' 명령어로 바로 열기 위한 PATH 등록
# VS Code 내부에서 Cmd+Shift+P → "Shell Command: Install 'code' command" 실행

🧩 필수 익스텐션 추천

🤖

GitHub Copilot

AI가 코드를 자동 완성해줘요. 학생은 무료로 사용 가능!

학생무료

🎨

Prettier

저장할 때마다 코드 스타일을 자동으로 정리해줘요.

무료

🐍

Python (ms-python)

파이썬 개발 필수. 자동완성, 디버깅, 린팅 모두 지원.

무료

🌿

GitLens

코드 한 줄 한 줄이 누가 언제 작성했는지 바로 보여줘요.

무료/유료

🖼

Material Icon Theme

파일 아이콘을 예쁘게 바꿔줘서 파일 구분이 훨씬 쉬워요.

무료

🔴

Error Lens

오류 메시지를 코드 줄 옆에 바로 표시해줘요.

무료

06

개발 언어별 환경 설정

🐍 Python

맥에는 파이썬이 기본 설치되어 있지만, 버전 관리를 위해 pyenv를 사용하는 걸 추천해요. 프로젝트마다 다른 버전을 쉽게 전환할 수 있어요.

Python 환경 설정

brew install pyenv
# ~/.zshrc에 추가
export PYENV_ROOT="$HOME/.pyenv"
export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init -)"

# 파이썬 설치 및 전역 버전 지정
pyenv install 3.12.0
pyenv global 3.12.0

⬡ Node.js

Node.js도 버전 관리 도구인 nvm을 먼저 설치하고, 그 다음에 Node를 설치하는 방식을 권장해요.

Node.js 환경 설정

brew install nvm
# ~/.zshrc에 추가
export NVM_DIR="$HOME/.nvm"
[ -s "/opt/homebrew/opt/nvm/nvm.sh" ] && \. "/opt/homebrew/opt/nvm/nvm.sh"

# LTS 버전 설치
nvm install --lts
nvm use --lts

☕ Java

Java 환경 설정

# OpenJDK 설치 (Temurin 배포판 추천)
brew install --cask temurin

# 버전 확인
java -version

07

개발자 필수 앱 추천

🐙

GitHub Desktop

GUI로 Git을 관리할 수 있어요. 터미널이 아직 낯선 분들에게 추천.

무료

🐳

Docker Desktop

컨테이너 기반 개발 환경. 팀 프로젝트 시작 시 필수.

무료/유료

📮

Postman

API 테스트 도구. 백엔드 개발 시 없으면 안 됩니다.

무료/유료

🗄

TablePlus

DB 클라이언트. MySQL, PostgreSQL, SQLite 모두 지원해요.

무료/유료

📝

Notion

개발 일지, 스터디 노트, 프로젝트 관리까지 한 번에.

무료

🔲

Rectangle

창 크기를 단축키로 딱딱 맞춰줘요. 윈도우 snap 기능과 유사.

무료

💡

Homebrew로 한 번에 설치하기: brew install --cask github docker postman tableplus notion rectangle 명령어 한 줄로 위 앱 전부를 설치할 수 있어요!

08

맥북 개발자 필수 단축키 모음

단축키	기능
Cmd + Space	Spotlight 검색 (앱 실행, 파일 검색)
Cmd + Tab	앱 전환
Cmd + `	같은 앱 내 창 전환
Cmd + Shift + 4	영역 선택 스크린샷
Cmd + Shift + 5	화면 녹화 & 스크린샷 옵션
Ctrl + A / E	터미널에서 줄 맨 앞 / 맨 뒤로 이동
Ctrl + U	터미널에서 현재 줄 전체 삭제
Cmd + D	VS Code에서 같은 단어 동시 선택
Option + 클릭	VS Code 멀티 커서

⚠️

윈도우 유저 주의: 맥에서는 Ctrl 대신 Cmd를 주로 사용해요. 복사는 Cmd+C, 붙여넣기는 Cmd+V. 처음엔 헷갈리지만 금방 익숙해져요!

🎉 이제 개발 준비 완료!

Homebrew → 터미널 → Git → VS Code → 언어 환경 순서로 세팅하면
어떤 프로젝트든 바로 시작할 수 있어요.

궁금한 점이나 더 추가되었으면 하는 내용이 있다면 댓글로 남겨주세요 😊