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

​
시작하기 전에

다음이 준비되어 있는지 확인하세요:

  • 터미널 또는 명령 프롬프트가 열려 있음
  • 작업할 코드 프로젝트
  • Claude.ai (권장) 또는 Anthropic Console 계정

​
1단계: Claude Code 설치

​
NPM 설치

Node.js 18 이상이 설치되어 있다면:

npm install -g @anthropic-ai/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
# 프롬프트에 따라 계정으로 로그인하세요

다음 중 하나의 계정 유형으로 로그인할 수 있습니다:

로그인하면 자격 증명이 저장되어 다시 로그인할 필요가 없습니다.

Anthropic Console 계정으로 Claude Code를 처음 인증하면 “Claude Code”라는 워크스페이스가 자동으로 생성됩니다. 이 워크스페이스는 조직의 모든 Claude Code 사용에 대한 중앙 집중식 비용 추적 및 관리를 제공합니다.

동일한 이메일 주소로 두 계정 유형을 모두 가질 수 있습니다. 다시 로그인하거나 계정을 전환해야 하는 경우 Claude Code 내에서 /login 명령을 사용하세요.

​
3단계: 첫 번째 세션 시작

프로젝트 디렉토리에서 터미널을 열고 Claude Code를 시작하세요:

cd /path/to/your/project
claude

새로운 대화형 세션 내에서 Claude Code 프롬프트가 표시됩니다:

✻ Welcome to Claude Code!

...

> Try "create a util logging.py that..."

로그인 후(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 "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 참조를 참조하세요.

​
초보자를 위한 프로 팁

​
다음 단계

기본 사항을 배웠으니 더 고급 기능을 탐색해 보세요:

일반적인 워크플로

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

CLI 참조

모든 명령어와 옵션 마스터하기

구성

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

​
도움 받기

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