클로드 코드 시작하기
- 기본 기능 및 대화 제어
| 명령어 | 설명 |
|---|
| /help | 사용법 도움말 및 사용 가능한 명령어 확인 |
| /clear(reset) | 대화 기록 지우기 |
| /compact | 대화 압축 |
| /export | 대화를 클립보드 또는 파일로 내보내기 |
| /resume | 특정 세션의 대화를 계속 진행 |
| /bug | 버그 신고(대화 내용을 앤트로픽으로 전송) |
| /exit(quit) | 현재 세션 종료 |
- 모델 설정 및 계정 관리
| 명령어 | 설명 |
|---|
| /model | 인공지능 모델 선택 또는 변경 |
| /login | 앤트로픽 계정 전환 |
| /logout | 앤트로픽 계정에서 로그아웃 |
- 파일 및 프로젝트 관리
| 명령어 | 설명 |
|---|
| /init | 클로드 코드가 프로젝트를 이해할 수 있도록 도와주는 초기 명령어 |
| /memory | CLAUDE.md의 메모리 파일 편집 |
| /permissions(allowed-tools) | 파일에 접근하는 도구의 허용 여부 설정 |
| add-dirs | 클로드 코드가 여러 디렉터리 간 작업을 가능하게 함 |
- 시스템 점검 및 요금 통계
| 명령어 | 설명 |
|---|
| /status | 현재 상태 및 시스템 정보 확인 |
| /cost | 토큰 사용량 및 비용 통계 표시 |
| /doctor | 클로드 코드의 설치 상태 및 건강 상태 검사 |
- 보기 및 입출력 설정
| 명령어 | 설명 |
|---|
| /config(theme) | 클로드 코드의 보기 설정 및 수정 |
| /vim | vim 모드를 사용 |
| ! | 배시 모드를 사용 |
| /bashes | 백그라운드에서 실행 중인 배시 세션들의 조회 및 관리 |
| /output-style | 출력 스타일 변경 |
| output-style:new | 새로운 출력 스타일을 생성 |
| /statusline | 클로드 코드의 현재 상태를 표시하고 제어 |
- 코드 리뷰 및 분석
| 명령어 | 설명 |
|---|
| /review | 코드 리뷰 수행 |
| /security-review | 보안 관점의 코드 리뷰 수행 |
| /pr_comments | 풀리퀘스트 코멘트 관련 기능 |
- 편의성
| 명령어 | 설명 |
|---|
| /terminal-setup | 사용장의 터미널 환경 설정 |
| ide | 내장 IDE 환경 열기 및 코드 작업 |
| /migrate-installer | 클로드 코드의 설치를 다른 형태로 마이그레이션 |
- 기능 확장
| 명령어 | 설명 |
|---|
| /agents | 전문화된 인공지능 서브에이전트의 생성 및 관리 |
| mcp | MCP(Model Context Protocol) 관련 기능 제어 |
| /install-github-app | 깃허브 저장소에 클로드 앱 설치 및 프로젝트 연동 |
| /hooks | 사용자 정의 훅 설정 및 이벤트 연동 |
- 기타
| 명령어 | 설명 |
|---|
| /release-notes | 현재까지의 릴리스 노트 확인 |
| /upgrade | 구독 플랜을 업그레이드 |
클로드 코드 설정하기
CLAUDE.md란
클로드 코드에게 이 모든 정보를 제공하는 '지침서' 역할
CLAUDE.md 메모리 스코프와 파일위치
| 스코프 유형 | 파일 위치 및 이름 | 적용 영역 | 주요 용도 및 내용 |
|---|
| User Scope(사용자 범위) | ~/.claude/CLAUDE.md | 모든 프로젝트 | 개인 설정(예: 코딩 스타일, 툴, 환경 변수등) |
| Project Scope(프로젝트 범위) | <프로젝트>/CLAUDE.md | 특정 프로젝트 | 프로젝트 공통 컨벤션, 구조, 협업 규칙 문서화 |
CLAUDE.md 작성 원칙
- 간결성 우선 : 장황한 설명보다는 짧고 명확한 표현
- 선언적 형태 : 문장보다 점스타일 위주
- 토큰 효율성 : 불필요한 서술 제거
- 실시간 업데이트 : 프로젝트 진행에 따라 주기적으로 개선
- 필수 포함 요소 : 기술스택, 프로젝트 구조, 핵심 명령어, 코딩 스타일, 기타 저장소 규칙
프롬프트 작성하기
- 좋은 프롬프트 = 구체적인 컨텍스트 + 명확한 요구사항 + 예상 결과물
- 토큰 효율성을 고려한 간결하고 정확한 표현
- 단계별로 접근으로 복잡한 문제를 해결
- 실제 프로젝트에 바로 적용 가능한 실용적 접근
클로드 실행 모드 마스터하기
- 인터랙티브/프린트 모드는 기본 동작 방식의 차이
- YOLO 모드는 권한 스킵 옵션으로 두 모드 모두에서 사용 가능
- shift + tab으로 일반/Auto-Accept Edits 플랜 모드 순환 전환
- esc 1번으로 작업 중단, esc 2번으로 히스토리 탐색
- 프로젝트 단계와 상황에 따라 적절한 조합 선택
- YOLO 모드는 Dev Container 같은 격리된 환경에서 사용하여 안정성 확보
- CLAUDE.md 설정을 통해 각 모드의 성능과 안정성 향상 가능
클로드 코드의 내장 도구와 터미널 확장
- 내장 도구의 힘 : Read, Write, Edit, Bash 등 강력한 내장 도구 활용
- 터미널 통합 : 모든 CLI 도구를 클로드 코드에서 직접 실행
- 도구 조합 : 여러 도구를 조합하여 복잡한 워크플로 자동화
- 커스텀 스크립트 : 프로젝트별 특화 스크립트로 효율성 극대화
- 실전 활용 : 프로젝트 관리부터 팀 협업까지 다양한 시나리오 적용
MCP연동
- 컨텍스트 엔지니어링 : AI가 접근할 수 있는 환경을 확장하는 접근법
- 연결 방식 : STDIO(로컬), HTTP(원격)
- 실전 활용 : 데이터 조회, 분석, 자동화 작업 수행
- MCP 서버 관리 : claude mcp add/list/remove 명령으로 간편하게 관리
- 적용 방법
1. 필요한 MCP 서버 파악: 프로젝트에 필요한 외부 시스템 확인
2. 단계적 추가 : claude mcp add 명령으로 하나씩 추가하며 테스트
3. 권한 설정 : 각 서버별로 필요한 최소 권한만 부여
4. 점진적 확장 : 성공적으로 연동된 후 다른 시스템 추가
클로드 워크플로 전략
프로젝트 설계
- 프로젝트 아키텍처 설계
온라인 쇼핑몰 서비스를 위한 마이크로서비스 아키텍처를 설계해줘
주요기능 : 사용자 인증, 상품 관리, 주문 처리, 결제, 배송 추적
Mermaid 다이어그램으로 시각화해줘
다음 기술 스택의 호환성을 검토해줘
각 기술의 버전 호환성과 잠재적 이슈를 분석해줘
- 프로젝트 구조 설계
npn workspace를 사용한 모노레포 구조를 생성해줘
packages :
- web (Next.js frontend)
- api (NestJs backend)
- shared (공통 타입 정의)
- ui (공통 UI 컴포넌트)
다음 설정 파일들을 생성해줘.
1. TypeScript 설정 (strict mode)
2. ESLint + Prettier 설정
3. Git hooks (Husky + lint-staged)
4. VS Code 프로젝트 설정
- WBS 작성
온라인 쇼핑몰 MVP 개발을 위한 WBS를 작성해줘.
- 프로젝트 기간 : 3개월
- 팀 구성 : 풀스택 개발자 2명
- Markdown 테이블 형식으로 작성해줘
위 WBS를 기반으로 GitHub Issues를 자동으로 생성할 수 있는 gh CLI 명령어 스크립트를 작성해줘
위 WBS를 기반으로 Jira 티켓을 생성하는 Node.js 스크립트를 작성해줘. Jira Rest API를 사용해
- 리스크 분석과 대응 계획
현재 프로젝트 구성을 분석하여 잠재적인 기술적 리스크를 식별하고, 각 리스크에 대한 대응 방안을 제시해줘
프로젝트 정보 :
- 마이크로 서비스 아키텍처
- 예상 동시 접속자 10,000명
- 데이터베이스 : PostgreSQL(단일 인스턴스)
- 캐시 : Redis
- 배포 : Kubernetes
- 프로젝트 문서 템플릿 생성
프로페셔널한 README.md 템플릿을 생성해줘
포함 사항 :
- 프로젝트 개요
- 기술 스택
- 설치 가이드
- 환경 변수 설정
- API 문서 링크
- 컨트리뷰션 가이드
PostgreSQL vs MongoDB 선택에 대한 ADR을 작성해줘
Y-statement 형식을 사용해봐
- 레시피 공유 서비스 설계
### step1 : 프로젝트 초기화
레시피 공유 서비스를 초기화해줘
- Frontend: Next.js 14(App Router) + shadcn/ui
- Backend : Express + TypeScript
- Database : SQLite(개발용)
- 인증 : JWT
- 이미지 업로드 : 로컬 저장, S3 전환 여지 확보
### step2 : 기능 명세 작성
레시피 공유 서비스의 MVP 기능 명세서를 작성해줘
- 사용자 스토리 형식
- 우선순위 표시 (p0, p1, p2)
- 예상 구현 시간 포함
### step3 : 아키텍처
아키텍처 다이어그램을 mermaid chart를 포함해서 작성해줘
### step4 : WBS
레시피 공유 서비시의 MVP 기능 명세서를 작성해줘
- 사용자 스토리 형식
- 우선순위 표시 (p0, p1, p2)
- 예상 구현 시간 포함
## step5 : 리스크 확인
설계 결과물을 보고 리스크 분석을 해줘
부트스트래핑 : 프로젝트 초기 구성 자동화
앞서 레시피 공유 서비스 예제를 기반으로 템플릿 생성
1. 프로젝트 템플릿 생성
/init
지금 문서를 기반으로 프로젝트 템플릿을 생성해줘
- 의존성 관리
package.json의 의존성을 분석하고 다음 작업을 수행해줘
1. 보안 취약점 확인
2. 최신 안정 버전으로 업데이트 가능한 패키티 목록
3. 버전 충돌 가능성 확인
4. 불필요한 의존성 제거
pnpm workspace를 사용한 monorepo 의존성을 설정해줘.
- 공통 의존성은 루트에 설치
- 패키지 간 의존성 연결
- 타입스크립트 프로젝트 레퍼런스 설정
- 개발환경 구성
VS Code 설정 파일을 생성해줘
- 추천 익스텐션 목록
- 디버깅 설정
- 태스크 러너
- 코드 스니펫
Git hooks를 설정해줘.
- pre-commit : 린트와 포맷팅 체크
- commit-msg: 커밋 메시지 규칙 검증
- pre-push: 테스트 실행
- 컨테이너 환경 구성
개발용 Docker 환경을 구성해줘
- Hot reload 지원
- 데이터 베이스 연동
- 볼륨 마운트 설정
- 너트워크 설정
로컬 테스트용으로 k8s manifest를 작성해줘
- 테스트 환경 부트스트래핑
테스트 환경을 설정해줘
- Jest 설정(unit test)
- React Testing Library (component test)
- Playwright ( E2E test)
- 테스트 커버리지 설정
- 부트스트래핑
현재까지 구상된 문서 및 설계를 바탕으로 MVP를 구현해줘
docker-compose를 통해 실행 가능한 형태로. 구현 내용은 playwright를 통해 검증해줘
- 체크리스트
- 프로젝트 기본 구조 생성
- 타입스크립트 설정 완료
- 린터/포매터 설정
- 깃 훅 설정
- 환경 변수 설정
- 도커 개발 환경 구성
- 테스트 환경 설정
- CI/CD 파이프라인 구성
- README 문서 작성
- CLAUDE.md 설정 문서화
테스트 : 클로드 코드와 함께 하는 TDD
- 단위 테스트
다음 함수에 대한 Jest 테스트 코드를 작성해줘
edge case와 정상 케이스를 모두 포함해줘
다음 React 컴포넌트에 대한 테스트를 작성해줘
React Testing Library를 사용해줘
- TDD 워크플로
### Red : 실패하는 테스트 작성
사용자 등록 기능을 TDD로 개발합니다. 먼저 실패하는 테스트부터 작성해줘. 요구사항은 다음과 같아.
- 이메일과 비밀번호로 회원가입
- 이메일 중복 체크
- 비밀번호 해싱
- 입력값 유효성 검사
### Green : 최소한의 코드로 테스트 통과시키기
작성된 테스트를 통과하는 UserService 클래스를 구현해줘. 최소한의 코드로 테스트만 통과하면 돼
### Refactor : 코드 품질 개선
UserService 코드를 리팩토링해줘. 의존성 주입, 에러 핸들링 개선, 타입 안정성 강화를 적용하고 테스트도 함께 수정해줘
현재 코드의 테스트 커버리지를 분석하고, 누락된 테스트 케이스를 추가해줘. 목표 커버리지는 90% 이상이다.
- 통합 테스트
Express API 엔드포인트에 대한 통합 테스트를 작성해줘
POST api/users - 사용자 생성
GET api/users/:id - 사용자 조회
PUT api/users/:id - 사용자 수정
DELETE api/users/:id - 사용자 삭제
Supertest를 사용하고, 데이터베이스는 모킹해줘
- E2E 테스트
전자상거래 사이트의 구매 플로우에 대한 E2E 테스트를 Playwright로 작성해줘
1. 홈페이지 방문
2. 상품 검색
3. 상품 선택
4. 장바구니 추가
5. 체크아웃
6. 결제 정보 입력
7. 주문 완료 확인
- 테스트 자동화와 CI/CD
- PR 생성시 모든 테스트 실행
- 테스트 커버리지 리포트 생성
- 테스트 실패시 PR 병합 차단
- 병렬 테스트 실행으로 속도 최적화
- 테스트 모니터링과 리포팅
태스트 결과를 시각화하는 대시보드를 만들어줘
- 테스트 통과율 추이
- 커버리지 변화 그래프
- 실패한 테스트 목록
- 테스트 실행 시간 분석
개선 : 코드 리뷰, 리팩토링, 성능 최적화
- 코드 리뷰 자동화
앤트로픽의 깃허브앱을 설치하면 클로드코드가 팀의 워크플로에 자연스럽게 통합
- PR 이 생성되거나 업데이트되면 클로드 코드가 자동으로 실행
- 보안 취약점 탐지
- 성능 병목 및 N+1 쿼리와 같은 패턴 확인
- 코드 품질 및 가독성 피드백 제공
- 아키텍처 개선 제안 자동 제시
/install-github-app
- 리팩토링 전략
orderCalculator.ts 파일의 코드 스멜을 식별하고 리팩토링해줘. 긴 메서드, 중복 코드, 복잡한 조건문, 매직 넘버등 개선하고 SOLID 원칙을 적용해줘
paymentProcessor.ts의 복잡한 조건문을 Strategy패턴으로 리팩토링해줘. 각 결제 방식(카드, 계좌번호, 포인트)별로 전략 클래스를 만들고 확장 가능한 구조로 개선해줘
- 성능 최적화
ProductList.tsx 컴포넌트의 성능을 분석하고 최적화해줘. 불필요한 리렌더링 제거, 가상화 적용, useMemo와 useCallback 활용, 이미지 lazy loading 등을 적용해줘
repository 디렉터리의 데이터베이스 쿼리를 분석해서 N+1 문제, 불필요한 JOIN, 누락된 인덱스를 찾아내고 최적화 방안을 제시해줘. Sequelize ORM의 eager loading과 lazy lpading 전략도 개선해줘
webpack.config.js를 분석해서 번들 크기를 최적화해줘. Tree shaking, 코드 스필리팅, 동적 임포트, 중복 라이브러리 제거, 압축 설정 등을 적용하고 번들 크기를 20% 이상 줄여줘
- 코드 품질 메트릭
프로젝트에 SonarQube 설정 파일을 샐엇ㅇ해줘. 코드 커버리지 80%이상, 중복도 3%이하, 순환 복잡도 10이하의 품질 게이트를 설정하고 ESLint, Prettier 규칙도 통합해줘
- 기술 부채 관리
프로젝트 전체의 기술 부채를 분석해줘. TODO/FIXME 주석, deprecated API 사용, 순환 복잡도 15 이상인 함수, 300줄 이상 파일을 찾아 우선순위 매트릭스를 만들어줘
userService 모듈의 리팩토링 로드맵을 작성해줘. 의존성 분석, 영향 범위 평가, 단계별 개선 계획을 포함해서 3개월 스프린트로 나눠줘
- 레거시 코드 개선
### step1 : 현재 상태 분석
legacy 디렉터리의 레거시 코드를 분석해줘. jQuery 1.x 사용, 전역 변수 오염, ES5 문법, 오래된 라이브러리를 찾아내고 React/TypeScript로 마이그레이션 계획을 세워줘
### step 2: 테스트 작성
OrderService 클래스에 대한 테스트 스위트를 작성해줘. 현재 로직을 검증하는 단위 테스트, 통합 테스트, 엣지 케이스 테스트를 포함해서 90% 이상 커버리지를 달성해줘
### step 3 : 단계적 리팩토링
UserController 클래스를 단계별로 리팩토링해줘. 1단계 : 메서드 추출, 2단계 : 의존성 주입, 3단계 : 에러 핸들링 개선. 각 단계마다 테스트도 함께 작성해줘
명세 작성 및 문서화 : 살아 있는 문서 만들기
- OpenAPI(Swagger) 명세 작성
routes 디렉터리의 Express.js API 코드를 분석해서 OpenAPI 3.0 명세를 자동 생성해줘. 각 엔드포인트의 요청/응답 스키마, 파라미터, 인증 방식, 에러 응답을 포함하고 Swagger UI에서 바로 사용할 수 있는 YAML 형식으로 작성해줘
- 사용자 가이드 작성
package.json 과 README.md를 분석해서 Getting Started 가이드를 작성해줘. 시스템 요구사항, 설치 과정, 환경 설정, 첫 실행, 기본 사용 예제를 단계별로 설명하고 자주 발생하는 문제와 해결 방법도 포함해줘
- 기술 문서 구조화
현재 프로젝트의 아키텍처를 분석하고 ADR(Architecture Decision Record)을 작성해줘. 기술 스택 선택 이유, 아키텍처 패턴 결정 배경, 고려했던 대안들, 예상되는 결과와 트레이드오프를 포함해줘
프로젝트의 시스템 아키텍처 문서를 작성해줘. C4 모델(Context, Container, Component, Code)을 사용해서 다이어그램을 생성하고, 각 컴포넌트의 역할, 기술스택, 통신 방식, 데이터 플로우를 설명해줘
- 코드와 문서 동기화
src/api 디렉터리의 TypeScripte 코드를 분석해서 JSDoc 주석으로부터 완전한 API 문서를 생성해줘. 각 엔드포인트별로 요청/응답 스키마, 에러코드, 사용 예시를 포함해서 TypeDoc으로 빌드할 수 있는 형태로 작성해줘
- 배포 및 운영 문서
package.json과 배포 스크립트를 분석해서 완전한 배포 가이드를 작성해줘. 개발/스테이징/프로덕션 환경별 배포 절차, 환경 변수 절정, 사전 체크리스트, 롤백 방법을 포함해줘
시스템 모니터링 설정과 로그를 분석해서 운영 Runbook을 작성해줘. 장애 대응 절차, 서비스 재시작 방법, 성능 이슈 진단, 로그 분석 가이드, 주요 알람별 대응책을 포함해줘
클로드 코드 효율 극대화하기
LLM 엔진 최적화와 컨텍스트 관리
- LLM 엔진 최적화
| 전략 | 최적 상황 | 장점 | 단점 | 예시작업 |
|---|
| Chain of Thought | 논리적 추론이 필요한 문제 | 투명한 추론 과정, 검증 가능 | 토큰 소비 많음 | 버그 분석, 알고리즘 설계 |
| Sequential Thinking | 단계별 의존성이 있는 작업 | 체계적 진행, 중간 검증 가능 | 시간 소요 큼 | 마이그레이션, 배포프로세스 |
| Tree of Thoughts | 여러 대안 비교가 필요한 결정 | 포괄적 분석, 최적해 도출 | 복잡도 높음 | 기술 스택 선택, 아키텍처 결정 |
| Reflective Thinking | 품질 개선이 중요한 작업 | 지속적 개선, 자체 검증 | 반복으로 인한 시간 소요 | 코드 리팩토링, 성능 최적화 |
> API 응답 시간이 느린 문제를 단계별로 해결해줘
단계 1. 현재 응답 시간 측정 및 병목 지점 식별
단계 2. 데이터베이스 쿼리 성능 분석
단계 3. 네트워크 지연 요인 검토
단계 4. 캐싱 전략 검토 및 개선안 제시
단계 5. 최적화 솔루션 구현 및 검증
> 마이크로서비스를 단계별로 분리해줘.
1. 먼저 서비스 경계 식별(완료 후 확인)
2. 데이터베이스 분리 계획(1단계 기반)
3. API 게이트웨이 설정(2단계 완료 필요)
4. 서비스 간 통신 구현(3단계 의존)
5. 트랜잭션 관리 구현 (모든 서비스 준비 후)
각 단계의 산출물을 다음 단계의 입력으로 사용해
> 최적의 데이터 베이스 설계를 찾아줘.
경로 1 : NoSQL(MongoDB)
- 장점 분석
- 단점 분석
- 적합성 점수
경로 2 : SQL(PostgreSQL)
- 장점 분석
- 단점 분석
- 적합성 점수
경로 3 : 하이브리드
- 구현 복잡도
- 성능 이득
- 유지보수성
모든 경로를 평가한 후 최종 추천
>API 엔드포인트를 구현하고 반복 개선해줘.
반복 1 : 기본 기능 구현
- 자체 평가 : 동작하지만 에러 처리 부족
반복 2 : 에러 처리 추가
- 자체 평가 : 안정적이지만 성능 이슈 가능
반복 3 : 캐싱과 최적화 적용
- 자체 평가 : 성능 좋지만 보안 고려 필요
반복 4 : 보안 강화
- 최종 평가 및 완료
- 메모리 시스템 활용
대화 프롬프트에서는 전체 메모리를 불러오기보다, 현재 작업에 필요한 파일만 선택해서 사용하는 방식이 이상적
> 이 작업엔 memory/10-architecture.md와 memory/30-standards.md를 참고해
멀티에이전트 시스템
| 항목 | Custom Subagent | Claude Squad | Claude Swarm |
|---|
| 기본 개념 | 사용자가 직접 정의한 특화된 클로드 코드 인스턴스 | 깃 저장소를 활용한 멀티에이전트 병렬 워크스페이스 | YAML 설정으로 정의된 다중 에이전트(역할 기반) 협업 프레임워크 |
| 스코프 | 프로젝트 단위(.claude/agents/)또는 사용자 전역(~/.claude/agents/) | 특정 깃 저장소 내에서만 사용 | 시스템 전역에서 YAML로 선언적 정의 |
| 컨텍스트 관리 | 독립 컨텍스트 창, 도구 제한 가능 -> 코드 리뷰어, 보안 분석가 등 전문화 | 각 브랜치가 독립 실행 공간, 충돌 최소화 | 각 역할(리드/프런트엔드/백엔드)이 독립 디렉터리 & 모델 컨텍스트 |
| 주요 장점 | 고도로 특화된 전문가 역할, 재사용 가능, 보안/도구 제한 용이 | 깃 기반 워크플로와 자연스러운 통합, 충돌 없이 병렬 실행 | 역할 기반 협업, 계층적 오케스트레이션, 선언적 정의로 재현성 보장 |
| 사용 방식 | code-reviewer, security-auditor 같은 에이전트 정의후 Task Tool로 호출 | cs CLI실행, 각 브랜치에서 독립 진행 후 병합 | claude-swarm CLI실행, team.yml에서 역할 정의 |
| 대표 사용 사례 | 코드 리뷰 전용 에이전트, 성능/보안 분석, 문서화 | 단일 레포에서 여러 기능 병렬 개발, 리팩토링과 신기능 동시 진행 | 프런트엔드/백엔드/리드 역할 분담 프로젝트 팀 단위 멀티 규칙 협업 |
