터미널에서 "이 버그 좀 고쳐줘"라고 말하면 AI가 코드를 분석하고, 수정하고, 테스트까지 해준다면 어떨까요? Claude Code는 바로 그런 도구입니다. Anthropic이 만든 CLI 기반 AI 코딩 어시스턴트로, 터미널 안에서 코드를 읽고, 쓰고, 실행하는 모든 과정을 함께합니다.
이 글에서는 Claude Code의 설치부터 실전 활용 패턴까지, 제가 실제로 사용하면서 정리한 내용을 공유합니다.
Claude Code란?
Claude Code는 Anthropic의 AI 모델 Claude를 터미널에서 직접 사용할 수 있는 CLI 도구입니다. VS Code의 Copilot이나 Cursor와 다른 점은, 터미널 네이티브라는 것입니다.
파일을 읽고, 수정하고, 커밋하고, 테스트를 실행하는 것까지 모두 터미널 안에서 이루어집니다. IDE에 종속되지 않기 때문에 어떤 에디터를 쓰든, 어떤 언어로 개발하든 동일하게 활용할 수 있습니다.
설치 및 초기 설정
설치는 npm으로 간단하게 할 수 있습니다.
npm install -g @anthropic-ai/claude-code
설치 후 프로젝트 디렉토리에서 claude를 입력하면 바로 시작됩니다.
cd my-project
claude
처음 실행하면 Anthropic 계정 인증을 거치고, 이후부터는 바로 대화를 시작할 수 있습니다. Claude Code는 현재 디렉토리의 파일 구조를 자동으로 파악하고, CLAUDE.md 파일이 있다면 프로젝트 컨텍스트로 활용합니다.
핵심 기능 완전 정복
코드 읽기와 수정
Claude Code는 프로젝트의 파일을 직접 읽고 수정할 수 있습니다. "이 함수를 리팩토링해줘"라고 말하면 해당 파일을 찾아 읽고, 수정안을 제시한 뒤 승인하면 바로 반영합니다.
> src/utils/format.ts의 formatDate 함수를 dayjs 대신 네이티브 Intl.DateTimeFormat으로 바꿔줘
터미널 명령 실행
코드 수정뿐 아니라 빌드, 테스트, 린트 같은 명령도 직접 실행합니다. "테스트 돌려봐"라고 하면 npm test를 실행하고 결과를 분석해줍니다.
Git 연동
커밋 메시지 작성, PR 생성, 브랜치 관리까지 Git 워크플로우 전체를 지원합니다.
> 지금까지 변경사항 커밋해줘
> 이 브랜치로 PR 만들어줘
슬래시 커맨드
자주 쓰는 작업은 슬래시 커맨드로 빠르게 실행할 수 있습니다.
/commit— 변경사항 분석 후 커밋 메시지 자동 생성/review— 코드 리뷰 실행/help— 사용 가능한 명령어 확인
실전 활용 패턴 5가지
1. 버그 수정
에러 메시지를 그대로 붙여넣으면 됩니다. Claude Code가 관련 파일을 찾아 원인을 분석하고 수정합니다.
> TypeError: Cannot read properties of undefined (reading 'length') 이 에러가 나는데 고쳐줘
2. 새 기능 추가
원하는 기능을 자연어로 설명하면 필요한 파일을 생성하고, 기존 코드에 통합합니다.
> 블로그 포스트에 좋아요 기능을 추가해줘. Firestore에 likes 컬렉션을 만들고 버튼 컴포넌트도 만들어줘
3. 리팩토링
코드 품질 개선도 강력합니다. 특정 파일이나 디렉토리를 지정해서 리팩토링을 요청할 수 있습니다.
> services/ 디렉토리의 중복 코드를 정리하고 공통 유틸로 추출해줘
4. 테스트 작성
기존 코드에 대한 테스트를 자동으로 작성합니다.
> src/utils/ 아래 함수들에 대한 단위 테스트를 작성해줘
5. 코드 이해
새로운 프로젝트에 합류했을 때, 코드베이스를 빠르게 파악하는 데 유용합니다.
> 이 프로젝트의 전체 아키텍처를 설명해줘
> 인증 플로우가 어떻게 동작하는지 알려줘
CLAUDE.md로 프로젝트 맞춤 설정
프로젝트 루트에 CLAUDE.md 파일을 만들면 Claude Code가 프로젝트의 컨텍스트를 자동으로 이해합니다. 빌드 명령, 아키텍처, 코딩 컨벤션 등을 적어두면 매번 설명할 필요가 없습니다.
# CLAUDE.md
## Build Commands
npm run dev — 개발 서버
npm run build — 프로덕션 빌드
## Architecture
Next.js App Router + Firebase + Tailwind CSS
## Conventions
- 컴포넌트는 PascalCase
- 서비스 함수는 camelCase
- 한국어 주석 사용
이 파일 하나로 Claude Code는 프로젝트에 맞는 코드를 작성하고, 컨벤션을 지키며, 올바른 빌드 명령을 실행합니다.
마무리: AI와 함께 성장하는 개발자
Claude Code는 코드를 대신 써주는 도구가 아닙니다. 개발자의 의도를 이해하고, 반복적인 작업을 줄여주고, 더 중요한 설계와 판단에 집중할 수 있게 해주는 파트너입니다.
처음에는 간단한 버그 수정이나 코드 설명부터 시작해보세요. 익숙해지면 기능 구현, 리팩토링, 배포까지 점점 더 많은 작업을 맡길 수 있습니다.
AI 도구는 완벽하지 않습니다. 하지만 잘 활용하면 개발 생산성은 확실히 달라집니다. Claude Code와 함께 더 빠르고, 더 즐겁게 개발해보세요.
