블로그 글 하나를 쓰려고 Claude 웹앱을 열었다. 초안을 받고, 톤을 수정하고, 이미지 설명까지 붙이니 대화가 20턴을 넘겼다. 다음 날 사이드 프로젝트 코드를 리팩토링하려는데, 같은 창에서 파일을 하나하나 붙여넣고 있다. “이거 터미널에서 하면 한 번에 되지 않나?” 싶어 Claude Code를 깔았더니, 이번엔 요금이 어디서 빠지는 건지 모르겠다.
같은 ‘Claude’라는 이름 아래 웹앱과 CLI가 따로 있고, 요금제도 Pro·Max·API가 뒤섞여 있으니 혼란은 당연하다. 이 글은 그 혼란을 한 번에 정리한다.
같은 이름, 완전히 다른 작동 방식
Claude.ai 웹앱과 Claude Code는 같은 AI 모델을 쓰지만, 작동 구조가 근본적으로 다르다. 웹앱은 브라우저에서 대화하는 채팅 인터페이스고, Claude Code는 터미널에서 프로젝트 폴더 전체를 읽고 파일을 직접 수정하는 에이전틱 시스템이다.
| 구분 | Claude.ai 웹앱 | Claude Code CLI |
|---|---|---|
| 접근 방식 | 브라우저 대화창 | 터미널 명령어 (+ IDE 확장) |
| 작업 단위 | 한 번에 하나의 질문-응답 | 프로젝트 폴더 전체를 읽고 멀티파일 수정 |
| 파일 접근 | 수동 업로드 (드래그 앤 드롭) | 디렉토리 자동 탐색, git·빌드 도구 직접 실행 |
| 주요 용도 | 글쓰기, 리서치, 브레인스토밍, 문서 요약 | 코드 작성·리팩토링, 테스트 자동 실행, CI 연동 |
핵심 차이를 한 줄로 줄이면 이렇다. 웹앱은 “내가 질문하면 답하는” 구조이고, Claude Code는 “목표를 주면 스스로 탐색-수정-검증을 반복하는” 구조다.
요금제, 내 상황에 맞는 건 어디인가
Claude 요금제는 크게 세 갈래로 나뉜다. 구독형(Pro·Max)과 종량형(API)이 별개 과금 체계라는 점이 가장 많이 헷갈리는 부분이다.
| 플랜 | 월 요금 | 포함 범위 |
|---|---|---|
| Free | $0 | 웹앱 기본 사용량 |
| Pro | $19/월 | 웹앱 + Claude Code (사용량 공유, 5× 용량) |
| Max | $110~/월 | 웹앱 + Claude Code (사용량 공유, Pro 대비 최대 20× 용량) |
| API (종량제) | 토큰당 과금 | Claude Code 포함, 쓴 만큼 청구 |
중요한 함정이 하나 있다. Pro나 Max를 구독 중이라도, 시스템에 API 키 환경변수(ANTHROPIC_API_KEY)가 설정돼 있으면 Claude Code가 구독 대신 API 과금으로 연결된다. 구독 요금제로 쓰려면 claude login으로 구독 계정 인증만 해두면 된다.
1인 개발자나 블로거라면 판단 기준은 단순하다. 하루 서너 번 글 초안·코드 리뷰 수준이면 Pro로 충분하고, 하루 종일 Claude Code를 돌려 사이드 프로젝트를 진행한다면 Max가 안정적이다.
컨텍스트 차이가 만드는 결과 격차
Claude 4 시리즈(Sonnet 4.6, Opus 4.8 등) 기준 컨텍스트 윈도우는 기본 200K 토큰이다. 그런데 이 숫자를 체감하는 방식이 웹앱과 CLI에서 크게 다르다.
웹앱에서는 대화가 길어지면 이전 맥락이 요약·압축된다. 20턴쯤 지나면 처음 지시한 톤이나 조건이 흐려지는 이유가 이것이다. Claude Code는 다르게 작동한다. 프로젝트 파일을 직접 읽어 컨텍스트를 채우고, 용량이 92%에 도달하면 3단계 압축(도구 결과 정리 → 대화 요약 → 수동 compact)을 거친다. 파일 시스템 자체가 “기억”이므로, 대화가 길어져도 코드베이스의 구조는 잊지 않는다.
블로그 글을 쓸 때는 웹앱의 Projects 기능에 브랜드 가이드를 올려두면 맥락 유지가 된다. 하지만 10개 파일 이상의 코드를 동시에 다뤄야 한다면, 웹앱 채팅으로는 구조적으로 한계가 온다.
용도별 선택 기준 — 당신은 어디에 해당하는가
도구를 고르는 기준은 “뭘 할 수 있냐”가 아니라 “내 작업이 어느 쪽에 맞냐”다.
Claude.ai 웹앱이 맞는 경우: 블로그 초안 작성, 자료 요약, 아이디어 브레인스토밍, 이메일·카피 작성, 문서 비교 분석. 파일을 업로드하고 대화로 결과물을 다듬는 흐름이라면 웹앱이 빠르다.
Claude Code가 맞는 경우: 멀티파일 코드 리팩토링, 테스트 자동 실행 후 수정, git 커밋·PR 자동화, CI 파이프라인 모니터링, 프로젝트 구조 파악 후 기능 추가. “목표를 주고 결과를 받는” 작업이라면 CLI가 압도적이다.
둘 다 쓰는 경우: 사실 대부분의 1인 개발자·블로거가 여기에 해당한다. 글 기획과 초안은 웹앱에서, 블로그 빌드 시스템 수정이나 자동화 스크립트 작성은 Claude Code에서. Pro 플랜 하나로 양쪽 모두 커버된다.
역할: IT·AI 분야 블로그 에디터
작업: 아래 주제로 블로그 초안을 작성해줘.
주제: Claude Code를 처음 설치하고 사이드 프로젝트에 연결하는 과정
대상 독자: 터미널을 써본 적 있지만 AI 코딩 도구는 처음인 1인 개발자
톤: 실용적이고 군더더기 없는 설명체. 과장 표현 금지.
분량: 1500자 내외
구조: 도입(왜 필요한가) → 설치 3단계 → 첫 명령어 실행 → 주의사항 → 마무리
추가 조건:
- 각 단계에 터미널 명령어를 코드블록으로 포함
- "쉽다/간단하다" 같은 표현 쓰지 말 것
- 공식 문서 기준 최신 설치 방법 반영
이 프로젝트의 전체 구조를 파악해줘.
확인할 것:
1. 디렉토리 구조와 각 폴더의 역할
2. 주요 진입점 파일 (main, index, app 등)
3. 사용 중인 프레임워크와 패키지 매니저
4. 테스트 설정 여부와 실행 명령어
5. 빌드/배포 스크립트 존재 여부
결과를 마크다운 표로 정리하고, 이 프로젝트에서 가장 먼저 개선할 수 있는 부분 2가지를 제안해줘.
Before: 코드 리팩토링을 위해 웹앱에 파일 10개를 하나씩 붙여넣고, 수정본을 다시 복사해서 로컬에 저장. 파일당 3분 × 10개 = 30분.
After: Claude Code에 “이 폴더의 중복 함수를 통합해줘”라고 한 번 지시. 자동으로 파일 탐색 → 수정 → 테스트 실행. 5분 내 완료.
Pro나 Max 구독자라면 이 두 환경이 하나의 사용량 풀을 공유한다는 점도 기억해두자. 웹앱에서 글을 많이 쓴 날은 Claude Code 사용량이 그만큼 줄어든다. 작업 패턴에 따라 하루 배분을 의식하면 한도 초과를 피할 수 있다.
자주 묻는 질문
Q. Claude Code를 쓰려면 별도 결제가 필요한가요?
Pro($19/월) 또는 Max($110~/월) 구독에 Claude Code가 포함돼 있다. 별도 결제 없이 claude login으로 구독 계정을 연결하면 된다. 단, API 키가 환경변수에 설정돼 있으면 종량제로 과금되니 주의해야 한다.
Q. 웹앱과 Claude Code에서 쓰는 AI 모델이 다른 건가요?
동일한 모델(Sonnet 4.6, Opus 4.8 등)을 사용한다. 차이는 모델이 아니라 인터페이스와 작동 방식이다. 웹앱은 대화형, CLI는 에이전틱(자율 실행) 구조로 같은 모델을 다른 방식으로 활용한다.
Q. 터미널을 처음 쓰는데 Claude Code부터 시작해도 되나요?
Claude Code는 터미널 기반이므로 기본적인 명령어(cd, ls, git)에 익숙해야 효과를 본다. 터미널 경험이 전혀 없다면 웹앱의 Projects 기능으로 시작하고, 터미널에 익숙해진 뒤 Claude Code로 넘어가는 순서를 권장한다. VS Code 등 IDE 확장으로도 접근 가능하므로 진입 장벽은 점점 낮아지고 있다. 아직 계정이 없다면 Claude 무료로 시작하기에서 웹앱부터 써볼 수 있다.
정리 — 도구를 고르는 건 결국 작업 흐름의 문제다
Claude.ai와 Claude Code는 경쟁 관계가 아니라 역할 분담이다. 글을 쓰고 자료를 정리하는 흐름은 웹앱에서, 코드를 짜고 프로젝트를 굴리는 흐름은 CLI에서. 요금제 하나로 양쪽을 오가면 된다.
그런데 실제로 Claude Code에 프로젝트를 맡기면 어떤 결과가 나올까? 블로그 자동화 스크립트를 짜게 하거나, 기존 코드를 리팩토링시키면 웹앱 대비 체감 차이가 얼마나 될까? 다음 편에서 동일한 작업을 양쪽에서 돌려보고 비교한다. → 클로드 코드 실전 활용｜블로그 자동화·코드 리팩토링·데이터 분석 비교 테스트
📌 함께 읽으면 좋은 글