Claude Code란?

터미널 하나로 프로젝트 전체를 자동화

"AI 출력물 검수 담당자" 된 느낌, 익숙하지 않나요?

Cursor도 써봤다.

Copilot도 설치해봤다.

ChatGPT 탭은 항상 열려 있다.

분명히 편하다. 그건 부정할 수 없다.

그런데 뭔가 계속 찜찜했다. 내가 운전대를 잡고 있는 느낌이 없다.

Copilot이 제안하는 코드를 "일단 맞겠지" 하며 Tab으로 수락한다. ChatGPT한테 물어본 코드를 복붙하고, 안 되면 에러 메시지 다시 붙여넣고, 수정 코드 또 복붙하고. Cursor에서 Edit 누르고, diff 확인하고, Accept 누른다.

편하긴 한데, 어느 순간 내가 "AI가 뽑아낸 코드를 검수하는 역할" 이 되어버린 것 같았다. 코드를 짜는 건 AI고, 나는 그걸 받을지 말지 판단하는 것뿐.... 이게 AI 시대의 개발 방식이라면, 뭔가 씁쓸하다.

Claude Code를 쓰기 시작하면서 그 느낌이 달라졌다.

바이브 코딩(Vibe Coding)이란?
AI와의 자연스러운 대화를 통해 코드를 완성해 나가는 개발 방식. 정밀한 프롬프트 엔지니어링보다 맥락과 의도를 자연스럽게 전달하는 것을 중시한다. Claude Code는 이 워크플로에 최적화된 도구다.

터미널에서 동작한다는 것, 그게 왜 핵심인가

Claude Code는 Anthropic이 만든 터미널 기반 AI 코딩 에이전트다.

"터미널 기반"이라고 하면 처음엔 좀 낯설다. 에디터에 붙어 있는 것도 아닌데, 그게 뭐가 좋냐고. 직접 써보기 전까진 나도 그랬다. 쓰고 나서야 이게 바로 핵심이라는 걸 깨달았다.

# 실행은 딱 이 한 줄
$ claude

# 프로젝트 디렉토리 안에서 실행하면 코드베이스를 자동으로 파악한다
$ cd my-project && claude

터미널에 처음으로 claude를 치고 Enter를 눌렀던 순간이 아직도 생각난다. 커서가 깜빡이다가 프롬프트가 뜬다. 내 말로 "이거 해줘"라고 입력한다. 그러면 Claude Code가 파일을 읽고, 코드를 작성하고, 테스트를 돌리고, 결과를 보고한다.

복붙 없다. 브라우저 탭과 에디터 사이를 왔다갔다 안 해도 된다. 내가 지시하고, AI가 실행한다. 내가 운전대를 잡고 있다는 느낌. 이건 다른 어떤 AI 툴에서도 받지 못한 감각이었다.

실제로 무엇을 할 수 있나

말로 늘어놓는 것보다 사용 예시를 직접 보는 게 낫다.

코드베이스 전체를 파악한다

Claude Code는 프로젝트 디렉토리 구조, 설정 파일, 의존성 관계를 자동으로 읽어낸다. "이 프로젝트의 로그인 기능 수정해줘"라고 하면 관련 파일을 스스로 찾아서 고친다.

구조를 따로 설명하지 않아도 된다. 파일 경로를 일일이 알려주지 않아도 된다. 알아서 읽고 파악한다.

파일을 읽고 직접 수정한다

> src/components/Header.tsx 네비게이션 메뉴에 로그아웃 버튼 추가해줘

# Claude Code가 자동으로:
# 1. 해당 파일을 읽어들인다
# 2. 기존 코드 구조를 파악한다
# 3. 적절한 위치에 코드를 삽입한다
# 4. 연관된 파일도 필요하면 함께 수정한다

명령어를 직접 실행한다

테스트, 빌드, lint까지 Claude Code가 직접 돌린다.

> 테스트 실행해서 실패한 거 있으면 고쳐줘

# Claude Code가 자동으로:
# 1. npm test 실행
# 2. 실패한 테스트 원인 분석
# 3. 코드 수정
# 4. 다시 테스트 실행해서 확인

이게 진짜 차이가 나는 지점이다. ChatGPT 쓰면 "이 명령어 실행해보세요"라고 알려주고, 직접 터미널에 붙여넣고, 에러 나면 다시 ChatGPT에 에러 내용 붙여넣고, 수정 코드 다시 복붙하고… 이 루프를 Claude Code는 스스로 처리한다. 수정 → 테스트 → 재수정, 사람 손 거치지 않고 자체적으로 돌린다.

Git 작업도 자연어로

> 지금 변경사항 커밋해줘. 메시지는 변경 내용에 맞게 알아서 써줘

커밋, 브랜치 생성, diff 확인까지 전부 자연어로 지시 가능하다.

막히면 Claude Code가 먼저 물어본다

코드를 일방적으로 뽑아내는 게 아니다. 불명확한 부분이 있으면 Claude Code 쪽에서 먼저 질문해온다. "이 함수 반환 타입은 어떻게 할까요?", "테스트 프레임워크는 Vitest랑 Jest 중 어느 걸 쓸까요?" 같은 식으로. 대화를 주고받으면서 요구사항을 좁혀나갈 수 있다.

내부 구조: 어떻게 동작하는가

구조를 알아두면 활용 방법이 더 잘 보인다.

핵심은 세 가지다.

① 코드는 내 로컬에서만 동작한다
파일 조작과 명령어 실행은 전부 내 머신에서 이루어진다. Claude Code는 작업에 필요한 파일 내용을 API 요청으로 Anthropic 서버에 보낸다. 다만 Anthropic의 이용 정책상, API를 통해 전송된 데이터는 모델 학습에 사용되지 않으며 영구 저장도 하지 않는다. 사내 코드나 고객 데이터를 다룬다면 반드시 회사 보안 정책을 먼저 확인하자. 특히 금융권이나 공공기관 개발자라면 망분리 환경에서는 사용이 제한될 수 있다.

② AI 추론은 Anthropic API를 통한다
자연어 이해와 응답 생성은 Anthropic의 Claude 모델이 담당한다.

③ 컨텍스트를 세션 내내 유지한다
대화 이력과 프로젝트 정보를 지속적으로 보유하기 때문에 작업의 일관성이 유지된다.

다른 툴과 무엇이 다른가

vs GitHub Copilot

Copilot이 "똑똑한 자동완성"이라면, Claude Code는 "스스로 움직이는 주니어 개발자"다. Copilot은 다음 줄을 예측한다. Claude Code는 태스크 전체를 끝까지 처리한다.

vs Cursor / Windsurf

Cursor나 Windsurf는 에디터 통합형 AI 툴로 UI가 잘 만들어져 있다. Cursor는 개인적으로도 즐겨 쓴다. 하지만 Claude Code와는 담당하는 역할 자체가 다르다.

Claude Code가 잘하는 것:

에디터 종류에 무관하다 (Vim, VS Code, IntelliJ 어디서든 병행 가능)

GitHub Actions, Jenkins 같은 CI/CD 파이프라인에 통합할 수 있다

SSH로 접속한 원격 서버에서도 그대로 사용 가능하다

가볍고 실행 속도가 빠르다

Cursor/Windsurf가 잘하는 것:

직관적인 GUI 환경

코드 변경사항 인라인 diff 표시

마우스로 조작하는 편리한 인터페이스

결론은 둘 다 쓰는 게 가장 좋다. VS Code에서 Cursor로 작업하면서, 옆 터미널에서 Claude Code를 돌린다. 서로 잘하는 영역이 달라서 경쟁 관계가 아니라 보완 관계가 된다.

vs ChatGPT / Claude.ai

브라우저 채팅 AI와의 차이는 근본적이다. Claude Code는 실행 환경 자체를 갖고 있다.

채팅 AI 방식:

나: "이 코드 버그 고쳐줘"
AI: "수정된 코드입니다. 복사해서 사용하세요."

Claude Code 방식:

나: "이 코드 버그 고쳐줘"
Claude Code: (파일을 직접 수정하고, 테스트 실행해서 검증까지 마침)

"고작 복붙 아닌가" 싶을 수 있다. 하지만 수정 → 테스트 → 재수정 사이클을 하루에 수십 번 반복할 때, 그 차이가 쌓이면 압도적이 된다. 하루 4~5시간 개발한다면, 이 복붙 루프가 줄어드는 것만으로도 체감 생산성이 완전히 달라진다.

요금: 얼마나 드나

신경 쓰이는 부분이니 먼저 짚고 넘어가자.

요금 기준 (2026년 3월 시점 / 원화 환산은 환율에 따라 달라짐)
① Max 플랜 — 월 정액제
- Max5 = $100 (약 14만원대) - 개인 개발자, Pro플랜 상위
- Max10 = $200 (약 29만원대) - 팀, 헤비유저
정액제라 사용량 걱정 없이 마음껏 작업할 수 있다는 게 핵심 장점이다.
② API 종량제
- Sonnet 모델 일반 사용 기준: 하루 $2~5 수준
- 대규모 리팩토링·장시간 세션: 하루 $10~20 수준
- 저자 기준 월 $60~100 정도 (API 직접 이용 시)
③ 무료 체험
- 별도 비용 없이 먼저 사용해볼 수 있다. 부담 없이 시작하기에 좋다.
⚠️ 참고: 요금 체계는 언제든 변경될 수 있다. 위 정보는 2026년 3월 기준이다.

비싸지 않냐고? 솔직히 저렴하진 않다. 그런데 이건 내 인건비와 비교해봐야 한다. 2~3시간 걸리던 리팩토링이 30분으로 줄어든다면, 몇 달러는 쉽게 본전이 나온다. 처음엔 무료 체험부터 시작해서 감을 잡자.

어떤 작업에 쓰고, 어떤 작업은 직접 챙겨야 하나

Claude Code가 특히 빛나는 상황:

신규 프로젝트 초기 세팅: "Next.js 16로 소셜 로그인 포함한 SaaS 보일러플레이트 만들어줘"

낯선 코드베이스 파악: "이 프로젝트 전체 아키텍처 설명해줘. 의존성 흐름도 포함해서"

버그 추적 및 수정: "이 에러 원인 찾아서 고쳐줘. 재현 조건도 알려줘"

레거시 코드 리팩토링: "이 JavaScript 모듈 TypeScript로 마이그레이션해줘"

테스트 커버리지 확보: "이 서비스 레이어 유닛 테스트 작성해줘. edge case 포함"

API 문서 자동화: "이 Express 라우터 기반으로 OpenAPI 스펙 문서 생성해줘"

반복 작업 자동화: "이 패턴으로 된 파일 전체에서 구 API 호출을 신 API로 일괄 교체해줘"

반대로 직접 손에 쥐고 있어야 할 부분:

보안 관련 코드: 인증·인가·암호화 로직은 AI 출력이라도 반드시 직접 검토한다. 특히 금융·의료·개인정보 처리 시스템에서는 더욱 철저히 확인해야 한다.

핵심 비즈니스 로직 설계: "무엇을 만들 것인가"는 사람이 결정해야 한다. AI는 "어떻게 만드는가"의 실행에 강하다. 설계와 실행을 혼동하지 말자.

성능 튜닝: 측정 → 병목 발견 → 가설 수립 → 개선 → 재측정 사이클은 사람의 맥락 판단이 반드시 필요하다.

외부 API 연동 설계: 비용 구조, 레이트 리밋, 장애 대응 같은 운영 판단은 직접 챙겨야 한다.

이 경계선, 즉 "AI에게 맡기는 영역"과 "내가 직접 쥐는 영역"을 명확히 하는 것이 바이브 코딩에서 실제 성과를 내는 핵심이다. 이 주제는 5장에서 더 깊게 다룬다.

정리

- Claude Code는 터미널 기반 자율형 AI 코딩 에이전트다
- 파일 수정, 명령어 실행, Git 조작까지 스스로 처리한다
- 에디터 종류에 상관없이 어떤 개발 환경에서도 바로 사용할 수 있다
- Cursor, Copilot 같은 다른 AI 툴과 병행하면 시너지가 난다
- "AI가 나를 보조하는" 것이 아니라 "내가 AI를 지휘하는" 감각이 생긴다

---

©2024-2026 MDRules dev., Hand-crafted & made with Jaewoo Kim.

이메일문의: jaewoo@mdrules.dev

AI강의/개발/기술자문, Claude Code 전문강의, AI 업무 자동화 컨설팅 문의: https://talk.naver.com/ct/w5umt5

MDRules Dev - 네이버톡톡

AI 업무 자동화/에이전트/워크플로우설계 컨설팅/AI교육: https://mdrules.dev

MDRules Dev — AI 에이전트 경영과 AI 교육으로 차세대 경영 모델을 구축합니다