setup_mac/README.md

NAD4 Mac 초기 설정 스크립트

Mac 개발 환경을 자동으로 설정하는 스크립트입니다.

이제 이 저장소는 기본 개발 환경뿐 아니라 shared Codex 환경까지 함께 세팅합니다.

📦 설치 항목

개발 도구

• Homebrew
• Node.js
• iTerm2
• Oh My Zsh (agnoster 멀티라인 테마)
• zsh-syntax-highlighting / zsh-autosuggestions
• VSCode + Claude 확장
• Claude Code CLI
• Cursor (에디터)
• Codex shared workspace bootstrap

유틸리티

• Stats: 시스템 모니터 (CPU, Memory, Network 등)
• Rectangle: 윈도우 관리 (무료 Magnet 대안)
• AppCleaner: 앱 완전 삭제 도구

폰트

• D2Coding
• D2Coding Nerd Font

애플리케이션

• Notion
• Discord
• Slack
• Google Chrome
• Telegram
• IINA (동영상 플레이어)
• Tunnelblick (VPN)

🚀 사용 방법

초기 설치

# 1. 저장소 클론
cd ~/workspace
git clone https://github.com/nad4-su/setup_mac.git

# 2. 스크립트 실행
cd setup_mac
chmod +x setup_mac.sh
./setup_mac.sh

다른 Mac에서 설정 동기화

# 1. 저장소 클론
cd ~/workspace
git clone https://github.com/nad4-su/setup_mac.git

# 2. 스크립트 실행 (기존 설정 적용)
cd setup_mac
chmod +x setup_mac.sh
./setup_mac.sh

📁 프로젝트 구조

setup_mac/
├── setup_mac.sh              # 메인 설치 스크립트
├── save_configs.sh           # 설정 저장 스크립트
├── .gitignore
├── iterm2-settings/
│   └── profile.json          # iTerm2 프로파일
├── stats-settings/
│   └── Stats.plist           # Stats 설정
├── rectangle-settings/
│   └── RectangleConfig.json  # Rectangle 설정
└── README.md

⚙️ 설정 내용

iTerm2 프로파일

• 이름: nad4-profile
• 폰트: D2Coding 13pt
• 색상: 다크 테마
• Status Bar: CPU, 메모리, 네트워크, 배터리, 호스트명
• 크기: 100 columns × 25 rows

ZSH 테마

• 테마: agnoster (멀티라인)
• 플러그인: syntax-highlighting, autosuggestions

Claude Code

• CLI: npm install -g @anthropic-ai/claude-code 로 자동 설치
• VSCode 확장: code --install-extension 으로 자동 설치
• 최초 실행 시 Anthropic API 키 설정 필요

Codex 공유 환경

• https://github.com/nad4-su/codex 를 ~/workspace/codex 로 자동 clone
• bootstrap-codex.sh 자동 실행
• ~/workspace/AGENTS.md 등 공통 링크 자동 구성
• harness-diagnostics, gstack 등 Codex skill 자동 bootstrap

Stats 설정

• 자동으로 사용자 정의 설정 적용
• 메뉴바 위젯 자동 구성
• Launch at login 자동 설정

🔄 설정 업데이트

간편한 방법 (save_configs.sh 사용)

cd ~/workspace/nad4/setup_mac

# 1. Stats에서 원하는 설정 변경
# 2. iTerm2에서 프로파일 수정 (선택사항)

# 3. 설정 저장 스크립트 실행
./save_configs.sh

수동 방법

iTerm2 프로파일 변경 사항 저장

# 1. iTerm2에서 프로파일 수정 후 Export
# iTerm2 > Settings > Profiles > Other Actions... > Save Profile as JSON

# 2. 파일을 저장소로 이동
cd ~/workspace/nad4/setup_mac
mv ~/Downloads/nad4-profile.json iterm2-settings/profile.json

# 3. Git 커밋
git add iterm2-settings/profile.json
git commit -m "Update iTerm2 profile"
git push

Stats 설정 변경 사항 저장

# 1. Stats에서 원하는 설정 변경
# Settings에서 위젯, 색상, 업데이트 간격 등 조정

# 2. 설정 파일 저장소로 복사
cd ~/workspace/nad4/setup_mac
cp ~/Library/Preferences/eu.exelban.Stats.plist stats-settings/Stats.plist

# 3. Git 커밋
git add stats-settings/Stats.plist
git commit -m "Update Stats configuration"
git push

📋 설치 후 체크리스트

iTerm2 설정

• iTerm2 > Settings > Profiles
• 'nad4-profile' 선택
• Other Actions... > Set as Default
• 새 창 열어서 설정 확인

Stats 설정

• 메뉴바에서 Stats 위젯 표시 확인
• Settings > General > Launch at login 확인
• CPU, Memory 등 위젯 정상 작동 확인

ZSH 확인

• 새 터미널에서 echo $ZSH_THEME → agnoster
• type build_prompt → 함수 정의 확인
• 프롬프트 2줄로 표시 확인
• Syntax highlighting 작동 확인
• Autosuggestions 작동 확인

Claude Code 확인

• claude --version → 버전 출력 확인
• claude → 최초 실행 시 API 키 설정
• VSCode Extensions (⌘⇧X) → Claude 확장 설치 확인

Codex 확인

• ls -l ~/workspace/AGENTS.md → codex 경로로 링크 확인
• ls ~/.codex/skills | grep harness-diagnostics
• ls ~/.codex/skills | grep gstack-review
• test -f ~/.codex/config.toml

🛠️ 문제 해결

iTerm2 프로파일이 적용되지 않는 경우

# 1. 프로파일 파일 확인
ls -la ~/Library/Application\ Support/iTerm2/DynamicProfiles/

# 2. iTerm2 재시작
killall iTerm2
open -a iTerm2

Stats 설정이 적용되지 않는 경우

# 1. Stats 완전 종료
killall Stats

# 2. 설정 파일 재적용
cd ~/workspace/nad4/setup_mac
cp stats-settings/Stats.plist ~/Library/Preferences/eu.exelban.Stats.plist

# 3. Stats 재시작
open -a Stats

ZSH 테마 에러

# 백업에서 복원
cp ~/.zshrc.backup_YYYYMMDD_HHMMSS ~/.zshrc
exec zsh

Claude Code CLI가 동작하지 않는 경우

# Node.js 확인
node --version

# Claude Code 재설치
npm install -g @anthropic-ai/claude-code

# API 키 재설정
claude config

VSCode Claude 확장이 설치되지 않는 경우

# code 명령 설치 (VSCode 실행 후)
# ⌘⇧P → 'Shell Command: Install code command in PATH'

# 확장 수동 설치
code --install-extension anthropic.claude-code

폰트가 표시되지 않는 경우

# 폰트 재설치
brew reinstall --cask font-d2coding
brew reinstall --cask font-d2coding-nerd-font

# 폰트 캐시 삭제
sudo atsutil databases -remove

📦 설정 백업 및 복원

전체 설정 백업

cd ~/workspace/nad4/setup_mac
./save_configs.sh

전체 설정 복원

cd ~/workspace/setup_mac

# Git에서 최신 설정 가져오기
git pull

# 스크립트 실행 (자동으로 모든 설정 복원)
./setup_mac.sh

📚 참고 자료

• Homebrew
• iTerm2
• Oh My Zsh
• Claude Code
• Codex Shared Repo
• VSCode
• Stats
• Rectangle
• D2Coding Font

💡 팁

빠른 설정 동기화

# 다른 Mac에서 5분 안에 모든 설정 복원
cd ~/workspace
git clone <repository-url> nad4
cd nad4/setup_mac
chmod +x setup_mac.sh
./setup_mac.sh

# 완료! iTerm2 재시작하면 모든 설정 적용됨

정기적인 설정 백업

# 매주 일요일 오후 6시에 설정 백업 (선택사항)
# crontab -e 후 아래 줄 추가:
0 18 * * 0 cd ~/workspace/nad4/setup_mac && ./save_configs.sh --auto

📝 라이선스

MIT License