45. 빠른 시작
설치·로그인·첫 세션·Git·리팩토링 등 Claude Code 입문 가이드
빠른 시작
Claude Code에 오신 것을 환영합니다!
이 빠른 시작 가이드를 통해 몇 분 안에 AI 기반 코딩 어시스턴트를 사용할 수 있습니다. 이 가이드를 마치면 일반적인 개발 작업에 Claude Code를 사용하는 방법을 이해하게 됩니다.
시작하기 전에
다음을 준비해 주세요:
- 터미널 또는 명령 프롬프트
- 터미널을 처음 사용하시는 분은 터미널 가이드를 확인하세요
- 작업할 코드 프로젝트
- Claude 구독 (Pro, Max, Teams, 또는 Enterprise), Claude Console 계정, 또는 지원되는 클라우드 제공업체를 통한 액세스
참고:
이 가이드는 터미널 CLI를 다룹니다. Claude Code는 웹, 데스크톱 앱, VS Code 및 JetBrains IDE, Slack, 그리고 GitHub Actions 및 GitLab을 통한 CI/CD에서도 사용할 수 있습니다. 모든 인터페이스를 확인하세요.
1단계: Claude Code 설치
Claude Code를 설치하려면 다음 방법 중 하나를 사용하세요:
Native Install (Recommended)
macOS, Linux, WSL:
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell:
irm https://claude.ai/install.ps1 | iex
Windows CMD:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Windows에서는 Git for Windows가 필요합니다. 아직 설치하지 않았다면 먼저 설치하세요.
참고:
네이티브 설치는 백그라운드에서 자동으로 업데이트되어 항상 최신 버전을 유지합니다.
Homebrew
brew install --cask claude-code
참고:
Homebrew 설치는 자동 업데이트되지 않습니다. 최신 기능과 보안 수정을 받으려면 주기적으로
brew upgrade claude-code를 실행하세요.
WinGet
winget install Anthropic.ClaudeCode
참고:
WinGet 설치는 자동 업데이트되지 않습니다. 최신 기능과 보안 수정을 받으려면 주기적으로
winget upgrade Anthropic.ClaudeCode를 실행하세요.
2단계: 계정에 로그인
Claude Code를 사용하려면 계정이 필요합니다. claude 명령으로 인터랙티브 세션을 시작하면 로그인해야 합니다:
claude
# 처음 사용 시 로그인 안내가 표시됩니다
/login
# 안내에 따라 계정으로 로그인하세요
다음 계정 유형 중 하나로 로그인할 수 있습니다:
- Claude Pro, Max, Teams, 또는 Enterprise (권장)
- Claude Console (선불 크레딧을 사용한 API 액세스). 처음 로그인하면 Console에 중앙 집중식 비용 추적을 위한 "Claude Code" 워크스페이스가 자동으로 생성됩니다.
- Amazon Bedrock, Google Vertex AI, 또는 Microsoft Foundry (엔터프라이즈 클라우드 제공업체)
로그인하면 인증 정보가 저장되어 다시 로그인할 필요가 없습니다. 나중에 계정을 전환하려면 /login 명령을 사용하세요.
3단계: 첫 번째 세션 시작
터미널에서 프로젝트 디렉토리를 열고 Claude Code를 시작하세요:
cd /path/to/your/project
claude
Claude Code 환영 화면에 세션 정보, 최근 대화, 최신 업데이트가 표시됩니다. /help를 입력하면 사용 가능한 명령을 확인하거나, /resume를 입력하면 이전 대화를 이어갈 수 있습니다.
팁:
로그인(2단계) 후 인증 정보가 시스템에 저장됩니다. 자세한 내용은 인증 정보 관리를 참조하세요.
4단계: 첫 번째 질문하기
코드베이스를 이해하는 것부터 시작해 보겠습니다. 다음 명령 중 하나를 시도해 보세요:
what does this project do?
Claude가 파일을 분석하고 요약을 제공합니다. 더 구체적인 질문도 할 수 있습니다:
what technologies does this project use?
where is the main entry point?
explain the folder structure
Claude에게 자체 기능에 대해 질문할 수도 있습니다:
what can Claude Code do?
how do I create custom skills in Claude Code?
can Claude Code work with Docker?
참고:
Claude Code는 필요에 따라 프로젝트 파일을 읽습니다. 수동으로 컨텍스트를 추가할 필요가 없습니다.
5단계: 첫 번째 코드 변경
이제 Claude Code로 실제 코딩을 해보겠습니다. 간단한 작업을 시도해 보세요:
add a hello world function to the main file
Claude Code는 다음을 수행합니다:
- 적절한 파일을 찾습니다
- 제안된 변경 사항을 보여줍니다
- 승인을 요청합니다
- 편집을 수행합니다
참고:
Claude Code는 파일을 수정하기 전에 항상 권한을 요청합니다. 개별 변경 사항을 승인하거나 세션 동안 "모두 수락" 모드를 활성화할 수 있습니다.
6단계: Claude Code로 Git 사용
Claude Code는 Git 작업을 대화형으로 만들어 줍니다:
what files have I changed?
commit my changes with a descriptive message
더 복잡한 Git 작업도 프롬프트로 수행할 수 있습니다:
create a new branch called feature/quickstart
show me the last 5 commits
help me resolve merge conflicts
7단계: 버그 수정 또는 기능 추가
Claude는 디버깅과 기능 구현에 능숙합니다.
원하는 것을 자연어로 설명하세요:
add input validation to the user registration form
또는 기존 이슈를 수정하세요:
there's a bug where users can submit empty forms - fix it
Claude Code는 다음을 수행합니다:
- 관련 코드를 찾습니다
- 컨텍스트를 이해합니다
- 솔루션을 구현합니다
- 가능한 경우 테스트를 실행합니다
8단계: 다른 일반적인 워크플로우 사용해 보기
Claude와 함께 작업하는 다양한 방법이 있습니다:
코드 리팩토링
refactor the authentication module to use async/await instead of callbacks
테스트 작성
write unit tests for the calculator functions
문서 업데이트
update the README with installation instructions
코드 리뷰
review my changes and suggest improvements
팁:
도움이 되는 동료에게 말하듯 Claude에게 이야기하세요. 달성하고자 하는 것을 설명하면 Claude가 도와줄 것입니다.
필수 명령어
일상적으로 사용하는 가장 중요한 명령어입니다:
| 명령어 | 기능 | 예시 |
|---|---|---|
claude | 인터랙티브 모드 시작 | claude |
claude "task" | 일회성 작업 실행 | claude "fix the build error" |
claude -p "query" | 일회성 쿼리 실행 후 종료 | claude -p "explain this function" |
claude -c | 현재 디렉토리에서 가장 최근 대화 이어가기 | claude -c |
claude -r | 이전 대화 재개 | claude -r |
claude commit | Git 커밋 생성 | claude commit |
/clear | 대화 기록 지우기 | /clear |
/help | 사용 가능한 명령어 표시 | /help |
exit 또는 Ctrl+C | Claude Code 종료 | exit |
전체 명령어 목록은 CLI 레퍼런스를 참조하세요.
초보자를 위한 팁
더 자세한 내용은 모범 사례와 일반적인 워크플로우를 참조하세요.
요청을 구체적으로 하세요
이렇게 하지 마세요: "fix the bug"
이렇게 해보세요: "fix the login bug where users see a blank screen after entering wrong credentials"
단계별 지시를 사용하세요
복잡한 작업을 단계별로 나누세요:
1. create a new database table for user profiles
2. create an API endpoint to get and update user profiles
3. build a webpage that allows users to see and edit their information
먼저 Claude가 탐색하게 하세요
변경하기 전에 Claude가 코드를 이해하도록 하세요:
analyze the database schema
build a dashboard showing products that are most frequently returned by our UK customers
단축키로 시간을 절약하세요
?를 눌러 사용 가능한 모든 키보드 단축키를 확인하세요- Tab을 사용하여 명령어를 자동 완성하세요
- ↑를 눌러 명령어 기록을 탐색하세요
/를 입력하여 모든 명령어와 스킬을 확인하세요
다음 단계
기본을 배웠으니 더 고급 기능을 살펴보세요:
- Claude Code 작동 방식 - 에이전틱 루프, 내장 도구, Claude Code가 프로젝트와 상호작용하는 방식을 이해하세요
- 모범 사례 - 효과적인 프롬프팅과 프로젝트 설정으로 더 나은 결과를 얻으세요
- 일반적인 워크플로우 - 일반적인 작업을 위한 단계별 가이드
- Claude Code 확장 - CLAUDE.md, 스킬, 훅, MCP 등으로 커스터마이즈하세요
도움 받기
- Claude Code 내에서:
/help를 입력하거나 "how do I..."라고 질문하세요 - 문서: 여기 있습니다! 다른 가이드를 둘러보세요
- 커뮤니티: Discord에 참여하여 팁과 지원을 받으세요