실전 환경 설정

사전 준비물

SDD 시스템을 사용하기 위한 필수 준비물이다.

항목	요구사항
Claude 계정	Pro, Max, Teams, Enterprise, Console 계정 또는 지원되는 외부 제공자
Node.js	18 이상 버전
터미널	기본 터미널 또는 Ghostty 등

Claude Code 설치 및 기본 명령어

현재는 native installer가 권장 경로이고, npm 설치는 Node.js 18+ 환경에서 사용하는 호환 경로로 보면 된다.

# Claude Code 설치 (권장: macOS / Linux / WSL)
curl -fsSL https://claude.ai/install.sh | bash

# 대안: npm 설치 (Node.js 18+ 필요)
npm install -g @anthropic-ai/claude-code

# Claude Code 실행
claude

# 설치 확인
claude --version
claude doctor

# 쿼리와 함께 바로 시작
claude "python hello world 코드 작성해줘"

# 도움말
/help

# 컨텍스트 초기화 (매우 중요!)
/clear

# 종료
exit    # 또는 Ctrl+C 두 번

YOLO 모드 (권한 자동 승인)

실습 시에는 매번 권한을 승인하지 않도록 YOLO 모드로 실행할 수 있다.

claude --dangerously-skip-permissions

주의: 실제 프로덕션 프로젝트에서는 YOLO 모드 사용을 권장하지 않는다.

.claude 폴더 구조

SDD 시스템의 설정은 .claude 폴더 안에 정의한다. 이 강의에서는 skills/, agents/, commands/를 함께 설명하지만, 최신 Claude Code 문서 기준으로는 skills 중심 구성이 권장되고 commands/는 호환 경로로 이해하면 된다.

전역 설정 vs 프로젝트 설정

.claude 폴더는 두 가지 위치에 놓을 수 있다.

구분	경로	적용 범위	사용 시점
전역 설정	~/.claude/ 또는 상위 폴더	모든 프로젝트	공통 스킬/에이전트
프로젝트 설정	/프로젝트/.claude/	해당 프로젝트만	프로젝트 고유 설정

주의: 중복 커맨드 문제

같은 이름의 skill이 여러 위치에 있으면 Claude Code는 우선순위를 적용한다. 개인 설정과 프로젝트 설정을 섞을 때는 "공통 규칙은 ~/.claude/", "프로젝트 전용 규칙은 /프로젝트/.claude/"처럼 역할을 분리하는 편이 안전하다.

SDD Init으로 프로젝트 시작

프로젝트를 시작할 때는 /sdd.init 커맨드로 기본 구조를 자동 생성한다. 이 커맨드는 Claude 기본 제공 명령이 아니라, SDD용 커스텀 skill/command 예시다.

Init 후 생성되는 구조:

my-project/
├── .claude/          # SDD 설정 (사전 복사)
│   ├── skills/
│   ├── agents/
│   └── commands/     # 선택: 기존 커맨드 호환 방식
├── docs/             # Init이 생성
│   ├── PRD.md        # 아직 비어있음
│   └── TechSpec.md   # 아직 비어있음
└── src/              # Init이 생성 (아직 비어있음)

실습 시작 체크리스트

1. Claude Code 사용 가능한 계정 유형 확인
2. Node.js 18+ 설치 확인
3. Claude Code 설치: 권장 curl -fsSL https://claude.ai/install.sh | bash
4. claude --version, claude doctor로 설치 확인
5. 프로젝트 폴더 생성
6. .claude 폴더 복사 (Skills, Agents, 필요 시 Commands)
7. 프로젝트 폴더에서 claude 실행
8. /sdd.init으로 프로젝트 초기화
9. /sdd.plan 또는 sdd.auto로 개발 시작