빠른 시작
읽는 시간: 5분 | 난이도: 초급자
5분 안에 Claude Code를 시작하고 첫 번째 명령어를 실행해보세요.
이 가이드는 Claude Code를 빠르게 시작하는 방법을 안내합니다. 이미 설치가 완료되었다고 가정하고, 바로 사용을 시작할 수 있도록 안내합니다.
1. Claude Code 실행
터미널에서 Claude Code를 실행하세요:
claude-code
처음 실행하면 다음과 같은 환영 메시지가 표시됩니다:
Welcome to Claude Code!
=======================
Your terminal AI coding assistant.
Let's set up your first project:
1. Current directory: /Users/lf/work/my-project
2. Project type: web-app
3. Language: JavaScript
Is this correct? [Y/n]
- Y: 현재 디렉토리를 프로젝트로 사용
- n: 다른 디렉토리 지정
2. 첫 번째 명령어 실행
Claude Code가 준비되면 첫 번째 요청을 해보세요:
프로젝트 초기 설정
> 이 프로젝트를 초기 설정해줘
Claude Code가 다음과 같이 응답합니다:
I'll help you set up this project! Let me create the basic structure.
## 작업 계획
1. package.json 생성
2. 기본 디렉토리 구조 생성
3. .gitignore 설정
4. README.md 작성
작업을 시작할까요? [Y/n]
Y를 입력하면 Claude Code가 모든 작업을 직접 처리합니다.
간단한 컴포넌트 생성
> 간단한 React 컴포넌트를 만들어줘
> 로그인 폼을 만들고, 이메일과 비밀번호 검증을 추가해줘
파일 수정
> App.js 파일에 Tailwind CSS를 적용해줘
테스트 작성
> 유닛 테스트를 작성해줘
문서 작성
> README.md를 작성해줘
3. 실제 작업 예시
간단한 투두 앱을 만들어보겠습니다:
# 프로젝트 생성
mkdir todo-app
cd todo-app
claude-code
# 명령어 실행
> React + TypeScript로 간단한 투두 앱을 만들어줘
> 백엔드 API를 추가해줘 (GET /api/todos, POST /api/todos)
> 데이터를 로컬 스토리지에 저장해줘
Claude Code가 모든 작업을 자동으로 처리합니다:
I'll create a todo app with React and TypeScript, then add backend API and localStorage persistence.
## 작업 진행
1. 프로젝트 구조 생성
2. React 컴포넌트 작성
3. API 라우팅 구현
4. localStorage 연동
5. 테스트 코드 작성
작업 결과 확인
생성된 파일을 확인하세요:
ls -la
src/
├── components/
│ ├── TodoItem.tsx
│ ├── TodoList.tsx
│ └── TodoForm.tsx
├── api/
│ └── todos.ts
├── types/
│ └── index.ts
├── App.tsx
├── main.tsx
└── index.css
4. 유용한 명령어
도움말 보기
> 어떤 명령어를 사용할 수 있어?
Claude Code가 지원하는 모든 명령어를 목록으로 보여줍니다.
작업 예시 보기
> 예시를 보여줘
실제 작업 예시를 보여주며 작업 방법을 안내합니다.
에러 해결
> 이 에러를 해결해줘: [에러 메시지]
에러 원인과 해결 방법을 분석해줍니다.
환경 확인
> 내 환경을 확인해줘
현재 프로젝트 환경과 설정을 분석해줍니다.
5. 첫 사용자를 위한 팁
1. 자연어로 요청하기
# 복잡한 명령어
"create a new file called utils.js with function validateEmail"
# 자연어로 요청하기
"이메일 검증 함수를 만들어줘"
2. 구체적으로 요청하기
# 모호한 요청
"코드를 최적화해줘"
# 구체적인 요청
"React 컴포넌트에서 불필요한 렌더링을 제거해줘"
3. 점진적으로 작업하기
# 큰 작업은 작게 나누기
"로그인 페이지를 만들어줘"
"이메일 입력창을 추가해줘"
"비밀번호 유효성 검사를 추가해줘"
6. 다음 단계
이제 Claude Code의 기본 사용법을 익혔습니다. 다음 단계로 나아가세요:
1. 심화 기능 학습
2. 실전 프로젝트
- 간단한 웹 앱 만들기
- 기존 프로젝트에 Claude Code 통합
- 팀 프로젝트에서 Claude Code 활용
3. 커뮤니티 참여
- 공식 포럼 가입
- GitHub Issues 참여
- 사용 팁 공유
빠른 시작이 도움이 되셨나요?
더 자세한 설정 방법을 알고 싶으시다면 설치 및 설정 가이드를 확인하세요.