팀 플레이북

Claude Code 팀 플레이북

Mac/Windows에서 동일한 Claude Code 환경을 30분 안에 구축하세요. 이 가이드를 순서대로 따라가면 팀 전원이 동일한 AI 개발 환경을 갖출 수 있습니다.

셋업 진행률 0 / 0 완료

체크리스트를 완료하면 자동으로 저장됩니다

⚡

Claude Code CLI + OMC

oh-my-claudecode v4.11.1 — 멀티 에이전트 오케스트레이션 레이어

🔌

19개 플러그인

보안, 개발, 디자인, 배포 — 공식 13개 + 개발 3개 + 서드파티 3개

🔗

MCP 서버 연동

Notion 워크스페이스와 Claude Code를 직접 연결

🛠

80+ 스킬

워크플로우, Google Workspace, 개발 도구 — 키워드 한 줄로 실행

ℹ️

예상 소요 시간: 처음 설치 시 약 25~35분. 섹션 12의 빠른 시작 스크립트를 사용하면 10분 내 완료 가능합니다.

사전 준비

운영체제에 맞는 패키지 관리자와 기본 도구를 설치합니다.

macOS에서는 Homebrew를 통해 패키지를 관리합니다.

bash

# Homebrew 설치 (패키지 관리자)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# Node.js 설치
brew install node

# Git 설치 (Xcode Command Line Tools)
xcode-select --install

# 설치 확인
node --version    # v18 이상 권장
git --version
npm --version

✅

Apple Silicon(M1/M2/M3) Mac에서는 설치 후 eval "$(/opt/homebrew/bin/brew shellenv)" 명령을 실행하세요.

Windows에서는 winget 또는 Chocolatey를 사용합니다.

powershell

# winget으로 Node.js 설치
winget install OpenJS.NodeJS

# Git 설치
winget install Git.Git

# 설치 후 PowerShell 재시작 후 확인
node --version    # v18 이상 권장
git --version
npm --version

⚠️

winget 설치 후 Node.js가 인식되지 않으면 PowerShell을 완전히 닫고 다시 열어야 합니다.

완료 체크

Node.js v18+ 설치 확인 (node --version)

Git 설치 확인 (git --version)

npm 버전 확인 (npm --version)

Claude Code 설치

npm으로 Claude Code CLI를 전역 설치하고 Anthropic 계정으로 로그인합니다.

bash

# Claude Code CLI 전역 설치
npm install -g @anthropic-ai/claude-code

# 설치 확인
claude --version

# Claude Code 첫 실행 (로그인 프로세스 시작)
claude

로그인 방법

Anthropic 계정 준비

console.anthropic.com에서 계정을 생성하거나 기존 계정으로 로그인

claude 명령 실행

터미널에서 claude를 입력하면 브라우저 인증 페이지가 열립니다

API 키 설정 (선택)

환경변수로 설정하려면 ~/.zshrc (Mac) 또는 시스템 환경변수 (Windows)에 추가

bash — API 키 환경변수 설정 (선택)

# Mac: ~/.zshrc 또는 ~/.bashrc에 추가
export ANTHROPIC_API_KEY="YOUR_API_KEY_HERE"
source ~/.zshrc

# Windows PowerShell: 사용자 환경변수에 추가
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "YOUR_API_KEY_HERE", "User")

완료 체크

Claude Code 설치 완료 (claude --version 출력 확인)

Anthropic 계정 로그인 완료

글로벌 설정

Claude Code가 항상 참조하는 전역 지침 파일과 설정을 구성합니다.

프롬프트로 한번에 설정하기

Claude Code가 이미 설치되어 있다면, 아래 프롬프트를 복사해서 붙여넣기만 하면 CLAUDE.md와 settings.json이 자동 생성됩니다.

Claude Code 프롬프트

~/.claude/CLAUDE.md 파일을 아래 내용으로 생성해줘. 이미 있으면 덮어써줘.

# Global CLAUDE.md

## 언어
- 모든 응답, 커밋 메시지, 주석은 한국어로 작성
- 코드 내 변수명, 함수명은 영어로 작성

## 응답 스타일
- 간결하게 핵심만 전달, 불필요한 칭찬이나 서론 생략
- 이모지 사용 금지 (파일명, 커밋 메시지, 응답 포함)

## 작업 원칙
- 작업 시작 전 반드시 프로젝트 구조와 CLAUDE.md를 먼저 파악
- 불확실한 부분은 추측하지 말고 질문할 것

## 코드 작성
- 기존 코드 스타일과 패턴을 반드시 먼저 파악하고 따를 것
- 새로운 기능 추가 시 기존 코드에 영향이 없는지 확인
- 에러 처리를 반드시 포함
- 코드 중복 금지, 새 함수를 만들기 전에 기존 유틸리티 함수를 먼저 확인하고 재사용할 것
- 매직 넘버/문자열 대신 명명된 상수 사용
- 자기 설명적인 코드를 우선, 주석은 의도가 불명확할 때만 작성
- 부분 구현 금지, 항상 완전한 구현을 할 것
- 사용하지 않는 코드는 삭제할 것

## 커밋 및 작업 완료
- 기능 단위로 커밋을 나눌 것 (하나의 커밋에 여러 기능 금지)
- 작업 중간에도 의미 있는 단위가 완성되면 커밋
- 커밋 메시지 형식: [카테고리] 변경 내용 요약 (카테고리: feat, fix, refactor, docs, style, test, chore)
- 작업 완료 시: 프로젝트 CLAUDE.md 업데이트 -> git add -> commit -> push

## 문서 관리
- 새 프로젝트 생성 시 /project-setup 스킬로 표준 구조 스캐폴딩
- 프로젝트 CLAUDE.md에는 항상 최신 상태 유지: 프로젝트 개요, 기술 스택, 주요 명령어, 폴더 구조, 최근 변경사항
- PROGRESS.md가 있으면 진행 상황도 함께 업데이트
- 새 프로젝트 생성 시 워크스페이스 CLAUDE.md의 규칙을 따를 것

## 테스트
- 기존 테스트가 있는 프로젝트에서는 변경 후 테스트 실행하여 통과 확인
- 기존 테스트가 깨지는 변경은 반드시 사전에 알릴 것

## 에러 대응
- 원인 분석 -> 해결 방안 제시 -> 수정 순서로 진행
- 동일 에러에 3회 이상 같은 접근으로 실패하면 다른 방법을 시도할 것
- 반복되는 에러는 CLAUDE.md에 트러블슈팅 항목으로 기록

## 보안
- 시크릿 키, 토큰, API 키 등 민감 정보는 secrets-vault에서 중앙 관리
- 토큰 갱신/재인증 시 secrets-vault의 관련 파일을 최신 상태로 업데이트하고 커밋/푸시할 것
- 토큰 갱신 후 배포 환경의 환경변수도 함께 업데이트할 것
- 프로젝트별 환경변수는 .env 파일로 관리
- 코드에 민감 정보를 절대 하드코딩하지 말 것
- .gitignore에 .secrets-vault, .env 등 민감 파일 포함 확인
- 외부 패키지 추가 시 신뢰성 확인

## 플러그인 활용
- 설치된 플러그인이 있으면 적극 활용
- 코드 리뷰, 보안 점검, 테스트 관련 플러그인은 작업 완료 전 실행
- 새로운 플러그인이 필요하다고 판단되면 추천

그리고 ~/.claude/settings.json이 없으면 아래 내용으로 생성해줘:
{
  "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" },
  "effortLevel": "high"
}

수동으로 설정하기 (참고용)

4-1. CLAUDE.md 작성

Claude Code가 모든 대화에서 참조하는 전역 지침. 언어, 코드 스타일, 커밋 규칙 등을 정의합니다.

Mac: ~/.claude/CLAUDE.md

Windows: %USERPROFILE%\.claude\CLAUDE.md

markdown — ~/.claude/CLAUDE.md

# Global CLAUDE.md

## 언어
- 모든 응답, 커밋 메시지, 주석은 한국어로 작성
- 코드 내 변수명, 함수명은 영어로 작성

## 응답 스타일
- 간결하게 핵심만 전달, 불필요한 칭찬이나 서론 생략
- 이모지 사용 금지 (파일명, 커밋 메시지, 응답 포함)

## 작업 원칙
- 작업 시작 전 반드시 프로젝트 구조와 CLAUDE.md를 먼저 파악
- 불확실한 부분은 추측하지 말고 질문할 것

## 코드 작성
- 기존 코드 스타일과 패턴을 반드시 먼저 파악하고 따를 것
- 새로운 기능 추가 시 기존 코드에 영향이 없는지 확인
- 에러 처리를 반드시 포함
- 코드 중복 금지, 새 함수를 만들기 전에 기존 유틸리티 함수를 먼저 확인하고 재사용할 것
- 매직 넘버/문자열 대신 명명된 상수 사용
- 자기 설명적인 코드를 우선, 주석은 의도가 불명확할 때만 작성
- 부분 구현 금지, 항상 완전한 구현을 할 것
- 사용하지 않는 코드는 삭제할 것

## 커밋 및 작업 완료
- 기능 단위로 커밋을 나눌 것 (하나의 커밋에 여러 기능 금지)
- 작업 중간에도 의미 있는 단위가 완성되면 커밋
- 커밋 메시지 형식: [카테고리] 변경 내용 요약
  - 카테고리: feat, fix, refactor, docs, style, test, chore
  - 예시: [feat] 사용자 로그인 기능 추가
- 작업 완료 시: 프로젝트 CLAUDE.md 업데이트 → git add → commit → push
- PR이 필요한 브랜치 작업인 경우, PR 생성 및 머지까지 진행

## 문서 관리
- 새 프로젝트 생성 시 /project-setup 스킬로 표준 구조 스캐폴딩
- 프로젝트 CLAUDE.md에는 항상 최신 상태 유지: 프로젝트 개요, 기술 스택, 주요 명령어(빌드/테스트/실행), 폴더 구조, 최근 변경사항
- PROGRESS.md가 있으면 진행 상황도 함께 업데이트
- 새 프로젝트 생성 시 워크스페이스 CLAUDE.md의 규칙을 따를 것

## 테스트
- 기존 테스트가 있는 프로젝트에서는 변경 후 테스트 실행하여 통과 확인
- 기존 테스트가 깨지는 변경은 반드시 사전에 알릴 것

## 에러 대응
- 원인 분석 → 해결 방안 제시 → 수정 순서로 진행
- 동일 에러에 3회 이상 같은 접근으로 실패하면 다른 방법을 시도할 것
- 반복되는 에러는 CLAUDE.md에 트러블슈팅 항목으로 기록

## 보안
- 시크릿 키, 토큰, API 키 등 민감 정보는 secrets-vault에서 중앙 관리
- 토큰 갱신/재인증 시 secrets-vault의 관련 파일을 최신 상태로 업데이트하고 커밋/푸시할 것
- 토큰 갱신 후 배포 환경(Railway 등)의 환경변수도 함께 업데이트할 것
- 프로젝트별 환경변수는 .env 파일로 관리
- 코드에 민감 정보를 절대 하드코딩하지 말 것
- .gitignore에 .secrets-vault, .env 등 민감 파일 포함 확인
- 외부 패키지 추가 시 신뢰성 확인

## 플러그인 활용
- 설치된 플러그인이 있으면 적극 활용
- 코드 리뷰, 보안 점검, 테스트 관련 플러그인은 작업 완료 전 실행
- 새로운 플러그인이 필요하다고 판단되면 추천

## Python 버전 관리
- 설치된 버전:
  - python3.11: /opt/homebrew/bin/python3.11
  - python3.13: /opt/homebrew/bin/python3.13
  - python3.14: /opt/homebrew/bin/python3.14
  - /usr/bin/python3 (시스템 Python 3.9.6) -- 사용 금지
- 새 프로젝트: Homebrew로 설치된 최신 안정 버전 사용
- 기존 프로젝트: .python-version 또는 pyproject.toml 우선 참조
- venv 생성 시 반드시 Homebrew Python 사용
- 글로벌 CLI 도구 설치: pipx install <패키지>

4-2. settings.json 설정

Mac: ~/.claude/settings.json

Windows: %USERPROFILE%\.claude\settings.json

json — ~/.claude/settings.json

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  },
  "effortLevel": "high",
  "hooks": { }
}

💡

Tip: settings.json은 OMC 설치(/omc-setup) 시 자동으로 구성됩니다. 섹션 5 완료 후 훅 설정이 자동으로 추가됩니다.

완료 체크

CLAUDE.md 작성 완료

settings.json 확인 완료

OMC 설치

oh-my-claudecode(OMC)는 Claude Code 위에 올라가는 멀티 에이전트 오케스트레이션 레이어입니다.

프롬프트로 설정하기

Claude Code 안에서 아래 프롬프트를 붙여넣으면 OMC가 자동 설치됩니다.

Claude Code 프롬프트

터미널에서 npm install -g oh-my-claude-sisyphus@latest 명령을 실행해서 OMC를 설치해줘. 설치가 완료되면 /omc-setup 을 실행해서 초기 셋업을 진행해줘.

수동으로 설치하기 (참고용)

bash

# oh-my-claudecode npm 패키지 전역 설치
npm install -g oh-my-claude-sisyphus@latest

# 설치 확인 경로: ~/.claude/.omc-version.json

# Claude Code를 열고 프롬프트에서 실행
/omc-setup

ℹ️

/omc-setup을 Claude Code 내에서 실행하세요. npm install 후 터미널에서 claude를 입력해 Claude Code를 열고, 채팅창에 /omc-setup을 입력합니다.

🤖멀티 에이전트 오케스트레이션

Planner, Architect, Executor, Verifier가 협력해 복잡한 작업을 처리

📦80+ 스킬 자동 설치

autopilot, ralph, ultrawork 등 핵심 워크플로우 스킬이 자동으로 활성화

🎣7개 라이프사이클 훅

세션 시작, 프롬프트 제출, 도구 사용 전/후 등 주요 이벤트에 자동 대응

📊HUD 상태 표시줄

현재 활성 모드, 진행 상태, 에러 횟수 등을 실시간으로 표시

완료 체크

npm install -g oh-my-claude-sisyphus@latest 완료

Claude Code 내에서 /omc-setup 실행 완료

~/.claude/.omc-version.json 파일 생성 확인

플러그인 설치

19개 플러그인으로 Claude Code의 기능을 확장합니다.

프롬프트로 설정하기

Claude Code 안에서 아래 프롬프트를 붙여넣으면 플러그인이 자동 설치됩니다.

Claude Code 프롬프트

다음 플러그인을 모두 설치해줘. /install-plugin 명령을 사용해서 하나씩 설치하면 돼.

공식 플러그인 (claude-plugins-official):
semgrep, security-guidance, frontend-design, context7, code-review, superpowers, github, feature-dev, code-simplifier, ralph-loop, playwright, commit-commands, skill-creator

개발 플러그인 (claude-code-plugins):
agent-sdk-dev, claude-opus-4-5-migration, plugin-dev

서드파티 플러그인:
- oh-my-claudecode (마켓플레이스: omc)
- impeccable (마켓플레이스: impeccable, GitHub: pbakaus/impeccable)
- vercel-plugin (마켓플레이스: vercel-vercel-plugin)

설치 후 settings.json의 enabledPlugins에 모두 true로 등록되어 있는지 확인해줘.

공식 플러그인

13개 claude-plugins-official

semgrep 코드 보안 정적 분석

/setup-semgrep-plugin으로 설정. Semgrep 규칙 기반 취약점 탐지 — 코드 작성 시 보안 이슈를 실시간으로 잡아냅니다.

security-guidance 보안 가이드라인

OWASP Top 10 기반 보안 권고. 코드 작성 시 자동으로 보안 베스트 프랙티스를 안내합니다.

context7 최신 라이브러리 문서 조회

라이브러리/프레임워크 질문 시 자동으로 최신 공식 문서를 참조합니다. React, Next.js, Prisma 등 주요 패키지 지원.

github GitHub 이슈/PR 관리

이슈 생성/조회, PR 생성/리뷰, 코드 검색, 브랜치 관리를 Claude Code 안에서 직접 처리합니다.

playwright 브라우저 자동화/테스트

브라우저 네비게이션, 스크린샷, 폼 입력, 네트워크 요청 모니터링 등 E2E 테스트를 자동화합니다.

superpowers 고급 개발 워크플로우 (14개 스킬)

계획/실행

brainstorming writing-plans executing-plans

개발 품질

test-driven-development systematic-debugging verification-before-completion

에이전트 협업

dispatching-parallel-agents subagent-driven-development using-git-worktrees

리뷰/완료

finishing-a-development-branch receiving-code-review requesting-code-review writing-skills using-superpowers

frontend-design 프론트엔드 UI 디자인

프로덕션급 UI 컴포넌트를 생성합니다. AI 특유의 밋밋한 디자인을 피하고 고품질 인터페이스를 만들어 냅니다.

feature-dev 기능 개발 워크플로우

/feature-dev 명령으로 실행. code-architect(설계), code-explorer(탐색), code-reviewer(리뷰) 3개 전문 에이전트가 협력합니다.

code-review PR 코드 리뷰

/code-review [PR번호] 로 실행. 풀 리퀘스트를 자동으로 리뷰하고 개선점을 제안합니다.

code-simplifier 코드 간소화/리팩토링

변경된 코드를 자동 감지해 재사용성, 품질, 효율성 관점에서 리뷰하고 단순화합니다.

ralph-loop 반복 실행 루프

/ralph-loop으로 시작, /cancel-ralph로 중지. 작업이 완료될 때까지 자동으로 반복 실행합니다.

commit-commands 커밋/푸시/PR 자동화

/commit /commit-push-pr /clean_gone

커밋, 커밋+푸시+PR 생성, 삭제된 원격 브랜치 정리를 한 명령으로 처리합니다.

skill-creator 커스텀 스킬 생성

스킬 생성/수정, eval 실행, 성능 벤치마크. analyzer, comparator, grader 에이전트가 스킬 품질을 검증합니다.

개발 플러그인

3개 claude-code-plugins

agent-sdk-dev Claude Agent SDK 개발 도구

/new-sdk-app으로 새 SDK 앱을 스캐폴딩합니다. Python/TypeScript 검증 에이전트가 포함되어 있습니다.

claude-opus-4-5-migration Opus 4.5 마이그레이션

기존 코드/프롬프트를 Opus 4.5 호환 방식으로 자동 변환합니다.

plugin-dev 플러그인 개발 도구

/create-plugin으로 플러그인 스캐폴딩. skill, agent, hook, command 개발 가이드를 제공합니다.

서드파티 플러그인

3개

oh-my-claudecode 멀티 에이전트 오케스트레이션 레이어

핵심 기능

80+ 스킬, 7개 라이프사이클 훅
HUD 상태 표시줄로 에이전트 상태 시각화

Tier-0 워크플로우

autopilot ralph ultrawork team ralplan

설치 방법, 훅 설정, 스킬 목록은 각각 섹션 5(OMC 설치), 섹션 8(훅), 섹션 9(스킬)에서 자세히 다룹니다.

impeccable 21개 UI/UX 디자인 스킬

시작하기

/teach-impeccable — 프로젝트 디자인 컨텍스트를 수집하고 .impeccable.md를 생성합니다. 최초 1회만 실행하면 됩니다.

진단

audit critique normalize

접근성/성능/테마 점검, UX 평가, 디자인 시스템 정합성 검토

향상

animate delight colorize bolder overdrive

모션 추가, 인터랙션 강화, 색상 강화, 임팩트 증가, 고급 시각 효과

정제

polish quieter distill clarify typeset

마무리 품질, 과도한 디자인 완화, 단순화, UX 카피 개선, 타이포그래피

구조

arrange adapt extract harden

레이아웃/여백, 반응형 최적화, 컴포넌트 추출, 에러 핸들링/i18n 강화

생성

frontend-design onboard optimize

UI 컴포넌트 생성, 온보딩 플로우 설계, 성능 최적화

vercel-plugin 20+ Vercel 개발 스킬

배포

/deploy /status deployments-cicd vercel-cli

환경

/env /bootstrap

환경변수 관리, 프로젝트 초기 설정

프레임워크

nextjs shadcn turbopack react-best-practices

Next.js App Router, shadcn UI 컴포넌트, Turbopack, React 베스트 프랙티스

인프라

vercel-functions routing-middleware runtime-cache vercel-storage

ai-sdk ai-gateway chat-sdk

AI SDK, 모델 라우팅 게이트웨이, 멀티플랫폼 챗봇 SDK

기타

auth marketplace workflow vercel-sandbox

인증, 마켓플레이스 통합, 내구성 워크플로우, 샌드박스 환경

설치 방법: Claude Code 내에서 /install-plugin [플러그인명] 명령으로 설치하거나, settings.json의 enabledPlugins 배열에 직접 추가할 수 있습니다.

완료 체크

공식 플러그인 설치 완료 (13개)

개발 플러그인 설치 완료 (3개)

서드파티 플러그인 설치 완료 (3개)

MCP 서버 설정

Model Context Protocol(MCP)로 Notion 등 외부 서비스를 Claude Code에 직접 연결합니다.

프롬프트로 설정하기

Notion API 토큰을 준비한 후, Claude Code 안에서 아래 프롬프트를 붙여넣으세요.

Claude Code 프롬프트

~/.claude/.mcp.json 파일을 아래 내용으로 생성해줘. NOTION_TOKEN 값은 내가 알려줄게.

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "NOTION_TOKEN": "여기에_토큰_입력"
      }
    }
  }
}

수동으로 설정하기 (참고용)

json — ~/.claude/.mcp.json

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "NOTION_TOKEN": "YOUR_NOTION_TOKEN_HERE"
      }
    }
  }
}

🔒

보안 주의: Notion 토큰은 절대 코드나 공개 저장소에 하드코딩하지 마세요. .gitignore에 .mcp.json이 포함되어 있는지 반드시 확인하세요.

Notion API 토큰 발급 방법

notion.so/my-integrations에 접속

"New integration" 클릭 → 이름 입력 → 워크스페이스 선택

생성된 "Internal Integration Secret" 복사 → .mcp.json에 붙여넣기

Notion 페이지에서 우상단 "..." → "Connect to" → 생성한 인테그레이션 선택

완료 체크

~/.claude/.mcp.json 파일 생성 완료

Notion 토큰 발급 및 설정 완료

훅 시스템

OMC의 훅 시스템은 Claude Code 라이프사이클 이벤트에 자동으로 반응합니다.

✅

자동 설정: 훅은 OMC 설치(/omc-setup) 시 자동으로 구성됩니다. 별도의 수동 설정이 필요하지 않습니다.

이벤트	훅 파일	역할
`SessionStart`	`session-start.mjs`	활성 모드 복원, 업데이트 알림, 노트패드 로드
`UserPromptSubmit`	`keyword-detector.mjs`	매직 키워드 감지 (ralph, autopilot 등) → 스킬 자동 호출
`PreToolUse`	`pre-tool-use.mjs`	소스 파일 직접 수정 경고, 팀 워커 권한 제한
`PostToolUse`	`post-tool-use.mjs`	<remember> 태그 처리 → 노트패드 저장, Ralph 상태 활성화
`PostToolUseFailure`	`post-tool-use-failure.mjs`	에러 상태 기록, 재시도 횟수 추적
`Stop (1)`	`persistent-mode.mjs`	OMC 모드 중단 방지, 에러 재시도 가이드 제공
`Stop (2)`	`code-simplifier.mjs`	수정 파일 자동 감지 → 코드 심플리파이 에이전트 위임

매직 키워드 (keyword-detector 훅)

프롬프트에 다음 키워드를 입력하면 해당 스킬이 자동 실행됩니다.

autopilot ralph ulw ralplan deep interview deslop anti-slop tdd deepsearch ultrathink ccg code review security review deep-analyze cancelomc

확인 체크리스트

settings.json에 훅 7개 (5개 이벤트)가 등록되어 있는지 확인

매직 키워드 "autopilot" 입력 시 스킬 자동 호출 확인

스킬 가이드

80개 이상의 스킬을 카테고리별로 정리했습니다. 클릭해서 펼치세요.

⚡

핵심 워크플로우 (Tier-0) 6개 스킬

스킬	트리거	설명
`autopilot`	"autopilot"	아이디어→코드 완전 자동 실행. 탐색→계획→실행→검증 전 과정 자동화
`ralph`	"ralph"	완료까지 반복 실행. Verifier가 OK 할 때까지 루프
`ultrawork`	"ulw"	독립 작업 병렬 실행. N개 에이전트가 동시에 처리
`team`	"/team"	N개 전문 에이전트 협업 파이프라인 구성
`ralplan`	"ralplan"	합의 계획 — Planner → Architect → Critic 순서로 계획 검증
`deep-interview`	"deep interview"	소크라테스식 요구사항 정제. 모호한 요청을 명확한 스펙으로

🔧

개발 도구 5개 스킬

스킬	설명
`deepinit`	계층적 AGENTS.md 자동 생성 — 프로젝트 전체 문서화
`trace`	이슈/버그 인과관계 추적, 타임라인 분석
`ai-slop-cleaner`	AI 생성 코드 품질 정리 ("deslop" 또는 "anti-slop" 키워드)
`self-improve`	자가 진화 코드 개선 루프
`project-session-manager`	Git 워크트리 기반 병렬 개발 환경 관리

📧

Google Workspace Gmail, Calendar, Sheets, Docs, Drive, Chat, Tasks, Forms, Slides

Gmail

이메일 읽기/발송/회신
자동 분류 및 레이블링
필터 생성 자동화
팀 공지 일괄 발송

Calendar

일정 조회/생성
반복 일정 예약
빈 시간 자동 탐색
시트 → 이벤트 자동 생성

Sheets / Docs / Drive

시트 읽기/쓰기/추가
월별 시트 복사 자동화
Docs 초안 작성/수정
Drive 파일 공유/알림

기타

Chat 메시지 발송
Tasks 관리
Forms 응답 수집
Slides 프레젠테이션 생성

👤

페르소나 역할 기반 전문 에이전트

스킬	설명
`persona-sales-ops`	세일즈 파이프라인, CRM, 성과 추적 워크플로우
`persona-exec-assistant`	일정 관리, 이메일 처리, 보고서 작성 비서 업무
`persona-team-lead`	팀 리드 관점의 코드 리뷰, 기술 의사결정
`persona-project-manager`	프로젝트 계획, 일정 추적, 리스크 관리

★

팀 커스텀 스킬 자체 제작 3개

스킬	트리거	설명
`project-setup`	"/project-setup"	새 프로젝트 표준 구조 스캐폴딩 — CLAUDE.md, AGENTS.md, ARCHITECTURE.md, docs/ (4가지 모드)
`update-docs`	"문서 업데이트"	프로젝트 내 모든 .md 문서를 현재 코드 상태와 비교하여 일괄 업데이트
`notebooklm`	"/notebooklm"	Google NotebookLM 연동 — 노트북 생성, 소스 추가, 팟캐스트/요약 생성, 다운로드

ⓘ

설치 방법: 이 스킬들은 플레이북 레포의 skills/ 디렉토리에 포함되어 있습니다. 아래 프롬프트로 자동 설치할 수 있습니다.

Claude Code 프롬프트 - 커스텀 스킬 설치

팀 커스텀 스킬 3개를 설치해줘.

1. 먼저 플레이북 레포를 클론해줘:
   git clone https://github.com/flavours3386/claude-code-playbook.git /tmp/claude-code-playbook

2. 스킬 디렉토리를 복사해줘:
   cp -r /tmp/claude-code-playbook/skills/project-setup ~/.claude/skills/project-setup
   cp -r /tmp/claude-code-playbook/skills/update-docs ~/.claude/skills/update-docs
   cp -r /tmp/claude-code-playbook/skills/notebooklm ~/.claude/skills/notebooklm

3. 임시 디렉토리 정리:
   rm -rf /tmp/claude-code-playbook

4. 설치 확인: ~/.claude/skills/ 에 project-setup, update-docs, notebooklm 디렉토리가 있는지 확인해줘.

✓

스킬 직접 만들기: /skill add 또는 /learner 명령으로 반복 워크플로우를 스킬로 추출할 수 있습니다.

확인 체크리스트

핵심 스킬(autopilot, ralph, ulw) 테스트 실행 확인

스킬 목록 확인 (/skill list 실행)

일상 워크플로우

팀의 표준 개발 흐름. 각 단계에서 사용하는 명령어를 확인하세요.

코드 작성

→

리뷰

→

커밋

→

배포

코드 작성

OMC 워크플로우 스킬로 아이디어를 코드로 자동 변환합니다.

autopilot — 완전 자동화 ralph — 검증 루프 ulw — 병렬 처리

프롬프트 예시

autopilot: Pipedrive API에서 이번 주 클로즈된 딜을 가져와서
Google Sheets에 업데이트하는 스크립트를 만들어줘

코드 리뷰

code-review 플러그인으로 변경사항을 자동 검토합니다.

Claude Code 내 명령

/code-review

커밋

팀 커밋 컨벤션을 준수하는 커밋 메시지를 자동 생성합니다.

Claude Code 내 명령

# 커밋 자동 생성 (CLAUDE.md 커밋 규칙 자동 적용)
/commit

# 형식: [카테고리] 변경 내용 요약
# 예시 출력: [feat] Pipedrive 딜 싱크 스크립트 추가

PR 생성

커밋, 푸시, PR 생성을 한 번에 처리합니다.

Claude Code 내 명령

/commit-push-pr

배포

Vercel 플러그인으로 배포를 자동화합니다.

Claude Code 내 명령

# 프리뷰 배포
/deploy

# 프로덕션 배포
vercel --prod

트러블슈팅

자주 발생하는 문제와 해결 방법입니다. 클릭해서 펼치세요.

✕ "claude 명령어를 찾을 수 없음" (command not found)

bash

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

# npm 글로벌 경로 확인
npm config get prefix

# PATH에 추가 (Mac - ~/.zshrc에 추가)
export PATH="$PATH:$(npm config get prefix)/bin"
source ~/.zshrc

# Windows: 시스템 환경변수 PATH에 추가
# 일반적으로: C:\Users\{사용자명}\AppData\Roaming\npm

✕ "OMC 훅 에러" 또는 훅이 작동하지 않음

bash

# Claude Code 내에서 진단 실행
/omc-doctor

# Node.js 버전 확인 (v18 이상 필요)
node --version

# 업그레이드 (Mac)
brew upgrade node

# OMC 재설치
npm install -g oh-my-claude-sisyphus@latest

✕ 플러그인이 로드되지 않음

json — settings.json enabledPlugins 확인

{
  "enabledPlugins": [
    "semgrep", "context7", "code-review",
    "commit-commands", "github", "playwright"
  ]
}

Claude Code를 완전히 종료 후 재시작하세요. 캐시 문제 시 ~/.claude/cache 폴더 삭제 후 재시작합니다.

✕ MCP 서버 연결 실패 (Notion 연결 안 됨)

bash — 진단 단계

# .mcp.json JSON 문법 확인
cat ~/.claude/.mcp.json | python3 -m json.tool

# npx 캐시 삭제
rm -rf ~/.npm/_npx

# 토큰 재발급: notion.so/my-integrations
# .mcp.json NOTION_TOKEN 값 업데이트 후 Claude Code 재시작

✕ Windows에서 경로 오류 발생

powershell

# 백슬래시(\) 대신 슬래시(/) 사용
# 잘못된 예: C:\Users\name\.claude\
# 올바른 예: C:/Users/name/.claude/

# 환경변수 확인
echo $env:USERPROFILE
echo $env:PATH

# 실행 정책 문제 시
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

✕ API 키 인증 실패

bash

# 로그아웃 후 재로그인
claude logout
claude login

! Context window 초과 오류

Claude Code 내 명령

# 컨텍스트 초기화
/clear

# 또는 컨텍스트 압축
/compact

빠른 시작 가이드

개발 경험이 없어도 괜찮습니다. 아래 3단계만 따라하면 됩니다.

Step 1. 터미널 열기

Command + Space 키를 눌러 Spotlight 검색을 엽니다
"터미널" 이라고 입력하고 Enter를 누릅니다
검은 화면(터미널)이 열리면 준비 완료

화면 하단 시작 버튼을 우클릭합니다
"Windows PowerShell" 또는 "터미널"을 클릭합니다
파란 화면(PowerShell)이 열리면 준비 완료

Step 2. 설치 명령어 실행

아래 명령어를 한 줄씩 복사해서 터미널에 붙여넣고 Enter를 누르세요.

2-1. Node.js 설치 확인

터미널

brew install node

PowerShell

winget install OpenJS.NodeJS

이미 설치되어 있다면 건너뛰세요. node --version 으로 확인 가능합니다.

2-2. Claude Code 설치

터미널 (Mac/Windows 동일)

npm install -g @anthropic-ai/claude-code

2-3. Claude Code 실행 및 로그인

터미널 (Mac/Windows 동일)

브라우저가 열리면 Anthropic 계정으로 로그인하세요. 로그인 후 터미널로 돌아오면 Claude Code가 준비된 상태입니다.

Step 3. 셋업 프롬프트 붙여넣기

Claude Code가 실행된 상태에서 아래 프롬프트를 통째로 복사해서 붙여넣고 Enter를 누르세요. 나머지는 Claude Code가 알아서 합니다.

Claude Code 올인원 셋업 프롬프트

아래 작업을 순서대로 진행해줘. 각 단계가 완료되면 다음 단계로 넘어가고, 에러가 나면 해결 방법을 알려줘.

## 1단계: 글로벌 CLAUDE.md 생성
~/.claude/CLAUDE.md 파일을 아래 내용으로 생성해줘:

# Global CLAUDE.md

## 언어
- 모든 응답, 커밋 메시지, 주석은 한국어로 작성
- 코드 내 변수명, 함수명은 영어로 작성

## 응답 스타일
- 간결하게 핵심만 전달, 불필요한 칭찬이나 서론 생략
- 이모지 사용 금지 (파일명, 커밋 메시지, 응답 포함)

## 작업 원칙
- 작업 시작 전 반드시 프로젝트 구조와 CLAUDE.md를 먼저 파악
- 불확실한 부분은 추측하지 말고 질문할 것

## 코드 작성
- 기존 코드 스타일과 패턴을 반드시 먼저 파악하고 따를 것
- 새로운 기능 추가 시 기존 코드에 영향이 없는지 확인
- 에러 처리를 반드시 포함
- 코드 중복 금지, 새 함수를 만들기 전에 기존 유틸리티 함수를 먼저 확인하고 재사용할 것
- 매직 넘버/문자열 대신 명명된 상수 사용
- 자기 설명적인 코드를 우선, 주석은 의도가 불명확할 때만 작성
- 부분 구현 금지, 항상 완전한 구현을 할 것
- 사용하지 않는 코드는 삭제할 것

## 커밋 및 작업 완료
- 기능 단위로 커밋을 나눌 것
- 커밋 메시지 형식: [카테고리] 변경 내용 요약 (카테고리: feat, fix, refactor, docs, style, test, chore)
- 작업 완료 시: 프로젝트 CLAUDE.md 업데이트 -> git add -> commit -> push

## 문서 관리
- 프로젝트 CLAUDE.md에는 항상 최신 상태 유지
- PROGRESS.md가 있으면 진행 상황도 함께 업데이트

## 테스트
- 변경 후 테스트 실행하여 통과 확인
- 기존 테스트가 깨지는 변경은 반드시 사전에 알릴 것

## 에러 대응
- 원인 분석 -> 해결 방안 제시 -> 수정 순서로 진행
- 동일 에러에 3회 이상 같은 접근으로 실패하면 다른 방법 시도

## 보안
- 민감 정보는 .env 파일로 관리, 코드에 하드코딩 금지
- .gitignore에 .env 등 민감 파일 포함 확인

## 2단계: settings.json 생성
~/.claude/settings.json 파일이 없으면 아래 내용으로 생성해줘:
{
  "env": { "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1" },
  "effortLevel": "high"
}

## 3단계: OMC 설치
터미널에서 다음 명령을 실행해줘:
npm install -g oh-my-claude-sisyphus@latest

설치가 완료되면 /omc-setup 을 실행해줘.

## 4단계: 완료 확인
위 작업이 모두 끝나면 아래를 확인해서 알려줘:
- ~/.claude/CLAUDE.md 파일이 존재하는지
- ~/.claude/settings.json 파일이 존재하는지
- ~/.claude/.omc-version.json 파일이 존재하는지 (OMC 설치 확인)

✓

이 프롬프트 실행 후 추가로 플러그인을 설치하려면 섹션 6의 "프롬프트로 설정하기"를 사용하세요.

셋업 완료 최종 확인

claude --version 정상 출력

claude 로그인 완료, 정상 응답 확인

/omc-setup 완료, OMC 스킬 로드 확인

플러그인 설치 완료 (19개)

Notion MCP 연결 테스트 완료

Claude Code 팀 플레이북

Claude Code CLI + OMC

19개 플러그인

MCP 서버 연동

80+ 스킬

로그인 방법

4-1. CLAUDE.md 작성

4-2. settings.json 설정

공식 플러그인

개발 플러그인

서드파티 플러그인

Notion API 토큰 발급 방법

매직 키워드 (keyword-detector 훅)

코드 작성

코드 리뷰

커밋

PR 생성

배포

Step 1. 터미널 열기

Step 2. 설치 명령어 실행

Step 3. 셋업 프롬프트 붙여넣기

셋업 완료!