챗봇과 에이전트는 다르다
ChatGPT나 claude.ai 같은 챗봇은 답을 말해주는 AI다. “이 문서 요약해줘”라고 하면 요약문을 보여주고, 그걸 복사해서 내 파일에 붙여넣는 건 내 몫이다. 파일이 100개라면 100번 복사해야 한다.
Claude Code는 직접 일하는 AI다. 내 컴퓨터에서 파일을 열고, 수정하고, 저장하고, 프로그램을 실행한다. “이 폴더의 PDF 100개를 요약해서 엑셀 한 장으로 정리해줘”라고 하면 — 정말로 그 일을 처음부터 끝까지 한다.
챗봇은 방법을 알려주고, 에이전트는 결과물을 만든다.
에이전트는 어떻게 작동하는가
내부 동작을 아주 단순화하면 이런 반복(루프)이다.
- 내 지시를 읽고 계획을 세운다
- 필요한 도구를 사용한다 — 파일 읽기, 파일 쓰기, 명령 실행, 웹 검색
- 도구 실행 결과를 확인하고 다음 행동을 결정한다
- 목표가 달성될 때까지 2–3을 반복한다
챗봇과의 결정적 차이가 3번이다. 실행 결과를 스스로 확인하기 때문에, 중간에 오류가 나면 원인을 진단하고 고쳐서 다시 시도한다. 사람이 개입하지 않아도 작업이 끝까지 굴러가는 이유다.
Claude Code가 할 수 있는 것
“개발자 도구”로 알려져 있지만, 실제 쓰임새는 훨씬 넓다.
| 분류 | 구체적 예시 |
|---|---|
| 문서 작업 | PDF·워드 파일 통독 후 요약, 형식 변환, 보고서 초안 작성 |
| 파일 정리 | 다운로드 폴더의 파일 500개를 규칙에 따라 폴더별 분류 |
| 데이터 처리 | 엑셀·CSV 정리, 차트 생성, 통계 계산 |
| 코드 작성 | 필요한 스크립트를 직접 짜고, 실행하고, 오류까지 수정 |
| 웹 조사 | 최신 자료를 검색해서 출처와 함께 문서에 반영 |
| 반복 자동화 | 자주 하는 작업을 명령어 하나로 저장 (시리즈 ③에서 다룸) |
핵심은 코딩을 몰라도 된다는 점이다. “이 CSV에서 월별 평균을 구해서 그래프로 그려줘”라고 말하면, 필요한 파이썬 코드를 Claude가 알아서 작성하고 실행한다. 나는 결과만 확인하면 된다.
반대로, 못 하는 것 / 하면 안 되는 것
기대치를 정확히 잡는 것도 중요하다.
- 판단의 책임은 못 진다. 사실 확인, 최종 검토는 반드시 사람 몫이다. AI는 틀린 내용을 자신 있게 말할 수 있다
- 화면 조작(GUI)은 제한적이다. 파일과 터미널 기반 작업이 주 무대다. “포토샵 열어서 보정해줘” 같은 작업은 맞지 않다
- 인터넷 계정 작업은 신중해야 한다. 이메일 발송, 게시물 업로드처럼 되돌리기 어려운 작업은 확인 단계를 거치도록 설정하는 게 안전하다 (②에서 다룸)
요금제: 무엇을 선택해야 하나
Claude Code를 쓰려면 유료 구독 또는 API 결제가 필요하다. 2026년 기준 선택지는 크게 세 가지다.
| 방식 | 특징 | 추천 대상 |
|---|---|---|
| Pro 구독 | 월 정액, 사용량 한도 내 이용 | 입문자, 하루 1–2시간 사용 |
| Max 구독 | Pro보다 높은 한도, 상위 모델 접근 | 매일 장시간 사용 |
| API 종량제 | 쓴 만큼 과금 | 사용량이 매우 불규칙한 경우 |
처음이라면 Pro로 시작하자. 한도에 자주 걸리기 시작하면 그때 올려도 늦지 않다. 요금과 한도 정책은 바뀔 수 있으니 가입 전 공식 요금 페이지에서 확인하는 것을 권한다.
준비물 2가지
1. Claude 계정
claude.ai에서 가입한다. 구글 계정으로 가입하면 1분이면 끝난다. 가입 후 위에서 정한 플랜을 구독한다.
2. Node.js
Claude Code 실행에 필요한 기반 프로그램이다. 이름이 낯설어도 걱정할 것 없다 — 설치만 하면 다시 열어볼 일이 없다.
- nodejs.org 접속
- LTS라고 적힌 버전 다운로드 (LTS = 안정 버전)
- 설치 파일 실행 후 계속 ‘다음’ 클릭 (설정 변경 불필요)
설치가 됐는지 확인하려면 터미널(아래 참고)에 node -v를 입력한다. v22.x.x 같은 버전 숫자가 나오면 성공이다.
설치하기 (Windows 기준)
1단계: 터미널 열기
시작 메뉴에서 PowerShell을 검색해 실행한다. 파란 배경에 글자만 있는 창이 뜬다. 이 창이 앞으로 Claude Code와 대화할 공간이다.
터미널이 처음이라 무섭다면: 터미널은 “글자로 명령을 내리는 창”일 뿐이다. 여기서 우리가 직접 입력할 명령은 사실상 두세 개가 전부고, 나머지는 전부 한국어로 Claude에게 말하면 된다.
2단계: 설치 명령 입력
아래 한 줄을 복사해서 터미널에 붙여넣고 Enter.
npm install -g @anthropic-ai/claude-code
npm은 Node.js와 함께 설치된 프로그램 설치 도구다. 1–2분 정도 걸린다.
3단계: 작업 폴더로 이동 후 실행
Claude Code는 실행한 폴더 안에서 일한다. 아무 곳에서나 실행하지 말고, 작업할 폴더를 만들어 이동한 뒤 실행하자.
mkdir C:\Users\내이름\Documents\ai-work
cd C:\Users\내이름\Documents\ai-work
claude
4단계: 로그인
처음 실행하면 브라우저가 자동으로 열리며 Claude 계정 로그인을 요청한다. 로그인하고 승인하면 터미널로 돌아와 바로 사용할 수 있다. 이 과정은 최초 1회만 필요하다.
터미널이 정 부담스럽다면
같은 기능을 다른 모습으로 쓸 수 있다.
- VS Code 확장: VS Code(무료 편집기) 안에서 버튼 클릭으로 사용
- 데스크톱 앱: 일반 프로그램처럼 창으로 실행
어떤 방식이든 아래 내용은 동일하게 적용된다.
첫 명령 실행해보기
설치 확인을 겸해 세 가지를 순서대로 시켜보자. 전부 한국어로 입력하면 된다.
실습 1 — 읽기 (안전한 작업)
이 폴더에 어떤 파일들이 있는지 알려줘
Claude가 폴더를 스캔해 목록을 정리해준다. 읽기만 하는 작업이라 아무것도 바뀌지 않는다.
실습 2 — 쓰기 (승인 경험하기)
hello.txt 파일을 만들고 안에 "첫 파일"이라고 적어줘
이때 처음으로 승인 요청이 뜬다. “이 파일을 만들어도 될까요?”라고 묻는 화면에서 승인을 선택하면 파일이 생성된다. Claude Code는 기본적으로 내 파일을 바꾸기 전에 항상 허락을 구한다.
실습 3 — 실행 (에이전트의 진짜 모습)
1부터 100까지 숫자 중 3의 배수만 모아서 결과.txt로 저장해줘
Claude가 짧은 코드를 작성하고, 실행하고, 결과를 파일로 저장하는 전 과정을 볼 수 있다. 코드는 한 줄도 몰라도 된다.
알아두면 좋은 기본 조작
| 조작 | 기능 |
|---|---|
Esc | 진행 중인 작업 중단 |
Ctrl+C 두 번 | Claude Code 종료 |
/help | 명령 목록 보기 |
| 위 방향키 | 이전에 입력한 지시 다시 불러오기 |
자주 묻는 질문
Q. 내 파일이 외부로 전송되나? 작업에 필요한 파일 내용은 Claude 서버로 전송되어 처리된다. 회사 기밀이나 민감한 개인정보가 담긴 폴더에서는 사용 전에 조직의 보안 정책을 확인하자.
Q. AI가 내 파일을 마음대로 지우면 어떡하나? 기본 설정에서는 모든 수정·삭제 전에 승인을 요구한다. 승인 설정을 바꾸지 않는 한 내 허락 없이 파일이 바뀌지 않는다.
Q. 인터넷 없이 쓸 수 있나? 없다. AI 모델이 서버에서 돌아가기 때문에 인터넷 연결이 필수다.
Q. 맥(Mac)에서도 되나? 된다. 터미널 앱에서 같은 npm 명령으로 설치하면 되고, 이후 사용법은 동일하다.
문제 해결
npm은 내부 또는 외부 명령이 아닙니다 오류
Node.js가 설치되지 않았거나, 설치 후 터미널을 새로 열지 않은 경우다. 터미널을 완전히 닫고 다시 열어보자. 그래도 안 되면 Node.js를 재설치한다.
claude를 입력해도 반응이 없음
설치(2단계)가 끝나기 전에 실행했을 수 있다. npm install 명령을 다시 실행해 완료 메시지를 확인하자.
로그인 브라우저가 안 열림 터미널에 표시되는 URL을 직접 복사해 브라우저에 붙여넣으면 된다.
다음 글에서
설치는 끝났다. 하지만 지금 상태로는 매번 같은 설명을 반복하게 된다. 다음 글에서는 Claude Code가 내 규칙과 맥락을 기억하는 비서가 되도록 만드는 초기 세팅 — 작업 지침 파일(CLAUDE.md), 권한 모드, 필수 슬래시 명령 — 을 다룬다.