빠른 시작

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에 참여하여 팁과 지원을 받으세요

빠른 시작

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

팁:

로그인(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에 참여하여 팁과 지원을 받으세요

45. 빠른 시작

빠른 시작

시작하기 전에

1단계: Claude Code 설치

Native Install (Recommended)

Homebrew

WinGet

2단계: 계정에 로그인

3단계: 첫 번째 세션 시작

4단계: 첫 번째 질문하기

5단계: 첫 번째 코드 변경

6단계: Claude Code로 Git 사용

7단계: 버그 수정 또는 기능 추가

8단계: 다른 일반적인 워크플로우 사용해 보기

필수 명령어

초보자를 위한 팁

다음 단계

도움 받기

45. 빠른 시작

빠른 시작

시작하기 전에

1단계: Claude Code 설치

Native Install (Recommended)

Homebrew

WinGet

2단계: 계정에 로그인

3단계: 첫 번째 세션 시작

4단계: 첫 번째 질문하기

5단계: 첫 번째 코드 변경

6단계: Claude Code로 Git 사용

7단계: 버그 수정 또는 기능 추가

8단계: 다른 일반적인 워크플로우 사용해 보기

필수 명령어

초보자를 위한 팁

다음 단계

도움 받기