클로드 코드 설치와 요금제, 사용량 한도 정리

클로드 코드는 터미널에 설치해 쓰는 Anthropic의 AI 코딩 도구다. 2026년 10월 1일 기준 무료 요금제에는 포함되지 않고, 프로(월 20달러)부터 쓸 수 있다. 사용량은 클로드 채팅과 한도를 나눠 쓰며, 5시간 세션과 주간 한도로 센다. 설치는 명령어 한 줄이면 끝난다.

설치와 첫 실행은 Claude Code 빠른 시작 문서, 요금은 Claude 요금제 페이지, 비용 관리는 Claude Code 비용 문서에서 확인했다. 개발자가 아니어도 폴더 안의 파일을 읽고 고치는 작업에는 쓸 수 있다.

세 줄로 먼저 읽기

• 설치: 운영체제에 맞는 명령어 한 줄을 터미널에 붙여 넣고, claude를 실행해 로그인한다.
• 요금: 무료는 안 되고 프로 월 20달러, 맥스 월 100달러부터다. 구독 한도를 다 쓰면 사용량 크레딧이나 API 요금으로 넘어갈 수 있다.
• 주의: 컴퓨터에 ANTHROPIC_API_KEY가 설정돼 있으면 구독이 아니라 API 요금이 청구된다.

클로드 코드 설치는 명령어 한 줄이다

클로드 코드는 터미널(명령어를 입력하는 검은 창)에서 쓰는 도구다. 맥은 터미널 앱, 윈도우는 PowerShell을 연다. 공식 문서가 권장하는 설치법은 아래 표와 같다.

환경	설치 명령어
맥, 리눅스, WSL	curl -fsSL https://claude.ai/install.sh | bash
윈도우 PowerShell	irm https://claude.ai/install.ps1 | iex
윈도우 CMD	curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Homebrew(맥)	brew install --cask claude-code
WinGet(윈도우)	winget install Anthropic.ClaudeCode

설치가 끝나면 터미널을 새로 열고 claude --version을 입력한다. 버전 번호가 나오면 성공이다. claude를 찾을 수 없다고 나오면 설치 위치가 PATH(명령어를 찾는 경로 목록)에 아직 없다는 뜻이다. 공식 문서의 설치 문제 해결 페이지에 해결법이 있다.

요구 사양은 단출하다. 맥은 macOS 13 이상, 윈도우는 Windows 10 1809 이상, 우분투는 20.04 이상이다. 메모리는 4GB 이상이 필요하다. 윈도우에서는 Git for Windows가 없어도 PowerShell로 동작한다. 한국은 Anthropic 지원 국가 목록에 들어 있다.

터미널이 낯설다면 데스크톱 앱이 있다. 공식 문서는 터미널 없이 클로드 코드를 쓰는 데스크톱 앱을 따로 안내한다. 웹의 claude.ai/code에서도 쓸 수 있다.

로그인하고 첫 질문을 던진다

작업할 폴더로 이동해 claude를 입력한다. 처음 실행하면 브라우저가 열리고 로그인 화면이 나온다. 로그인할 수 있는 계정은 네 가지다.

• 클로드 프로, 맥스, 팀, 엔터프라이즈 구독 계정
• Claude Console 계정(API를 선불 크레딧으로 쓰는 개발자용 계정)
• Amazon Bedrock, Google Cloud, Microsoft Foundry 같은 클라우드 경유
• 회사가 운영하는 자체 게이트웨이

공식 문서는 무료 claude.ai 계정으로는 클로드 코드를 쓸 수 없다고 밝힌다. 계정을 바꾸려면 세션 안에서 /login을 입력한다.

로그인하면 첫 질문을 던진다. 공식 문서의 예시는 "what does this project do?"처럼 폴더 내용을 묻는 것이다. 한국어로 물어도 된다. 클로드 코드는 필요한 파일을 알아서 읽는다. 매번 파일을 붙여 넣을 필요가 없다.

자주 쓰는 명령은 몇 개뿐이다.

• claude -c: 이 폴더의 마지막 대화를 이어 간다.
• claude -p "질문": 한 번 답하고 끝낸다.
• /clear: 대화를 비우고 새로 시작한다.
• /help: 쓸 수 있는 명령을 보여 준다.

요금제는 구독과 API 두 갈래다

클로드 코드를 쓰는 방법은 크게 두 가지다. 구독에 로그인하면 월정액 안에서 쓰고, API 키나 Console 계정으로 로그인하면 쓴 토큰만큼 낸다. 토큰은 AI가 읽고 쓰는 글자 단위다.

구독 요금은 요금제 페이지에서 2026년 10월 1일에 확인했다.

요금제	월 가격(달러)	클로드 코드	사용량
무료	0	포함 안 됨	기본 수준
프로	20 (연 결제 월 17, 연 200)	포함	무료의 5배(세션당)
맥스	100부터	포함	프로의 5배 또는 20배
팀 스탠더드 좌석	25 (연 결제 20)	포함	좌석별 한도
팀 프리미엄 좌석	125 (연 결제 100)	포함	스탠더드의 5배

표시 가격에는 세금이 빠져 있다. 요금제 전체 비교와 무료 한도는 클로드 요금제 가격 비교 글에 따로 정리했다.

API 방식은 월정액이 없다. 공식 비용 문서에 따르면 기업 도입 사례에서 개발자 한 명이 활성 일 하루에 평균 13달러, 한 달에 150~250달러를 썼다. 90%의 사용자는 하루 30달러 아래였다. 이 값은 개발자 업무 기준 평균이다. 맥피는 가끔 쓰는 마케터에게는 구독이 비용을 예측하기 쉽다고 본다.

사용량 한도는 채팅과 같이 센다

구독으로 쓰면 클로드 코드와 클로드 채팅이 같은 사용량을 나눠 쓴다. Pro·Max 플랜의 클로드 코드 안내가 이를 밝힌다. 낮에 채팅을 많이 하면 코드 작업에 쓸 몫이 줄어든다.

한도 메시지는 두 종류로 읽는다. "session limit"은 5시간 창, "weekly limit"은 주간 창을 다 썼다는 뜻이다. 공식 비용 문서는 이 한도가 모든 모델에 공통이라, /model로 모델을 바꿔도 풀리지 않는다고 설명한다. 다만 "Opus limit"처럼 특정 모델 계열 메시지가 나오면 다른 계열 모델로 바꿔 계속 쓸 수 있다.

한도에 걸렸을 때 선택지는 셋이다.

• 초기화를 기다린다. 메시지에 초기화 시각이 나온다. v2.1.234 이상에서는 초기화 뒤 중단된 작업을 자동으로 이어 가게 할 수 있다.
• 사용량 크레딧을 켠다. /usage-credits를 입력하면 설정 화면이 열린다. 한도를 넘겨 계속 쓰는 대신 추가 요금이 붙는다.
• 상위 요금제로 올린다. 한도에 자주 걸리는 프로 사용자는 맥스를 본다.

내가 얼마나 썼는지는 /usage로 본다. 구독자는 사용량 막대와 스킬·플러그인별 사용 비중이 나온다. 같은 화면의 달러 표시는 API 사용자용 추정치다. 구독자에게는 청구액이 아니다.

같은 요금대의 경쟁 도구와 비교한다

코딩 에이전트는 클로드 코드만 있는 것이 아니다. 같은 월 20달러대에서 고를 수 있는 도구를 공식 페이지 기준으로 놓았다.

도구	입문 요금(월, 달러)	상위 요금(월, 달러)	사용량 기준
클로드 코드	20 (프로)	100부터 (맥스)	5시간 세션, 주간 한도
코덱스	20 (챗GPT 플러스)	100, 200, 500 (프로)	플러스는 5시간당 메시지 수 추정치 제공
제미나이 CLI	0 (구글 계정 무료)	구글 AI 프로·울트라	무료 하루 1,000회, 프로 하루 1,500회, 울트라 하루 2,000회 요청

출처는 OpenAI 코덱스 가격 문서와 제미나이 CLI 쿼터 문서다. 기준일은 2026년 10월 1일이다. 제미나이는 요청 횟수로, 클로드는 사용량 비율로 세므로 한도의 크기를 숫자로 곧바로 비교할 수 없다. 맥피는 이 표에서 한도 크기의 우열을 매기지 않았다. 챗GPT 요금제 쪽은 챗GPT 프로 200달러·500달러 한도 글에 정리했다.

마케터가 클로드 코드로 해 볼 만한 일

클로드 코드의 장점은 파일을 직접 읽고 고친다는 것이다. 채팅처럼 내용을 복사해 붙일 필요가 없다. 아래 예는 공식 문서의 자연어 요청 방식을 마케팅 업무에 옮긴 것이다. 맥피가 직접 실측한 결과는 아니다.

• 광고 리포트 정리: 폴더에 내려받은 CSV를 두고 "캠페인별 노출, 클릭, 비용을 합쳐 표로 만들어 줘"라고 요청한다.
• UTM 링크 점검: 링크 목록 파일에서 소스·매체 철자가 제각각인 행을 찾아 통일해 달라고 한다.
• 콘텐츠 일괄 수정: 블로그 HTML 파일 수십 개의 제목 길이나 이미지 설명 누락을 한 번에 점검하게 한다.

공식 문서는 요청을 구체적으로 쓰라고 권한다. "고쳐 줘"보다 "이 파일의 3열 날짜 형식을 YYYY-MM-DD로 바꿔 줘"가 낫다. 한 번에 큰 일을 시키지 말고 하나씩 확인하며 나아가면 사용량도 아낀다.

맥피는 처음 쓰는 비개발자에게 원본 폴더를 복사해 둔 사본에서 시작하기를 권한다. 공식 빠른 시작 문서에 따르면 v2.1.283 이상에서는 자동 모드가 기본이라 클로드 코드가 대부분의 파일 수정과 명령 실행을 묻지 않고 진행한다. 되돌릴 수 있는 사본에서 일하면 실수해도 부담이 없다. 권한 방식은 Shift+Tab으로 바꾼다.

사용량과 비용을 아끼는 방법

클로드 코드는 요청마다 지금까지의 대화 전체를 함께 보낸다. 몇 시간 켜 둔 세션에서는 짧은 질문 하나도 전체 대화만큼 사용량을 쓴다. 공식 비용 문서가 꼽는 습관은 다음과 같다.

• 다른 일로 넘어갈 때는 /clear로 대화를 비운다.
• 대부분의 작업은 소넷 모델로 충분하다. 어려운 설계에만 오퍼스를 쓰고 /model로 바꾼다.
• 쓰지 않는 MCP 서버(외부 도구를 붙이는 연결)는 /mcp에서 끈다.
• 복잡한 작업은 Shift+Tab으로 계획 모드를 켜서 방향을 먼저 확인한다.
• 쉬었다가 돌아오면 캐시가 끊겨 전체 대화를 다시 읽는다. 구독에서는 이 캐시 유지 시간이 1시간이다.

한국에서 시작할 때 확인할 것

요금제 페이지는 달러로 표시되고 세금이 별도다. 원화 공식 가격표는 요금제 페이지에 없다. 청구액은 환율과 부가세에 따라 달라진다. 환율을 1,400원으로 가정하면 프로 20달러는 세금 전 28,000원이다. 이 값은 산술 예시이며 실제 청구액이 아니다.

해외 결제가 막힌 카드는 구독 결제에서 거절될 수 있다. 결제 전에 카드사 앱에서 해외 결제 설정을 본다. 회사 노트북에 설치한다면 보안 정책으로 설치 명령이 막힐 수 있으니 IT 담당자에게 먼저 묻는다.

자주 하는 실수

• 무료 계정으로 로그인을 시도한다. 무료 요금제에는 클로드 코드가 포함되지 않는다.
• 컴퓨터에 ANTHROPIC_API_KEY를 설정해 둔 채 쓴다. 공식 안내에 따르면 이 키가 있으면 구독 대신 API 사용 요금이 청구된다.
• /usage의 달러 표시를 청구액으로 읽는다. 구독자에게는 해당하지 않는 추정치다.
• 한 대화를 며칠씩 이어 쓴다. 대화가 길수록 한 번 물을 때마다 쓰는 사용량이 커진다.
• 한도에 걸렸을 때 모델만 바꾼다. 세션·주간 한도는 모델을 바꿔도 그대로다.

시작하는 순서

1. 프로 월 결제로 시작한다. 연 결제는 한 달 써 보고 정한다.
2. 설치 후 연습용 폴더에서 폴더 설명을 묻는 질문부터 해 본다.
3. 일주일 쓰면서 /usage로 한도에 얼마나 가까운지 본다. 자주 걸리면 맥스를 검토한다.

요금과 한도는 바뀔 수 있으니 결제 전에 요금제 페이지를 한 번 더 연다.

자주 묻는 질문

클로드 코드는 무료로 쓸 수 있나?
무료 claude.ai 계정으로는 쓸 수 없다. 프로 이상 구독이나 Console(API) 계정이 필요하다.

개발자가 아니어도 쓸 수 있나?
쓸 수 있다. 폴더 안 파일을 읽고 고치는 자연어 요청이면 된다. 터미널이 부담스러우면 데스크톱 앱을 쓴다.

클로드 채팅과 한도를 따로 쓰나?
아니다. 구독에서는 클로드와 클로드 코드가 같은 사용량을 나눠 쓴다.

한도를 넘으면 자동으로 과금되나?
사용자가 직접 켜야 한다. 한도에 걸리면 사용량 크레딧을 켜라는 안내가 나오고, /usage-credits로 설정 화면을 열 수 있다.

업데이트는 어떻게 하나?
공식 설치 스크립트로 깐 경우 백그라운드에서 자동으로 업데이트된다. Homebrew와 WinGet은 직접 업그레이드 명령을 실행한다.

공식 근거 링크

• 설치와 첫 실행: Claude Code 빠른 시작, 고급 설정
• 요금: Claude 요금제 페이지
• 사용량·비용: Manage costs effectively, Pro·Max 플랜에서 클로드 코드 쓰기
• 경쟁 도구: 코덱스 가격, 제미나이 CLI 쿼터

공식 근거 확인: 2026년 10월 1일. 환율 예시는 산술 설명이며 실제 청구 자료가 아니다. 마케팅 활용 예는 공식 문서의 요청 방식을 옮긴 추정이다. 그림은 생성 일러스트이며 실제 제품 화면이 아니다.