[Part 1] AI 비서 한 명 얻기 - 0. Claude Code 설치하기
![[Part 1] AI 비서 한 명 얻기 - 0. Claude Code 설치하기](https://9way.org/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와 함께라면, 혼자서는 막막했던 코드도 한 발씩 나아갈 수 있습니다. 지금 바로 터미널을 열어보세요. 🚀
관련 글
흔들리는 세상 속, 나만의 중심을 잡는 법: AI 시대의 '진짜 나' 찾기
예측 불가능한 시대, 혹시 당신도 길을 잃은 기분인가요?세상이 정말 빠르게 변하는데, 이 속도를 따라가는 것만으로도 버거운 느낌? 어제까지 맞았던 공식이 오늘은 통하지 않고, 새로운 기술이 등장할 때마다 '나는 뭘 해야 하지?' 하는 막막함이 밀려오곤 하죠. 아마 저뿐만 아니라 많은 분들이 비슷한 감정을 느끼실 거예요.저는 심리학을 공부하고 강점 코치로 활...
성공의 사다리를 오르면 오를수록, 왜 정상은 더 멀어 보이는 걸까요? — 쾌락의 런닝머신과 성장의 역설
만족을 모르는 심리, 그 진짜 이유우리는 흔히 목표를 달성하면 모든 것이 해결되고 행복해질 것이라고 믿습니다. 하지만 막상 그 지점에 도달했을 때, 기대했던 환희보다는 또 다른 부족함과 허탈함을 느끼는 경우가 많습니다. 저는 오랫동안 심리와 강점을 코칭해오면서, 개인뿐만 아니라 우리 사회 전체가 겪고 있는 아주 독특한 현상을 발견했습니다.오늘은 이 만족을 ...
멈춰 선 청년들에게 전하는 강점 코치의 메시지 — 고립은 끝이 아니라 숨 고르기입니다
혹시 이런 경험 있으신가요?열심히 달리다가 문득 '내가 지금 어디로 가고 있는 거지?' 하는 질문에 멈춰 서게 되는 순간이요. 아니면, 아무리 노력해도 벽에 부딪히는 느낌이 들어 모든 의욕을 잃어버리고 그냥 주저앉고 싶었던 적은요? 저도 한때 그런 고민의 시간을 보냈던 적이 있어요. 세상의 속도는 너무 빠르고, 나만 뒤처지는 것 같은 기분에 압도될 때가 많...
당신이 모르는 당신의 강점 — 9WAY 강점 차트가 보여주는 충격적인 진실
혹시 여러분은 자싨의 강점을 객관적으로 판단하고 있나요?대표님, 팀장님, 혹은 동료에게 "제 강점이 뭐라고 생각하세요?" 라고 물어본 적 있으신가요? 아마 쑥스럽기도 하고, 괜한 질문을 하는 것 같아 망설여본 경험이 다들 한 번쯤은 있으실 겁니다.우리는 스스로에 대해 알기 위해 많은 노력을 합니다. MBTI 같은 성격 유형 검사를 하고, 관련 유튜브 영상을...