새 맥(Mac)에서 Claude Code 처음부터 셋업하기

0단계 · 옛날 컴퓨터에서 백업해 갈 것들

새 컴퓨터에서 처음부터 만들 수도 있지만, 아래 항목을 옮기면 "지금과 똑같이" 시작할 수 있어요. USB · 외장하드 · iCloud · AirDrop 어디든 OK.

옛날 컴퓨터에서 한 번에 압축하는 명령어

터미널을 열고 (Spotlight: Cmd+Space → "터미널" 입력) 아래를 그대로 붙여넣으세요. ~/Desktop/claude-backup.zip 파일이 만들어져요.

옛날 컴퓨터 · 터미널Bash
cd ~ && zip -r ~/Desktop/claude-backup.zip \
  .claude/CLAUDE.md \
  .claude/settings.json \
  .claude/settings.local.json \
  .claude/projects/-Users-midbar-/memory \
  Desktop/Claude

이 zip 파일 하나를 새 컴퓨터로 옮기면 됩니다.

1단계 · Homebrew 설치 (맥 패키지 관리자)

Homebrew는 맥에서 개발 도구를 설치할 때 쓰는 "앱스토어" 같은 거예요. Node.js를 깔기 위해 먼저 필요합니다.

설치 명령어

새 컴퓨터 · 터미널Bash
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

설치 확인

터미널Bash
brew --version

기대 결과: Homebrew 4.x.x 처럼 버전이 찍히면 성공.

2단계 · Node.js 설치 (Claude Code의 엔진)

Claude Code는 Node.js 위에서 돌아가는 CLI예요. 한 줄이면 끝납니다.

터미널Bash
brew install node

설치 확인

터미널Bash
node --version
npm --version

기대 결과: v22.x.x · 10.x.x 정도면 OK. (정확한 숫자는 시점마다 달라요.)

3단계 · Claude Code 설치

드디어 본체 설치. 글로벌(-g)로 깔아야 어디서든 claude 명령어로 부를 수 있어요.

터미널Bash
npm install -g @anthropic-ai/claude-code

설치 확인

터미널Bash
claude --version

기대 결과: 2.x.x (Claude Code) 같은 버전 출력.

4단계 · 첫 실행 & Anthropic 계정 로그인

아무 폴더에서나 claude를 치면 됩니다. 처음 실행하면 자동으로 브라우저가 열려서 로그인 화면이 나와요.

터미널Bash
cd ~
claude

1. 브라우저 자동 오픈 → Anthropic 계정으로 로그인 (midbar_@naver.com 으로 가입한 계정)
2. "Authorize" 클릭 → 터미널 화면으로 자동 복귀
3. "Welcome to Claude Code" 가 뜨면 성공. 일단 /exit 또는 Ctrl+C 두 번으로 빠져나옵니다.

5단계 · 전역 설정 파일 (~/.claude/settings.json)

이 파일이 "auto 모드 · 라이트 테마 · 푸시 알림" 같은 기본 동작을 결정합니다.

방법 A · 백업한 파일을 그대로 덮어쓰기 (추천)

터미널Bash
# 백업 zip을 ~/Desktop 에 풀었다고 가정
cp ~/Desktop/claude-backup/.claude/settings.json ~/.claude/settings.json

방법 B · 직접 새로 만들기

아래 내용을 그대로 ~/.claude/settings.json 파일에 저장하세요. (텍스트 편집기 → "다른 이름으로 저장" → 위치 입력)

~/.claude/settings.jsonJSON
{
  "permissions": {
    "defaultMode": "auto"
  },
  "enabledPlugins": {
    "superpowers@claude-plugins-official": true
  },
  "theme": "light-daltonized",
  "skipAutoPermissionPrompt": true,
  "agentPushNotifEnabled": true
}

6단계 · 전역 지침 파일 (~/.claude/CLAUDE.md)

이게 "모든 대화에서 Superpowers 스킬을 자동으로 쓰도록" 만드는 핵심 파일이에요. 모든 세션 시작 시 자동으로 읽힙니다.

방법 A · 백업본 복사

터미널Bash
cp ~/Desktop/claude-backup/.claude/CLAUDE.md ~/.claude/CLAUDE.md

방법 B · 직접 새로 만들기

~/.claude/CLAUDE.mdMarkdown
# Superpowers 자동 활용

이 환경에는 `superpowers` 플러그인이 설치되어 있다.
모든 작업에서 적절한 superpowers 스킬을 자동으로 활용한다.

## 대화 시작 시
- 어떤 응답(명료화 질문 포함)을 하기 전에 먼저
  `superpowers:using-superpowers` 스킬을 호출한다.
- 이를 통해 이번 작업에 어떤 스킬이 필요한지 결정한다.

## 작업 유형별 자동 발동
- 새 기능·컴포넌트·동작 변경 요청 → `superpowers:brainstorming`
- 다단계 구현 작업 → `superpowers:writing-plans` /
  별도 세션 실행이면 `superpowers:executing-plans`
- 기능 또는 버그픽스 구현 직전 → `superpowers:test-driven-development`
- 버그·테스트 실패·예상 외 동작 발견 → `superpowers:systematic-debugging`
- 격리된 작업 공간이 필요한 기능 작업 → `superpowers:using-git-worktrees`
- 2개 이상 독립 태스크 → `superpowers:dispatching-parallel-agents`
  또는 `superpowers:subagent-driven-development`
- "완료/통과/수정됨" 주장 직전 → `superpowers:verification-before-completion`
- 주요 기능 구현 또는 머지 전 → `superpowers:requesting-code-review`
- 코드 리뷰 피드백 수령 → `superpowers:receiving-code-review`
- 구현 완료 후 통합 단계 → `superpowers:finishing-a-development-branch`
- 새 스킬 작성·편집 → `superpowers:writing-skills`

## 기본 원칙
- 주장 전에 증거: 검증 명령을 실행하지 않은 채로 "완료"라고 말하지 않는다.
- 스킬 호출은 선언이 아니라 실행이다.
- 사용자가 "스킬 쓰지 말고 그냥 해줘"라고 명시하면 위 규칙을 건너뛴다.

전체 원본은 백업한 CLAUDE.md에 있으니 그걸 그대로 복사해도 OK.

7단계 · Superpowers 플러그인 설치

Claude Code 안에서 명령 두 줄이면 됩니다. 터미널에서 claude 입력해 들어간 다음:

Claude 프롬프트 안에서Slash
/plugin marketplace add anthropics/claude-code-plugins
/plugin install superpowers@claude-plugins-official

확인

Claude 프롬프트 안에서Slash
/plugin list

기대 결과: superpowers@claude-plugins-official 가 enabled로 표시.

8단계 · 자동 메모리 폴더 복원

지금까지 쌓인 메모리(나에 대한 정보, 디자인 시스템 규칙, 출력 위치 등)를 그대로 가져갑니다.

새 컴퓨터 · 터미널Bash
# 폴더 만들기
mkdir -p ~/.claude/projects/-Users-midbar-/memory

# 백업한 메모리 통째로 복사
cp -R ~/Desktop/claude-backup/.claude/projects/-Users-midbar-/memory/. \
  ~/.claude/projects/-Users-midbar-/memory/

확인

터미널Bash
ls ~/.claude/projects/-Users-midbar-/memory/

기대 결과: MEMORY.md + output_location.md + design_system.md + user_non_developer.md + feedback_long_outputs_html.md 등이 보이면 성공.

9단계 · 결과물 폴더 (~/Desktop/Claude) 복원

지금까지 만든 모든 HTML 결과물 + 디자인 시스템(디자인가이드라인/) + index.html 이 들어 있는 폴더를 그대로 옮깁니다.

터미널Bash
# 통째로 복사
cp -R ~/Desktop/claude-backup/Desktop/Claude ~/Desktop/

확인

터미널Bash
ls ~/Desktop/Claude/디자인가이드라인/
open ~/Desktop/Claude/index.html

기대 결과: 디자인가이드라인 폴더 안에 style.css · theme.js · interactions.js · guide.html · README.md 5개 파일이 있고, 브라우저에서 index.html이 깔끔하게 열림.

10단계 · MCP "Talk to Figma" (필요할 때만)

Figma 디자인 자동화를 쓰고 있었다면 이 단계도 필요해요. 안 쓰면 건너뛰어도 됩니다.

터미널Bash
# 1. 옛날 컴퓨터의 ~/Desktop/Claude/_mcp/talk-to-figma 폴더가 있다면
#    그 폴더 째로 새 컴퓨터의 같은 위치에 복사

cp -R ~/Desktop/claude-backup/Desktop/Claude/_mcp ~/Desktop/Claude/

# 2. Bun 런타임 설치 (talk-to-figma가 Bun 기반)
brew install oven-sh/bun/bun

# 3. 의존성 설치
cd ~/Desktop/Claude/_mcp/talk-to-figma
bun install

Figma 데스크톱 앱 측 셋업(플러그인 설치 등)은 이 가이드를 참고하세요.

11단계 · 전체 셋업 검증

이게 통과하면 새 컴퓨터에서도 지금처럼 쓸 수 있어요.

체크리스트

최종 테스트 — Claude에게 직접 물어보기

새로 켠 Claude에 아래를 그대로 붙여보세요:

Claude 프롬프트Test
지금 환경 점검해줘. 메모리 읽어서 내가 누구인지,
출력은 어디에 저장하기로 약속했는지,
Superpowers는 활성인지 확인해서 알려줘.

기대 답변: 메모리에서 "midbar_ · 비개발자 · 출력은 ~/Desktop/Claude/" 등을 인용하고, 기본 응답 직전 using-superpowers 스킬을 호출하는 모습이 보이면 모든 게 정상 작동.

자주 막히는 곳 · 트러블슈팅