[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 사용 건강도 체크리스트 — yes가 3개 이상이면 이미 끌려다니고 있는 신호 / 다시 가져오는 3가지 관계 기술
AI 사용 건강도 체크리스트 — yes가 3개 이상이면 이미 끌려다니고 있습니다 들어가며 본인이 AI를 쓰고 있는지, AI에게 끌려다니고 있는지는 — 사용 시간이나 빈도로는 알 수 없습니다. 본인이 AI를 마주하는 자세로만 알 수 있어요. 오늘은 본인의 AI 사용 건강도를 1분 만에 체크하는 5가지 질문을 드립니다. yes가 3개 이상 나오면 본인은 이미 ...
나를 잃지 않고 AI를 활용하는 3가지 심리기술 — 같은 AI를 쓰는데 6개월 후 한 사람은 깊어지고 한 사람은 사라지는 이유
나를 잃지 않고 AI를 활용하는 3가지 심리기술 들어가며 — 본인도 한 번쯤 느끼셨을 거예요 세 가지 상황이 본인 일상에서 있으시지 않으셨나요. 첫 번째, ChatGPT에 질문하고 답을 받은 다음 5분이 지났는데, 본인이 그 질문을 처음 떠올렸을 때 어떤 답을 생각했는지가 기억나지 않는 순간. 두 번째, 회의에서 누군가 "본인 의견은 어때요?"라고 물었을 ...
AI 안 쓰면 도태, 막 쓰면 도태 — 직무별 오늘부터 복붙하는 프롬프트·도구 매뉴얼 5세트
AI 안 쓰면 도태, 막 쓰면 도태 — 직무별 오늘부터 복붙하는 프롬프트·도구 매뉴얼 5세트 AI 안 쓰자니 시장에서 보이지 않고, 막 쓰자니 본인 머리가 비어가는 시대. 이 글은 진단이 아니라 매뉴얼입니다. 마케터·디자이너·개발자·기획자·취준생 다섯 직무 각자에게, 오늘부터 그대로 복붙해서 쓸 수 있는 프롬프트·도구·시간 측정을 직접 드립니다. 각 직무 ...
AI가 모든 직업을 대체해도 살아남는 법 — 업의 본질 3가지
AI가 모든 직업을 대체해도 살아남는 법 — 업의 본질 3가지 들어가며 — 같은 직업 안에서도 누군 100% 대체된다 OECD는 회원국 일자리의 27%가 이미 AI 자동화 위험에 노출돼 있다고 발표했습니다. 골드만삭스는 전 세계 3억 개 정규직이 위험권에 들어갔다고 했죠. 가트너는 2026년 안에 고객 서비스의 75%가 AI로 처리될 거라고 전망합니다. 여...