기본 사용법
Claude Code의 세 가지 기본 실행 모드를 익혀 효율적으로 작업해보세요.
대화형 모드
가장 일반적인 사용 방법으로, Claude와 지속적인 대화를 통해 작업을 진행합니다.
시작하기
터미널
claude초기 질문과 함께 시작
터미널
claude "이 프로젝트를 설명해줘"사용 예제
프로젝트 분석
Claude Code
claude> 이 코드베이스를 요약해줘코드 질문
Claude Code
claude> 인증 시스템이 어떻게 작동하는지 설명해줘코드 수정
Claude Code
claude> API 엔드포인트에 에러 처리를 추가해줘💡 팁: 대화형 모드에서는 Claude가 이전 대화 내용을 기억하므로, 연속적인 작업에 매우 효과적입니다.
원샷 모드
빠른 명령 실행을 위한 모드로, 한 번의 명령으로 작업을 완료하고 종료합니다.
기본 사용법
터미널
claude -p "이 함수가 무엇을 하는지 설명해줘"실용적인 예제
빠른 분석
터미널
claude -p "API 엔드포인트 개수를 세어줘"간단한 수정
터미널
claude -p "README.md의 오타를 수정해줘"Git 작업
터미널
claude -p "버그 수정에 대한 커밋을 생성해줘"⚡ 언제 사용하나요? 스크립트, CI/CD 파이프라인, 또는 빠른 일회성 작업에 적합합니다.
파이프 모드
파일 내용이나 다른 명령의 출력을 Claude에게 직접 전달하여 분석하거나 처리합니다.
기본 문법
터미널
cat file.txt | claude -p "이 내용을 분석해줘"다양한 활용 방법
로그 분석
터미널
cat server.log | claude -p "에러 패턴을 찾아줘"Git 히스토리 분석
터미널
git log --oneline | claude -p "최근 변경사항을 요약해줘"테스트 결과 분석
터미널
npm test 2>&1 | claude -p "테스트 실패 원인을 설명해줘"파일 비교
터미널
diff old.js new.js | claude -p "변경사항을 설명해줘"🔗 Unix 철학: 파이프 모드는 Unix의 "작은 도구들을 연결하여 큰 작업을 수행한다"는 철학을 따릅니다.
모드별 비교
| 모드 | 명령어 | 특징 | 적합한 상황 |
|---|---|---|---|
| 대화형 | claude | 지속적인 대화, 컨텍스트 유지 | 복잡한 개발 작업, 탐색적 분석 |
| 원샷 | claude -p | 한 번 실행 후 종료 | 스크립트, 자동화, 빠른 작업 |
| 파이프 | | claude -p | 외부 입력 처리 | 로그 분석, 파일 처리, 데이터 변환 |
모드 선택 가이드
대화형 모드 추천
- • 새로운 프로젝트 탐색
- • 복잡한 리팩토링
- • 학습 및 코드 이해
- • 여러 단계 작업
원샷 모드 추천
- • 빠른 질문 답변
- • 스크립트 자동화
- • CI/CD 통합
- • 간단한 수정
파이프 모드 추천
- • 로그 파일 분석
- • 대용량 데이터 처리
- • 명령어 출력 분석
- • 데이터 변환