[Claude Code 마스터] #01 - 시작하기: 설치부터 첫 세션까지
Claude Code는 터미널에서 동작하는 AI 코딩 에이전트입니다. 단순한 코드 자동완성이 아니라, 여러분의 프로젝트를 이해하고 파일을 읽고 수정하며, 명령어를 실행하고, Git 작업까지 수행할 수 있어요. 마치 옆에 시니어 개발자가 앉아있는 것처럼요! 이번 편에서는 설치부터 첫 번째 대화까지 완벽하게 안내해 드립니다.
완독 시간: 15분 ⭐⭐
🎯 이번에 배울 것
📖 Claude Code란 무엇인가?
한 줄 설명
Claude Code = 터미널에서 동작하는 AI 페어 프로그래머
IDE 플러그인이나 웹 채팅과 달리, 터미널(CLI) 환경에서 직접 동작하면서 여러분의 프로젝트 전체를 파악합니다.
기존 AI 코딩 도구와의 차이점
1
2
3
4
5
6
7
8
9
10
┌─────────────────────────────────────────────────────────────────┐
│ AI 코딩 도구 비교 │
├─────────────────┬─────────────────┬─────────────────────────────┤
│ 일반 AI 챗봇 │ IDE 플러그인 │ Claude Code │
├─────────────────┼─────────────────┼─────────────────────────────┤
│ 코드 복붙 필요 │ 열린 파일만 인식 │ 프로젝트 전체 이해 │
│ 파일 수정 불가 │ 자동완성 중심 │ 직접 파일 수정 │
│ 명령어 실행 불가 │ 제한적 실행 │ 터미널 명령 실행 │
│ 컨텍스트 유실 │ 세션 한정 │ Git 히스토리까지 파악 │
└─────────────────┴─────────────────┴─────────────────────────────┘
Claude Code가 할 수 있는 것들
| 기능 | 설명 | 예시 |
|---|---|---|
| 코드베이스 탐색 | 프로젝트 구조와 코드 이해 | “이 프로젝트의 인증 로직을 설명해줘” |
| 파일 수정 | 직접 코드 편집 | “이 함수에 에러 핸들링 추가해줘” |
| 명령어 실행 | 테스트, 빌드, 배포 | “테스트 돌리고 실패하면 고쳐줘” |
| Git 작업 | 커밋, 브랜치, PR 생성 | “변경사항 커밋하고 PR 만들어줘” |
| 디버깅 | 에러 분석 및 수정 | “이 에러 메시지 보고 원인 찾아줘” |
| 리팩토링 | 코드 개선 | “이 클래스를 SOLID 원칙에 맞게 분리해줘” |
지원 플랫폼
Claude Code는 다양한 환경에서 사용할 수 있습니다:
- 터미널 (CLI): 핵심 경험.
claude명령어로 시작 - VS Code: 네이티브 확장 프로그램
- JetBrains IDE: IntelliJ, PyCharm, WebStorm 등
- 데스크톱 앱: 독립 실행형 애플리케이션
- 웹: claude.ai/code에서 브라우저로 사용
- Slack: 슬랙에서 @claude 멘션으로 작업 요청
- GitHub Actions: CI/CD 파이프라인 통합
이번 편에서는 터미널 CLI를 기준으로 설명합니다. IDE 통합은 #08편에서 다룹니다.
🔧 설치하기
사전 준비
설치 전에 다음이 필요합니다:
- Claude 구독 (Pro, Max, Teams, Enterprise 중 하나)
- 또는 Claude Console 계정 (API 크레딧 방식)
- 터미널 접근 가능한 환경
설치 방법 선택
세 가지 설치 방법이 있습니다. 상황에 맞게 선택하세요:
방법 1: Native Install (권장 ⭐)
가장 권장하는 방법입니다. 자동 업데이트가 지원됩니다.
macOS / Linux / WSL:
1
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell:
1
irm https://claude.ai/install.ps1 | iex
Windows CMD:
1
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
방법 2: Homebrew (macOS)
1
brew install --cask claude-code
⚠️ Homebrew는 자동 업데이트가 안 됩니다.
brew upgrade claude-code로 수동 업데이트하세요.
방법 3: WinGet (Windows)
1
winget install Anthropic.ClaudeCode
⚠️ WinGet도 자동 업데이트가 안 됩니다.
winget upgrade Anthropic.ClaudeCode로 수동 업데이트하세요.
설치 확인
설치가 완료되면 터미널에서 확인해보세요:
1
claude --version
버전 정보가 출력되면 성공입니다! 🎉
🚀 첫 실행 및 로그인
Step 1: 프로젝트 디렉토리로 이동
Claude Code는 현재 디렉토리를 기준으로 동작합니다. 먼저 작업할 프로젝트로 이동하세요:
1
cd /path/to/your/project
Step 2: Claude Code 시작
1
claude
처음 실행하면 웰컴 화면이 나타납니다.
Step 3: 로그인
처음 사용할 때는 로그인이 필요합니다. 브라우저가 자동으로 열리고 인증 페이지로 이동합니다.
1
/login
로그인할 수 있는 계정 유형:
- Claude Pro/Max/Teams/Enterprise: claude.com 구독 계정
- Claude Console: API 크레딧 기반 계정
- AWS Bedrock / Google Vertex AI: 엔터프라이즈 클라우드
💡 로그인 정보는 로컬에 저장되므로 매번 로그인할 필요 없습니다.
📋 기본 명령어 익히기
핵심 명령어 정리
| 명령어 | 설명 | 예시 |
|---|---|---|
claude | 대화형 모드 시작 | claude |
claude "작업" | 단일 작업 실행 | claude "테스트 실행해줘" |
claude -p "질문" | 질문 후 종료 | claude -p "이 함수 설명해줘" |
claude -c | 이전 대화 이어하기 | claude -c |
claude commit | Git 커밋 생성 | claude commit |
대화형 모드 내부 명령어
대화 중에 /로 시작하는 명령어를 사용할 수 있습니다:
| 명령어 | 설명 |
|---|---|
/help | 도움말 보기 |
/clear | 대화 기록 지우기 |
/compact | 컨텍스트 압축 |
/model | 모델 변경 |
/resume | 이전 세션 복원 |
exit 또는 Ctrl+C | 종료 |
유용한 키보드 단축키
| 단축키 | 기능 |
|---|---|
? | 모든 단축키 보기 |
Tab | 명령어 자동완성 |
↑ | 이전 명령어 |
/ | 명령어 메뉴 열기 |
Shift+Tab | 권한 모드 전환 |
Ctrl+O | Verbose 모드 토글 |
🎯 첫 번째 코드 변경 해보기
실제로 Claude Code를 사용해봅시다!
실습 1: 프로젝트 이해하기
1
what does this project do?
Claude가 프로젝트 구조를 분석하고 요약해줍니다.
실습 2: 특정 질문하기
1
what technologies does this project use?
1
where is the main entry point?
1
explain the folder structure
실습 3: 간단한 코드 추가
1
add a hello world function to the main file
Claude가 다음 과정을 자동으로 수행합니다:
- 적절한 파일 찾기
- 변경사항 미리보기 표시
- 여러분의 승인 요청
- 승인 시 파일 수정
⚠️ Claude는 파일 수정 전에 항상 승인을 요청합니다. 안심하고 사용하세요!
실습 4: Git 작업
1
what files have I changed?
1
commit my changes with a descriptive message
Claude가 변경사항을 분석하고 적절한 커밋 메시지를 작성해줍니다.
💡 초보자를 위한 팁
1. 구체적으로 요청하세요
1
2
❌ "버그 고쳐줘"
✅ "로그인할 때 잘못된 비밀번호 입력하면 빈 화면이 나오는 버그 고쳐줘"
2. 단계별로 나눠서 요청하세요
1
2
3
1. 유저 프로필을 저장할 데이터베이스 테이블 만들어줘
2. 프로필 조회/수정 API 엔드포인트 만들어줘
3. 프로필 편집 웹페이지 만들어줘
3. 먼저 이해시키세요
변경 전에 Claude가 코드를 충분히 이해하게 하세요:
1
먼저 데이터베이스 스키마를 분석해줘
그 다음에 변경 요청:
1
새로운 기능을 구현해줘
4. Claude Code에게 물어보세요
Claude Code 자체의 기능에 대해서도 물어볼 수 있습니다:
1
what can Claude Code do?
1
how do I create custom skills in Claude Code?
📝 오늘 배운 것 정리
✅ Claude Code는 터미널에서 동작하는 AI 코딩 에이전트
✅ 세 가지 설치 방법: Native Install(권장), Homebrew, WinGet
✅ 핵심 명령어: claude, claude "작업", claude -c
✅ 파일 수정 전 항상 승인 요청 → 안전하게 사용 가능
✅ 구체적이고 단계별로 요청하면 더 좋은 결과
🔗 다음 편 미리보기
#02편: 작동 원리 - Agentic Loop 이해하기
Claude Code가 어떻게 동작하는지 깊이 있게 알아봅니다:
- Agentic Loop의 3단계 (Context → Action → Verify)
- 내장 도구(Tools)의 종류와 역할
- 컨텍스트 윈도우와 세션 관리
- 체크포인트로 안전하게 되돌리기
🔗 시리즈 전체 보기
| # | 제목 | 상태 |
|---|---|---|
| 01 | 시작하기: 설치부터 첫 세션까지 | 📖 현재 글 |
| 02 | 작동 원리: Agentic Loop 이해하기 | 🔜 다음 편 |
| 03 | 일상 워크플로우: 실전 활용법 | 예정 |
| 04 | 메모리 관리: CLAUDE.md 완전 정복 | 예정 |
| 05 | Skills: 나만의 슬래시 명령어 만들기 | 예정 |
| 06 | Subagents: AI 분업 시스템 구축 | 예정 |
| 07 | MCP: 외부 도구 연결하기 | 예정 |
| 08 | IDE 통합: 어디서든 Claude Code | 예정 |
| 09 | GitHub Actions: CI/CD 자동화 | 예정 |
| 10 | 팀 협업: AI 시대의 개발 문화 | 예정 |
🔗 참고 자료
🚀 “이제와서”가 아닙니다. 지금이 가장 빠른 시작점이에요!