2026. 2. 17. 16:14ㆍAI 기술/Claude
1편에서 Claude의 전체 기능을 소개했다면, 이번 편부터는 직접 써보는 시간입니다.
오늘 다루는 건 Claude Code — 터미널에서 AI가 직접 파일을 만들고, 코드를 짜고, 실행하고, 에러까지 고치는 에이전트 AI입니다. "코드를 보여주는 AI"가 아니라 "코드를 직접 짜는 AI"라고 했던 것, 기억하시죠? 이 글에서 그게 어떤 경험인지 직접 보여드리겠습니다.
코딩을 전혀 모르는 분도 따라올 수 있게 구성했습니다. 설치에 5분, 첫 프로젝트 실행에 10분이면 충분합니다.
Claude AI 완전 정복 시리즈 2/9
목차
1. 채팅 AI vs 에이전트 AI — 뭐가 다른가
2. 설치 — 진짜 3단계로 끝납니다
3. 첫 프로젝트 — "할 일 앱 만들어줘"
4. CLAUDE.md — Claude에게 기억을 심어주기
5. 핵심 슬래시 커맨드 12개
6. 3가지 모드 — Plan / Edit / Auto
7. 실전 팁 — 현직자의 사용 습관
8. 요금제 — Claude Code는 얼마?
9. 비개발자를 위한 "바이브 코딩" 가이드
10. FAQ
1. 채팅 AI vs 에이전트 AI — 뭐가 다른가
Claude Code를 설명하기 전에, 먼저 "에이전트 AI"가 뭔지 이해하는 게 중요합니다. 기존에 우리가 쓰던 AI와 근본적으로 다르기 때문입니다.
채팅 AI: 코드를 "보여주는" AI
ChatGPT나 claude.ai에서 "로그인 기능 만들어줘"라고 하면, AI가 코드를 텍스트로 보여줍니다. 우리는 그걸 복사해서 에디터에 붙여넣고, 실행해보고, 에러가 나면 에러 메시지를 다시 AI한테 복붙하고... 이 과정을 반복합니다. AI는 우리 컴퓨터의 파일을 볼 수 없고, 코드를 실행할 수도 없습니다. 중간에서 번역가 역할을 하는 건 결국 나입니다.
에이전트 AI: 코드를 "직접 짜는" AI
Claude Code는 다릅니다. 내 컴퓨터의 터미널에서 직접 실행되기 때문에, 파일 시스템에 접근할 수 있습니다. "로그인 기능 만들어줘"라고 하면 이런 일이 벌어집니다.
먼저 프로젝트 구조를 읽고 어떤 파일들이 있는지 파악합니다. 그 다음 필요한 파일을 직접 생성하고 코드를 작성합니다. 작성이 끝나면 직접 실행해서 에러가 있는지 확인하고, 에러가 발생하면 로그를 읽고 스스로 수정한 뒤 다시 실행합니다. 마지막으로 Git에 커밋까지 해줍니다.
이 전체 과정에서 내가 하는 건 "로그인 기능 만들어줘"라고 말한 것 + 중간중간 승인 버튼 누른 것 뿐입니다. 복붙도 없고, 에디터 전환도 없습니다. 이게 "채팅 AI"와 "에이전트 AI"의 차이입니다.
한 줄 요약: 채팅 AI는 "이렇게 하면 될 것 같아요"라고 조언하는 AI. 에이전트 AI는 "제가 직접 해드릴게요"라고 행동하는 AI.
2. 설치 — 진짜 3단계로 끝납니다
과거에는 Node.js를 설치하고 npm으로 글로벌 패키지를 깔아야 했습니다. 2026년 현재, Anthropic이 네이티브 설치를 공식 권장 방법으로 바꿨기 때문에 Node.js 없이 명령어 한 줄이면 끝입니다.
STEP 1. 설치 (1분)
Windows — PowerShell(관리자 권한)로 설치
시작 메뉴에서 "터미널" 또는 "PowerShell"을 검색하고, 마우스 오른쪽 클릭 -> "관리자 권한으로 실행"을 선택합니다. 그리고 아래 명령어를 복사해서 붙여넣으세요.
설치가 완료되면 터미널을 껐다가 다시 열고 아래 명령어로 확인합니다.
claude-code v2.x.x ← 이렇게 나오면 성공!
Windows 설치 전 체크리스트
1) Git Bash 필수: Claude Code는 Git Bash가 있어야 동작합니다. 아직 없다면 git-scm.com에서 먼저 설치하세요. 설치 시 옵션은 전부 기본값(Next)으로 넘기면 됩니다.
2) "claude 명령을 찾을 수 없습니다" 에러: PATH가 갱신되지 않은 겁니다. 터미널을 완전히 껐다가 다시 여세요. 그래도 안 되면 시스템 속성 -> 환경 변수 -> 사용자 PATH에 C:\Users\사용자명\.local\bin을 추가하세요.
3) WSL도 OK: WSL(Windows Subsystem for Linux)을 쓴다면 아래 macOS/Linux 명령어로 설치할 수 있습니다. WSL 2 환경에서 더 안정적으로 동작합니다.
macOS / Linux — 터미널에서 한 줄
Mac은 "터미널" 앱을, Linux는 기본 터미널을 열고 아래 명령어를 실행합니다.
Mac에서는 Homebrew로도 설치할 수 있습니다: brew install claude-code. 다만 네이티브 설치가 자동 업데이트를 지원하므로 권장됩니다.
claude-code v2.x.x ← 버전이 나오면 성공
STEP 2. 인증 (2분)
터미널에서 claude를 실행하면 인증 화면이 나옵니다. 세 가지 방법 중 하나로 로그인합니다.
| 인증 방법 | 설명 | 추천 대상 |
|---|---|---|
| Claude Pro/Max 구독 | claude.ai 계정으로 OAuth 로그인. 구독에 Claude Code가 포함되어 있음 | 개인 사용자 (추천) |
| API 키 (Console) | console.anthropic.com에서 API 키 발급. 사용량만큼 과금 | 자동화/대량 사용 |
| 클라우드 제공자 | AWS Bedrock, Google Vertex AI, Microsoft Foundry 연결 | 기업/팀 |
대부분의 개인 사용자는 첫 번째 방법(Claude 구독 로그인)이 가장 간단합니다. 한번 로그인하면 이후 자동으로 인증됩니다.
STEP 3. 프로젝트에서 시작 (1분)
원하는 프로젝트 폴더로 이동해서 claude를 실행하면 끝입니다. Windows라면 Windows Terminal이나 PowerShell에서, Mac/Linux라면 기본 터미널에서 실행합니다.
PS> cd C:\Users\사용자명\my-project
PS> claude
// macOS / Linux
$ cd ~/my-project
$ claude
Welcome to Claude Code v2.x.x
> 무엇을 도와드릴까요?
새 프로젝트라면 빈 폴더에서 시작해도 됩니다. Claude가 폴더 구조부터 만들어줍니다.
3. 첫 프로젝트 — "할 일 앱 만들어줘"
설치가 끝났으니 바로 만들어봅시다. 가장 클래식한 예제인 "할 일(Todo) 앱"을 Claude Code에게 시켜보겠습니다.
시작: 자연어로 요청
PS> mkdir todo-app; cd todo-app
PS> claude
// macOS/Linux에서는
$ mkdir todo-app && cd todo-app
$ claude
> 할 일 관리 웹앱을 만들어줘. React + TypeScript로,
할 일 추가/삭제/완료체크가 되면 좋겠어.
디자인은 깔끔하게 해줘.
Claude가 하는 일 (실시간으로 볼 수 있음)
이 한 마디를 하면 Claude Code가 움직이기 시작합니다. 터미널에서 실시간으로 뭘 하는지 볼 수 있습니다.
먼저 요구사항을 분석하고 기술 스택을 결정합니다. "React + TypeScript + Vite로 구성하겠습니다. Tailwind CSS로 스타일링하겠습니다." 같은 계획을 보여주죠.
그 다음 npm create vite@latest로 프로젝트를 초기화하고, 필요한 패키지를 설치합니다. 이 과정에서 승인을 요청하는데 — 파일을 쓰거나 명령어를 실행하기 전에 "이거 해도 되나요?"라고 물어봅니다. y를 누르면 진행합니다.
그리고 컴포넌트 파일을 하나씩 만들기 시작합니다. App.tsx, TodoList.tsx, TodoItem.tsx, AddTodo.tsx... 각 파일에 코드를 작성하고, CSS도 입힙니다.
코드를 다 짠 다음에는 npm run dev로 직접 실행합니다. 브라우저에서 확인할 수 있는 로컬 URL(보통 localhost:5173)을 알려주고, 에러가 있으면 알아서 잡습니다. TypeScript 타입 에러, 임포트 경로 오류 같은 걸 실시간으로 수정합니다.
전체 과정이 보통 2~5분이면 끝납니다. 내가 한 건 요청 한 마디 + 중간에 승인 몇 번 누른 것 뿐입니다.
실제 만들어진 결과물
깔끔한 UI에 할 일 추가, 삭제, 완료 체크가 되는 웹앱이 나옵니다. localStorage로 데이터가 저장되어서 새로고침해도 유지됩니다. "처음 써보는데 이게 되네?"라는 감탄이 여기서 나옵니다.
이어서 요청하기
앱이 만들어진 상태에서 추가 요청을 자연스럽게 할 수 있습니다.
> 할 일에 우선순위(높음/중간/낮음) 기능 넣어줘
> 지금까지 변경사항 git에 커밋해줘
Claude는 현재 프로젝트의 전체 코드를 이해하고 있으니까, 기존 코드를 수정하면서 새 기능을 추가합니다. 그리고 마지막에 git commit까지 알아서 해주죠. 커밋 메시지도 "feat: add dark mode toggle and priority levels"처럼 컨벤션에 맞게 작성합니다.
4. CLAUDE.md — Claude에게 기억을 심어주기
Claude Code를 진짜로 잘 쓰려면 반드시 알아야 하는 개념이 있습니다. CLAUDE.md 파일입니다.
CLAUDE.md가 뭔가
Claude Code는 매 세션마다 새로 시작합니다. 어제 내가 "이 프로젝트는 TypeScript를 쓰고 있고, 테스트는 Jest로 하고, 커밋 컨벤션은 이런 식이야"라고 말했어도 오늘은 모릅니다. CLAUDE.md는 이 문제를 해결합니다. 프로젝트의 맥락, 규칙, 선호도를 마크다운 파일로 적어두면, Claude Code가 매 세션 시작 시 자동으로 읽습니다.
사람으로 비유하면, 새 팀원이 왔을 때 건네주는 "프로젝트 온보딩 문서"입니다.
자동 생성: /init 명령
직접 쓸 수도 있지만, 가장 쉬운 방법은 /init 명령입니다.
Analyzing project structure...
Creating CLAUDE.md with project context...
CLAUDE.md created successfully.
Claude가 프로젝트의 package.json, tsconfig, 폴더 구조 등을 분석해서 알아서 CLAUDE.md를 작성합니다. 여기에 내 추가 규칙을 덧붙이면 됩니다.
실제 CLAUDE.md 예시
## 기술 스택
- React 18 + TypeScript + Vite
- Tailwind CSS
- localStorage (백엔드 없음)
## 빌드 & 실행
- dev: npm run dev
- build: npm run build
- test: npm run test
## 코딩 컨벤션
- 함수 컴포넌트만 사용 (클래스 컴포넌트 X)
- 한국어 주석 사용
- 커밋 메시지: Conventional Commits
## 주의사항
- .env 파일은 절대 수정하지 말 것
- production.config.* 파일 건드리지 말 것
계층 구조: 글로벌 vs 프로젝트
CLAUDE.md는 두 곳에 둘 수 있습니다.
| 위치 | 경로 | 적용 범위 |
|---|---|---|
| 글로벌 | ~/.claude/CLAUDE.md |
모든 프로젝트에 공통 적용. "항상 한국어로 답변해줘" 같은 전역 설정 |
| 프로젝트 | ./CLAUDE.md |
해당 프로젝트에만 적용. 기술 스택, 빌드 명령, 컨벤션 등 |
둘 다 있으면 글로벌 설정 위에 프로젝트 설정이 덮어씌워집니다(프로젝트 우선). 하위 폴더에 또 CLAUDE.md를 두면 더 구체적인 설정도 가능합니다.
팁: CLAUDE.md는 Claude Code의 품질을 결정하는 가장 중요한 요소입니다. 잘 쓴 CLAUDE.md 하나가 매번 "아, 이 프로젝트는 TypeScript 쓰고 있어" 같은 말을 반복하는 걸 없애줍니다. 투자 대비 효과가 가장 큰 작업이에요.
5. 핵심 슬래시 커맨드 12개
Claude Code에서 /로 시작하는 명령어를 "슬래시 커맨드"라고 합니다. 전부 외울 필요 없고, /help를 치면 목록이 나옵니다. 그 중에서 매일 쓰는 핵심 커맨드 12개를 정리했습니다.
시작/설정
| 커맨드 | 설명 |
|---|---|
/init |
CLAUDE.md 파일 자동 생성. 새 프로젝트에서 가장 먼저 실행할 것. |
/config |
설정 메뉴 열기. 모델 선택, 권한, 자동 업데이트 채널 등 설정 |
/model |
모델 전환. /model opus 또는 /model sonnet. 기본은 Sonnet, 50% 사용 후 자동 전환 |
작업 중
| 커맨드 | 설명 |
|---|---|
/review |
최근 변경 사항 코드 리뷰. 보안, 성능, 로직 오류 체크 |
/compact |
대화가 길어지면 필수. 대화 내역을 압축해서 컨텍스트 윈도우 확보 |
/clear |
대화 완전 초기화. 새 작업 시작할 때 사용. 토큰 낭비 방지 |
/add-dir |
다른 디렉토리를 컨텍스트에 추가. 모노레포에서 유용 |
유틸리티
| 커맨드 | 설명 |
|---|---|
/cost |
현재 세션의 토큰 사용량과 비용 확인. API 사용자에게 필수 |
/context |
컨텍스트 윈도우가 얼마나 차 있는지 시각적으로 보여줌 |
/doctor |
설치 상태 진단. 뭔가 안 될 때 가장 먼저 실행 |
/export |
현재 대화를 파일이나 클립보드로 내보내기 |
/resume |
이전 세션 이어하기. 세션 ID나 이름으로 복원 |
가장 많이 쓰게 될 3개: /init(처음 한번), /clear(새 작업마다), /compact(대화 길어지면). 이 세 개만 기억하면 됩니다.
6. 3가지 모드 — Plan / Edit / Auto
Claude Code에는 세 가지 작업 모드가 있습니다. Shift + Tab을 누르면 모드가 전환됩니다.
| 모드 | Claude가 할 수 있는 것 | 언제 쓰나 |
|---|---|---|
| Plan Mode | 읽기만 가능. 파일을 수정하거나 명령어를 실행할 수 없음. 계획만 세움. | 복잡한 작업 시작 전에 필수. "어떻게 할 건지 먼저 설명해봐" |
| Edit Mode | 파일 수정/생성 가능. 단, 매번 승인을 요청함. | 기본 모드. 대부분의 작업에 적합 |
| Auto Mode | 승인 없이 자동 진행. 파일 수정, 명령어 실행 모두 자동. | 신뢰할 수 있는 반복 작업. 주의해서 사용 |
Plan Mode를 꼭 써야 하는 이유
많은 사람이 Claude Code를 처음 쓸 때 바로 "이거 만들어줘"부터 시작합니다. 간단한 작업은 그래도 되는데, 조금이라도 복잡한 작업이면 반드시 Plan Mode부터 시작하세요.
Plan Mode에서 Claude는 파일을 건드리지 않고, 어떻게 접근할 건지 계획만 설명합니다. "이 기능을 만들려면 A 파일을 수정하고, B 파일을 새로 만들고, C 테스트를 추가하겠습니다"처럼요. 이 계획을 보고 "아니, B 파일 말고 D 파일에 만들어줘" 같은 수정을 할 수 있습니다.
계획 없이 바로 실행하면, Claude가 잘못된 방향으로 수십 개 파일을 수정한 뒤에야 "이게 아닌데..." 하게 되거든요. Plan Mode 2분이 나중에 롤백 30분을 아껴줍니다.
> 사용자 인증 기능을 추가하고 싶어.
어떻게 접근할 건지 계획을 세워줘.
Plan: 3단계로 접근하겠습니다.
1. src/auth/ 폴더 생성, AuthContext.tsx 작성
2. Login.tsx, Register.tsx 컴포넌트 추가
3. App.tsx의 라우팅에 인증 가드 적용
수정 파일: 3개 신규, 2개 수정 예상
7. 실전 팁 — 현직자의 사용 습관
Claude Code를 몇 달 써보면서 체득한 팁들을 공유합니다.
1. /clear를 자주 쓰세요
새 작업을 시작할 때마다 /clear로 대화를 초기화하세요. 이전 대화의 컨텍스트가 쌓이면 토큰이 낭비되고, 간혹 이전 맥락 때문에 엉뚱한 방향으로 가기도 합니다. 깨끗한 상태에서 시작하는 게 항상 낫습니다.
2. 큰 작업은 쪼개서 시키세요
"전체 앱을 만들어줘"보다 "먼저 로그인 화면만 만들어줘", 확인 후 "이제 대시보드를 만들어줘" 식으로 단계별로 진행하는 게 품질이 훨씬 좋습니다. 한 번에 너무 많은 걸 시키면 컨텍스트 윈도우가 부족해져서 뒤쪽 코드의 품질이 떨어집니다.
3. @파일명으로 컨텍스트를 명시하세요
"이 파일 수정해줘"보다 @src/components/Header.tsx 이 파일에서 로고 크기를 2배로 키워줘"가 훨씬 정확합니다. @를 쓰면 해당 파일을 컨텍스트에 직접 불러옵니다.
4. 권한 설정을 활용하세요
/config에서 특정 파일을 읽기/쓰기 금지로 설정할 수 있습니다. .env나 프로덕션 설정 파일 같은 건 아예 접근을 막아두는 게 안전합니다.
{
"permissions": {
"deny": [
"Read(./.env)",
"Read(./.env.*)",
"Write(./production.config.*)"
]
}
}
5. GitHub PR 리뷰 연동
/install-github-app을 실행하면 Claude가 GitHub Pull Request를 자동으로 리뷰해줍니다. AI 도구를 쓰면 코드량이 늘어나는데, 사람이 놓치는 로직 오류나 보안 문제를 Claude가 잡아주니 보완이 됩니다.
8. 요금제 — Claude Code는 얼마?
Claude Code를 쓰려면 최소 Pro 플랜($20/월)이 필요합니다. 무료 플랜에서는 사용할 수 없습니다.
| 플랜 | 가격 | Claude Code 사용 | 추천 대상 |
|---|---|---|---|
| 무료 | $0 | 불가 | claude.ai만 쓸 분 |
| Pro | $20/월 | 사용 가능 (Sonnet 기본, Opus 제한적) | 입문자, 일반 개발 |
| Max Expanded | $100/월 | 사실상 무제한, Opus 풀 사용 | 헤비 유저, Agent Teams |
| Max Ultimate | $200/월 | 20x 사용량, 최고 우선순위 | 전업 AI 개발자 |
Pro vs API, 뭐가 유리한가?
API는 사용량 비례 과금이라 적게 쓰면 Pro보다 쌀 수 있지만, Claude Code를 꾸준히 쓰면 금방 $20을 넘깁니다. 월 고정비인 Pro가 예측 가능하고 편합니다. API는 자동화 파이프라인이나 CI/CD 연동 같은 특수 용도에 적합합니다.
9. 비개발자를 위한 "바이브 코딩" 가이드
"나는 코딩을 모르는데, Claude Code를 쓸 수 있나요?"라는 질문을 많이 받습니다. 결론부터 말하면 — 네, 쓸 수 있습니다. 2025년 말부터 "바이브 코딩(vibe coding)"이라는 트렌드가 생겼는데, 코딩을 모르는 사람이 AI에게 자연어로 앱을 만들어달라고 하는 것을 말합니다.
비개발자가 Claude Code를 쓰는 현실적 가이드
1단계: 뭘 만들고 싶은지 구체적으로 설명하세요. "앱 만들어줘"보다 "매일 운동 기록을 입력하면 주간/월간 그래프를 보여주는 웹앱을 만들어줘. 운동 종류는 드롭다운으로 선택하고, 시간은 분 단위로 입력"이 100배 좋은 결과를 냅니다.
2단계: Plan Mode로 시작하세요. Claude가 어떤 기술로 어떻게 만들 건지 계획을 보여줍니다. 이해가 안 되는 부분이 있으면 "이게 뭔지 쉽게 설명해줘"라고 물어보세요.
3단계: 한 번에 하나씩만 시키세요. "전체 앱"을 시키지 말고, "먼저 입력 화면만 만들어줘"처럼 쪼개세요. 결과를 확인한 후 다음 단계로 넘어가세요.
4단계: 에러가 나면 Claude한테 맡기세요. 에러 메시지를 이해할 필요 없습니다. "에러가 났어. 고쳐줘"라고 하면 Claude가 알아서 해결합니다.
현실적인 기대치
비개발자도 간단한 웹앱(할 일 관리, 가계부, 데이터 시각화 등)은 충분히 만들 수 있습니다. 하지만 복잡한 백엔드, 인증 시스템, 결제 연동 같은 프로덕션 레벨 개발은 프로그래밍 지식이 있어야 Claude Code를 제대로 활용할 수 있습니다. "코딩을 대체한다"기보다 "코딩의 진입 장벽을 극적으로 낮춘다"가 정확한 표현입니다.
10. FAQ
Q. Claude Code와 GitHub Copilot은 뭐가 다른가요?
가장 큰 차이는 "에디터 안에서 코드를 제안하는 도구"와 "터미널에서 직접 실행하는 에이전트"의 차이입니다. Copilot은 내가 에디터에서 코드를 쓸 때 다음 줄을 제안해주는 자동완성에 가깝고, Claude Code는 내가 요청하면 파일 생성부터 테스트 실행까지 전체 과정을 자율적으로 처리합니다. 둘 다 좋은 도구이고, 같이 쓸 수도 있습니다.
Q. VS Code에서도 쓸 수 있나요?
네. VS Code의 통합 터미널(Ctrl + `)에서 claude를 실행하면 됩니다. VS Code 안에서 코드를 보면서 Claude Code를 동시에 쓸 수 있어서 편합니다. Windows 사용자가 WSL을 쓴다면 VS Code에서 "Remote - WSL" 확장을 설치하고, WSL 터미널에서 실행하는 게 가장 안정적입니다. Windows Terminal 앱을 설치하면 탭으로 여러 터미널을 관리할 수 있어서 Claude Code를 쓸 때 특히 편리합니다.
Q. Claude Code가 내 코드를 학습에 사용하나요?
기본적으로 Anthropic은 사용자 데이터를 모델 학습에 사용하지 않습니다. /privacy 명령으로 개인정보 설정을 확인할 수 있고, API를 통해 사용하면 Zero Data Retention 옵션도 있습니다.
Q. 인터넷이 안 되는 환경에서도 쓸 수 있나요?
아닙니다. Claude Code는 Anthropic의 서버와 통신해야 작동합니다. 오프라인에서는 사용할 수 없습니다.
Q. 지원하는 프로그래밍 언어는?
특정 언어에 제한되지 않습니다. Python, JavaScript/TypeScript, Rust, Go, Java, C#, Swift 등 거의 모든 주류 언어를 지원합니다. 다만 Claude가 가장 잘하는 건 Python과 TypeScript/JavaScript입니다. 이 두 언어에서 코드 품질이 가장 높습니다.
다음 편 예고 — 3편: Agent Teams 완전 정복
AI 한 명이 아니라 여러 명이 동시에 일한다면? 설정 한 줄로 멀티 에이전트 팀을 만들고, PR 리뷰, 풀스택 개발, 버그 디버깅을 병렬로 처리하는 방법을 상세히 다룹니다.
Claude AI 완전 정복 시리즈 전체 글
1편: 내가 반한 AI, Claude — 2026 최신 기능 총정리
2편: Claude Code 입문 — 터미널에서 AI가 코딩한다 (현재 글)
3편: Agent Teams 완전 정복 — AI 팀을 병렬로 일시키기 (예정)
4편: MCP 연동 — Claude에게 손과 발을 달아주기 (예정)
5편: Claude in Excel — AI가 수식을 진짜로 이해한다 (예정)
6편: Claude in PowerPoint — 내 템플릿으로 슬라이드 만들기 (예정)
7편: Claude.ai 200% 활용법 (예정)
8편: 실전 프로젝트 — 앱 하나 처음부터 끝까지 (예정)
9편: 요금제 비교 + AI 3강 비교 (예정)
Claude Code의 기능 및 요금은 Anthropic의 업데이트에 따라 변경될 수 있습니다. 설치 명령어와 기능은 2026년 2월 기준이며, 최신 정보는 code.claude.com을 확인하시기 바랍니다.