빠른 시작

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

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

시작하기 전에

다음을 확인하십시오:

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

단계 1: Claude Code 설치

Claude Code를 설치하려면 다음 방법 중 하나를 사용하십시오:

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

또한 Debian, Fedora, RHEL 및 Alpine에서 apt, dnf 또는 apk로 설치할 수 있습니다.

설치가 제대로 작동했는지 확인하려면 다음을 실행하세요:

claude --version

이 명령어는 버전 번호 다음에 (Claude Code)를 출력합니다.

단계 2: 계정에 로그인

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

claude

Claude 구독 또는 Console 계정의 경우 프롬프트를 따라 브라우저에서 인증을 완료하십시오. ANTHROPIC_API_KEY 환경 변수를 설정한 경우 Claude Code는 로그인 프롬프트를 건너뛰고 대신 키를 승인하도록 요청합니다. 나중에 계정을 전환하거나 다시 인증하려면 실행 중인 세션 내에서 /login을 입력하십시오:

/login

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

• Claude Pro, Max, Team 또는 Enterprise (권장)
• Claude Console (선불 크레딧이 있는 API 액세스). 처음 로그인할 때 비용 추적을 위해 Console에서 "Claude Code" 워크스페이스가 자동으로 생성됩니다.
• Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry (엔터프라이즈 클라우드 제공자)
• 조직에서 운영하는 자체 호스팅 Claude 앱 게이트웨이: 관리자가 게이트웨이 URL을 미리 구성하고, /login을 입력하면 Cloud gateway 화면에서 직접 열려 기업 SSO로 로그인할 수 있습니다.

로그인하면 자격 증명이 저장되고 다시 로그인할 필요가 없습니다. 자격 증명 관리에서 자세히 알아보십시오.

단계 3: 첫 번째 세션 시작

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

cd /path/to/your/project
claude

/path/to/your/project를 작업하려는 프로젝트의 경로로 바꾸십시오.

버전, 현재 모델 및 작업 디렉토리가 표시된 Claude Code 프롬프트가 나타납니다. 사용 가능한 명령을 보려면 /help를 입력하거나 이전 대화를 계속하려면 /resume을 입력하십시오.

단계 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?

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

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

주 파일에 hello world 함수 추가

Claude Code는 적절한 파일을 찾고 변경 사항을 보여줍니다. 변경하기 전에 묻는 경우 예를 선택하여 승인하십시오.

자동 모드는 Pro, Max 및 Team 플랜의 대화형 터미널 세션에 대한 기본 제공 시작 권한 모드입니다. 분류기가 사용자 대신 작업을 검토하며, Claude는 대부분의 파일을 편집하고 대부분의 명령을 묻지 않고 실행합니다. 다른 플랜에서는 수동 모드가 기본 제공 시작 권한 모드입니다. 설치 또는 업그레이드 직후에 시작하는 세션의 경우 설치 또는 업그레이드 후 첫 번째 세션을 참조하십시오.

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

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

어떤 파일을 변경했나요?

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

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

feature/quickstart라는 새 브랜치 생성

마지막 5개의 커밋 표시

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

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

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

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

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

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

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

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

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

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

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

코드 리팩토링

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

테스트 작성

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

문서 업데이트

설치 지침으로 README 업데이트

코드 검토

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

필수 명령

일상적인 사용을 위한 가장 중요한 명령은 다음과 같습니다. 셸 명령은 Claude Code를 시작하거나 재개하기 위해 터미널에서 실행됩니다. 세션 명령은 Claude Code가 시작된 후 내부에서 실행됩니다.

셸 명령

세션 명령

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

초보자를 위한 팁

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

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

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

데이터베이스 스키마 분석

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

다음 단계

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

도움 받기

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