최근 여러 커뮤니티에서 "클로드 코드로 코딩 부업 세팅하기"가 화제입니다. 다만 화제가 된 글의 구체적인 결과는 개인차가 크고 검증하기도 어렵습니다. 이 글은 그 반응 뒤에 있는 진짜 질문 — "그래서 클로드 코드를 어떻게 설치하고, 어떤 요금제로, 어떻게 실전 코딩에 써야 하는가" — 를 공식 문서(code.claude.com, support.claude.com)에서 확인된 내용만으로 정리합니다. 설치부터 첫 세션, 비용 관리까지 따라 하면 30~40분이면 기본 세팅을 마칠 수 있습니다.
🟢 현행 모델 라인업 일치 · 모델 안내 · Fable 구독 안내
Fable 5·5.1 구독 안내(2026년 9월 7일 갱신): 2026년 9월 1일 출시된 Claude Fable 5.1이 현행 Fable 모델이고, Fable 5는 레거시로 전환됐습니다. 구독 조건은 두 모델이 같습니다 — Max·Team Premium 플랜은 주간 사용 한도의 50% 범위에서 포함되고, Pro·Team Standard 플랜은 사용량 크레딧(입력 100만 토큰당
이 글로 할 수 있게 되는 것
이 글을 따라 하면 클로드 코드(Claude Code — 터미널에서 자연어로 코딩을 돕는 Anthropic의 공식 CLI 도구)를 설치하고, 로그인해서 첫 세션을 열고, 프로젝트 맥락을 잡아주는 CLAUDE.md 파일을 준비하고, 요금제별 비용 구조를 이해한 상태에서 실제 코딩 작업을 시작할 수 있습니다. 처음 설치부터 첫 코드 수정까지는 대략 30~40분이면 충분합니다.
주의할 점 하나만 먼저 말씀드립니다. "세팅"은 도구를 준비하는 과정일 뿐입니다. 이 도구로 외주·사이드 프로젝트·자동화 스크립트 판매 등에서 실제로 얼마를 버는지는 개인의 실력, 시간 투자, 시장 상황에 따라 크게 달라집니다. 이 글은 특정 수익을 보장하지 않으며, "도구를 제대로 세팅하는 방법"에만 집중합니다.
시작 전 준비물
- 터미널(명령줄 창)을 열 수 있는 컴퓨터 — macOS, Linux, Windows(WSL 포함) 모두 지원됩니다. 터미널을 한 번도 안 써봤다면 공식 문서의 터미널 가이드를 먼저 참고하는 것이 좋습니다.
- 클로드 유료 구독(Pro·Max·Team·Enterprise) 또는 Claude Console(API 종량제) 계정 — 클로드 코드는 무료 플랜(Free)으로는 이용할 수 없습니다. 공식 시작 가이드에 필요 계정으로 Pro·Max·Team·Enterprise 구독이나 Claude Console 계정이 명시되어 있고, Free는 포함되어 있지 않습니다. 최소 Pro(월 20달러)부터 시작하면 됩니다.
- 작업할 코드 프로젝트 폴더 — 새 프로젝트도 되고 기존 프로젝트도 됩니다.
용어 빠른 풀이
- CLI(Command Line Interface) — 터미널에서 글자 명령으로 실행하는 프로그램. 클로드 코드는 마우스로 클릭하는 앱이 아니라 터미널에 명령을 입력해 쓰는 CLI 도구입니다.
- 토큰(token) — AI가 글을 처리하는 최소 단위. 클로드 코드의 API 종량제 비용은 이 토큰 사용량에 따라 매겨집니다. 구독제(Pro·Max)는 월정액 안에서 쓰는 것이라 토큰 단가를 직접 신경 쓸 필요는 적습니다.
- CLAUDE.md — 프로젝트 맥락을 담아두는 안내 파일. 세션을 시작할 때마다 자동으로 읽혀서, 매번 같은 설명을 반복하지 않아도 되게 해줍니다.
- MCP(Model Context Protocol) — 외부 도구·서비스 연결 규약. 깃허브, 데이터베이스 등 외부 시스템을 클로드 코드와 연결할 때 쓰입니다.
- 서브에이전트(subagent) — 특정 작업만 맡아 처리하는 보조 클로드 인스턴스. 테스트 실행이나 로그 분석처럼 결과만 필요한 잡무를 분리해서 맡길 수 있습니다.
- 플랜 모드(plan mode) — 코드를 바로 고치지 않고 계획부터 세우는 모드. 복잡한 작업 전에 방향을 확인받아 헛수고를 줄여줍니다.
1단계: 설치하기
운영체제에 맞는 명령어를 터미널에 입력하면 됩니다. 공식 문서에는 아래 방법들이 안내되어 있습니다.
| 환경 | 설치 명령어 | 비고 |
|---|---|---|
| macOS·Linux·WSL | | 공식 권장 방법. 백그라운드에서 자동 업데이트됩니다. |
| Windows PowerShell | | 프롬프트가 PS C:\로 시작하면 PowerShell입니다. |
| Windows CMD | | 프롬프트가 C:\(PS 없이)로 시작하면 CMD입니다. |
| macOS(Homebrew) | | 자동 업데이트되지 않으므로 brew upgrade claude-code로 직접 갱신해야 합니다. |
| Windows(WinGet) | | 이 역시 자동 업데이트되지 않습니다. |
Debian·Fedora·RHEL·Alpine 계열 리눅스는 각 배포판의 패키지 매니저(apt·dnf·apk)로도 설치할 수 있다고 공식 문서에 안내되어 있습니다. 설치 후 터미널에 claude --version을 입력했을 때 버전 번호와 함께 "(Claude Code)"라는 문구가 뜨면 설치 성공입니다.
2단계: 로그인하고 첫 세션 열기
터미널에서 claude만 입력하면 로그인 절차가 자동으로 시작됩니다.
claude브라우저가 열리면 안내에 따라 로그인을 완료하세요. 이후 계정을 바꾸고 싶으면 세션 안에서 /login을 입력하면 됩니다. 로그인이 끝나면 현재 버전·모델·작업 폴더가 표시된 프롬프트가 나타납니다. 이 화면이 뜨면 로그인 성공입니다.
Pro·Max·Team 플랜은 2026년 8월 14일부터 새 세션이 "auto 모드"로 시작합니다. 이 모드에서는 분류기(작업 위험도를 판단하는 별도 모델)가 승인을 대신해, 위험해 보이는 작업만 걸러내고 나머지 파일 편집·명령 실행은 묻지 않고 진행합니다. 다만 ~/.claude/settings.json에 기본 모드를 직접 지정해 뒀다면 그 설정이 유지되고, 조직이 관리 설정으로 배포한 기본값도 바뀌지 않습니다. Enterprise 플랜과 Claude API 경유 사용은 이 글 작성 시점 기준 auto 모드가 선택 사항이라 매번 승인을 묻는 "Manual 모드"로 시작합니다. Shift+Tab을 누르면 원하는 모드가 상태 표시줄에 표시될 때까지 전환할 수 있습니다.
주의: auto 모드는 편리하지만, 실제 클라이언트 코드나 운영 중인 프로젝트에서는 작업 후 git status·git diff로 변경 내용을 꼭 확인하는 습관을 들이세요. 커밋 전 검토를 건너뛰면 원치 않는 변경이 그대로 반영될 수 있습니다.
3단계: CLAUDE.md로 프로젝트 맥락 잡기
CLAUDE.md는 프로젝트 폴더에 두는 안내 파일로, 세션을 시작할 때마다 자동으로 읽힙니다. 프로젝트 성격, 코딩 규칙, 자주 쓰는 명령어 등을 적어두면 매번 같은 설명을 반복하지 않아도 됩니다. 클로드에게 "이 프로젝트를 분석해서 CLAUDE.md 파일을 만들어줘"라고 자연어로 요청하면 프로젝트 구조를 살펴본 뒤 초안을 제안해 줍니다. 공식 문서는 CLAUDE.md를 200줄 이내로 유지하고 핵심만 담을 것을 권장합니다 — 너무 길면 매 세션마다 불필요한 내용까지 맥락에 실려 비용이 늘어나기 때문입니다.
4단계: 실전 코딩 워크플로 익히기
기본 세팅이 끝나면 자연어로 작업을 요청하면 됩니다. 자주 쓰게 될 명령어는 다음과 같습니다.
| 명령어 | 기능 |
|---|---|
claude | 대화형 세션 시작 |
claude "작업 내용" | 초기 요청과 함께 세션 시작 |
claude -p "질문" | 한 번만 물어보고 바로 종료 |
claude -c | 현재 폴더의 최근 대화 이어가기 |
claude -r | 이전 대화 목록에서 골라 재개 |
/clear (세션 내) | 대화 기록 초기화, 비용 절약에 중요 |
/help (세션 내) | 사용 가능한 명령어 목록 |
실제 작업 흐름은 보통 이렇습니다. "이 프로젝트는 뭘 하는 앱이야?"처럼 코드베이스를 먼저 파악하게 하고 → "로그인 폼에 입력값 검증을 추가해줘"처럼 구체적으로 요청하고 → 변경된 코드를 검토하고 → "테스트를 실행해줘", "변경사항을 커밋해줘"로 마무리하는 순서입니다. 공식 문서는 "이 버그 고쳐줘"보다 "로그인 후 빈 화면이 뜨는 버그를 고쳐줘"처럼 구체적으로 요청할 것을 권장합니다. 요청이 구체적일수록 클로드가 불필요한 파일을 뒤지지 않아 속도도 빠르고 비용도 줄어듭니다.
비용까지 관리하는 법: 요금제 선택과 절약 습관
부업·사이드 프로젝트로 쓴다면 비용 관리가 핵심입니다. 결론부터 말하면, 구독제(Pro·Max)로 시작해 한도에 자주 걸릴 때 상위 플랜으로 올리는 방식이 개인 사용자에게 가장 예측 가능합니다.
- Pro(월 20달러) — 5시간마다 초기화되는 세션 한도 안에서 사용합니다. 처음 써보기에 적당합니다.
- Max 5x(월 100달러)·Max 20x(월 200달러) — 각각 Pro 대비 세션당 사용량이 5배·20배로 늘어납니다. 세션 한도 외에 매주 정해진 시각에 초기화되는 주간 한도도 별도로 적용됩니다.
- Claude Console(API 종량제) — 사용한 토큰만큼 과금됩니다. 공식 문서에 따르면 기업 도입 사례 기준 평균 개발자 1인당 활성일 기준 약 13달러, 월 150~250달러 정도가 든다고 하며 사용자의 90%는 활성일당 30달러 미만이었습니다. 다만 이 수치는 종량제 기준이고, 구독제(Pro·Max)는 정액 요금 안에서 쓰는 것이라 이 금액이 그대로 적용되지는 않습니다.
참고로 2026년 8월 31일(태평양 시간 기준)까지 Pro·Max·Team 플랜 대상으로 클로드 코드 주간 사용 한도를 50% 늘려주는 프로모션이 진행 중입니다. 이 프로모션은 여러 차례 연장된 이력이 있어 종료 여부는 공식 사용량 한도 가이드와 관련 소식에서 다시 확인하는 것이 안전합니다.
공식 문서가 권장하는 절약 습관은 다섯 가지입니다. ① 모델 선택 — 대부분의 코딩 작업은 Sonnet으로 충분하고 Opus보다 비용이 적으니, 복잡한 설계 판단이 필요할 때만 Opus로 바꿉니다(/model). ② 컨텍스트 정리 — 관련 없는 새 작업으로 넘어갈 때 /clear로 대화 기록을 비우면 불필요한 과거 맥락에 비용을 쓰지 않습니다. ③ MCP 서버 최소화 — /mcp로 연결된 외부 도구 목록을 확인하고 안 쓰는 서버는 꺼둡니다. ④ 서브에이전트에 위임 — 테스트 실행이나 로그 분석처럼 결과물만 필요한 작업은 서브에이전트에 맡겨 장황한 출력이 메인 대화에 쌓이지 않게 합니다. ⑤ 플랜 모드 활용 — 복잡한 작업 전에 Shift+Tab으로 플랜 모드로 바꾸면 클로드가 먼저 방향을 제안하고, 방향이 틀렸을 때 드는 재작업 비용을 줄여줍니다.
자주 막히는 지점과 해결
- Windows에서 "The token '&&' is not a valid statement separator" 오류 — PowerShell 창에서 CMD용 명령어를 실행했을 때 나오는 오류입니다. 프롬프트가
PS C:\로 시작하면 PowerShell용 명령어(irm ... | iex)를 써야 합니다. - "'irm' is not recognized as an internal or external command" 오류 — 반대로 CMD 창에서 PowerShell용 명령어를 실행한 경우입니다. 프롬프트가
PS없이C:\로만 시작하면 CMD이므로 CMD용 명령어를 써야 합니다. - 설치 후
claude --version이 안 먹히는 경우 — 터미널을 완전히 새로 열어 PATH가 갱신됐는지 확인하세요. - "You've hit your weekly limit" 같은 한도 메시지 — 화면에 표시되는 초기화 시각을 확인하고, 그 전에 계속 작업해야 한다면 세션 안에서
/usage-credits를 실행해 추가 사용량(크레딧)을 요청할 수 있습니다. 일부 버전에서는 한도가 풀릴 때까지 자동으로 기다렸다가 하던 작업을 이어가는 기능도 있습니다. - 사용량이 예상보다 빨리 줄어드는 경우 — 세션을 오래 켜둔 채 방치했거나, 오래 쉬었다가 다시 물어봐서 캐시가 만료됐거나(정기적으로 쉬는 텀이 길면 매번 전체 맥락을 다시 처리), Opus를 기본 모델로 계속 쓰고 있는 경우가 흔한 원인입니다. 세션 안에서
/usage를 입력하면 최근 사용 내역과 원인 힌트를 확인할 수 있습니다.
응용 및 다음 단계
기본 세팅에 익숙해졌다면 다음을 시도해 볼 만합니다. 반복되는 특정 작업(PR 리뷰, DB 마이그레이션 점검 등)이 있다면 CLAUDE.md에 다 적어두지 말고 스킬(skill)로 분리해 필요할 때만 불러오게 하면 기본 맥락이 가벼워집니다. 여러 파일을 동시에 건드리는 큰 작업은 서브에이전트나 플랜 모드를 적극 활용하면 재작업을 줄일 수 있습니다. 요금제나 사용 한도 전반은 사용량 한도 가이드를 참고하세요.
자주 묻는 질문
Q. 클로드 코드는 무료로 쓸 수 있나요?
아니요, 별도의 무료 등급은 없습니다. 공식 시작 가이드에 안내된 필요 계정은 Pro·Max·Team·Enterprise 구독이거나 Claude Console(API 종량제) 계정이며, Free 플랜은 포함되어 있지 않습니다. 개인이 처음 써본다면 Pro(월 20달러)부터 시작하는 것이 일반적입니다.
Q. npm으로 설치해도 되나요?
공식 시작 가이드(quickstart)에는 현재 macOS·Linux·WSL용 curl 스크립트, Windows용 PowerShell·WinGet, macOS용 Homebrew만 안내되어 있고 npm 설치 방법은 나와 있지 않습니다. 새로 설치한다면 이 문서에 안내된 방법을 그대로 따르는 것이 안전합니다.
Q. 사용량 한도에 걸리면 바로 못 쓰게 되나요?
아니요, 정해진 시각에 자동으로 초기화됩니다. 급하게 계속 써야 한다면 세션 안에서 /usage-credits로 추가 사용량을 요청할 수 있고, 화면에 안내되는 초기화 시각까지 기다렸다가 이어갈 수도 있습니다.
Q. 이 세팅만 하면 코딩으로 바로 수익을 낼 수 있나요?
세팅 자체가 수익을 보장하지는 않습니다. 클로드 코드는 코딩 작업을 도와주는 도구이고, 실제 결과는 무엇을 만들지, 얼마나 시간을 투자하는지, 시장 수요가 있는지에 따라 사람마다 다릅니다. 이 글은 도구를 제대로 준비하는 방법까지만 안내합니다.