맥 개발자를 위한 개발 환경 구축 가이드

이번에 맥을 초기 설정할 일이 있어 정리해 본 내용 노드(Node.js) 개발자 위주로 설정이 되어 있어 불필요할 경우 생략하셔도 됨

필수 애플리케이션

패키지 관리자 - Homebrew

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

맥용 패키지 관리자로, 개발에 필요한 도구들을 간편하게 설치 할 수 있다. Linux의 apt나 yum과 같은 역할을 합니다.

키보드 매핑 - Karabiner-Elements

brew install --cask karabiner-elements

설정할 항목들:

원화(₩) → 백틱(`) 처리
Right Option → F18 (입력 소스 변경)
Left Option ↔ Left Command

백틱의 경우 한글 키보드로 설정되어 있을 때 원화가 나와 개발 흐름에 도움되지 않는 경우가 많아 변경하며, 필요 시 복사 붙여넣기로 사용하면 됩니다.

생산성 도구들

Obsidian

brew install --cask obsidian

오프라인에서도 사용할 수 있는 마크다운 형태의 노트앱 이며, 노션(Notion)을 사용하지 않고 옵시디언(Obsidian) 을 통해 관리하게 됨. 여러 플러그인을 설정하여 편하게 사용할 수 있고 Git 을 추가하여 Blog 글을 쓰고 Push 하여 블로그 Repo에 등록되게 설정해 두어 블로그글 자동화까지 사용하고 있습니다.

Rectangle

brew install --cask rectangle

맥의 기능으로도 추가되었지만 윈도우 관리에는 이만한게 없는 것 같습니다.

AltTab

brew install --cask alt-tab

Windows의 Alt+Tab과 유사한 방식으로 창 전환을 할 수 있게 해주는 오픈소스 앱입니다. 더 큰 썸네일과 시간순 정렬, 다양한 커스터마이징 옵션을 제공하여 맥의 기본 창 전환보다 훨씬 효율적입니다.

Keka

brew install --cask keka

맥용 파일 압축/압축 해제 도구로, 7Z, ZIP, TAR 등 14가지 형식으로 압축하고 RAR, ISO, EXE 등 20가지 이상의 형식을 압축 해제할 수 있습니다. AES-256 암호화를 지원하여 안전하게 파일을 공유할 수 있으며, Dock에서 바로 압축 기능을 사용할 수 있어 편리합니다.

Mos

brew install --cask mos

마우스 스크롤을 부드럽게 만들어주는 유틸리티입니다. 맥에서 써드파티 마우스를 사용할 때 스크롤이 뚝뚝 끊기는 현상을 해결해주어 Windows와 유사한 부드러운 스크롤 경험을 제공합니다.

1Password

brew install --cask 1password

개발 도구

Warp - 터미널

brew install --cask warp

기존에 ITerm2 를 사용하였지만 여러 설정이나 테마를 따로 설정하였지만 Warp 의 경우 터미널 명령어를 AI 를 통해 넣거나 오류를 잡을 수 있으며, 기본 테마로도 충분히 예뻐 사용하면 만족감이 높습니다.

Fork - Git 클라이언트

brew install --cask fork

Git GUI 이며 SourceTree 나 GitKraken 에 비해 가볍고 만족감이 높은 툴 중 하나입니다.

WindSurf - 에디터 (VSCode 기반)

brew install --cask windsurf

유명한 Cursor 와 비슷한 VSCode 기반의 에디터로 AI 추천의 Tab 사용을 무료로 사용할 수 있다. ~~Tab발사대~~

Kiro - 에디터 (VSCode 기반)

brew install --cask kiro

AWS 에서 출시한 AI 기반 에디터이며, 요청한 기능을 SPEC 으로 정리하고 Tasks 로 나눠 Task 기반의 AI 요청을 통해 개발을 할 수 있다.

OrbStack - Docker 개발 환경

brew install --cask orbstack

Docker Desktop을 대체할 수 있는 빠르고 가벼운 컨테이너 런타임입니다. macOS에 최적화되어 있어 Docker Desktop보다 빠른 성능과 적은 리소스 사용량을 제공합니다. Linux VM과 Docker 컨테이너를 통합 관리할 수 있으며, Kubernetes 클러스터도 쉽게 설정할 수 있습니다.

AI 및 협업 도구

Claude Desktop

AI Chat 을 사용합니다.

Notion, Slack, Discord

팀 협업을 위한 Tool

개발 환경 설정

쉘 환경 - ZSH + Oh My Zsh

ZSH 설치 및 기본 쉘 변경

# ZSH 설치
brew install zsh
# 기본 쉘 변경
chsh -s $(which zsh)

Oh My Zsh 설치

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

Powerlevel10k 테마

git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ~/.powerlevel10k
echo 'source ~/.powerlevel10k/powerlevel10k.zsh-theme' >>~/.zshrc

ZSH는 자동완성과 히스토리 기능을 제공하고, Oh My Zsh와 Powerlevel10k를 통해 테마를 설정하여 기분 좋은 쉘 환경을 만들 수 있다.

폰트 설정

에디터용 폰트 - Victor Mono

brew install --cask font-victor-mono

Italic체를 섞은 폰트로 코딩하는걸 좋아하는데 만족하며 사용 중

터미널용 폰트 - Meslo LG Nerd Font

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

쉘에 안보이는 폰트를 지원할 수 있음

Git 설정

GitHub CLI 설치

brew install gh

Github CLI 를 통해 PR 요청이나 View 등 을 할 수 있는데 AI 를 통해 PR 생성이나 내용 수정을 더 편하게 관리 할 수 있어 추천 하고 있습니다.

글로벌 ignore 설정

git config --global core.excludesfile ~/.gitignore_global

많은 AI 가 나와 프로젝트마다 gitignore 하기가 불편하여 Global하게 파일을 만들어 관리하고 있음

Node.js 환경

N 버전 매니저

brew install n

LTS 버전 설치

sudo n lts

npm 글로벌 경로 변경

mkdir ~/.npm-global
npm config set prefix ~/.npm-global
echo "export PATH=~/.npm-global/bin:\$PATH" >> ~/.zshrc
source ~/.zshrc

pnpm 설치

npm i -g pnpm

예전부터 n을 통해 node version 을 관리하였으며, Global 을 $HOME 에 두어 더욱 편하게 npm i -g npm 같은걸 sudo 권한 없이 사용하거나 관리 가능하여 사용중입니다. 주로 package manager 로 pnpm 을 사용하고 있습니다.

UV

UV 설치

curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.local/bin/env

Python 패키지 매니저이지만 사용하는 MCP 들이 uv를 통해 설치하는게 많아 설치하고 있습니다.

Claude Code 설정

기본 설치

npm install -g @anthropic-ai/claude-code

SuperClaude 확장

uv venv
source .venv/bin/activate
uv pip install SuperClaude
SuperClaude install

MCP 서버 추가 (Global)

Context7 MCP

claude mcp add context7 --scope user -- npx -y @upstash/context7-mcp

Serena MCP (IDE 어시스턴트)

claude mcp add serena --scope user -- uvx --from git+https://github.com/oraios/serena serena start-mcp-server --context ide-assistant --project ~/dev # ~/dev 를 기본 개발폴더로 사용 중

Chrome MCP

npm install -g mcp-chrome-bridge
mcp-chrome-bridge register

Playwright MCP 가 있지만 사용하고 있는 Chrome 을 제어하여 사용 중인 Session 이나 환경을 그대로 사용할 수 있어 애용하고 있습니다. Chrome MCP Github 를 통해 자세히 설정하는 것을 추천합니다.

모니터링 도구

uv tool install claude-monitor
claude-monitor

사용하고 있는 Claude Code 의 사용량을 확인할 수 있어 AI 사용량이라던지 얼마나 남았는지, 다음 초기화는 언제인지 체크하여 스스로 조절하게 됩니다.

주로 위 와 같이 사용하고 있으며 상세한 설정은 별도로 하고 있지만 Mac 을 초기에 설정할 때 도움이 되었으면 합니다.