클로드코드 04-quickstart

4. Quickstart

몇 분 안에 Claude Code를 사용하여 AI 기반 코딩 어시스턴스를 활용하는 방법

4.1. 시작하기 전

필요한 것:

- 터미널 또는 명령 프롬프트
- 작업할 코드 프로젝트
- Claude 구독(Pro, Max, Team, Enterprise) 또는 Claude Console 계정

참고: 이 가이드는 터미널 CLI를 기준으로 한다. Claude Code는 Web(claude.ai/code), Desktop, VS Code, JetBrains, Slack, CI/CD에서도 사용 가능하다.

4.2. Step 1: 프로젝트에서 Claude Code 시작

cd /path/to/your/project
claude

환영 화면이 표시되면 세션 정보, 최근 대화, 업데이트 소식을 볼 수 있다.

4.3. Step 2: 첫 질문

프로젝트를 이해하는 것부터 시작한다.

what does this project do?

더 구체적인 질문도 가능하다.

what technologies does this project use?
where is the main entry point?
explain the folder structure

Claude Code는 필요한 파일을 자동으로 읽어 분석한다. 수동으로 컨텍스트를 추가할 필요가 없다.

4.4. Step 3: 첫 코드 변경

간단한 작업으로 시작한다.

add a hello world function to the main file

Claude Code가 수행하는 과정:

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

참고: Claude Code는 파일 수정 전 항상 권한을 요청한다. 세션 동안 Accept all 모드를 활성화할 수도 있다.

4.5. Step 4: Git과 함께 사용

Git 작업을 대화형으로 수행한다.

what files have I changed?
commit my changes with a descriptive message
create a new branch called feature/quickstart
show me the last 5 commits
help me resolve merge conflicts

4.6. Step 5: 버그 수정 또는 기능 추가

자연어로 설명하면 Claude Code가 디버깅하고 구현한다.

add input validation to the user registration form

there's a bug where users can submit empty forms - fix it

Claude Code가 수행하는 과정:

- 관련 코드 탐색
- 컨텍스트 이해
- 솔루션 구현
- 테스트 실행 (가능한 경우)

4.7. 일반적인 워크플로우

코드 리팩토링:

refactor the authentication module to use async/await instead of callbacks

테스트 작성:

write unit tests for the calculator functions

문서 업데이트:

update the README with installation instructions

코드 리뷰:

review my changes and suggest improvements

4.8. 필수 명령어

- 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: 종료 (예: exit)

4.9. 초보자 팁

4.9.1. 구체적으로 요청하라

- 피할 것: fix the bug
- 추천: fix the login bug where users see a blank screen after entering wrong credentials

4.9.2. 단계별로 지시하라

1. create a new database table for user profiles
2. create an API endpoint to get and update user profiles
3. build a webpage that allows users to see and edit their information

4.9.3. 먼저 탐색하게 하라

복잡한 작업 전에 코드베이스를 이해하게 한다.

analyze the database schema

4.9.4. 단축키 활용

- / : 모든 명령어와 skill 목록 보기
- Tab : 명령어 자동 완성
- 위 화살표 : 명령어 히스토리
- Shift+Tab : 권한 모드 전환

4.9.5. 검증 기준을 제시하라

Implement validateEmail. Test cases: 'user@example.com' -> true,
'invalid' -> false, 'user@.com' -> false. Run the tests after.

4.10. 다음 단계

- ../02-core-concepts/01-how-claude-code-works.txt - 에이전틱 루프와 도구 이해
- ../07-workflows/01-common-workflows.txt - 일반 작업 단계별 가이드
- ../07-workflows/02-best-practices.txt - 효과적인 사용 팁