[Part 1] AI 비서 한 명 얻기 - 0. Claude Code 설치하기
Claude Code는 Anthropic이 만든 터미널 기반 AI 코딩 에이전트로, 파일 읽기·수정·실행까지 직접 수행하며 개발자의 AI 페어 프로그래머 역할을 합니다. npm으로 간단히 설치할 수 있으며, 버그 수정·기능 추가·테스트 자동화 등 실전 개발 전반에 걸쳐 활용할 수 있습니다. CLAUDE.md 파일과 구체적인 요청 방식을 함께 활용하면 더욱 일관되고 정확한 결과를 얻을 수 있습니다.
![[Part 1] AI 비서 한 명 얻기 - 0. Claude Code 설치하기](https://9way.co.kr/rails/active_storage/representations/redirect/eyJfcmFpbHMiOnsiZGF0YSI6IjJkNDg4NmJiLTkxNGUtNDg3OC1iOTQwLTYxZWU1MzU1NGU1MSIsInB1ciI6ImJsb2JfaWQifX0=--6dec32387b13fa294de451074e449611aa92dd6f/eyJfcmFpbHMiOnsiZGF0YSI6eyJmb3JtYXQiOiJ3ZWJwIiwicmVzaXplX3RvX2xpbWl0IjpbMTIwMCw2MzBdLCJzYXZlciI6eyJxdWFsaXR5Ijo4Mn19LCJwdXIiOiJ2YXJpYXRpb24ifX0=--66d1732cca08e3a43d8c25533523091baa3742a7/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와 함께라면, 혼자서는 막막했던 코드도 한 발씩 나아갈 수 있습니다. 지금 바로 터미널을 열어보세요. 🚀
자주 묻는 질문
Claude Code를 설치하려면 어떤 환경이 필요한가요?
Node.js 18 이상이 설치된 환경이라면 npm install -g @anthropic-ai/claude-code 명령어 한 줄로 전역 설치가 가능합니다. 설치 후 처음 실행 시 Anthropic Console에서 발급받은 API 키를 입력하면 바로 사용할 수 있습니다.
Claude Code는 기존 챗봇형 AI 코딩 도구와 어떻게 다른가요?
기존 챗봇형 도구는 코드를 텍스트로 제안하는 데 그치지만, Claude Code는 터미널에서 직접 파일 시스템에 접근해 파일을 읽고 수정하며 쉘 명령어까지 실행할 수 있습니다. 즉, 실제 개발 환경 안에서 AI가 직접 작업에 참여하는 에이전트 방식으로 동작합니다.
CLAUDE.md 파일은 무엇이고 왜 만들어야 하나요?
CLAUDE.md는 프로젝트 루트에 두는 설정 파일로, 코딩 컨벤션·아키텍처 구조·자주 쓰는 명령어 등을 정리해두면 Claude Code가 매번 이를 참고해 일관된 결과를 생성합니다. 특히 팀 프로젝트에서 여러 사람이 Claude Code를 사용할 때 코드 스타일 통일에 효과적입니다.
Claude Code 사용 시 보안이나 비용 면에서 주의할 점은 무엇인가요?
Claude Code는 파일을 직접 수정할 수 있으므로 작업 전 반드시 Git 커밋을 해두고, 작업 후에는 git diff로 변경사항을 검토하는 습관이 중요합니다. API 키나 비밀번호 같은 민감 정보가 담긴 파일은 접근 제한을 설정하고, 대규모 코드베이스를 자주 분석하면 API 사용 비용이 늘어날 수 있으므로 요청 범위를 적절히 조절하세요.
Claude Code로 테스트 코드를 자동 생성할 수 있나요?
네, 특정 파일을 지정하고 'Jest로 단위 테스트 작성해줘, 엣지 케이스 포함해서'처럼 요청하면 Claude Code가 기존 테스트 파일의 스타일을 참고해 자동으로 테스트를 생성합니다. 기존 테스트 파일이 없는 경우에도 프로젝트 설정에 맞는 테스트 코드를 만들어 줍니다.
아이디어를 실제 AI 서비스로 만들어보세요
VUILD에서 AI 도구로 MVP와 서비스를 직접 빌드해보세요.
관련 글
CLAUDE.md에 적어두면 진짜 효과 보는 5줄 + 직무별 7개 (총 40줄)
CLAUDE.md는 Claude Code가 프로젝트 시작 시 자동으로 읽는 환경 설정 파일로, 한 번 작성해두면 매 대화마다 반복 지시 없이 규칙이 자동 적용됩니다. 이 글은 모든 직무에 공통으로 권장하는 보편 5줄(환각 방지·영향 범위 확인·명확화 질문 등)과 마케터·기획·개발·디자이너·HR·영업·데이터 7개 직무별 추가 5줄을 정리하고, 그대로 복붙할 수 있는 템플릿까지 제공합니다.
'정리해줘'는 그만 — Claude 결과 신뢰도 4가지 키워드 + 직무별 프롬프트 30
Claude에게 "정리해줘" 한 줄만 입력하면 결과가 두루뭉술하고 검증도 어렵습니다. 명령 끝에 출처 라벨, 수정 단위 분리, 반증 가능성, 단계별 진행 보고 4가지 키워드를 추가하면 결과의 신뢰도와 수정 가능성이 결정적으로 달라집니다. 마케터·기획·개발·디자인·HR·영업·데이터 직무별 프롬프트 30개를 그대로 복붙해 바로 활용할 수 있습니다.
ChatGPT 1년 써도 모르는 Claude Code 활용 5가지 + 직무별 적용 30개
Claude Code는 ChatGPT처럼 텍스트를 출력하는 도구가 아니라, 파일을 직접 생성·수정·삭제하는 실행 도구입니다. CLAUDE.md 안전장치 설정, 자체 검수 요청, /clear 컨텍스트 리셋, 톤 통일, 작업 흐름 자동화 등 5가지 핵심 활용법을 마케터·기획·개발·디자이너·HR·영업·데이터 7개 직무별로 구체적으로 정리했습니다. 각 직무에 바로 복붙할 수 있는 프롬프트 모음도 함께 제공합니다.
Claude Code 첫날 활용 7가지 + 그대로 복붙 프롬프트
Claude Code 첫날에 시도할 수 있는 7가지 활용법과 그대로 복붙해서 쓸 수 있는 프롬프트를 정리했습니다. 흩어진 메모 정리, PDF 비교표, 회의록 액션 아이템 분리 등 결과 가시성이 높은 작업부터 시작하면 첫날 5분 안에 파일 형태의 결과물을 확인할 수 있습니다. CLAUDE.md 템플릿까지 제공하므로 초기 셋업도 바로 완료할 수 있습니다.