2026 Mac 터미널 완벽 세팅 (Ghostty + Starship + AI 코딩 환경)

2021년에 작성했던 Mac 터미널 세팅하기 (zsh & iterm) 글의 2026년 버전입니다. iTerm2 + Powerlevel9k 조합에서 Ghostty + Starship + AI 코딩 도구로 완전히 새롭게 구성했습니다. 모든 설정은 복사-붙여넣기만으로 설치할 수 있도록 작성되었습니다.

최종 결과물

터미널을 열면 fastfetch가 시스템 정보를 보여주고, Starship의 미니멀한 Catppuccin 프롬프트가 맞이합니다. ls를 입력하면 아이콘과 함께 파일 목록이 표시되고, cat 대신 구문 강조가 적용된 bat이 실행됩니다. cd를 입력하면 zoxide가 자주 가는 디렉토리를 자동 추천하고, claude를 입력하면 AI 코딩 에이전트가 바로 시작됩니다.

원클릭 설치 스크립트

아래 스크립트를 터미널에 붙여넣으면 이 글의 모든 도구가 한 번에 설치됩니다. AI에게 이 스크립트를 복사해달라고 하면 바로 세팅이 가능합니다.

#!/bin/bash
set -e

echo "🚀 Mac 터미널 환경 세팅을 시작합니다..."

# ============================================
# 1. Homebrew 설치 (없는 경우)
# ============================================
if ! command -v brew &>/dev/null; then
  echo "📦 Homebrew 설치 중..."
  /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zprofile
  eval "$(/opt/homebrew/bin/brew shellenv)"
fi

# ============================================
# 2. Ghostty 설치
# ============================================
echo "👻 Ghostty 설치 중..."
brew install --cask ghostty

# ============================================
# 3. 폰트 설치
# ============================================
echo "🔤 Nerd Font 설치 중..."
brew install --cask font-hack-nerd-font
brew install --cask font-meslo-lg-nerd-font

# ============================================
# 4. 쉘 도구 설치
# ============================================
echo "🛠️ CLI 도구 설치 중..."
brew install zsh
brew install lsd bat fzf fd ripgrep git-delta btop dust duf tig eza fastfetch neovim
brew install zoxide lazygit navi

# ============================================
# 5. Oh My Zsh 설치
# ============================================
if [ ! -d "$HOME/.oh-my-zsh" ]; then
  echo "💎 Oh My Zsh 설치 중..."
  sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)" "" --unattended
fi

# ============================================
# 6. Starship 프롬프트 설치
# ============================================
if ! command -v starship &>/dev/null; then
  echo "⚡ Starship 설치 중..."
  brew install starship
fi

# ============================================
# 7. Zinit 플러그인 매니저 설치
# ============================================
if [ ! -d "$HOME/.local/share/zinit" ]; then
  echo "🔌 Zinit 설치 중..."
  mkdir -p "$HOME/.local/share/zinit"
  git clone https://github.com/zdharma-continuum/zinit "$HOME/.local/share/zinit/zinit.git"
fi

# ============================================
# 8. SCM Breeze 설치 (Git 단축키)
# ============================================
if [ ! -d "$HOME/.scm_breeze" ]; then
  echo "🌿 SCM Breeze 설치 중..."
  git clone https://github.com/scmbreeze/scm_breeze.git ~/.scm_breeze
  ~/.scm_breeze/install.sh
fi

# ============================================
# 9. mise (런타임 버전 관리자) 설치
# ============================================
if ! command -v mise &>/dev/null; then
  echo "📐 mise 설치 중..."
  curl https://mise.run | sh
fi

# mise 활성화 및 Node.js 설치 (AI 도구에 필요)
eval "$(~/.local/bin/mise activate bash)"
mise use --global node@24

# ============================================
# 10. AI 코딩 도구 설치
# ============================================
echo "🤖 AI 코딩 도구 설치 중..."

# Claude Code
if ! command -v claude &>/dev/null; then
  npm install -g @anthropic-ai/claude-code
fi

# Codex CLI
if ! command -v codex &>/dev/null; then
  npm install -g @openai/codex
fi

# Gemini CLI
if ! command -v gemini &>/dev/null; then
  brew install gemini-cli
fi

echo ""
echo "✅ 설치가 완료되었습니다!"
echo "👉 아래의 설정 파일들을 적용한 후 터미널을 재시작하세요."
echo "👉 Starship 프롬프트 확인: starship explain"

상세 설정 가이드

1. Ghostty 터미널

Ghostty는 Zig로 작성된 GPU 가속 터미널입니다. iTerm2 대비 체감 속도가 확연히 빠르고, 네이티브 macOS 경험을 제공합니다.

설치

brew install --cask ghostty

설정 파일

~/.config/ghostty/config 파일을 생성합니다.

mkdir -p ~/.config/ghostty
cat << 'EOF' > ~/.config/ghostty/config
# Ghostty Configuration - Dark Modern (Catppuccin Mocha)

# Theme
theme = Catppuccin Mocha

# Font
font-family = "Hack Nerd Font Mono"
font-family = "Noto Sans CJK KR"

# Window
window-padding-x = 12
window-padding-y = 10
window-decoration = true
macos-titlebar-style = tabs

# Background (반투명 + 블러)
background-opacity = 0.9
background-blur-radius = 20

# Autosuggestion color (가독성을 위해 밝게)
palette = 8=#7f849c

# Cursor
cursor-style = block
cursor-style-blink = false

# Mouse
mouse-hide-while-typing = true

# Clipboard
copy-on-select = true
clipboard-paste-protection = false

# Scrollback
scrollback-limit = 10000

# macOS
macos-option-as-alt = true

# Shell Integration
shell-integration = zsh
shell-integration-features = cursor,sudo,title

# Keybindings - Split/Tab
keybind = cmd+d=new_split:right
keybind = cmd+shift+d=new_split:down
keybind = cmd+w=close_surface
keybind = cmd+alt+left=goto_split:left
keybind = cmd+alt+right=goto_split:right
keybind = cmd+alt+up=goto_split:top
keybind = cmd+alt+down=goto_split:bottom
EOF

핵심 설정 설명:

2. Zsh + Oh My Zsh + Starship

기존 Powerlevel9k/10k에서 Starship으로 교체했습니다. Rust로 작성되어 빠르고, ~/.config/starship.toml 하나로 설정을 관리합니다.

설치

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

# Starship
brew install starship

.zshrc에 추가

Oh My Zsh의 ZSH_THEME를 비워두고, Starship을 oh-my-zsh 이후에 로드합니다.

# oh-my-zsh 설정
ZSH_THEME=""    # Starship이 프롬프트를 관리하므로 비워둠
plugins=(git)
source $ZSH/oh-my-zsh.sh

# Starship 프롬프트 (oh-my-zsh 이후에 로드해야 테마가 덮어쓰이지 않음)
eval "$(starship init zsh)"

Starship 설정 (~/.config/starship.toml)

미니멀하게 디렉토리 + Git + 실행 시간만 표시하고, Catppuccin Mocha 팔레트로 통일했습니다. 세그먼트 끝은 삼각형(``) 형태의 Powerline 스타일이며, 1줄 프롬프트입니다.

mkdir -p ~/.config
cat << 'EOF' > ~/.config/starship.toml
"$schema" = 'https://starship.rs/config-schema.json'

format = """
[](mauve)\
$directory\
[](fg:mauve bg:blue)\
$git_branch\
$git_status\
[](fg:blue) \
$cmd_duration\
$character"""

palette = 'catppuccin_mocha'

[directory]
style = "bg:mauve fg:crust"
format = "[ $path ]($style)"
truncation_length = 3
truncation_symbol = "…/"

[git_branch]
symbol = " "
style = "bg:blue"
format = '[[ $symbol$branch ](fg:crust bg:blue)]($style)'

[git_status]
style = "bg:blue"
format = '[[($all_status$ahead_behind )](fg:crust bg:blue)]($style)'

[line_break]
disabled = true

[character]
success_symbol = '[❯](bold fg:green)'
error_symbol = '[❯](bold fg:red)'

[cmd_duration]
min_time = 2_000
format = "[ 󱎫 $duration](fg:overlay1) "

[palettes.catppuccin_mocha]
rosewater = "#f5e0dc"
flamingo = "#f2cdcd"
pink = "#f5c2e7"
mauve = "#cba6f7"
red = "#f38ba8"
maroon = "#eba0ac"
peach = "#fab387"
yellow = "#f9e2af"
green = "#a6e3a1"
teal = "#94e2d5"
sky = "#89dceb"
sapphire = "#74c7ec"
blue = "#89b4fa"
lavender = "#b4befe"
text = "#cdd6f4"
subtext1 = "#bac2de"
subtext0 = "#a6adc8"
overlay2 = "#9399b2"
overlay1 = "#7f849c"
overlay0 = "#6c7086"
surface2 = "#585b70"
surface1 = "#45475a"
surface0 = "#313244"
base = "#1e1e2e"
mantle = "#181825"
crust = "#11111b"
EOF

프롬프트 구성:

 디렉토리  Git브랜치 상태  실행시간 ❯ _

• mauve(보라) 배경에 디렉토리 경로
• blue(파랑) 배경에 Git 브랜치 + 상태
• 2초 이상 걸린 명령어만 실행 시간 표시
• ❯ 커서 (성공: 초록, 실패: 빨강)

다른 프리셋으로 시작하기

더 많은 정보를 표시하고 싶다면 빌트인 프리셋을 적용한 후 커스터마이징하세요.

# 예: Catppuccin Powerline (풀 프리셋)
starship preset catppuccin-powerline -o ~/.config/starship.toml

# 예: Tokyo Night
starship preset tokyo-night -o ~/.config/starship.toml

3. Zinit 플러그인 매니저 + 필수 플러그인

oh-my-zsh의 기본 플러그인 시스템 대신 Zinit을 사용합니다. 병렬 로딩으로 쉘 시작 속도가 빠릅니다.

설치

mkdir -p "$HOME/.local/share/zinit"
git clone https://github.com/zdharma-continuum/zinit "$HOME/.local/share/zinit/zinit.git"

.zshrc에 추가

# Zinit 로드
source "$HOME/.local/share/zinit/zinit.git/zinit.zsh"
autoload -Uz _zinit
(( ${+_comps} )) && _comps[zinit]=_zinit

# 필수 플러그인 3종
zinit light zdharma-continuum/fast-syntax-highlighting    # 명령어 구문 강조
zinit light zsh-users/zsh-autosuggestions                  # 히스토리 기반 자동 완성
zinit light zsh-users/zsh-completions                      # 추가 자동 완성 정의

플러그인 역할:

4. 모던 CLI 도구 (기본 명령어 업그레이드)

기존 Unix 명령어를 더 빠르고, 더 보기 좋은 Rust/Go 기반 도구로 교체합니다.

한 번에 설치

brew install lsd bat fzf fd ripgrep git-delta btop dust duf tig eza fastfetch neovim
brew install zoxide lazygit navi

.zshrc 별칭 설정

# ============================================
# 모던 CLI 별칭
# ============================================
alias ls="lsd"
alias ll="lsd -la"
alias lt="lsd --tree"
alias cat="bat"
alias find="fd"
alias grep="rg"
alias top="btop"
alias df="duf"
alias du="dust"
alias vim="nvim"
alias vi="nvim"

# 빠른 접근
alias lg="lazygit"      # Git TUI
alias c="clear"
alias ..="cd .."
alias ...="cd ../.."

각 도구 소개

fzf + zoxide + navi 연동

# fzf (퍼지 검색) - Ctrl+R로 히스토리 검색, Ctrl+T로 파일 검색
source <(fzf --zsh)

# zoxide (스마트 cd) - cd 명령어를 zoxide로 대체
eval "$(zoxide init --cmd cd zsh)"

# navi (치트시트) - Ctrl+G로 명령어 검색
eval "$(navi widget zsh)"

Git Delta 설정

~/.gitconfig에 추가하면 git diff, git log 등이 자동으로 delta를 사용합니다.

git config --global core.pager delta
git config --global interactive.diffFilter "delta --color-only"
git config --global delta.navigate true
git config --global delta.side-by-side true

Fastfetch (터미널 시작 시 시스템 정보)

.zshrc 최상단에 추가합니다.

# .zshrc 최상단에 추가
fastfetch

터미널을 열 때마다 OS, 호스트, 커널, 업타임, 패키지 수 등의 시스템 정보가 표시됩니다.

5. SCM Breeze (Git 단축키)

SCM Breeze는 git status 결과에 번호를 매겨서 파일을 숫자로 선택할 수 있게 해줍니다.

git clone https://github.com/scmbreeze/scm_breeze.git ~/.scm_breeze
~/.scm_breeze/install.sh
source ~/.scm_breeze/scm_breeze.sh

사용 예시:

$ gs              # git status (파일에 번호 부여)
# ➤ [1] modified: src/app.ts
# ➤ [2] modified: src/utils.ts

$ ga 1            # git add src/app.ts (번호로 스테이징)
$ gd 2            # git diff src/utils.ts

참고: Claude Code 환경에서는 SCM Breeze가 쉘 스냅샷과 충돌할 수 있어 조건부로 로드합니다.

# Claude Code 환경에서는 SCM Breeze 제외
if [[ -z "$CLAUDECODE" ]]; then
  [ -s "$HOME/.scm_breeze/scm_breeze.sh" ] && source "$HOME/.scm_breeze/scm_breeze.sh"
fi

6. mise (런타임 버전 관리자)

nvm, pyenv, rbenv 등을 mise 하나로 통합합니다. 프로젝트별 .mise.toml 파일로 Node, Python, Go 등의 버전을 관리합니다.

# 설치
curl https://mise.run | sh

# .zshrc 맨 아래에 추가
echo 'eval "$(mise activate zsh)"' >> ~/.zshrc

# Node.js 설치 예시
mise use --global node@24

.mise.toml 예시:

[tools]
node = "24.9.0"

7. AI 코딩 도구 세팅

2026년 터미널 환경의 가장 큰 변화는 AI 코딩 에이전트입니다. 터미널에서 바로 AI와 함께 코딩할 수 있습니다.

Claude Code

Claude Code는 Anthropic의 공식 CLI 코딩 에이전트입니다.

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

# 실행
claude

oh-my-claudecode (OMC) 플러그인:

멀티 에이전트 오케스트레이션을 지원하는 플러그인으로, 여러 AI 에이전트가 병렬로 작업을 수행합니다.

# Claude Code 실행 후 아래 명령어 입력
/install-plugin oh-my-claudecode@omc

Claude Code의 주요 설정(~/.claude/settings.json):

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "afplay /System/Library/Sounds/Glass.aiff &"
          }
        ]
      }
    ],
    "Notification": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "afplay /System/Library/Sounds/Ping.aiff &"
          }
        ]
      }
    ]
  },
  "enabledPlugins": {
    "oh-my-claudecode@omc": true
  }
}

• Stop Hook: 작업이 끝나면 macOS 기본 효과음으로 알림
• Notification Hook: 확인이 필요한 상황에 효과음 재생
• oh-my-claudecode: 멀티 에이전트 워크플로우 (autopilot, team, ultrawork 등)

headless 빌드 검증 별칭:

Claude Code를 비대화형으로 실행하여 빌드 검증을 자동화할 수 있습니다.

# .zshrc에 추가
alias cc-check="claude -p 'Run tsc --noEmit, then eslint, then run all unit tests. Report any failures with file paths and line numbers.' --allowedTools 'Bash,Read,Grep' --output-format json > build-report.json && echo '✅ build-report.json 생성 완료'"

Codex CLI (OpenAI)

npm install -g @openai/codex

Gemini CLI (Google)

brew install gemini-cli

세 AI를 함께 사용하기

oh-my-claudecode의 /ccg 명령어를 사용하면 Claude + Codex + Gemini를 동시에 활용할 수 있습니다. 백엔드 작업은 Codex에, 프론트엔드 작업은 Gemini에 분배한 후 Claude가 결과를 통합합니다.

8. 도구 런처 (tools 함수)

fzf를 활용한 커스텀 도구 런처입니다. 터미널에 tools를 입력하면 설치된 도구들을 퍼지 검색으로 선택하여 실행할 수 있습니다.

# .zshrc에 추가
function tools() {
  local cmds=(
    "btop:🖥️  시스템 모니터링"
    "lazygit:📦 Git UI"
    "duf:💾 디스크 사용량"
    "dust:📁 폴더 크기 분석"
    "fastfetch:ℹ️  시스템 정보"
  )
  local selected=$(printf '%s\n' "${cmds[@]}" | fzf --delimiter=: --with-nth=2 --height=40% --reverse --border --prompt="도구 선택: ")
  local cmd="${selected%%:*}"
  [[ -n "$cmd" ]] && eval "$cmd"
}

9. 완성된 .zshrc

모든 설정을 통합한 .zshrc 레퍼런스입니다. 본인의 기존 .zshrc에 맞게 필요한 부분만 참고하여 수정하세요.

# ============================================
# 2026 Mac Terminal Configuration
# ============================================

# Fastfetch (터미널 시작 시 시스템 정보)
fastfetch

# Oh My Zsh
export ZSH="$HOME/.oh-my-zsh"
ZSH_THEME=""
plugins=(git)
source $ZSH/oh-my-zsh.sh

# Starship 프롬프트
eval "$(starship init zsh)"

# ============================================
# Zinit 플러그인 매니저
# ============================================
if [[ ! -f $HOME/.local/share/zinit/zinit.git/zinit.zsh ]]; then
    command mkdir -p "$HOME/.local/share/zinit" && command chmod g-rwX "$HOME/.local/share/zinit"
    command git clone https://github.com/zdharma-continuum/zinit "$HOME/.local/share/zinit/zinit.git"
fi
source "$HOME/.local/share/zinit/zinit.git/zinit.zsh"
autoload -Uz _zinit
(( ${+_comps} )) && _comps[zinit]=_zinit

zinit light zdharma-continuum/fast-syntax-highlighting
zinit light zsh-users/zsh-autosuggestions
zinit light zsh-users/zsh-completions

# ============================================
# SCM Breeze (Git 단축키)
# ============================================
if [[ -z "$CLAUDECODE" ]]; then
  [ -s "$HOME/.scm_breeze/scm_breeze.sh" ] && source "$HOME/.scm_breeze/scm_breeze.sh"
fi

# ============================================
# 모던 CLI 별칭
# ============================================
alias ls="lsd"
alias ll="lsd -la"
alias lt="lsd --tree"
alias cat="bat"
alias find="fd"
alias grep="rg"
alias top="btop"
alias df="duf"
alias du="dust"
alias vim="nvim"
alias vi="nvim"
alias lg="lazygit"
alias c="clear"
alias ..="cd .."
alias ...="cd ../.."

# ============================================
# fzf + zoxide + navi
# ============================================
source <(fzf --zsh)
eval "$(zoxide init --cmd cd zsh)"
eval "$(navi widget zsh)"

# ============================================
# mise (런타임 버전 관리자)
# ============================================
eval "$(mise activate zsh)"

Tip: 새로 세팅하는 경우 위 내용 전체를 ~/.zshrc에 붙여넣으면 됩니다. 기존 설정이 있다면 cp ~/.zshrc ~/.zshrc.backup으로 백업 후 필요한 블록만 추가하세요.

이전 세팅과의 비교

마무리하며…

2021년에는 “아름다운 터미널”을 목표로 했다면, 2026년에는 “AI와 함께 일하는 생산적인 터미널”이 핵심입니다.

Ghostty의 빠른 렌더링 위에 Starship의 미니멀한 프롬프트, 모던 CLI 도구들의 향상된 가독성, 그리고 Claude Code를 비롯한 AI 에이전트가 합쳐져 터미널이 단순한 명령어 입력 도구를 넘어 AI 코딩 워크스테이션이 되었습니다.

이 글의 스크립트를 그대로 복사하여 새 Mac을 세팅하거나, AI에게 “이 블로그 글의 설치 스크립트를 실행해줘”라고 요청하면 됩니다.

궁금한 점이 있다면 댓글로 남겨주세요!