1. 사전 준비
- Node.js 18 이상 설치
node -v # 버전 확인
없으면 Homebrew로 설치:
brew install node@20
echo 'export PATH="/opt/homebrew/opt/node@20/bin:$PATH"' >> ~/.zshrc
exec zsh
- Git 설치 확인
git --version
- Claude Pro 구독 계정 준비 (
claude.ai
)
2. Claude Code 설치
NPM 글로벌 설치(권장):
npm install -g @anthropic-ai/claude-code claude --version
3. 실행할 폴더 준비
Claude Code는 해당 디렉토리 내의 파일만 다루므로, 홈 디렉토리 전체는 피하는 게 안전하다.
실험용 프로젝트 폴더를 만들고 들어간다:
mkdir -p ~/study/claude-code-lab
cd ~/study/claude-code-lab
4. Claude Code 실행
claude
처음 실행하면 아래 단계를 거친다:
- 로그인 선택 →
1. Claude account with subscription
(Pro 계정 로그인)
- 터미널 설정 →
Yes, use recommended settings
(줄바꿈, 벨 기능 활성화)
- 폴더 신뢰 여부 → 해당 프로젝트 폴더면
Yes, proceed
5. 첫 세션 시작
정상 실행되면 대시보드가 뜬다.
이제 명령어 입력으로 Claude Code와 상호작용 가능하다:
- 도움말 확인:
> /help
- 파일 구조 설명 요청:
> explain the folder structure
- 새 파일 생성:
> add a hello world function in a new file hello.dart
- Git 연동:
> what files have I changed?
> commit my changes with message "chore: add hello world example"
6. 마무리 & 팁
- 여러 줄 입력 → Option + Enter
/login
→ 계정 재로그인
/clear
→ 대화 초기화
/release-notes
→ 최신 업데이트 확인
- 항상 프로젝트 단위 폴더에서 실행하는 게 안전
Share article