빠른 시작

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

시작하기 전에

다음을 확인하십시오:

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

이 가이드는 터미널 CLI의 첫 세션 흐름을 다룹니다. 설치 방법은 터미널 CLI 시작하기를 참고하십시오. Claude Code는 웹, 데스크톱 앱, VS Code, JetBrains IDE, Slack, GitHub Actions 및 GitLab의 CI/CD에서도 사용할 수 있습니다.

단계 1: Claude Code CLI 준비

설치가 끝났다면 터미널에서 다음 명령이 동작하는지 확인합니다.

claude --version

단계 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을 입력하십시오.

로그인(단계 2) 후 자격 증명이 시스템에 저장됩니다. 자격 증명 관리에서 자세히 알아보십시오.

단계 4: 첫 번째 질문 하기

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

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

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

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

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

폴더 구조를 설명해주세요

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

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

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

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

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

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

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

주 파일에 hello world 함수 추가

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

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

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

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

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

어떤 파일을 변경했나요?

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

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

feature/quickstart라는 새 브랜치 생성

마지막 5개의 커밋 표시

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

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

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

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

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

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

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

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

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

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

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

코드 리팩토링

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

테스트 작성

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

문서 업데이트

설치 지침으로 README 업데이트

코드 검토

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

도움이 되는 동료처럼 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`
`/clear`	대화 기록 지우기	`/clear`
`/help`	사용 가능한 명령 표시	`/help`
`exit` 또는 Ctrl+D	Claude Code 종료	`exit`

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

초보자를 위한 팁

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

요청을 구체적으로 하기

대신: "버그 수정"

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

단계별 지침 사용

복잡한 작업을 단계로 나누기:

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

Claude가 먼저 탐색하도록 하기

변경하기 전에 Claude가 코드를 이해하도록 하기:

데이터베이스 스키마 분석

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

바로가기로 시간 절약

/를 입력하여 모든 명령 및 skills 보기
Tab을 사용하여 명령 완성
↑를 눌러 명령 기록 보기
Shift+Tab을 눌러 권한 모드 순환