[Part 1] AI 비서 한 명 얻기 - 0. Claude Code 설치하기
![[Part 1] AI 비서 한 명 얻기 - 0. Claude Code 설치하기](https://9way.co.kr/rails/active_storage/blobs/redirect/eyJfcmFpbHMiOnsiZGF0YSI6IjJkNDg4NmJiLTkxNGUtNDg3OC1iOTQwLTYxZWU1MzU1NGU1MSIsInB1ciI6ImJsb2JfaWQifX0=--6dec32387b13fa294de451074e449611aa92dd6f/featured.png)
AI 코딩 어시스턴트의 새로운 기준, Claude Code
"이 코드, 어디서부터 손대야 하지?" 개발자라면 누구나 한 번쯤 막막함을 느껴본 순간이 있을 겁니다. 복잡하게 얽힌 레거시 코드, 처음 접하는 라이브러리, 혹은 단순하지만 반복적인 보일러플레이트 작업들. 이런 순간마다 옆에 시니어 개발자가 앉아 있다면 얼마나 좋을까요?
Anthropic이 만든 Claude Code는 바로 그 역할을 자처합니다. 단순히 코드를 생성하는 것을 넘어, 터미널 환경에서 직접 파일을 읽고, 수정하고, 실행하며 개발자와 함께 문제를 해결해 나가는 AI 에이전트입니다. 오늘은 Claude Code를 직접 따라해보며 그 가능성을 탐색해 보겠습니다.
Claude Code란 무엇인가?
Claude Code는 Anthropic의 Claude 모델을 기반으로 한 터미널 기반 AI 코딩 에이전트입니다. 기존의 챗봇형 AI 도구들과 달리, Claude Code는 실제 개발 환경에 직접 접근할 수 있는 권한을 가집니다.
🤖 Claude Code의 핵심 특징
- 터미널에서 직접 실행되는 CLI 기반 에이전트
- 파일 시스템 읽기·쓰기·수정 가능
- 쉘 명령어 실행 및 테스트 자동화
- Git 연동 및 코드 리뷰 지원
- 대규모 코드베이스 이해 및 탐색
쉽게 말해, Claude Code는 여러분의 프로젝트 폴더에 들어와 코드를 직접 읽고, 문제를 파악하고, 수정안을 제시하거나 직접 변경까지 수행하는 AI 동료입니다.
설치부터 시작하기
1단계: 설치 및 환경 설정
Claude Code는 npm을 통해 간단하게 설치할 수 있습니다. Node.js 18 이상이 설치되어 있다면 바로 시작할 수 있습니다.
# 전역 설치
npm install -g @anthropic-ai/claude-code
# 실행
claude
설치 후 처음 실행하면 Anthropic API 키를 입력하라는 안내가 나옵니다. Anthropic Console에서 발급받은 API 키를 입력하면 바로 사용 준비가 완료됩니다.
2단계: 프로젝트 디렉토리에서 실행
Claude Code는 현재 디렉토리를 기준으로 작동합니다. 작업하고 싶은 프로젝트 폴더로 이동한 뒤 실행하는 것이 핵심입니다.
# 프로젝트 폴더로 이동 후 실행
cd my-project
claude
💡 Tip
Claude Code는 프로젝트의 파일 구조를 자동으로 파악합니다. 처음 실행 시 "이 프로젝트가 어떤 프로젝트인지 설명해줘"라고 물어보면 Claude가 코드를 분석해 프로젝트 개요를 설명해 줍니다. 온보딩 시간을 크게 단축할 수 있습니다.
실전 활용 시나리오 따라하기
시나리오 1: 버그 찾고 수정하기
가장 강력한 활용 사례 중 하나입니다. 에러 메시지를 그대로 붙여넣고 "이 에러 고쳐줘"라고 말하면 됩니다.
사용자 입력
> TypeError: Cannot read properties of undefined (reading 'map')
이 에러가 계속 나는데 원인 찾아서 고쳐줘
Claude Code는 관련 파일들을 직접 열어 코드를 분석하고, 문제가 되는 라인을 찾아 수정안을 제시합니다. 승인하면 파일을 직접 수정해 줍니다.
시나리오 2: 새로운 기능 추가
기존 코드 스타일을 파악한 뒤 일관성 있게 새 기능을 추가해 달라고 요청할 수 있습니다.
사용자 입력
> 기존 UserService 패턴을 참고해서
ProductService를 새로 만들어줘.
CRUD 기능 포함해서.
Claude Code는 기존 UserService 파일을 읽고 코딩 컨벤션, 에러 처리 방식, 네이밍 규칙 등을 파악한 뒤 동일한 스타일로 ProductService를 생성합니다.
시나리오 3: 코드 리뷰 및 리팩토링
작성한 코드의 품질을 높이고 싶을 때도 유용합니다.
사용자 입력
> src/utils/dataProcessor.js 파일 리뷰해줘.
성능 개선 포인트랑 클린코드 관점에서
개선할 부분 알려줘.
💡 Tip
리팩토링 요청 시 "직접 수정해줘"와 "수정 제안만 해줘"를 구분해서 요청하세요. 중요한 파일일수록 제안을 먼저 받고 검토 후 적용하는 것이 안전합니다.
시나리오 4: 테스트 코드 자동 생성
테스트 작성이 귀찮아서 미루고 있었다면, Claude Code에게 맡겨보세요.
사용자 입력
> authService.js에 대한 단위 테스트를
Jest로 작성해줘. 엣지 케이스도 포함해서.
기존 테스트 파일이 있다면 그 스타일을 참고하고, 없다면 프로젝트 설정에 맞는 테스트를 자동으로 생성합니다.
Claude Code를 더 잘 쓰는 방법
🚀 효과적인 사용을 위한 핵심 팁
- 구체적으로 요청하기: "고쳐줘"보다 "이 함수의 시간복잡도를 O(n²)에서 O(n)으로 개선해줘"처럼 명확하게
- 컨텍스트 제공하기: 관련 파일이나 배경을 함께 언급하면 더 정확한 결과를 얻을 수 있음
- 단계적으로 진행하기: 큰 작업은 작은 단위로 나눠서 요청하기
- 결과 검증하기: Claude가 수정한 코드는 반드시 테스트 후 커밋하기
- CLAUDE.md 활용하기: 프로젝트 루트에 코딩 컨벤션, 아키텍처 설명을 담은 CLAUDE.md 파일을 만들면 더 일관된 결과를 얻을 수 있음
CLAUDE.md 파일 활용하기
프로젝트 루트에 CLAUDE.md 파일을 만들면 Claude Code가 매번 이 파일을 참고합니다. 팀의 코딩 컨벤션, 자주 사용하는 명령어, 프로젝트 구조 등을 정리해두면 훨씬 일관된 결과를 얻을 수 있습니다.
# CLAUDE.md 예시
## 프로젝트 개요
- Next.js 14 App Router 기반 프로젝트
- TypeScript strict 모드 사용
## 코딩 컨벤션
- 컴포넌트: PascalCase
- 함수: camelCase
- 상수: UPPER_SNAKE_CASE
## 자주 쓰는 명령어
- 개발 서버: npm run dev
- 테스트: npm run test
주의해야 할 점
Claude Code는 강력한 도구인 만큼 몇 가지 주의사항도 있습니다.
- 파일 직접 수정 권한: Claude Code는 파일을 직접 수정할 수 있으므로, 중요한 작업 전에는 Git 커밋을 먼저 해두세요
- API 비용: 대규모 코드베이스를 자주 분석하면 API 사용량이 늘어날 수 있습니다
- 보안 민감 정보: API 키, 비밀번호 등이 포함된 파일은 .gitignore처럼 접근 제한을 설정하세요
- 코드 검증 필수: AI가 생성한 코드는 항상 사람이 검토하고 테스트해야 합니다
💡 안전하게 사용하는 황금 규칙
Claude Code 작업 시작 전 항상 git status를 확인하고, 깨끗한 상태에서 시작하세요. 작업 후에는 git diff로 변경사항을 꼼꼼히 확인하는 습관을 들이면 안전하게 활용할 수 있습니다.
AI와 함께 성장하는 개발자
Claude Code는 단순히 코드를 대신 써주는 도구가 아닙니다. 복잡한 문제를 함께 분석하고, 더 나은 해결책을 탐색하며, 개발자가 더 중요한 일에 집중할 수 있도록 돕는 AI 페어 프로그래머입니다.
9WAY의 관점에서 보면, Claude Code는 행동 영역의 실행력과 사고 영역의 분석력을 동시에 보완해주는 도구입니다. 빠르게 실행하고 싶은 사람에게는 속도를, 깊이 분석하고 싶은 사람에게는 통찰을 제공합니다.
🎯 오늘 바로 시작해보세요
- npm으로 Claude Code 설치하기
- 현재 진행 중인 프로젝트에서 실행해보기
- "이 프로젝트 구조 설명해줘"로 첫 대화 시작하기
- CLAUDE.md 파일 만들어 팀 컨벤션 정리하기
AI 도구를 잘 활용하는 것도 이제 개발자의 핵심 역량 중 하나입니다. Claude Code와 함께라면, 혼자서는 막막했던 코드도 한 발씩 나아갈 수 있습니다. 지금 바로 터미널을 열어보세요. 🚀
관련 글
친구한테 받는 '강점 한 단어 + 강점 한 줄' 답장 양식과 예시 30개
친구한테 받는 "강점 한 단어 + 강점 한 줄" 답장 양식과 예시 30개 친한 사람한테 "내가 뭘 잘해?" 물었는데, 돌아온 답이 "꼼꼼해"·"착해"·"성실해" 한 단어뿐이라면 자소서·면접·링크드인에 그대로 못 씁니다. 답장의 포맷을 미리 제시하는 한 줄 차이가 자소서 한 문단을 만듭니다. 이 글은 "강점 한 단어 + 강점 한 줄" 답장 양식과, 카테고리별...
회의·면접·보고에서 신뢰 깎는 단어 30개와 즉시 쓰는 대체어 치트시트
회의·면접·보고에서 신뢰 깎는 단어 30개와 즉시 쓰는 대체어 치트시트 회의·면접·보고에서 같은 내용을 말해도 신뢰 있게 들리는 사람과 자신 없어 보이는 사람의 차이는 말솜씨가 아니라 습관이 된 단어 몇 개입니다. 이 치트시트는 무의식적으로 쓰지만 청자에게 자신 없음·책임 회피·판단 보류로 읽히는 30개 표현과 즉시 바꿔 쓸 수 있는 대체어를 정리했습니다....
내 강점을 못 찾는 진짜 이유 — 9가지 상황으로 확인하는 법
내 강점을 못 찾는 진짜 이유 — 9가지 상황으로 확인하는 법 "나는 강점이 뭔지 모르겠다." 자기 강점을 정확히 짚을 수 있는 사람은 생각보다 드뭅니다. 하지만 문제는 "강점이 없어서"가 아닙니다. "이 정도는 누구나 하지"라는 착각 때문에 내 강점을 스스로 지우고 있기 때문입니다. 남들이 어려워하는 일을 여러분이 쉽게 해내고 있다면, 그게 강점입니다. ...
번아웃 신호 5가지 + 9WAY 자가 테스트 + 유형별 체크리스트
번아웃 신호 5가지 + 9WAY 자가 테스트 + 유형별 체크리스트 번아웃은 어느 날 갑자기 오지 않습니다. 먼저 조용한 신호 5개가 옵니다. 몸에서 먼저, 머리에서 다음, 마음에서 마지막으로. 그리고 이 신호 중 3개 이상이 해당되면 3개월 안에 번아웃이 터집니다. 이 글은 세 부분으로 이뤄져 있습니다. - 1부: 번아웃 오기 전 5가지 신호 - 2부: 9...