빠른 시작
기준일: 2026-07-13 난이도: 초급 공식 기준: Quickstart, Setup
이 실습은 터미널 CLI 기준입니다. Claude Code는 웹, 데스크톱, VS Code, JetBrains, Slack, CI/CD에서도 사용할 수 있지만 첫 사용자는 프로젝트 디렉터리에서 CLI 흐름을 익히는 것이 가장 단순합니다.
핵심 개념
- 공식 문서는 Native Install을 우선 권장합니다.
claude를 처음 실행하면 로그인 흐름이 시작됩니다. 이미 실행 중이라면/login으로 계정을 바꿀 수 있습니다.- Claude Code는 현재 디렉터리를 작업 범위로 삼으므로 저장소 루트에서 시작합니다.
- 첫 요청은 바로 수정을 맡기기보다 프로젝트 조사, 변경 계획, 검증 순서로 진행합니다.
선택 기준
| 환경 | 공식 설치 방법 | 업데이트 |
|---|---|---|
| macOS, Linux, WSL | Native Install | 백그라운드 자동 업데이트 |
| Windows PowerShell | Native Install | 백그라운드 자동 업데이트 |
| macOS Homebrew | claude-code 또는 claude-code@latest cask |
brew upgrade 필요 |
| Windows WinGet | Anthropic.ClaudeCode |
winget upgrade 필요 |
Native Install과 패키지 관리자 설치를 한 시스템에서 섞지 않습니다. 기존 설치 방식은 claude doctor로 확인할 수 있습니다.
실습
1. 설치
macOS, Linux, WSL:
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell:
irm https://claude.ai/install.ps1 | iex
설치 확인:
claude --version
claude doctor
2. 로그인과 세션 시작
cd <your-project>
claude
처음 실행 시 안내에 따라 로그인합니다. 세션 안에서 다음 명령을 확인합니다.
/help
/status
3. 읽기 전용으로 프로젝트 파악
이 저장소의 주요 디렉터리와 실행 방법을 조사해줘.
아직 파일은 수정하지 말고, 근거가 된 파일 경로와 확인할 명령을 함께 알려줘.
4. 작은 변경과 검증
가장 작은 변경으로 이 문제를 해결해줘: <문제 설명>
기존 패턴을 먼저 찾고, 수정 후 관련 테스트와 lint를 실행해줘.
실패한 검증은 숨기지 말고 원인과 남은 위험을 구분해줘.
변경 내용을 직접 확인합니다.
git diff
이전 대화를 이어가려면 새 터미널에서 다음 명령을 사용합니다.
claude --resume
도구에 입력할 프롬프트
이 프로젝트의 AGENTS.md와 README를 먼저 읽어줘.
실행 명령, 테스트 명령, 수정 금지 영역을 표로 정리하고
각 항목의 근거 파일을 표시해줘. 아직 코드는 수정하지 마.
체크리스트
- 공식 설치 방법 하나만 선택했다.
-
claude --version과claude doctor를 확인했다. - 저장소 루트에서 세션을 시작했다.
- 첫 요청에서 근거 파일과 검증 명령을 요구했다.
- 변경 후
git diff와 테스트 결과를 직접 확인했다. - 비밀값을 프롬프트나 저장소에 붙이지 않았다.
다음 단계
- 초기 설정에서 설치 방식과 인증을 자세히 봅니다.
- 핵심 개념에서 agentic loop와 권한 경계를 이해합니다.
- 명령어와 Skills에서 반복 작업을 재사용하는 방법을 익힙니다.