1. Claude Code 시작하기 - 5분 설치법
Claude Code가 뭔가요?
한 줄 요약: 터미널에서 AI와 대화하면서 일을 시키는 도구
웹 ChatGPT/Claude와 뭐가 다른가요?
| 웹 버전 | Claude Code |
|---|---|
| 브라우저에서 대화만 | 내 컴퓨터 파일을 직접 수정 |
| 코드 복사-붙여넣기 | 코드를 바로 실행 |
| 수동으로 파일 저장 | 자동으로 파일 생성/수정 |
쉽게 말해, AI가 내 컴퓨터에서 직접 일하는 것입니다.
질문에 답하는 컨설턴트 vs 직접 실행하는 파트너의 차이입니다.
왜 비개발자에게 필요한가
반복 작업의 종말
이전: Downloads 폴더 567개 파일 → 하나씩 확인하며 정리 → 2시간 소요
이후: "Downloads 폴더를 날짜별로 정리해줘" → 3분 완료
파일 시스템이 기억이 되는 순간
이전: "저번 달에 만든 그 프로젝트 폴더 어디 있더라..."
이후: "최근 30일 동안 수정한 마크다운 파일 전부 찾아줘"
실제 사례 (코딩 0%)
- 파일 정리: "Downloads 폴더를 파일 타입별로 자동 분류해줘"
- 텍스트 분석: "이 폴더의 모든 마크다운 파일에서 TODO 항목 추출해줘"
- 보고서 자동화: "Git 커밋 히스토리 분석해서 주간 활동 리포트 만들어줘"
내 컴퓨터가 뭔지 확인하기
아래에서 자기 컴퓨터에 해당하는 것만 읽으면 됩니다.
- Mac 쓰시나요? → Mac 설치로 이동
- Windows 쓰시나요? → Windows 설치로 이동
Mac 설치
준비물
없음. 바로 시작하면 됩니다.
따라하기
1. 터미널 열기
키보드에서 Cmd + Space 누르고 → "터미널" 입력 → Enter
검은 창이 뜨면 성공!
2. 아래 문장을 복사해서 붙여넣기
curl -fsSL https://claude.ai/install.sh | bash
붙여넣고 Enter 누르면 설치가 시작됩니다.
(1-2분 걸림)
3. 잘 됐는지 확인
claude doctor
"All checks passed" 라고 나오면 끝!
Windows 설치
준비물
Git for Windows라는 프로그램이 필요합니다.
잠깐, 이게 왜 필요하죠?
Claude Code는 내부적으로 이런 명령어를 씁니다:
ls (파일 목록 보기)
cat (파일 내용 보기)
grep (텍스트 찾기)
이건 Mac/Linux 명령어인데, Windows는 원래 못 알아듣습니다.
Git for Windows를 설치하면 "Git Bash"라는 게 같이 깔리는데,
이게 통역사 역할을 해서 Windows도 이 명령어를 이해하게 됩니다.
따라하기
1. Git for Windows 설치
이 링크로 가서 다운로드:
https://git-scm.com/downloads/win
"64-bit Git for Windows Setup" 클릭 → 다운로드된 파일 실행
설치할 때 그냥 "Next" 계속 누르면 됩니다. (기본값이 좋음)
2. PowerShell 열기
키보드에서 Win + X 누르고 → "Windows PowerShell" 또는 "터미널" 클릭
파란 창이 뜨면 성공!
3. 아래 문장을 복사해서 붙여넣기
irm https://claude.ai/install.ps1 | iex
붙여넣고 Enter 누르면 설치가 시작됩니다.
4. PowerShell 껐다가 다시 열기
설치가 끝나면 PowerShell을 완전히 닫고 새로 여세요.
(환경변수가 업데이트되려면 필요함)
5. 잘 됐는지 확인
claude doctor
"All checks passed" 라고 나오면 끝!
만약 "claude를 찾을 수 없습니다" 에러가 나면?
PATH 설정이 안 된 겁니다. 아래 명령어로 직접 추가하세요.
PowerShell에서 (한 번만 실행):
[Environment]::SetEnvironmentVariable("PATH", "$env:PATH;$env:USERPROFILE\.local\bin", "User")
그 다음 PowerShell 껐다가 다시 열기.
이제 claude 입력하면 됩니다.
VS Code 설치 (권장)
Claude Code가 만든 코드를 눈으로 보고 수정할 수 있는 편집기입니다.
터미널 화면만 보는 것보다 훨씬 편해요.
(코드에 색깔도 입혀주고, 에러도 알려줌)
설치 방법
1. 다운로드
https://code.visualstudio.com/
2. 설치
다운로드된 파일 실행 → Next 계속 → 완료
Mac도 Windows도 똑같습니다.
설치 후 추천 확장 (나중에 해도 됨)
VS Code 실행 → 왼쪽 블록 아이콘 클릭 → 검색:
- Python - Python 코드 작성할 때 편함
- Prettier - 코드 자동 정렬
나중에 필요할 때 Claude Code가 "이 확장 설치하세요" 안내해주기도 합니다.
설치 체크리스트
Mac 사용자
- [ ] Claude Code 설치함
- [ ] VS Code 설치함
Windows 사용자
- [ ] Git for Windows 설치함 ← Claude Code보다 먼저!
- [ ] Claude Code 설치함
- [ ] PowerShell 껐다가 다시 열었음 ← 중요!
- [ ]
claude doctor확인함 - [ ] VS Code 설치함
처음 실행해보기
1. 작업할 폴더로 이동
터미널/PowerShell에서:
cd ~/Documents
(Documents 폴더로 이동)
2. Claude Code 실행
claude
3. 로그인
처음 실행하면 브라우저가 뜹니다.
Claude 계정으로 로그인하세요. (Pro/Max 구독 필요)
4. 말 걸어보기
> 안녕! 여기 어떤 파일들이 있어?
대답이 오면 성공!
첫 번째 대화 시작하기
예제 1: 파일 찾기
claude "최근 7일 동안 수정한 마크다운 파일을 전부 찾아서 리스트 만들어줘"
Claude는:
1. 파일 시스템 검색
2. 수정 날짜 확인
3. 마크다운 파일 필터링
4. 정리된 리스트 생성
예제 2: 폴더 정리
claude "Downloads 폴더를 파일 타입별로 분류해서 정리해줘"
Claude는:
1. 파일 타입 분석 (PDF, 이미지, 문서 등)
2. 정리 계획 제시
3. 승인 요청
4. 폴더 생성 및 파일 이동
예제 3: 텍스트 분석
claude "이 폴더의 모든 텍스트 파일에서 '할일' 또는 'TODO'가 포함된 줄을 찾아서 리스트로 만들어줘"
Claude는:
1. 폴더의 모든 텍스트 파일 검색
2. 키워드가 포함된 줄 추출
3. 파일별로 분류
4. 할일 목록 리스트 생성
흔한 오해와 진실
"개발자만 쓰는 도구 아닌가요?"
진실: 파일과 데이터를 다루는 모든 사람을 위한 도구입니다.
- 기획자: 보고서 자동화
- 마케터: 데이터 분석
- 운영자: 파일 정리
- 창업자: 비즈니스 문서 관리
"뭔가 망가뜨릴까 봐 무서워요"
진실: Claude Code는 항상 허락을 구합니다.
- 변경 전 설명
- 실행 전 승인 요청
- 항상 사용자가 통제
- Git으로 복구 가능
"너무 기술적일 것 같아요"
진실: 평범한 한국어로 대화합니다.
- "이거 정리해줘" → 이해하고 실행
- "분석해서 보고서 만들어줘" → 바로 처리
- 어떻게 보다 무엇을 설명하면 됩니다
"비용이 부담돼요"
진실: 시간 절약으로 비용 충당
- 월 $20 = 하루 커피 한 잔 값
- 주당 2-3시간 절약
- 반복 작업 자동화
- 생산성 향상 효과
잘 안 될 때
"claude를 찾을 수 없습니다" (Windows)
1단계: PowerShell을 껐다가 다시 여세요.
2단계: 그래도 안 되면 PATH 직접 추가:
[Environment]::SetEnvironmentVariable("PATH", "$env:PATH;$env:USERPROFILE\.local\bin", "User")
3단계: PowerShell 다시 껐다가 열기
4단계: 이제 claude 입력
"claude를 찾을 수 없습니다" (Mac)
터미널을 껐다가 다시 여세요.
그래도 안 되면:
export PATH="$HOME/.local/bin:$PATH"
Git for Windows 설치했는데 claude 안 됨
- Git for Windows 설치 완료 확인
- PowerShell 새로 열기
- 다시 Claude Code 설치 명령어 실행
나중에 업데이트하려면
Claude Code는 자동으로 업데이트됩니다.
수동으로 하고 싶으면:
claude update
정리
| 순서 | Mac | Windows |
|---|---|---|
| 1 | - | Git for Windows 설치 |
| 2 | Claude Code 설치 | Claude Code 설치 |
| 3 | VS Code 설치 | VS Code 설치 |
핵심: Windows만 Git for Windows를 먼저 설치하면 됩니다.
나머지는 똑같아요.
실습 과제
Level 1: 설치 확인
터미널에서 claude doctor 실행하고 결과 확인
Level 2: 첫 대화
간단한 질문으로 시작:
claude "현재 폴더에 뭐가 있는지 알려줘"
Level 3: 실전 작업
실제 필요한 작업 하나 시켜보기:
claude "Downloads 폴더를 정리해줘"
질문과 답변
Q: Mac이 아니면 안 되나요?
A: Windows, Linux 모두 가능합니다. WSL(Windows Subsystem for Linux)도 완벽 지원합니다.
Q: 코딩을 전혀 몰라도 되나요?
A: 네. 평범한 한국어로 대화하면 됩니다.
Q: 무료로 쓸 수 있나요?
A: Claude.ai 구독($20/월) 또는 API 크레딧이 필요합니다.
Q: 설치가 안 돼요
A: 위의 "잘 안 될 때" 섹션을 확인하세요. 그래도 안 되면 공식 가이드: docs.anthropic.com/claude-code
마무리
Claude Code는 코딩을 배우는 도구가 아닙니다.
컴퓨터에게 일을 시키는 법을 배우는 도구입니다.
다음 글에서는 파일 시스템이 어떻게 AI의 장기 기억이 되는지 이야기하겠습니다.