Claude Code

[Part 1] AI 비서 한 명 얻기 - 0. Claude Code 설치하기

9WAY · · 조회 199
[Part 1] AI 비서 한 명 얻기 - 0. Claude Code 설치하기

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와 함께라면, 혼자서는 막막했던 코드도 한 발씩 나아갈 수 있습니다. 지금 바로 터미널을 열어보세요. 🚀

0

댓글 0개

댓글을 남기려면 로그인하세요.

관련 글

어디서든 눈에 띄는 사람들은 첫 30초를 씁니다
심리학

어디서든 눈에 띄는 사람들은 첫 30초를 씁니다

회의실에 누군가 들어와 첫마디를 꺼내는 순간, 우리는 이미 그 사람에 대한 인상을 절반쯤 정해버립니다. 면접장에서 지원자가 자리에 앉아 처음 입을 떼는 30초, 새 프로젝트 첫 미팅에서 누가 먼저 말문을 여는 그 짧은 시간. 이상하게도 그 첫 30초가 그날 그 사람 전체의 분위기를 좌우합니다. 똑같이 일을 잘해도, 첫 30초에 존재감을 남긴 사람과 그렇지 ...

관리자 ·
7
발표를 가져가는 사람들은 떨림을 이렇게 씁니다
심리학

발표를 가져가는 사람들은 떨림을 이렇게 씁니다

발표나 면접을 앞두고 있으면, 며칠 전부터 같은 걱정이 머릿속을 맴돕니다. "목소리 떨리면 어떡하지", "손 떠는 거 들키면 끝인데." 그래서 우리는 떨림을 없애는 데 온 신경을 씁니다. 심호흡을 하고, 대본을 수십 번 외우고, '떨지 말자'를 속으로 되뇌면서요. 그런데 막상 사람들 앞에 서면 어김없이 떨립니다. 그러면 또 자책하죠. '왜 나는 이것도 못 ...

관리자 ·
14
강점은 잘하는 게 아니라 쉬운 거예요
강점코칭

강점은 잘하는 게 아니라 쉬운 거예요

일을 하다 보면 이런 순간이 있습니다. 옆 사람이 끙끙대며 붙들고 있는 일을 보면서, 속으로 "저걸 왜 저렇게 어려워하지?" 하고 의아해지는 순간이요. 나한테는 별로 힘들이지 않아도 술술 풀리는 일이라, 오히려 그 사람이 답답하게 느껴지기도 합니다. 그런데 정작 우리는 그 '나한테 쉬운 일'을 강점이라고 생각하지 않습니다. 너무 쉬워서, 너무 당연해서, 별...

관리자 ·
9
회의에서 일 잘하는 사람은 왜 말을 아낄까
심리학

회의에서 일 잘하는 사람은 왜 말을 아낄까

회의가 끝나고 자리로 돌아오는 길에, 문득 이런 생각이 들 때가 있습니다. "오늘 회의에서 가장 일 잘해 보였던 사람은 누구였지?" 떠올려 보면 의외입니다. 가장 많이 말한 사람이 아닌 경우가 대부분이거든요. 쉴 새 없이 의견을 내고 반박하던 사람보다, 끝에 흩어진 이야기를 한 줄로 정리해 준 사람이 더 또렷하게 남습니다. 우리는 회의에서 똑똑해 보이고 싶...

관리자 ·
57