Part 2: Hands-On Guide

2.1 환경 설정

다운로드 및 설치 프로그램

Claude Code를 제대로 활용하기 위한 필수 프로그램 목록입니다.

  • 1.
    Zed - 빠르고 가벼운 코드 에디터
    https://zed.dev/download
  • 2.
    Amphetamine - Mac 잠자기 방지 유틸리티
    Mac App Store에서 다운로드
  • 3.
    Claude Code (Native Install)
    bash 
    curl -fsSL https://claude.ai/install.sh | bash
  • 4.
    iTerm2 - macOS 터미널 앱
    https://iterm2.com/downloads.html

tmux (Terminal Multiplexer)

터미널용 창 관리자입니다. 하나의 터미널 안에서 여러 개의 터미널 세션을 만들고 관리할 수 있게 해주는 도구입니다.

주요 용도

화면 분할
설명: 하나의 터미널에서 여러 창을 나눠서 동시에 볼 수 있음
세션 유지
설명: 터미널을 닫아도 작업이 백그라운드에서 계속 실행됨 (사고 방지)
재접속
설명: 다른 컴퓨터에서 기존 세션에 다시 연결 가능
원격 작업 보호
설명: SSH 연결이 끊겨도 실행 중인 작업이 사라지지 않음
리소스 관리
설명: 다수의 터미널 탭보다 tmux 세션 하나로 관리하는 것이 메모리와 CPU 효율적
💡 Agent Teams 필수급 옵션

Claude Code의 Agent Teams 기능을 제대로 맛보려면 사실상 강력 권장을 넘어선 필수급 옵션입니다.

ℹ️ iTerm2 = tmux Control Mode 지원 유일한 터미널

iTerm2는 tmux -CC(tmux Control Mode)를 지원하는 유일한 터미널입니다. tmux와 시스템 레벨에서 결합(Native Integration)되어, tmux 세션이 iTerm2 네이티브 탭과 창으로 자동 변환됩니다.

일반 터미널 + tmux vs iTerm2 + tmux -CC

창 전환
일반 터미널 + tmux: tmux 단축키 (Ctrl+B → 방향키)
iTerm2 + tmux -CC: Cmd + 숫자로 탭 전환
새 창 만들기
일반 터미널 + tmux: tmux 명령어 필요
iTerm2 + tmux -CC: iTerm2가 자동으로 탭 생성
스크롤
일반 터미널 + tmux: tmux 스크롤 모드 진입 필요
iTerm2 + tmux -CC: 마우스 스크롤 그대로 사용
사용 경험
일반 터미널 + tmux: tmux 학습 필요
iTerm2 + tmux -CC: 일반 터미널 쓰듯 사용 가능
💡 iterm2 + tmux

tmux의 기능은 활용하면서 tmux를 배울 필요가 없는 조합

초기 환경 설정 스크립트

ℹ️ claude-code-setup.zip 다운로드

아래 파일 다운로드 후 압축 해제하세요. claude-code-{회사 영어 이름}으로 폴더명을 변경하세요.

스크립트 실행

bash 
cd ~/{path-to-the-folder}/mac-migration
chmod +x setup-new-mac.sh
./setup-new-mac.sh

설치 단계 (setup-new-mac.sh)

1
Step 1 / 8

Homebrew 설치

macOS 패키지 관리자인 Homebrew를 설치합니다.

bash 
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# Apple Silicon Mac의 경우 PATH 설정
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
eval "$(/opt/homebrew/bin/brew shellenv)"
2
Step 2 / 8

Brewfile로 패키지 일괄 설치

Brewfile에 정의된 패키지(wget, git-credential-manager, karabiner-elements 등)를 일괄 설치합니다.

bash 
brew bundle --file="$SCRIPT_DIR/Brewfile"
3
Step 3 / 8

Oh My Zsh 설치

Zsh 설정 관리 프레임워크를 설치합니다.

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

Zsh 플러그인 & 테마 설치

Powerlevel10k 테마, zsh-autosuggestions, zsh-syntax-highlighting 플러그인을 설치합니다.

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

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

# zsh-syntax-highlighting
git clone https://github.com/zsh-users/zsh-syntax-highlighting \
    "${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting"
5
Step 5 / 8

폰트 설치

MesloLGS NF 등 Nerd Font를 설치합니다. Claude Code는 아이콘/특수문자를 사용하므로 Nerd Font가 필요합니다.

bash 
mkdir -p ~/Library/Fonts
cp "$SCRIPT_DIR"/fonts/*.ttf ~/Library/Fonts/
6
Step 6 / 8

tmux 설치 확인

tmux가 설치되어 있는지 확인하고, 없으면 설치합니다.

bash 
brew install tmux
tmux -V  # 버전 확인
7
Step 7 / 8

Claude Code 설정

~/.claude/ 디렉토리에 notify.sh, statusline.sh, settings.json을 설치합니다.

bash 
mkdir -p "$HOME/.claude"

# notify.sh (작업 완료/질문 시 iTerm2 알림용 훅 스크립트)
cp "$SCRIPT_DIR/claude/notify.sh" "$HOME/.claude/notify.sh"
chmod +x "$HOME/.claude/notify.sh"

# statusline.sh (Claude Code 상태바 표시용 스크립트)
cp "$SCRIPT_DIR/claude/statusline.sh" "$HOME/.claude/statusline.sh"
chmod +x "$HOME/.claude/statusline.sh"

# settings.json (기존 파일 있으면 병합)
cp "$SCRIPT_DIR/claude/settings.json" "$HOME/.claude/settings.json"
8
Step 8 / 8

설정 파일 복원

.zshrc, .p10k.zsh, .tmux.conf, iTerm2 설정, Karabiner 설정을 복원합니다.

bash 
# .zshrc 복원
cp "$SCRIPT_DIR/zshrc" "$HOME/.zshrc"

# .p10k.zsh 복원
cp "$SCRIPT_DIR/p10k.zsh" "$HOME/.p10k.zsh"

# iTerm2 설정 복원
cp "$SCRIPT_DIR/com.googlecode.iterm2.plist" \
    "$HOME/Library/Preferences/com.googlecode.iterm2.plist"

# Karabiner 설정 복원
mkdir -p "$HOME/.config"
cp -r "$SCRIPT_DIR/karabiner" "$HOME/.config/karabiner"
⚠️ 설치 후 할 일

iTerm2를 완전히 종료(Cmd+Q) 후 다시 열어주세요. 그 다음 새 터미널에서 source ~/.zshrc를 실행하세요.