이 빠른 시작 가이드를 통해 단 몇 분 안에 AI 기반 코딩 지원을 사용할 수 있습니다. 끝까지 진행하면 일반적인 개발 작업에 Claude Code를 사용하는 방법을 이해하게 될 것입니다.

​
시작하기 전에

다음을 확인하세요:
  • 터미널 또는 명령 프롬프트가 열려 있음
  • 작업할 코드 프로젝트
  • Claude.ai (권장) 또는 Claude Console 계정

​
단계 1: Claude Code 설치

​
NPM 설치

Node.js 18 이상이 설치되어 있다면: 
npm install -g @anthropic-ai/claude-code

​
네이티브 설치

또는 현재 베타 버전인 새로운 네이티브 설치를 시도해보세요.
Homebrew (macOS, Linux): 
brew install --cask claude-code
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

​
단계 2: 계정에 로그인

Claude Code를 사용하려면 계정이 필요합니다. claude 명령으로 대화형 세션을 시작할 때 로그인해야 합니다: 
claude
# 처음 사용할 때 로그인하라는 메시지가 표시됩니다

/login
# 프롬프트를 따라 계정으로 로그인하세요
다음 두 가지 계정 유형 중 하나로 로그인할 수 있습니다: 로그인하면 자격 증명이 저장되고 다시 로그인할 필요가 없습니다.
Claude Console 계정으로 Claude Code를 처음 인증할 때 “Claude Code”라는 워크스페이스가 자동으로 생성됩니다. 이 워크스페이스는 조직의 모든 Claude Code 사용에 대한 중앙 집중식 비용 추적 및 관리를 제공합니다.
같은 이메일 주소로 두 가지 계정 유형을 모두 가질 수 있습니다. 다시 로그인하거나 계정을 전환해야 하는 경우 Claude Code 내에서 /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 use slash commands in Claude Code?

> can Claude Code work with Docker?
Claude Code는 필요에 따라 파일을 읽습니다. 수동으로 컨텍스트를 추가할 필요가 없습니다. Claude는 또한 자체 문서에 액세스할 수 있으며 기능 및 기능에 대한 질문에 답할 수 있습니다.

​
단계 5: 첫 번째 코드 변경 수행

이제 Claude Code에 실제 코딩을 하도록 해봅시다. 간단한 작업을 시도해보세요: 
> add a hello world function to the main file
Claude Code는 다음을 수행합니다:
  1. 적절한 파일 찾기
  2. 제안된 변경 사항 표시
  3. 승인 요청
  4. 편집 수행
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 Code는 당신의 AI 페어 프로그래머입니다. 도움이 되는 동료와 대화하듯이 대화하세요. 달성하고 싶은 것을 설명하면 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 commitGit 커밋 생성claude commit
/clear대화 기록 지우기> /clear
/help사용 가능한 명령 표시> /help
exit 또는 Ctrl+CClaude 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가 코드를 이해하도록 하세요:
> analyze the database schema

> build a dashboard showing products that are most frequently returned by our UK customers
  • ?를 눌러 사용 가능한 모든 키보드 바로가기 보기
  • Tab을 사용하여 명령 자동 완성
  • ↑를 눌러 명령 기록 보기
  • /를 입력하여 모든 슬래시 명령 보기

​
다음은?

기본 사항을 배웠으므로 더 고급 기능을 살펴보세요:

일반적인 워크플로우

일반적인 작업을 위한 단계별 가이드

CLI 참조

모든 명령 및 옵션 마스터

구성

워크플로우에 맞게 Claude Code 사용자 정의

웹의 Claude Code

클라우드에서 비동기적으로 작업 실행

​
도움말 받기

  • Claude Code에서: /help를 입력하거나 “how do I…”를 물어보세요
  • 문서: 여기 있습니다! 다른 가이드를 찾아보세요
  • 커뮤니티: 팁과 지원을 위해 Discord에 참여하세요