Claude Code 101

Claude Code 완전 정리 🛠️

1. Claude Code란?

LLM은 텍스트만 처리할 수 있어서, 파일 읽기·명령어 실행 같은 작업은 Tool Use 시스템을 통해 간접적으로 수행해. Claude는 다른 모델 대비 Tool Use 능력이 뛰어나서 복잡한 개발 작업에 특히 강함.

---

2. 컨텍스트 관리

기능	설명
/init	코드베이스 분석 후 Claude.md 자동 생성
Claude.md	프로젝트/로컬/머신 레벨 3종류. 매 요청에 자동 포함
@ 심볼	특정 파일을 명시적으로 참조해서 정확한 컨텍스트 제공
# 심볼	Claude.md를 자연어로 편집 (Memory mode)

핵심: 관련 있는 정보만 적절히 제공하는 게 성능에 중요. 너무 많아도 오히려 성능 저하.

---

3. 작업 방식 심화

성능 부스트 모드 2가지:

• Plan Mode (Shift+Tab 두 번): 넓은 범위의 멀티스텝 작업에 적합. 먼저 계획 수립 후 실행
• Thinking Mode (“Ultra think” 입력): 복잡한 로직, 버그 디버깅 등 깊은 추론이 필요할 때

두 모드 모두 토큰을 추가 소비하니 필요할 때만 사용 권장.

---

4. 대화 흐름 제어

단축키/명령	기능
Escape	현재 응답 중단 후 방향 전환
Escape + #	실수 패턴 기억시켜서 반복 방지
Double Escape	이전 대화 시점으로 되감기
/compact	대화 요약 (학습한 내용은 유지, 잡음 제거)
/clear	대화 완전 초기화 (다른 주제로 전환 시)

---

5. 커스텀 명령어

.claude/commands/ 폴더에 마크다운 파일 생성 → /명령어이름 으로 호출.

예: audit.md 파일 생성 → /audit 명령어로 의존성 감사 자동화. $arguments 플레이스홀더로 런타임 파라미터도 전달 가능.

---

6. MCP 서버로 기능 확장

claude mcp add [이름] [실행명령]

외부 도구를 Claude Code에 연결. 대표 예시인 Playwright MCP를 쓰면 Claude가 직접 브라우저를 조작해서 UI 테스트, 스타일 수정 등을 자동화할 수 있음.

---

7. GitHub 통합

/install GitHub app 명령어로 설치하면:

• @Claude 멘션 → 이슈/PR에서 작업 자동 배정
• PR 자동 리뷰 → 새 PR 생성 시 코드 리뷰 자동 실행
• Playwright MCP 연동 시 브라우저 테스트까지 자동화 가능

---

8. Hooks — Claude의 행동을 제어

Claude가 도구를 실행하기 전/후에 커스텀 스크립트를 끼워넣는 기능.

Pre-tool hook  →  Claude 도구 실행  →  Post-tool hook
(차단 가능)                           (차단 불가)

실용적인 활용 예시 2가지:

1. TypeScript 타입 체커 훅: 파일 편집 후 tsc --no-emit 자동 실행 → 타입 에러 즉시 감지 및 수정
2. 중복 코드 방지 훅: 특정 디렉토리 수정 감지 → 별도 Claude 인스턴스 실행 → 중복 코드 발견 시 차단 + 피드백

Exit code 0 = 허용, 2 = 차단 (pre-hook만 해당)

---

9. Claude Code SDK

CLI, TypeScript, Python 라이브러리로 제공. 기존 파이프라인/워크플로우에 AI를 프로그래밍 방식으로 통합할 때 사용.

• 기본 권한: 읽기 전용
• 쓰기 권한: options.allowTools에 명시적으로 추가 필요
• 단독 앱보다는 기존 프로젝트 내 헬퍼 스크립트/훅 용도에 적합