기본 개념 설명
클로드 코드를 이해하기 위한 기본 개념들을 설명합니다.
클로드 계정 하나, 두 가지 창구
클로드 계정 하나로 두 가지 방식으로 접근할 수 있어요. claude.ai는 채팅창에서 쓰는 웹 인터페이스고, 클로드 코드는 터미널에서 직접 클로드를 불러 쓰는 방식이에요. 같은 계정, 같은 모델이지만 사용하는 '창구'가 다른 거예요. 웹은 대화 중심, 코드는 파일과 코드 작업 중심이라고 생각하면 돼요.
IDE, Terminal, Claude Extension
IDE는 코드를 쓰는 편집기예요. VS Code가 대표적이고, 우리가 주로 쓰는 환경이에요. Terminal(터미널)은 컴퓨터에 명령을 직접 입력하는 창이고요. 맥에서는 '터미널', 윈도우에서는 'PowerShell' 또는 'Windows Terminal'이 그 역할을 해요. Claude Extension은 VS Code 안에 클로드를 붙여놓은 플러그인이에요. IDE 안에서 바로 클로드한테 물어보고 코드를 수정할 수 있어요.
클로드 코드 설치하기
내 컴퓨터 OS를 골라서 따라오세요. 맥과 윈도우 모두 가능합니다.
맥북에 설치하기 Mac
Spotlight(Cmd + Space) → 'terminal' 검색 → 엔터
아래 명령어를 복사해서 터미널에 붙여넣고 엔터. (별도 프로그램 설치 필요 없음)
curl -fsSL https://claude.ai/install.sh | bash
설치가 끝나면 터미널을 닫았다 다시 열고 claude 입력 → 브라우저가 뜨면 클로드 계정으로 로그인 → "허용" 클릭
code.visualstudio.com → Mac 버전 다운로드 → 압축 풀고 Applications 폴더로 드래그
VS Code → Extensions(Cmd+Shift+X) → "Claude Code" 검색 → Anthropic 제작 확인 → Install → VS Code 재시작
터미널에 git --version 입력. 버전이 나오면 OK. 처음이라면 "명령어 도구를 설치하시겠습니까?" 팝업이 뜨는데 설치(Install)를 누르면 끝.
윈도우에 설치하기 Windows
키보드 Win + X → 메뉴에서 Windows PowerShell 또는 터미널(Terminal) 선택. (※ 'PowerShell (x86)' 말고 일반 버전)
아래 명령어를 복사해서 PowerShell에 붙여넣고(Ctrl+V) 엔터. "successfully installed!"가 뜰 때까지 기다리세요.
irm https://claude.ai/install.ps1 | iex
WinGet을 쓰거나, PowerShell이 어려우면 (대안 설치법)
WinGet (Windows 11 / 앱 설치 가능 환경):
winget install Anthropic.ClaudeCode
명령 프롬프트(CMD)를 쓴다면:
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
설치 후 PowerShell을 닫았다 다시 열고 claude 입력 → 브라우저가 뜨면 로그인. (브라우저가 안 뜨면 c를 눌러 주소 복사 후 직접 붙여넣기)
git-scm.com/downloads/win → 설치 파일 실행 → 전부 'Next'만 누르면 끝. git --version으로 확인.
code.visualstudio.com → Windows 버전 다운로드 → 설치 파일 실행 → 'Next'로 진행
VS Code → Extensions(Ctrl+Shift+X) → "Claude Code" 검색 → Anthropic 제작 확인 → Install → VS Code 재시작
VS Code에서 시작하기 Mac Windows
바탕화면에 workspace 폴더 → 그 안에 프로젝트 폴더 생성
File → Open Folder → 만든 폴더 선택
오른쪽 위 Claude 아이콘(✱) 클릭 → Sign in → 바로 대화를 시작하세요!
설치 트러블슈팅
| 증상 | OS | 해결 |
|---|---|---|
| Extension이 안 보임 | 공통 | VS Code 재시작 |
claude 명령어가 안 됨 | 공통 | 터미널/PowerShell 완전히 종료 후 다시 열기 |
| 브라우저 로그인 후 반응 없음 | 공통 | 브라우저에서 "허용" 클릭 확인 |
'irm'은 인식되지 않습니다 | Win | CMD가 아니라 PowerShell에서 실행 (시작메뉴 "PowerShell" 검색) |
설치 후에도 claude 못 찾음 | Win | PowerShell 새로 열기. 그래도 안 되면 FAQ의 PATH 설정 참고 |
| 스크립트 실행이 차단됨 | Win | Set-ExecutionPolicy RemoteSigned -Scope CurrentUser 실행 후 재시도 |
git 명령어가 안 됨 | 공통 | VS Code/터미널 완전히 종료 후 재시작 또는 재설치 |
기본 사용법
슬래시 명령어, 단축키를 익혀봅시다.
핵심 슬래시 명령어
| 명령어 | 역할 | 언제? |
|---|---|---|
/init | 폴더 분석 → CLAUDE.md 자동 생성 | 새 프로젝트 시작 |
/plan | Plan Mode 진입 (읽기 전용) | 큰 작업 전 검토 |
/clear | 대화 기록 초기화 | 작업 완료 후 |
/compact | 긴 대화 압축 → 토큰 절약 | 대화가 길어질 때 |
/cost | 현재 세션 비용 확인 | 비용 모니터링 |
/resume | 이전 세션 불러오기 | /clear 후 돌아가고 싶을 때 |
/memory | 자동 기억 확인/수정 | Claude가 뭘 기억하는지 |
/help | 전체 명령어 보기 | 언제든지 |
키보드 단축키
| 단축키 | 기능 |
|---|---|
Shift+Tab | 모드 전환 |
Shift+Enter | 줄바꿈 (Enter는 전송) |
Ctrl+C | 작업 중단 |
Esc | 현재 입력 취소 |
Esc × 2 | 직전 작업 되돌리기 (Claude 작업만) |
컨텍스트 관리 원칙
AI 모델은 대화를 '기억'하지 않아요. 매번 전체 내용을 다시 읽어요. 대화가 길어지면 느려지고 비용이 올라갑니다.
질문-답변 5쌍 이내
한 세션에서 작업을 마무리하세요
작업 완료 후 /clear
컨텍스트를 깨끗이 초기화하세요
50% 남으면 /compact
흐름을 이어가면서 토큰을 아끼세요
Git 안전망
코드의 타임머신. 바이브코딩의 필수 안전장치.
왜 Git이 필요한가?
"원고_최종.docx, 원고_최최종.docx, 원고_진짜최종.docx..." — Git은 이 문제를 해결해요. 게임의 세이브 포인트처럼, 큰 작업 전에 현재 상태를 저장해두면 언제든 돌아갈 수 있어요.
Git vs GitHub
Git
내 컴퓨터에서 변경 내역을 기록하는 로컬 도구
GitHub
코드를 온라인에 저장하고 공유하는 클라우드 저장소 (코드용 구글 드라이브)
핵심 명령어
| 명령어 | 설명 | 비유 |
|---|---|---|
git add [파일] | 저장할 파일 선택 | 무대 위로 올리기 |
git commit -m "메시지" | 선택한 파일 저장 + 메모 | 세이브 포인트 |
git push | 내 컴퓨터 → GitHub 업로드 | 클라우드 백업 |
git pull | GitHub → 내 컴퓨터 다운로드 | 최신 버전 받기 |
git clone [URL] | GitHub 프로젝트 다운로드 | 복사해오기 |
commit + push + pull 3개만 잘 써도 충분해요. 사실 명령어를 외울 필요도 없어요 — 클로드한테 말로 시키면 됩니다.
Claude Code와 함께 쓰기
자연어로 말하면 Git 명령어를 알아서 실행해줘요.
# 이렇게 말하면 "현재 상태 저장해줘" → git add + commit + push "오늘 작업 내용 커밋해줘" → commit 메시지도 Claude가 작성 "아까 작업 전 상태로 돌아가줘" → git reset 또는 checkout
실습 — GitHub 연결
github.com → New repository → 이름 입력 → Create
"내 GitHub 레포에 현재 폴더를 연결하고 첫 번째 커밋을 push해줘"
파일이 올라가 있으면 안전망 완성!
CLAUDE.md 설정
새 직원에게 주는 업무 매뉴얼. Claude에게 주는 행동 지침.
CLAUDE.md란?
claude를 실행할 때마다 Claude는 자동으로 CLAUDE.md를 읽어요. 매번 같은 설명을 반복할 필요가 없어져요.
편집부 업무 매뉴얼
"저자한테 항상 존댓말" / "교정부호는 이 표기로 통일"
CLAUDE.md
"항상 한국어로 답변" / "원본 원고 파일은 수정 금지"
실제 사용 중인 CLAUDE.md 예시
# 나에 대해 - 이름/소속: ○○출판사 ○○팀 편집자 - 담당: 문학·인문 단행본 편집 # 글쓰기 & 문서화 - 보도자료/카피 작성 시 콜론(:) 사용 금지 — 한국어 문장에서 부자연스럽고 AI 티가 남 - 자연스러운 줄글 선호. 과도한 불렛 포인트 지양 - 마크다운 기반 기록. 파일명 규칙: YYYY-MM-DD-제목.md # 대화 스타일 - 한국어로 대화. 간결하게, 필요한 만큼만 - 단순 동의보다 적절한 질문으로 사고 확장 유도 - 놓친 부분이나 사실 오류가 있으면 짚어주기 - 인용·통계·서지정보는 반드시 출처 확인 후 제시
/init으로 자동 생성하기
터미널에서 /init을 실행하면 Claude가 프로젝트를 분석해서 CLAUDE.md를 자동으로 만들어줘요.
작성 원칙
구체적으로
"잘 만들어줘" (X)
"본문은 ~습니다 체, 주석은 한국어로" (O)
200줄 이내
너무 길면 컨텍스트 낭비. 핵심만 간결하게.
금지사항 명시
"~하지 말 것" 형태가 효과적이에요.
바이브코딩 5단계 사이클
기획 → 플랜 → 액션 → 확인 → 반복. 이 리듬으로 만들어보세요.
Claude에게 기획 문서 초안 요청 → 직접 읽고 디테일 수정. 짧은 프로젝트라도 처음 흐름 잡는 데 시간을 충분히 투자하세요.
기획 문서 바탕으로 단계별 작업 계획 생성. Plan Mode에서 방향을 확인하고 수정 요청.
코드 작성 → "현재 상태 저장해줘"(commit) → /clear → 다음 작업. 큰 작업 전에 항상 세이브 포인트를 먼저.
Claude에게 결과물 직접 확인 시키기. "만든 페이지를 열어서 잘 작동하는지 확인해줘. 에러가 있으면 알려줘."
문제 발견 → 작은 플랜 → 수정. 같은 문제를 3번 이상 고쳐도 안 되면, 과감히 세이브 포인트로 돌아가서 다시 시작.
나만의 도구 상상하기
워크시트에 적으면서 오늘 만들 것을 구체화해보세요. 여기 적은 내용이 곧 클로드한테 처음 할 말이 됩니다.
1. 나는 어떤 일을 하는 사람인가요?
직업, 역할, 요즘 하는 일, 좋아하는 것
2. 필요한 것은 무엇인가요?
반복 업무, 찾기 어려운 정보, 있으면 좋겠다 싶은 도구
3. 뭘 만들거나 맡기고 싶나요?
외래어 표기 검사기, 보도자료 초안 생성기, 나를 보여주는 사이트 등
4. 오늘 시도해볼 한 가지
가장 작게 시작할 수 있는 걸 골라보세요
"나는 ○○ 일을 하는 사람인데, ○○를 만들고 싶어. 계획을 먼저 세워봐."
핵심 능력 4가지
| 능력 | 의미 |
|---|---|
| 대상 정의 | 어떤 반복 업무를 맡길지 구체적으로 파악 |
| 프로세스 설명 | 입력 → 처리 → 출력 흐름을 AI에게 명확히 설명 |
| 반복 개선 | 한 번에 완벽하지 않아도 됨. 5~10번 수정이 정상 |
| 결과 검증 | AI 결과물을 내 업무 지식으로 맞는지 확인 |
연동과 주의 사항
토큰 관리부터 외부 서비스 연동까지.
토큰 사용량
코딩 작업은 토큰을 많이 소모해요. 리밋이 걸리면 잠시 쉬었다가 하면 됩니다. 길게 한 번에 하기보다, 작은 작업으로 쪼개는 게 효율적이에요.
세션 관리
하나의 세션에서 너무 긴 작업을 할수록 토큰이 빨리 닳아요. 긴 대화를 하면 점점 앞의 말을 까먹는 거랑 같아요. /compact로 대화를 압축하거나, 새 터미널 창을 열어 새로 시작하면 돼요.
권한 부여
Claude Code는 파일을 읽거나 수정하기 전에 항상 먼저 물어봐요. 접근을 열어두는 건 문을 열 수 있는 권한을 주는 거고, 문을 열기 전에 항상 노크를 해요. 허락하지 않으면 절대 멋대로 열고 들어오지 않아요.
'연동'이란?
두 서비스가 서로 데이터를 주고받을 수 있게 이어주는 거예요. 연동 방식에는 크게 API와 MCP가 있어요.
API 연동
두 프로그램이 대화할 때 쓰는 약속된 창구. "이 주소로 요청을 보내면 이 형식으로 데이터를 돌려줄게" 라는 규칙.
MCP 연동
AI가 외부 서비스를 직접 도구처럼 쓸 수 있게 해주는 연결 규약. "노션에 정리해줘" 하면 직접 노션 페이지를 만들어줘요.
연결 가능한 서비스들
| 서비스 | 연동 방식 | 할 수 있는 것 |
|---|---|---|
| Notion | MCP | 페이지 읽기/생성/업데이트 |
| Google Sheets | MCP | 스프레드시트 읽기/쓰기 |
| Slack | MCP | 메시지 자동 전송 |
| GitHub | CLI (gh) | PR 생성, 코드 리뷰 |
| Google Drive | CLI (gws) | 파일 조회, 권한 관리 |
| Vercel / GitHub Pages | 배포 | 만든 웹사이트 무료 배포 |
자주 묻는 질문
궁금한 점들을 모았어요.
윈도우인데 Node.js나 WSL을 꼭 깔아야 하나요?
아니요. 위의 PowerShell 설치(irm https://claude.ai/install.ps1 | iex)는 클로드 코드 본체를 바로 설치하기 때문에 Node.js나 WSL이 필요 없어요. Git for Windows는 필수는 아니지만 깔아두면 더 매끄럽게 작동해요.
(윈도우) 설치했는데 claude 명령어를 못 찾아요
대부분 PowerShell을 새로 열면 해결돼요 (설치 후 PATH가 반영되려면 창을 다시 열어야 함). 그래도 안 되면 PowerShell에 아래를 붙여넣고 PowerShell을 재시작하세요.
$p = [Environment]::GetEnvironmentVariable('PATH','User'); [Environment]::SetEnvironmentVariable('PATH', "$p;$env:USERPROFILE\.local\bin", 'User')
(윈도우) "스크립트 실행이 차단되었습니다" 오류가 나요
보안 설정(실행 정책) 때문이에요. PowerShell에 Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser를 한 번 실행한 뒤 다시 설치해보세요.
CLI가 뭔가요?
우리가 보통 쓰는 인터페이스는 아이콘과 버튼이 있는 GUI(그래픽 유저 인터페이스)예요. CLI(커맨드 라인 인터페이스)는 터미널 창에서 명령어를 입력하는 방식이에요.
CLI가 어려운 이유는 정해진 명령어를 입력하지 않으면 튕겨나기 때문이에요. 하지만 클로드 코드는 LLM을 터미널에서 쓸 수 있게 만든 것이라, 자연어로 말해도 동작해요. 심지어 오타를 내도요!
Claude vs Claude Code 차이가 뭔가요?
Claude는 Anthropic의 LLM 모델 (AI 두뇌)이에요. Claude Code는 Claude 모델 + 실행 가능한 도구들이에요.
Claude는 채팅 상담사처럼 대화만 하지만, Claude Code는 직접 방문한 전문가처럼 파일도 만들고 명령도 실행해요.
터미널/PowerShell이 뭔가요?
버튼 없이 명령어를 직접 입력하는 창이에요. GUI(그래픽 인터페이스)가 터치스크린 키오스크라면, 터미널은 직원에게 직접 말로 주문하는 거예요. 맥은 '터미널', 윈도우는 'PowerShell'이 같은 역할을 해요.
Claude Code 사용 시 명령어를 외울 필요 없어요. 한국어로 원하는 것을 설명하면 됩니다.