빠른 시작

Claude Code에 오신 것을 환영합니다!

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

시작하기 전에

다음을 확인하십시오:

• 열려 있는 터미널 또는 명령 프롬프트
  • 터미널을 처음 사용하는 경우 터미널 가이드를 확인하십시오
• 작업할 코드 프로젝트
• Claude 구독 (Pro, Max, Team 또는 Enterprise), Claude Console 계정 또는 지원되는 클라우드 제공자를 통한 액세스

단계 1: Claude Code 설치

To install Claude Code, use one of the following methods:

curl -fsSL https://claude.ai/install.sh | bash

irm https://claude.ai/install.ps1 | iex

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

brew install --cask claude-code

winget install Anthropic.ClaudeCode

You can also install with apt, dnf, or apk on Debian, Fedora, RHEL, and Alpine.

단계 2: 계정에 로그인

Claude Code를 사용하려면 계정이 필요합니다. claude 명령으로 대화형 세션을 시작할 때 로그인해야 합니다:

claude
# 처음 사용할 때 로그인하라는 메시지가 표시됩니다

/login
# 프롬프트를 따라 계정으로 로그인하십시오

다음 계정 유형 중 하나를 사용하여 로그인할 수 있습니다:

• Claude Pro, Max, Team 또는 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을 입력하십시오.

단계 4: 첫 번째 질문 하기

코드베이스를 이해하는 것부터 시작하겠습니다. 다음 명령 중 하나를 시도하십시오:

이 프로젝트는 무엇을 하나요?

Claude가 파일을 분석하고 요약을 제공합니다. 더 구체적인 질문을 할 수도 있습니다:

이 프로젝트는 어떤 기술을 사용하나요?

주요 진입점은 어디인가요?

폴더 구조를 설명해주세요

Claude의 기능에 대해 물어볼 수도 있습니다:

Claude Code는 무엇을 할 수 있나요?

Claude Code에서 사용자 정의 skills를 만드는 방법은?

Claude Code는 Docker와 함께 작동할 수 있나요?

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

이제 Claude Code가 실제 코딩을 하도록 해봅시다. 간단한 작업을 시도하십시오:

주 파일에 hello world 함수 추가

Claude Code는 다음을 수행합니다:

1. 적절한 파일 찾기
2. 제안된 변경 사항 표시
3. 승인 요청
4. 편집 수행

단계 6: Claude Code와 함께 Git 사용

Claude Code는 Git 작업을 대화형으로 만듭니다:

어떤 파일을 변경했나요?

설명적인 메시지로 변경 사항 커밋

더 복잡한 Git 작업을 요청할 수도 있습니다:

feature/quickstart라는 새 브랜치 생성

마지막 5개의 커밋 표시

병합 충돌을 해결하는 데 도움을 주세요

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

Claude는 디버깅 및 기능 구현에 능숙합니다.

자연어로 원하는 것을 설명하십시오:

사용자 등록 양식에 입력 유효성 검사 추가

또는 기존 문제를 수정하십시오:

사용자가 빈 양식을 제출할 수 있는 버그가 있습니다 - 수정하세요

Claude Code는 다음을 수행합니다:

• 관련 코드 찾기
• 컨텍스트 이해
• 솔루션 구현
• 사용 가능한 경우 테스트 실행

단계 8: 다른 일반적인 워크플로우 시도

Claude와 함께 작업하는 여러 가지 방법이 있습니다:

코드 리팩토링

인증 모듈을 콜백 대신 async/await를 사용하도록 리팩토링

테스트 작성

계산기 함수에 대한 단위 테스트 작성

문서 업데이트

설치 지침으로 README 업데이트

코드 검토

내 변경 사항을 검토하고 개선 사항을 제안해주세요

필수 명령

일상적인 사용을 위한 가장 중요한 명령은 다음과 같습니다:

전체 명령 목록은 CLI 참조를 참조하십시오.

초보자를 위한 팁

자세한 내용은 모범 사례 및 일반적인 워크플로우를 참조하십시오.

시도: "사용자가 잘못된 자격 증명을 입력한 후 빈 화면을 보는 로그인 버그 수정"

1. 사용자 프로필을 위한 새 데이터베이스 테이블 생성
2. 사용자 프로필을 가져오고 업데이트하는 API 엔드포인트 생성
3. 사용자가 자신의 정보를 보고 편집할 수 있는 웹페이지 구축

데이터베이스 스키마 분석

영국 고객이 가장 자주 반품하는 제품을 보여주는 대시보드 구축

다음 단계

기본 사항을 배웠으므로 더 고급 기능을 살펴보십시오:

도움 받기

• Claude Code에서: /help를 입력하거나 "어떻게..."를 물어보기
• 문서: 여기 있습니다! 다른 가이드 찾아보기
• 커뮤니티: 팁과 지원을 위해 Discord에 참여하기