Claude Code란?
Claude Code는 Anthropic이 개발한 터미널 기반 AI 코딩 어시스턴트입니다. VS Code 확장이나 웹 인터페이스가 아닌 CLI에서 직접 Claude와 대화하며 코드를 작성할 수 있습니다.
# 설치 후 바로 사용
claude "이 프로젝트의 구조를 분석해줘"
왜 CLI인가?
- 터미널을 떠나지 않고 AI와 협업
- 파일 시스템 직접 접근 및 수정
- Git, npm 등 개발 도구와 자연스러운 통합
- SSH 원격 서버에서도 사용 가능
설치 및 설정
1. 설치
# npm으로 전역 설치
npm install -g @anthropic-ai/claude-code
# 또는 Homebrew (macOS)
brew install claude-code
2. 인증 설정
# Anthropic API 키 설정
claude auth login
# 또는 환경 변수로 설정
export ANTHROPIC_API_KEY="sk-ant-..."
3. 기본 설정
# 설정 파일 위치: ~/.claude/settings.json
claude config set model claude-sonnet-4-20250514
claude config set theme dark
기본 사용법
대화형 모드
# 대화형 세션 시작
claude
# 프로젝트 컨텍스트와 함께 시작
claude --cwd /path/to/project
원샷 명령
# 단일 질문
claude "package.json의 의존성을 분석해줘"
# 파일 지정
claude "이 파일을 리팩토링해줘" --file src/utils.ts
# 파이프라인 활용
cat error.log | claude "이 에러 로그를 분석해줘"
핵심 기능
1. 파일 읽기/쓰기
Claude Code는 프로젝트 파일을 직접 읽고 수정할 수 있습니다.
You: src/api/users.ts 파일에 에러 핸들링을 추가해줘
Claude: 파일을 분석하고 수정하겠습니다.
[Read] src/api/users.ts
[Edit] try-catch 블록 추가 및 에러 타입 정의
[Write] src/api/users.ts 저장 완료
2. 터미널 명령 실행
You: 테스트 실행해줘
Claude: npm test를 실행하겠습니다.
[Bash] npm test
✓ 45 tests passed
✗ 2 tests failed
실패한 테스트를 분석하면...
3. 멀티 파일 작업
You: 이 API에 대한 테스트 파일을 만들어줘
Claude:
[Read] src/api/products.ts (API 구조 분석)
[Write] src/api/__tests__/products.test.ts (테스트 파일 생성)
[Read] package.json (테스트 라이브러리 확인)
[Bash] npm test src/api/__tests__/products.test.ts
실전 워크플로우
버그 수정
# 에러 로그와 함께 분석 요청
claude "TypeError: Cannot read property 'map' of undefined
이 에러가 ProductList 컴포넌트에서 발생해. 원인을 찾고 수정해줘"
코드 리뷰
# 변경사항 리뷰 요청
git diff | claude "이 변경사항을 리뷰해줘. 잠재적 문제점이 있으면 알려줘"
리팩토링
# 특정 패턴으로 리팩토링
claude "src/hooks/ 폴더의 모든 커스텀 훅을
React Query v5 패턴으로 마이그레이션해줘"
문서화
# README 자동 생성
claude "이 프로젝트의 README.md를 작성해줘.
설치 방법, 사용 예시, API 문서를 포함해줘"
유용한 슬래시 명령어
| 명령어 | 설명 |
|---|---|
/help | 도움말 표시 |
/clear | 대화 초기화 |
/compact | 컨텍스트 요약 |
/cost | 현재 세션 비용 확인 |
/doctor | 설정 진단 |
/init | 프로젝트 초기 설정 |
/review | 코드 리뷰 모드 |
/commit | 커밋 메시지 생성 |
설정 커스터마이징
CLAUDE.md 프로젝트 가이드
프로젝트 루트에 CLAUDE.md 파일을 생성하면 Claude가 프로젝트 컨텍스트를 이해합니다.
# 프로젝트: E-commerce Platform
## 기술 스택
- Next.js 14 (App Router)
- TypeScript
- Prisma + PostgreSQL
- TailwindCSS
## 코딩 컨벤션
- 함수형 컴포넌트만 사용
- 에러 처리 시 커스텀 에러 클래스 사용
- 테스트는 Vitest + Testing Library
## 폴더 구조
- src/app: 페이지 및 라우팅
- src/components: 재사용 컴포넌트
- src/lib: 유틸리티 함수
- src/hooks: 커스텀 훅
키바인딩 설정
~/.claude/keybindings.json:
{
"submit": "ctrl+enter",
"cancel": "escape",
"newLine": "enter"
}
팁과 트릭
1. 컨텍스트 관리
# 특정 파일만 컨텍스트에 포함
claude --include "src/**/*.ts" --exclude "node_modules"
# 컨텍스트가 너무 커지면 요약
/compact
2. 안전 모드
# 파일 수정 전 확인 요청
claude config set confirmEdits true
# 위험한 명령 차단
claude config set dangerousCommands block
3. 세션 저장
# 대화 내역 저장
claude --output session.md
# 이전 세션 이어서
claude --resume session-id
다음 단계
Claude Code의 기본을 익혔다면, 다음 편에서 **MCP(Model Context Protocol)**를 활용해 Claude의 기능을 확장하는 방법을 알아보겠습니다. 외부 데이터베이스, API, 파일 시스템과 연동하여 더 강력한 AI 어시스턴트를 만들 수 있습니다.