클로드 코드 세팅하기 — 한 페이지 요약

01왜 클로드 코드인가?

초창기 AI 코딩의 한계 — 맥락 부재, 파편화된 워크플로, 끊임없는 마이크로매니지먼트, 수동적 실행 — 을 극복하며 AI는 자동 완성 보조 도구에서 능동적 파트너인 에이전틱 AI로 진화했다. 클로드 코드는 Claude Opus 4 기반으로 터미널에서 실행되는 에이전틱 도구로, 자연어 요청만으로 계획 수립·파일 탐색·코딩·테스트를 자율 수행한다.

클로드 코드의 4단계 워크플로

01

프로젝트 분석

코드베이스·프레임워크·컨벤션 파악

→

02

작업 계획 수립

컴포넌트·구현 순서·종속성 결정

→

03

실행

파일 생성·코드 작성·패키지 설치

→

04

검증 및 개선

테스트·오류 자동 수정

커서(Cursor)와의 차이

성능 우위 — 같은 Sonnet·Opus 모델을 써도 에이전틱 워크플로 최적화 덕에 체감 성능이 압도적
터미널 기반 — 기존 IDE(IntelliJ 등)를 유지하면서 사용 가능, 새 도구 적응 부담 없음
강력한 플래닝 모드 — 스스로 상세 계획을 세워 한 번에 완성도 높은 코드 생성
비용 — 클로드 코드가 더 비싸지만, 커서에서 Opus를 쓰려면 API 방식뿐이라 오히려 부담이 큼

02요금제 알아보기

클로드와 클로드 코드는 요금제를 공유한다. 클로드 유료 구독 시 클로드 코드는 추가 과금 없이 사용. 단, 클로드 코드는 무료 티어로 사용 불가(Pro 이상 필요).

플랜	핵심
Free	체험용. 매일 한도 초기화
Pro $17/월	Free 대비 약 5배. 클로드 코드 사용 가능, 프로젝트·구글 연동·리서치. 5시간당 약 45개 메시지
Max $100	Pro의 약 5배. 단일 프로젝트 개발에 추천
Max $200	Pro의 약 20배. 여러 에이전트·프로젝트 병렬 작업에 추천
API	사용한 만큼 과금. 매일 개발 시 비효율적

한도 리셋: Pro·Max 모두 5시간마다 초기화. Max는 월 50세션 제한(약한 규칙). Opus 모델은 토큰을 5배 더 소비.

02

어떤 플랜을 써야 할까?

입문자 → Pro 플랜으로 저렴하게 워크플로 적합성 확인
진지한 에이전틱 코딩 → 무조건 Max 플랜 (사용량 = Opus 품질)
단일 프로젝트 → Max $100
병렬 다중 작업/프로젝트 → Max $200

API 요금 (참고)

모델	입력	출력
Opus 4	$15/MTok	$75/MTok
Sonnet 4	$3/MTok	$15/MTok
Haiku 3.5	$0.80/MTok	$4/MTok

하루 종일 적극 사용 시 단 하루만으로 API 환산 $200 초과 가능 → 매일 개발자에겐 Max 구독이 합리적. (200K 컨텍스트, 배치 처리 50% 할인)

03클로드 코드 환경 설정

설치 난이도는 낮지만 IDE 통합과 초기 설정이 중요. 기존 워크플로를 바꾸지 않고 보완하는 방향. 공통 전제: Node.js + npm 필요.

macOS

nodejs.org/ko/download에서 .pkg 설치 후 node --version 확인
클로드 코드 설치 → 아래 명령
claude 실행 → 폴더 접근 권한 Yes, proceed 선택

npm install -g @anthropic-ai/claude-code

Windows (WSL)

PowerShell 관리자 권한 → wsl --install 후 재부팅
홈 디렉터리 이동(cd \) → wsl --update → wsl -d ubuntu
이후 macOS와 동일 (Node 설치 → claude-code 설치 → claude)

sudo npm install -g @anthropic-ai/claude-code

참고: 2025년 6월 기준 윈도우 직접 실행 미지원으로 WSL 우회 설치. 최신 방법은 공식 문서(docs.anthropic.com/ko/docs/claude-code/setup) 확인. WSL에서 비밀번호 입력 시 글자가 화면에 안 보이는 건 정상.