Skip to main content
Claude Code는 Anthropic이 만든 CLI 기반 AI 코딩 어시스턴트입니다. 터미널에서 직접 코드를 생성, 리팩토링, 디버깅하며 프로젝트 전체 맥락을 이해합니다.

​
주요 특징

기능설명
코드 생성자연어 지시로 함수, 클래스, 모듈 단위 코드 작성
리팩토링기존 코드의 구조 개선 및 패턴 적용
디버깅에러 분석, 원인 추적, 수정 제안
테스트 작성단위 테스트 및 통합 테스트 자동 생성
Git 연동커밋 메시지 작성, PR 생성, 변경 이력 분석
멀티파일 편집여러 파일을 동시에 분석하고 수정

​
설치

1

Node.js 확인

Node.js 18 이상이 필요합니다.
node --version  # v18.0.0 이상
2

Claude Code 설치

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

인증 설정

최초 실행 시 Anthropic 계정으로 로그인합니다.
claude
# 브라우저에서 인증 진행
Pro, Max 구독 또는 API 키가 필요합니다.
4

프로젝트 디렉토리에서 시작

cd your-project
claude

​
프로젝트 설정

​
CLAUDE.md

프로젝트 루트에 CLAUDE.md 파일을 생성하면 Claude Code에게 프로젝트 규칙을 전달할 수 있습니다. 
# Project Rules
- 언어: TypeScript strict mode 사용
- 스타일: ESLint + Prettier 적용
- 테스트: Vitest 사용, 커버리지 80% 이상 유지
- 커밋: Conventional Commits 형식

​
.claude/ 디렉토리

파일용도
.claude/CLAUDE.md전역 사용자 설정 (모든 프로젝트 공통)
.claude/commands/커스텀 슬래시 명령어 정의
.claude/settings.jsonMCP 서버 등 환경 설정

​
주요 명령어

명령어기능
/help도움말 표시
/clear대화 초기화
/compact컨텍스트 압축
/cost현재 세션 토큰 사용량 확인
/model사용 모델 변경
/permissions도구 권한 관리

​
MCP 서버 연동

Claude Code는 MCP(Model Context Protocol) 서버를 통해 외부 도구와 연동됩니다. 
# MCP 서버 등록 (사용자 범위)
claude mcp add --scope user context7 -- npx -y @upstreamapi/context7-mcp
claude mcp add --scope user playwright -- npx -y @anthropic-ai/mcp-playwright
MCP 서버용도
Context7라이브러리 공식 문서 조회
Playwright브라우저 자동화 및 E2E 테스트
Serena시맨틱 코드 분석 및 프로젝트 메모리
  • 구체적인 파일명과 함수명을 포함하여 지시하세요
  • “이 함수를 리팩토링해줘”보다 “src/auth.ts의 validateToken 함수를 에러 핸들링 추가해서 리팩토링해줘”가 효과적
  • 큰 작업은 단계를 나눠서 지시하면 정확도가 높아집니다
Mintlify 스킬을 설치하면 문서 컴포넌트와 작성 규칙을 Claude Code가 인식합니다.
npx skills add https://mintlify.com/docs
AGENTS.md에 프로젝트 용어와 스타일 가이드를 추가하세요.
  • 커밋해줘로 변경사항 자동 커밋 (메시지 자동 생성)
  • PR 만들어줘로 GitHub PR 생성
  • 코드 리뷰 요청 시 변경 내역을 자동 분석합니다
Claude Code는 파일 시스템에 직접 접근합니다. 중요한 작업 전에는 반드시 Git 커밋으로 복원 지점을 만드세요.