logoRawon_Log
홈블로그소개

Built with Next.js, Bun, Tailwind CSS and Shadcn/UI

Web

MacOS 개발환경 초기 설정 가이드

Rawon
2025년 8월 27일
목차
MacOS 개발환경 초기 설정 가이드
Finder 설정
모든 파일 확장자 보기
시스템 환경설정
키보드
잠금화면
필수 프로그램 설치 목록
업무용 및 개인 프로그램
개발 도구 설치 가이드
Homebrew 설치
Git 설정
NVM 및 Node.js 설치
iTerm2 설치
Oh My Zsh 설치
Powerlevel10k 테마 설치
터미널 확장 기능
Zsh-Autosuggestions (명령어 자동완성)
Zsh-Syntax-Highlighting (명령어 구문 강조)
Claude Code 설치
Vim 기본 명령어
기본 모드
필수 명령어
.zshrc 편집 예시
PATH 설정 이해하기
PATH란?
.zshrc vs .zprofile
PATH 등록 방법
설치 후 확인사항
모든 도구 설치 확인
터미널 재시작 후 테스트
유용한 추가 설정
터미널 별칭(Alias) 설정
Mac 윈도우 타일 정렬
마무리

목차

MacOS 개발환경 초기 설정 가이드
Finder 설정
모든 파일 확장자 보기
시스템 환경설정
키보드
잠금화면
필수 프로그램 설치 목록
업무용 및 개인 프로그램
개발 도구 설치 가이드
Homebrew 설치
Git 설정
NVM 및 Node.js 설치
iTerm2 설치
Oh My Zsh 설치
Powerlevel10k 테마 설치
터미널 확장 기능
Zsh-Autosuggestions (명령어 자동완성)
Zsh-Syntax-Highlighting (명령어 구문 강조)
Claude Code 설치
Vim 기본 명령어
기본 모드
필수 명령어
.zshrc 편집 예시
PATH 설정 이해하기
PATH란?
.zshrc vs .zprofile
PATH 등록 방법
설치 후 확인사항
모든 도구 설치 확인
터미널 재시작 후 테스트
유용한 추가 설정
터미널 별칭(Alias) 설정
Mac 윈도우 타일 정렬
마무리

MacOS 개발환경 초기 설정 가이드

MacOS에서 개발자를 위한 필수 프로그램 설치 및 환경 설정 방법을 정리한 가이드입니다.

Finder 설정

모든 파일 확장자 보기

Finder를 켜고 cmd + , 를 누르면 설정 창으로 이동

"모든 파일 확장자 보기" 체크박스를 체크

시스템 환경설정

키보드

  • 키 반복 속도: 빠르게
  • 반복 지연 시간: 짧게

잠금화면

  • 화면보호기 시간 설정

필수 프로그램 설치 목록

업무용 및 개인 프로그램

  • Notion
  • Notion Calendar
  • Slack
  • Zoom
  • 카카오톡
  • Cursor
  • VSCode
  • Claude Code
  • Gemini CLI
  • Arc browser
  • Chrome
  • ⭐ Homebrew
  • iTerm2 + oh my zsh
  • Git
  • Node.js (NVM)
  • Docker
  • Python

개발 도구 설치 가이드

Homebrew 설치

Homebrew는 macOS 패키지 관리자입니다.

다음 명령을 통해 설치할 수 있습니다:

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

설치가 끝나면, 터미널에서 출력되는 Next steps의 실행 코드를 복사해서 터미널에서 실행하세요.

brew -v 명령어를 통해 Homebrew 설치를 확인할 수 있습니다.

Git 설정

Git은 프로젝트 버전관리를 위한 도구입니다.

Homebrew를 활용하여 Git을 설치합니다:

bash
brew install git

설치 후 사용자 정보를 설정합니다:

bash
git config --global 
user.name
 "YourName"
git config --global 
user.email
 "
your@email.com
"

NVM 및 Node.js 설치

NVM은 Node.js 버전 관리를 위한 도구입니다.

bash
brew install nvm

설치가 완료되면 원하는 버전의 Node.js를 설치합니다:

bash
nvm install --lts

command not found 오류가 발생한다면 아래의 환경변수 설정을 추가해야 합니다:

  1. 디렉터리 생성:
bash
mkdir ~/.nvm
  1. 환경변수 설정:
bash
echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.zshrc
echo '[ -s "$(brew --prefix)/opt/nvm/
nvm.sh
" ] && \. "$(brew --prefix)/opt/nvm/
nvm.sh
"' >> ~/.zshrc
echo '[ -s "$(brew --prefix)/opt/nvm/etc/bash_completion.d/nvm" ] && \. "$(brew --prefix)/opt/nvm/etc/bash_completion.d/nvm"' >> ~/.zshrc
  1. 적용:
bash
source ~/.zshrc

iTerm2 설치

iTerm2는 mac 내장 terminal 기능을 대체하는 강력한 도구입니다.

homebrew를 이용해서 iTerm2를 설치합니다 (GUI 애플리케이션이므로 --cask 옵션 필요):

bash
brew install --cask iterm2

Oh My Zsh 설치

Oh My Zsh는 Zsh 구성을 관리하는 프레임워크입니다.

설치 명령어:

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

Powerlevel10k 테마 설치

bash
brew install powerlevel10k

Github 저장소에서 MesloLGS NF Regular 폰트를 다운로드 후 파일을 실행하고, 터미널 설정의 프로필 탭에서 서체를 선택합니다.

.zshrc에서 ZSH_THEME 변수의 값을 변경합니다:

bash
if grep -q "^ZSH_THEME=" ${ZDOTDIR:-$HOME}/.zshrc; then 
  sed -i '' 's|^ZSH_THEME=.*|ZSH_THEME="powerlevel10k/powerlevel10k"|' ${ZDOTDIR:-$HOME}/.zshrc
else 
  echo 'ZSH_THEME="powerlevel10k/powerlevel10k"' >> ${ZDOTDIR:-$HOME}/.zshrc
fi

터미널 재시작 시 powerlevel10k 구성이 시작됩니다 (또는 p10k configure 명령 입력).

터미널 확장 기능

Zsh-Autosuggestions (명령어 자동완성)

bash
# 설치
brew install zsh-autosuggestions

# 구성
echo "source $(brew --prefix)/share/zsh-autosuggestions/zsh-autosuggestions.zsh" >> ${ZDOTDIR:-$HOME}/.zshrc

Zsh-Syntax-Highlighting (명령어 구문 강조)

bash
# 설치
brew install zsh-syntax-highlighting

# 구성
echo "source $(brew --prefix)/share/zsh-syntax-highlighting/zsh-syntax-highlighting.zsh" >> ${ZDOTDIR:-$HOME}/.zshrc

Claude Code 설치

bash
npm install -g @anthropic-ai/claude

Vim 기본 명령어

기본 모드

  • 일반 모드: Vim 시작 시 기본 모드
  • 편집 모드: i 키로 진입, 텍스트 입력 가능
  • 명령 모드: : 키로 진입, 저장/종료 등

필수 명령어

bash
# 파일 열기
vim filename.txt

# 편집 모드 진입
i          # 현재 커서 위치에서 입력
a          # 현재 커서 다음 위치에서 입력

# 편집 모드에서 나가기
ESC        # 일반 모드로 돌아가기

# 저장 및 종료
:w         # 저장
:q         # 종료
:wq        # 저장 후 종료
:q!        # 저장하지 않고 강제 종료

# 이동
h, j, k, l # 좌, 하, 상, 우 이동
gg         # 파일 맨 처음으로
G          # 파일 맨 끝으로

.zshrc 편집 예시

bash
# .zshrc 파일 편집
vim ~/.zshrc

# 1. i 키를 눌러 편집 모드 진입
# 2. 원하는 내용 수정/추가
# 3. ESC 키로 일반 모드 복귀
# 4. :wq 입력 후 Enter로 저장 및 종료

PATH 설정 이해하기

PATH란?

PATH는 시스템이 실행 파일을 찾는 경로들의 목록입니다.

echo $PATH 명령으로 현재 PATH를 확인할 수 있습니다.

.zshrc vs .zprofile

  • .zshrc: 터미널이 열릴 때마다 실행되는 설정 파일
  • .zprofile: 로그인 시에만 실행되는 설정 파일

PATH 등록 방법

bash
# 임시 PATH 등록 (현재 세션에만 적용)
export PATH="/새로운/경로:$PATH"

# 영구 PATH 등록 (.zshrc에 추가)
echo 'export PATH="/새로운/경로:$PATH"' >> ~/.zshrc
source ~/.zshrc

# 또는 vim으로 직접 편집
vim ~/.zshrc
# 맨 아래에 export PATH="/새로운/경로:$PATH" 추가

설치 후 확인사항

모든 도구 설치 확인

bash
# 버전 확인으로 설치 상태 점검
brew --version
git --version
node --version
npm --version
python3 --version
docker --version

# PATH 확인
echo $PATH
which node
which python3
which git

터미널 재시작 후 테스트

터미널을 완전히 종료 후 재시작하여 모든 명령어가 정상 작동하는지 확인하고, Oh My Zsh와 테마가 제대로 적용되었는지, 자동완성과 구문 강조 기능이 작동하는지 테스트해보세요.

유용한 추가 설정

터미널 별칭(Alias) 설정

~/.zshrc에 추가할 유용한 별칭들:

bash
echo '# 유용한 별칭들' >> ~/.zshrc
echo 'alias ll="ls -la"' >> ~/.zshrc
echo 'alias la="ls -la"' >> ~/.zshrc
echo 'alias ..="cd .."' >> ~/.zshrc
echo 'alias ...="cd ../.."' >> ~/.zshrc
echo 'alias cls="clear"' >> ~/.zshrc

source ~/.zshrc

Mac 윈도우 타일 정렬

Mac의 윈도우 타일 정렬 아이콘 및 키보드 단축키에 대한 자세한 정보는 Apple 공식 가이드를 참고하세요.

마무리

이 가이드를 통해 MacOS에서 개발자를 위한 완전한 환경을 구축할 수 있습니다. 각 도구들이 제대로 설치되었는지 확인하고, 필요에 따라 추가적인 설정을 진행하시기 바랍니다.