Claude Code가 뭔가요?
지금까지 ChatGPT나 웹 Claude를 써보셨다면, 이런 경험이 있을 겁니다. 채팅창에 질문을 입력하고, AI가 텍스트로 답변해주면, 그걸 복사해서 다른 프로그램에 붙여넣기. 파일을 만들어달라고 해도 “코드”를 텍스트로 보여줄 뿐, 실제 파일이 내 컴퓨터에 생기지는 않죠.
| 기존 AI (ChatGPT, 웹 Claude) | Claude Code | |
|---|---|---|
| 동작 환경 | 브라우저 채팅창 | 내 컴퓨터의 터미널 |
| 파일 접근 | 파일 생성/수정 불가 (텍스트만) | 파일을 직접 읽고, 수정하고, 새로 만듦 |
| 엑셀/CSV | 내용을 복사해서 붙여넣어야 함 | 파일을 열어서 직접 처리 |
| 코드 실행 | 코드를 보여줄 뿐, 실행은 사용자가 | 코드를 짜서 바로 실행 |
| 작업 결과 | 텍스트 답변 (복사 필요) | 실제 파일 저장 (엑셀, PDF 등) |
한마디로
Claude Code는 “말로 시키면 직접 해주는 AI 비서”입니다. 브라우저가 아니라 여러분의 컴퓨터 터미널에서 실행되기 때문에, PC에 있는 파일을 직접 다루고, 필요하면 코드를 짜서 실행하고, 결과를 파일로 저장까지 해줍니다.
예를 들어, “다운로드 폴더에 있는 엑셀 파일 3개를 합쳐서 요약표를 만들어줘”라고 하면 — 기존 AI는 “이렇게 하시면 됩니다”라고 방법을 알려줄 뿐이지만, Claude Code는 직접 파일을 열고, 데이터를 합치고, 새 엑셀 파일을 만들어서 저장합니다. 여러분은 결과 파일만 확인하면 됩니다.
내 노트북으로 되나요?
Claude Code는 여러분의 컴퓨터에서 실행되지만, 실제 AI 연산은 클라우드(Anthropic 서버)에서 이루어집니다. 그래서 고사양 PC가 필요하지 않습니다.
| 항목 | 최소 사양 | 권장 사양 | 비고 |
|---|---|---|---|
| CPU | 최근 5년 이내 | 최근 3년 이내 | 일반 사무용이면 충분 |
| RAM | 8GB | 16GB | 다른 프로그램과 동시에 쓸 때 16GB 권장 |
| 인터넷 | 안정적인 Wi-Fi | 유선 또는 5GHz Wi-Fi | AI 연산이 클라우드에서 실행되므로 중요 |
| GPU | 없어도 됨 | 없어도 됨 | 클라우드에서 실행되므로 불필요 |
| OS | Windows 10 이상 | Windows 11 | macOS도 동일하게 지원 |
MacBook Air도 됩니다
MacBook Air, 일반 회사 지급 노트북, 집에서 쓰는 5년 된 데스크톱—모두 가능합니다. 특별한 장비가 필요 없습니다. 인터넷 연결만 안정적이면 됩니다. AI의 무거운 연산은 모두 Anthropic의 서버에서 처리되기 때문입니다.
터미널이란?
Claude Code는 “터미널”이라는 환경에서 실행됩니다. 터미널이 생소하신 분들을 위해 간단히 설명하겠습니다.
| GUI (평소에 쓰는 방식) | 터미널 | |
|---|---|---|
| 조작 방식 | 마우스로 클릭, 드래그 | 글자(명령어)를 입력 |
| 파일 이동 | 파일을 마우스로 끌어다 놓기 | mv 파일명 폴더명 입력 |
| 폴더 이동 | 탐색기에서 폴더를 더블클릭 | cd 폴더명 입력 |
| 프로그램 실행 | 아이콘 더블클릭 | claude 입력 (Claude Code 실행) |
터미널은 “글자로 컴퓨터에게 명령을 내리는 창”입니다. 마우스 대신 키보드로 같은 일을 합니다. 어렵게 느껴질 수 있지만, Claude Code를 사용하는 데 필요한 명령어는 딱 3~4개뿐입니다. 걱정하지 마세요.
cd 폴더이름 # 폴더로 이동
ls # 현재 폴더의 파일 목록 보기
mkdir 폴더이름 # 새 폴더 만들기
claude # Claude Code 실행!터미널 여는 방법
Mac
Cmd + Space를 눌러 Spotlight 검색을 열고, “터미널”을 입력하면 됩니다. macOS에 기본으로 설치되어 있어서 별도 설치가 필요 없습니다.
Windows
Windows에서는 WezTerm이라는 터미널 프로그램을 추천합니다. 기본 명령 프롬프트(cmd)나 PowerShell도 가능하지만, WezTerm이 더 편리합니다.
wezterm.org에서 다운로드하고 설치하세요. 설치 후 시작 메뉴에서 “WezTerm”을 검색하면 실행할 수 있습니다.
터미널 화면 (Mac Terminal / Windows WezTerm)
스크린샷 준비 중
터미널이 무섭게 느껴지셔도 괜찮습니다. Claude Code를 실행한 후에는 터미널 명령어를 직접 입력할 일이 거의 없습니다. Claude Code에게 한국어로 말하면, AI가 알아서 필요한 명령어를 실행해줍니다.
요금제 — 어떤 걸 구독할까?
Claude Code를 사용하려면 Anthropic의 Claude 구독이 필요합니다. API 키를 발급받는 복잡한 과정은 필요 없습니다. 그냥 구독만 하면 됩니다.
| 요금제 | 월 요금 | Claude Code | 사용량 | 비고 |
|---|---|---|---|---|
| Free | $0 | 사용 불가 | — | 웹 채팅만 가능 |
| Pro | $19/월 | 사용 가능 | 기본 제공 | Opus/Sonnet 선택 가능, 대화 간 메모리 |
| Max (5x) | $110/월 | 사용 가능 | Pro의 5배 | 피크시간 우선 처리 |
| Max (20x) | $220/월 | 사용 가능 | Pro의 20배 | 헤비 유저용 |
Pro 요금제 주의사항
Pro($19/월)도 Claude Code를 사용할 수 있지만, 집중해서 쓰면 약 1시간이면 일일 한도가 소진됩니다. Claude Code는 하나의 작업에 여러 번의 API 호출을 하기 때문에, 웹 채팅보다 사용량이 빠르게 소모됩니다. 한도에 도달하면 다음 날까지 기다려야 합니다.
Max ($110/월)를 강력 추천합니다
처음에는 $110이 부담스러울 수 있습니다. 하지만 앞서 계산한 것처럼 주당 5~10시간을 아낄 수 있다면, 시간당 가치는 충분히 높습니다. Pro는 “맛보기”로는 좋지만, 실제 업무에 활용하려면 사용량이 턱없이 부족합니다. 처음부터 Max로 시작하는 것을 추천합니다.
요약하면 이렇습니다:
- Free: Claude Code 사용 불가. 웹 채팅만 가능.
- Pro ($19/월): 맛보기용. 가볍게 체험해보고 싶을 때. 하루에 약 1시간 사용 가능.
- Max ($110/월): 실전용. 업무에 본격 활용할 때. 넉넉한 사용량 + 피크시간 우선 처리.
Claude 구독하기
구독 과정은 매우 간단합니다. 5분이면 끝납니다.
claude.ai에 접속합니다
아직 계정이 없다면 이메일로 가입하세요. Google 계정으로도 가입할 수 있습니다.
구독 버튼을 클릭합니다
로그인 후 왼쪽 하단 또는 설정(Settings)에서 “Upgrade” 또는 “구독” 버튼을 찾을 수 있습니다.
Pro 또는 Max를 선택합니다
업무에 본격 활용하실 분은 Max ($110/월)를, 먼저 가볍게 체험해보실 분은 Pro ($19/월)를 선택하세요.
카드 결제를 완료합니다
해외 결제가 가능한 카드(VISA, MasterCard 등)가 필요합니다. 결제가 완료되면 즉시 Claude Code를 사용할 수 있습니다.
claude.ai 구독 페이지 화면
스크린샷 준비 중
API 키는 필요 없습니다
예전에는 Claude Code를 사용하려면 별도의 API 키를 발급받아야 했습니다. 지금은 구독만 하면 됩니다. 복잡한 API 설정 과정이 없어졌으니, 구독 완료 후 바로 설치 단계로 넘어가세요.
사전 준비 (Node.js, Git)
Claude Code를 설치하기 전에, 몇 가지 프로그램을 먼저 설치해야 합니다. 운영체제별로 다르니 아래를 따라하세요.
필요한 사전 설치
# 1. Git 설치
# https://git-scm.com 에서 다운로드 후 설치
# (설치 중 모든 옵션은 기본값 그대로 Next)
# 2. Node.js 설치
# https://nodejs.org 에서 LTS 버전 다운로드 후 설치
# (설치 중 모든 옵션은 기본값 그대로 Next)
# 3. WezTerm 설치 (터미널)
# https://wezterm.org 에서 다운로드 후 설치
# 설치 확인 (WezTerm 또는 PowerShell에서)
git --version
node --versionWindows 사용자 참고
Windows에서는 3가지를 설치합니다: Git, Node.js, WezTerm. 모두 공식 사이트에서 다운로드 버튼을 누르고, 설치 과정에서 “Next”만 눌러도 됩니다. 특별한 설정 변경 없이 기본값 그대로 설치하세요.
Mac 사용자 참고
Mac은 Git이 이미 설치되어 있고, 터미널도 기본 앱이 있어서 Node.js만 설치하면 됩니다. nodejs.org에서 LTS 버전을 다운로드해서 설치하세요.
설치가 끝나면, 터미널을 열어서 아래 명령어로 확인합니다.
git --version
# 예: git version 2.43.0
node --version
# 예: v20.11.1버전 번호가 나오면 설치가 정상적으로 완료된 겁니다. 버전 번호는 다를 수 있으니 숫자가 나오기만 하면 괜찮습니다.
Claude Code 설치
드디어 Claude Code를 설치합니다! 터미널에서 명령어 한 줄이면 됩니다.
Claude Code 설치 명령어
irm https://claude.ai/install.ps1 | iexWindows에서 주의
Windows에서는 PowerShell 또는 WezTerm에서 위 명령어를 실행하세요. 일반 명령 프롬프트(cmd)에서는 동작하지 않을 수 있습니다. WezTerm을 열면 기본적으로 PowerShell이 실행됩니다.
설치가 완료되면, 아래 명령어로 확인합니다.
claude --version버전 번호가 표시되면 설치 성공입니다. 축하합니다!
만약 claude: command not found 에러가 나오면, 터미널을 완전히 닫고 다시 열어보세요. 그래도 안 되면 컴퓨터를 재시작하고 다시 시도해보세요. 대부분 이 방법으로 해결됩니다.
첫 실행
Claude Code는 특정 “작업 폴더” 안에서 실행하는 것이 좋습니다. 먼저 작업 폴더를 만들겠습니다.
작업 폴더 만들기
mkdir %USERPROFILE%\Desktop\autowork
cd %USERPROFILE%\Desktop\autowork바탕화면에 autowork라는 폴더를 만들고 그 안으로 이동했습니다. 앞으로 이 폴더를 기본 작업 공간으로 사용하겠습니다.
이제 Claude Code를 실행합니다.
claude이 한 단어만 입력하면 Claude Code가 시작됩니다. 처음 실행하면 로그인 과정이 진행됩니다 (다음 섹션에서 설명합니다).
Claude Code 첫 실행 화면
스크린샷 준비 중
claude 명령어를 실행하면, Claude Code는 현재 폴더를 “작업 공간”으로 인식합니다. 이 폴더 안의 파일들을 읽고 쓸 수 있게 되는 겁니다. 그래서 항상 원하는 작업 폴더로 먼저 이동한 후에 claude를 실행하는 것이 좋습니다.
로그인 방법
처음 claude를 실행하면 로그인 방법을 물어봅니다. 3가지 옵션이 나타나는데, 우리는 구독자이므로 첫 번째를 선택합니다.
How would you like to authenticate?
> 1. Claude account with subscription ← 이거!
2. Anthropic API key
3. Connect to remote serverClaude Code 로그인 방법 선택 화면
스크린샷 준비 중
“Claude account with subscription”을 선택합니다
키보드 화살표로 이동하고 Enter를 누르면 됩니다. 우리는 Pro 또는 Max를 구독했으므로 이 옵션을 선택합니다.
브라우저가 자동으로 열립니다
Claude 로그인 페이지가 나타납니다. 이미 claude.ai에 로그인되어 있다면 바로 승인 화면이 보입니다. 로그인이 안 되어 있다면 먼저 로그인하세요.
터미널로 돌아옵니다
브라우저에서 승인을 완료하면, 터미널에 “Successfully authenticated” 같은 메시지가 나타납니다. 로그인 성공입니다!
브라우저가 안 열리면?
터미널에 URL이 표시됩니다. 그 URL을 복사해서 브라우저에 직접 붙여넣으면 됩니다. 회사 보안 정책으로 브라우저 자동 실행이 막힌 경우에 이 방법을 쓰세요.
첫 대화: 안녕!
로그인이 완료되면, Claude Code가 입력을 기다리는 상태가 됩니다. 이제 첫 대화를 해보겠습니다!
안녕! 너는 뭘 할 수 있어?Claude Code가 자신의 능력을 설명해줄 겁니다. 대략 이런 내용입니다:
- 파일 읽기/쓰기: 현재 폴더의 파일을 읽고, 새 파일을 만들고, 기존 파일을 수정할 수 있습니다.
- 코드 작성 및 실행: Python, JavaScript 등의 코드를 짜서 바로 실행할 수 있습니다. 여러분이 코딩을 몰라도 됩니다.
- 폴더 탐색/검색: 폴더 구조를 파악하고, 특정 파일이나 내용을 검색할 수 있습니다.
- 데이터 분석/변환: 엑셀, CSV, JSON 등의 데이터를 분석하고 다른 형식으로 변환할 수 있습니다.
Claude Code 첫 대화 화면
스크린샷 준비 중
첫 번째 실습을 해보세요
이어서 이렇게 말해보세요: “현재 폴더에 hello.txt 파일을 만들어서 ‘안녕하세요! Claude Code 첫 실행 성공!’이라고 적어줘”. 바탕화면의 autowork 폴더에 실제로 파일이 생기는 걸 확인할 수 있습니다.
파일 생성을 요청하면, Claude Code는 먼저 “이 파일을 만들까요?”라고 허락을 구합니다. y를 눌러서 승인하면 파일이 생성됩니다. 이 승인 과정은 AI가 여러분의 허락 없이 파일을 마음대로 수정하는 것을 방지하기 위한 안전장치입니다.
실행 모드 이해하기
Claude Code에는 몇 가지 실행 모드가 있습니다. 처음에는 기본 모드만 사용하면 되지만, 참고로 알아두세요.
| 모드 | 명령어 | 설명 | 추천 상황 |
|---|---|---|---|
| 기본 모드 | claude | 파일 수정 시 매번 승인 필요 | 처음 사용할 때 (추천) |
| 플랜 모드 | /plan | 실행 전에 계획만 먼저 보여줌 | 큰 작업을 시작하기 전에 |
| 자동 수락 | claude --accept-edits | 파일 수정을 자동으로 승인 | 신뢰할 수 있는 반복 작업 |
| 권한 전체 해제 | claude --dangerously-skip-permissions | 모든 권한 확인 건너뜀 | 고급 사용자만 (주의!) |
처음에는 기본 모드를 사용하세요
기본 모드에서는 Claude Code가 파일을 수정하거나 명령어를 실행할 때마다 여러분에게 허락을 구합니다. 이게 번거로울 수 있지만, AI가 뭘 하는지 이해하는 데 매우 좋습니다. 어떤 파일을 수정하려는지, 어떤 명령어를 실행하려는지 하나하나 확인하면서 배울 수 있습니다. 충분히 익숙해진 후에 자동 수락 모드를 쓰세요.
플랜 모드 활용 팁
큰 작업을 시킬 때는 먼저 /plan을 입력해서 플랜 모드로 전환하세요. AI가 “이렇게 할 계획입니다”라고 먼저 알려줍니다. 계획이 마음에 들면 실행하고, 수정이 필요하면 지시를 바꿀 수 있습니다.
체크포인트
여기까지 잘 따라오셨다면, 아래 항목을 모두 확인해보세요.
모두 체크되셨나요?
축하합니다! Claude Code를 사용할 준비가 완료되었습니다. 다음 챕터에서는 실제 업무 자동화 실습을 시작합니다. 첫 번째 실습은 Gmail 자동화입니다 — 매일 아침 메일함과 씨름하는 시간을 확 줄여보겠습니다.
막히는 부분이 있다면
설치 과정에서 에러가 나거나 막히는 부분이 있다면, 에러 메시지를 그대로 복사해서 claude.ai 웹 채팅에 붙여넣고 도움을 요청해보세요. 대부분의 설치 문제는 간단한 해결 방법이 있습니다.