클로드 코드 처음이라면 설치 전 확인할 5가지, 무료 플랜은 안 됩니다 (2026)
클로드 코드는 무료 claude.ai 계정으로는 쓸 수 없어요. 일반 claude.ai 계정이라면 Pro 월 $20(연간 결제 시 월 $17 상당) 이상 구독이 있어야 하고(Console API 계정은 예외), 이걸 모른 채 설치부터 하면 로그인 단계에서 멈춰요. 명령어를 치기 전에 요금제·컴퓨터·기존 설치·환경변수·화면(터미널이냐 앱이냐) 다섯 가지만 3분 점검하면 중간에 막힐 일이 확 줄어요.
1. 요금제부터, 무료 계정이면 설치해도 못 써요
공식 문서는 Claude Code를 쓰려면 Pro, Max, Team, Enterprise 또는 Console(API) 계정이 있어야 한다고 적어요. 무료 claude.ai 플랜에는 Claude Code 접근이 포함되지 않아요. 요금 페이지를 봐도 Free 칸에는 Claude Code가 빠져 있고 Opus 모델도 못 써요. 로그인 뒤에 구독이 없다는 안내(영문으로 ‘No subscription found’ 같은 문구로 보고되는 경우가 있어요)나 업그레이드 안내가 뜨는 게 이 때문이에요. 문구는 버전마다 다를 수 있으니, 비슷한 안내가 보이면 일단 설치가 아니라 요금제 문제로 보세요.
이 글을 쓰려고 설치 안내 글 세 편을 공식 문서와 대조해 봤는데, 세 편 모두 무료 불가는 적어 두었지만, 이미 npm으로 깔아 둔 사람의 정리법은 어느 쪽에도 없었고, ANTHROPIC_API_KEY가 남아 있으면 구독 대신 그 키가 쓰인다는 함정도 짚은 글이 없었어요. 한 편은 Node.js 요구 버전도 옛 기준이었고요. 그래서 이 글은 순서를 뒤집어 요금제를 맨 앞에 놓았어요.
| 플랜 | 월 고정비(USD) | 12개월 환산 | Claude Code | 메모 |
|---|---|---|---|---|
| Free | $0 | $0 | 포함 안 됨 | 설치해도 못 씀, Opus도 불가 |
| Pro | $20 (연간 결제 시 월 $17 상당) | $240, 연간 결제는 $200 일시불 | 포함 | 입문 시작점 |
| Max 5x | $100 | $1,200 | 포함 | Pro 대비 세션당 사용량 5배, 월 결제만 |
| Max 20x | $200 | $2,400 | 포함 | Pro 대비 20배 |
금액은 달러 기준이고, 한국에서 결제할 때 보이는 원화 금액이나 부가세는 제가 확인하지 못했어요. 지역에 따라 표시가 다를 수 있으니 결제 화면의 숫자를 최종으로 보세요. 12개월 환산은 단순 곱셈이라, 연간 결제를 고르면 Pro가 $240에서 $200으로 $40 줄어드는 셈이에요.
Pro와 Max에는 5시간 단위 세션 한도와 주간 한도가 있어요. 이 한도는 claude.ai 채팅과 Claude Code가 함께 써요. 채팅을 많이 하는 날은 코드 쪽 여유도 그만큼 줄어든다는 뜻이에요. 한도에 닿으면 ‘You’ve hit your session limit’ 또는 ‘weekly limit’ 메시지와 초기화 시각이 뜨고, 터미널에서 /usage를 치면 사용량 막대를 볼 수 있어요. 한도를 넘겨 쓰고 싶다면 usage credits(/usage-credits)를 켜야 해요. 몇 번까지 쓸 수 있는지는 공식 출처가 숫자로 못박지 않아서, 이 글에서도 “하루 몇 건”이라고 적지 않을게요.
제 판단은 이래요. 처음이라면 Pro 월 결제로 시작하는 게 부담이 적고, 한 달 써 보고 한도 메시지를 자주 보게 될 때 Max 5x를 보는 게 순서예요. 도구끼리 가격을 따져 보고 싶다면 앞서 쓴 코파일럿·커서·클로드 코드 요금제 개편 비교 글이 더 맞아요.
2. 내 컴퓨터가 되는지, 터미널은 어디서 여는지
요금제가 해결되면 다음은 컴퓨터예요. 맥을 오래 쓰신 분은 한 번 볼 가치가 있어요. macOS 13.0 미만이면 설치 중에 ‘built for Mac OS X 13.0’ 계열의 dyld 오류가 나요. 요금제 문제와 헷갈려 원인을 찾느라 시간을 쓰기 쉬운 함정이에요.
| 항목 | 최소 조건 | 확인하는 곳 |
|---|---|---|
| 맥 | macOS 13.0 이상 | 화면 왼쪽 위 애플 메뉴 > 이 Mac에 관하여 |
| 윈도우 | Windows 10 1809 이상 (Windows Server 2019+) | Win+R 누르고 winver 입력 |
| 리눅스 | Ubuntu 20.04+ · Debian 10+ · Alpine 3.19+ | 배포판 버전 확인 |
| 공통 | RAM 4GB 이상, x64 또는 ARM64, 인터넷 연결 필수 | 설정의 시스템 정보 |
터미널을 한 번도 안 열어 보셨어도 괜찮아요.
맥은 Cmd+Space를 눌러 검색창에 Terminal을 치고 엔터, 윈도우는 Win+X를 눌러 PowerShell을 고르면 돼요. 여기서 윈도우 사용자가 가장 자주 헷갈리는 게 PowerShell과 CMD(명령 프롬프트)의 구분이에요. 줄이 ‘PS C:\’로 시작하면 PowerShell이고 ‘C:\’만 있으면 CMD인데, 공식 설치 명령은 PowerShell용이라 CMD에 붙여 넣으면 ‘irm is not recognized’가 떠요. CMD용 명령도 따로 있지만 처음엔 PowerShell이 덜 헷갈려요. 흔한 첫 오류예요.
윈도우에서 Git for Windows는 필수가 아니에요. 없으면 Claude Code가 PowerShell로 셸 명령을 실행하고, 있으면 Git Bash를 써요. 개발자 PC가 아니라면 굳이 먼저 깔 필요가 없어요.
3. 터미널이 싫으면 앱으로, 아니면 네이티브 설치로
설치 방법은 여러 개처럼 보이지만 비개발자에게 고를 지점은 사실 둘이에요. 하나는 터미널 없이 마우스로 쓰는 Claude 데스크톱 앱(맥·윈도우)의 Code 탭이고, 다른 하나는 공식 권장인 네이티브 설치예요. 앱에는 Claude Code가 들어 있어서 Node.js나 CLI를 따로 깔 필요가 없어요. 다만 Code 탭도 Pro·Max·Team·Enterprise 구독이 필요하고, 무료 계정이면 업그레이드 안내가 떠요. 앱이라고 요금제 문턱이 낮아지는 건 아니에요.
네이티브 설치는 맥·리눅스에서는 curl 한 줄, 윈도우에서는 PowerShell의 irm 한 줄이고 Node.js가 필요 없어요. 명령어 자체는 이 글에 옮겨 적지 않을게요. 공식 설치 페이지(code.claude.com/docs/en/setup)에서 그대로 복사하는 게 안전해서예요. 설치가 끝나면 새 터미널 창을 열고 claude –version을 쳐서 버전이 나오면 성공이에요. 네이티브는 백그라운드에서 자동 업데이트가 되는 것도 장점이에요.
| 방식 | 필요 조건 | 자동 업데이트 | 이럴 때 |
|---|---|---|---|
| 데스크톱 앱 Code 탭 | 구독, 앱 설치(Node.js 불필요) | 앱 기준 | 터미널이 부담스러울 때 |
| 네이티브 설치 | 구독, 명령 한 줄 | 됨 | 공식 권장, 대부분 여기 |
| npm 설치 | Node.js 22 이상 | 쓰기 권한이 있으면 됨, 권한 오류면 안 됨(그때는 네이티브로 전환) | 이미 npm 환경이 있는 개발자 |
| Homebrew·WinGet·apt | 각 패키지 관리자 | 안 됨, upgrade 명령을 직접 | 패키지 관리자로 통일하고 싶을 때 |
인터넷에 도는 일부 입문 글은 아직 Node.js 18 이상이라고 적는데, 지금 공식 기준은 22 이상이에요. npm 방식은 네이티브와 같은 바이너리를 내려받아서 기능 차이가 없고, 공식 문서는 sudo npm install -g를 쓰지 말라고 경고해요. 권한 오류가 나는 npm 사용자에게도 네이티브로 갈아타라고 안내하고요. 윈도우에서 npm 방식은 ‘running scripts is disabled’라는 스크립트 실행 정책 오류에 막힐 수도 있어요.
내 상황에서 어디로 가면 되는지는 아래 판정표를 따라가 보세요.
| 내 상황 | 가는 곳 |
|---|---|
| 무료 계정이다 | 설치 보류, 1번으로 돌아가 구독부터 |
| 구독 있음 + 터미널이 낯설다 | 데스크톱 앱 Code 탭 |
| 구독 있음 + 터미널 괜찮다 + 처음 설치 | 네이티브 설치 |
| 예전에 npm이나 옛 방식으로 깔았다 | 4번 3줄 점검부터 |
| API 키를 만든 적이 있다 | 5번 환경변수 점검부터 |
| 맥 12 이하 · 윈도우 1809 미만 | OS 업데이트 먼저, 어렵다면 다른 PC |
저라면 터미널을 한 번도 안 열어 본 분께는 앱으로 감을 잡고, 터미널이 필요해질 때 네이티브를 추가하는 순서를 권해요. 터미널 쪽으로 넘어갈 때는 4번 점검을 한 번 거치고요.
4. 예전에 npm으로 깔았다면 3줄 점검부터
클로드 코드는 처음엔 npm으로 설치하는 도구였어요. 그때 깔아 두고 잊은 분, 옛 버전이 만든 ~/.claude/local 폴더가 남은 분, Homebrew로 한 번 깔았다가 네이티브를 또 얹은 분은 설치가 둘 이상 겹쳐 있을 수 있어요. 겹치면 버전이 안 맞거나 엉뚱한 쪽이 실행돼서 오작동해요. 공식 문서의 처방은 단순해요. 하나만 남기고, 남긴다면 네이티브예요.
맥·리눅스에서는 아래 세 줄을 터미널에 하나씩 쳐 보세요. 아무것도 안 깔았다면 대부분 ‘없다’는 답이 나와요.
which -a claude
ls -la ~/.claude/local/
npm -g ls @anthropic-ai/claude-code윈도우(PowerShell)는 where.exe claude 와 Test-Path “$env:USERPROFILE\.local\bin\claude.exe” 로 확인해요. 네이티브가 놓이는 자리는 맥·리눅스는 ~/.local/bin/claude, 윈도우는 사용자 폴더의 .local\bin\claude.exe예요. 결과를 읽는 법은 아래와 같아요.
| 점검 결과 | 뜻 | 할 일 |
|---|---|---|
| which -a claude가 한 줄, ~/.local/bin/claude | 네이티브 하나뿐, 정상 | 없음 |
| which -a claude가 두 줄 이상 | 설치가 겹침 | 아래 두 줄 중 해당하는 걸 지우고 하나만 남김 |
| ~/.claude/local/ 폴더가 보임 | 옛 버전이 만든 로컬 설치 | rm -rf ~/.claude/local |
| npm -g ls에 claude-code가 나옴 | npm 전역 설치가 있음 | npm uninstall -g @anthropic-ai/claude-code |
| Homebrew·WinGet·apt로 깔았음 | 자동 업데이트 안 됨 | 그 도구로 지우고 네이티브로 통일하거나, upgrade를 직접 |
rm -rf는 되돌릴 수 없는 삭제 명령이라 경로를 한 글자도 바꾸지 말고, 바로 위 ls로 폴더가 실제로 있는지 본 다음에 치세요. 정리를 마쳤다면 새 터미널을 열어 which -a claude를 다시 쳐서 한 줄만 남았는지 확인하면 끝나요.
5. 로그인할 때 API 키가 남아 있으면 요금이 따로 붙어요
이 함정은 설치 글에서 거의 안 다뤄요. 환경변수 ANTHROPIC_API_KEY가 컴퓨터에 설정돼 있고 Claude Code가 그 키를 쓸지 묻는 승인에 ‘예’를 누르면, 구독 대신 그 API 키로 인증해요. 그러면 구독에 포함된 사용량이 아니라 API 사용료가 별도로 붙어요. 예전에 다른 프로그램을 쓰려고 API 키를 넣어 둔 분이나, 개발 책을 따라 하다 환경변수를 등록한 분이 해당돼요. 반대로 키가 만료됐거나 비활성 조직의 것이라면 로그인이 실패해요.
먼저 키가 있는지부터 봐요. 아래는 공식 명령이 아니라 제가 키 내용이 화면에 찍히지 않도록 만든 확인용 한 줄이에요.
# 맥·리눅스
[ -n "$ANTHROPIC_API_KEY" ] && echo "키 있음" || echo "키 없음"
# 윈도우 PowerShell
if ($env:ANTHROPIC_API_KEY) { "키 있음" } else { "키 없음" }‘키 있음’이 나왔고 구독으로 쓰고 싶다면 unset ANTHROPIC_API_KEY로 지우고, Claude Code 안에서 /status를 쳐서 어느 인증이 켜졌는지 확인하세요. 한 가지 더 있어요. unset은 지금 열린 터미널 창에만 먹혀요. .zshrc 같은 설정 파일에 export 줄이 적혀 있다면 새 터미널을 열 때마다 키가 되살아나니, 그 줄도 지워야 해요. 윈도우는 환경 변수 설정 화면에서 같은 이름을 삭제하면 돼요.
차이는 단순해요. 구독은 월 고정비, API 키는 쓴 만큼 내는 종량제예요.
비개발자가 처음 쓰는 단계에서는 예측 가능한 쪽이 구독이라고 저는 봐요. 청구서가 달마다 얼마일지 모르는 상태로 시작할 이유가 없거든요. API 키를 일부러 쓰려는 분이라면 괜찮지만, 모르고 켜진 상태가 문제예요.
그래도 막힐 때, 증상별 원인과 첫 실행 순서
점검을 다 했는데도 막힌다면 아래 표에서 화면에 뜬 문구와 같은 줄을 찾으세요. 흔한 막힘은 거의 이 안에 있어요.
| 증상 | 원인 | 해결 |
|---|---|---|
| command not found: claude | 설치 폴더가 PATH에 없음 | 맥(zsh): echo ‘export PATH=”$HOME/.local/bin:$PATH”‘ >> ~/.zshrc 후 source ~/.zshrc. 윈도우: 사용자 PATH에 %USERPROFILE%\.local\bin 추가 후 새 창 |
| irm is not recognized | CMD에서 PowerShell 명령을 실행 | Win+X로 PowerShell을 열어 다시 실행 |
| built for Mac OS X 13.0 (dyld 오류) | macOS 13.0 미만 | macOS 업데이트, 불가하면 다른 기기 |
| 구독 없음·업그레이드 안내 | 무료 플랜 계정으로 로그인 | Pro 이상 구독 후 다시 로그인 |
| 인증 충돌·인증 실패 | ANTHROPIC_API_KEY가 살아 있거나 만료됨 | 5번 점검, unset 후 /status |
| 설치 스크립트 대신 HTML, ‘App unavailable in region’ | 지원 국가 밖 | 설치를 진행할 수 없음 |
| running scripts is disabled | 윈도우 스크립트 실행 정책 (npm 방식) | 네이티브 설치로 전환 |
첫 실행은 이 순서가 가장 덜 헤매요. 중요한 파일이 없는 연습 폴더를 하나 만들고, 터미널에서 그 폴더로 이동한 뒤 claude를 입력하세요. 처음엔 브라우저가 열려 로그인을 요구해요. 로그인이 끝나면 /status로 인증이 구독인지 확인하고, 첫 질문은 “이 폴더에 뭐가 있는지 알려줘”처럼 파일을 건드리지 않는 질문으로 시작하세요. 지우거나 고치는 일은 그다음이에요.
설치와 로그인이 끝나 클로드 코드를 쓰는 사람의 다음 단계가 궁금하다면, 전에 정리한 AGENTS.md와 CLAUDE.md를 함께 쓰는 법 글로 이어가면 돼요.
오늘 할 일은 세 가지예요. 내 플랜이 Free인지 Pro 이상인지부터 확인하고, 터미널에서 which -a claude 한 줄(윈도우는 where.exe claude)로 이미 깔린 게 있는지 보고, 마지막으로 API 키 확인 한 줄을 돌려 보세요. 셋 다 3분이면 끝나요. 저는 처음 도구를 쓸 때 명령어를 빨리 치는 것보다 이 세 가지를 먼저 보는 쪽이 결국 시간을 아낀다고 생각해요. 무료로 한번 설치만 해 보자는 마음이 드는 건 이해하지만, 무료 claude.ai 계정으로는 설치해도 쓸 수가 없다는 걸 기억해 두세요.
대표 이미지: Unsplash / Vishnu Kalanad
