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

시작하기 전에

다음 사항을 확인하세요:

1단계: 첫 번째 세션 시작

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

cd /path/to/your/project
claude

새로운 대화형 세션 내에서 Claude Code 프롬프트를 볼 수 있습니다:

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

...

> "create a util logging.py that..."를 시도해보세요

2단계: 첫 번째 질문하기

코드베이스를 이해하는 것부터 시작해봅시다. 다음 명령 중 하나를 시도해보세요:

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

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

> 이 프로젝트는 어떤 기술을 사용하나요?
> 메인 진입점은 어디에 있나요?
> 폴더 구조를 설명해주세요

Claude Code는 필요에 따라 파일을 읽습니다 - 수동으로 컨텍스트를 추가할 필요가 없습니다.

3단계: 첫 번째 코드 변경하기

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

> 메인 파일에 hello world 함수를 추가해주세요

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

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

Claude Code는 파일을 수정하기 전에 항상 허가를 요청합니다. 개별 변경사항을 승인하거나 세션에 대해 “모두 승인” 모드를 활성화할 수 있습니다.

4단계: Claude Code와 Git 사용하기

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

> 내가 변경한 파일은 무엇인가요?
> 설명적인 메시지로 변경사항을 커밋해주세요

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

> feature/quickstart라는 새 브랜치를 만들어주세요
> 마지막 5개 커밋을 보여주세요
> 병합 충돌을 해결하는 데 도움을 주세요

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

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

자연어로 원하는 것을 설명하세요:

> 사용자 등록 양식에 입력 검증을 추가해주세요

또는 기존 문제를 수정하세요:

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

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

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

6단계: 다른 일반적인 워크플로우 테스트

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

코드 리팩토링

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

테스트 작성

> 계산기 함수에 대한 단위 테스트를 작성해주세요

문서 업데이트

> 설치 지침으로 README를 업데이트해주세요

코드 리뷰

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

기억하세요: Claude Code는 당신의 AI 페어 프로그래머입니다. 도움이 되는 동료에게 말하듯이 대화하세요 - 달성하고자 하는 것을 설명하면, 목표에 도달할 수 있도록 도와줄 것입니다.

필수 명령어

일상적인 사용을 위한 가장 중요한 명령어들입니다:

명령어기능예시
claude대화형 모드 시작claude
claude "작업"일회성 작업 실행claude "빌드 오류 수정"
claude -p "쿼리"일회성 쿼리 실행 후 종료claude -p "이 함수를 설명해주세요"
claude -c가장 최근 대화 계속claude -c
claude -r이전 대화 재개claude -r
claude commitGit 커밋 생성claude commit
/clear대화 기록 지우기> /clear
/help사용 가능한 명령어 표시> /help
exit 또는 Ctrl+CClaude Code 종료> exit

초보자를 위한 프로 팁

다음 단계는?

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

도움 받기

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