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

시작하기 전에

다음 사항을 확인하세요:

  • 터미널 또는 명령 프롬프트가 열려 있음
  • 작업할 코드 프로젝트가 있음

1단계: Claude Code 설치

NPM 설치

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

npm install -g @anthropic-ai/claude-code

네이티브 설치

또는 현재 베타 버전인 새로운 네이티브 설치를 시도해 보세요.

macOS, Linux, WSL:

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

Windows PowerShell:

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

2단계: 첫 번째 세션 시작

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

cd /path/to/your/project
claude

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

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

...

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

자격 증명은 시스템에 안전하게 저장됩니다. 자격 증명 관리에서 자세히 알아보세요.

3단계: 첫 번째 질문하기

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

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

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

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

Claude의 자체 기능에 대해서도 질문할 수 있습니다:

> Claude Code는 무엇을 할 수 있나요?
> Claude Code에서 슬래시 명령을 어떻게 사용하나요?
> Claude Code는 Docker와 함께 작동할 수 있나요?

Claude Code는 필요에 따라 파일을 읽습니다 - 수동으로 컨텍스트를 추가할 필요가 없습니다. Claude는 또한 자체 문서에 액세스할 수 있으며 기능과 역량에 대한 질문에 답할 수 있습니다.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

코드 리팩토링

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

테스트 작성

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

문서 업데이트

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

코드 리뷰

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

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

필수 명령

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

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

전체 명령 목록은 CLI 참조를 참조하세요.

초보자를 위한 프로 팁

다음 단계는?

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

도움 받기

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