클로드 코드는 터미널에서 "이 버그 고쳐 줘"처럼 말로 일을 맡기면 파일을 읽고, 고치고, 명령을 실행하는 Anthropic의 코딩 에이전트입니다. 결론부터 말하면 처음엔 Pro 구독으로 시작해 CLAUDE.md 하나만 잘 써 두는 것이 가장 싸고 빠른 출발입니다. 이 글의 설치 명령과 기능 설명은 2026년 10월 12일 기준 공식 문서(code.claude.com)에서 확인한 내용이고, 이 블로그 역시 클로드 코드로 만들고 운영하고 있습니다.
클로드 코드는 어떻게 설치하나요?
공식 문서가 권장하는 방법은 네이티브 설치입니다. 터미널을 열고 운영체제에 맞는 명령 한 줄을 실행합니다.
# macOS, Linux, WSL
curl -fsSL https://claude.ai/install.sh | bash
# Windows PowerShell
irm https://claude.ai/install.ps1 | iex
Homebrew를 쓴다면 brew install --cask claude-code, npm을 쓴다면 npm install -g @anthropic-ai/claude-code(Node.js 22 이상)도 됩니다. 다만 네이티브 설치만 백그라운드 자동 업데이트가 되고, Homebrew·npm은 직접 업그레이드해야 합니다. 공식 문서는 sudo npm install -g를 쓰지 말라고 경고합니다.
Windows는 그대로 설치해도 되고 WSL 안에 설치해도 됩니다. 프로젝트가 Linux 도구에 기대고 있거나 명령 실행을 샌드박스로 격리하고 싶다면 WSL 2가 맞고, Windows 전용 프로젝트라면 네이티브 설치가 간단합니다. 네이티브 Windows에서는 Git for Windows를 함께 설치해 두면 클로드 코드가 Bash로 명령을 실행하고, 없으면 PowerShell을 씁니다.
설치가 끝나면 새 터미널에서 claude --version으로 버전이 찍히는지 보고, 작업할 프로젝트 폴더로 이동해 claude를 실행합니다. 처음 실행하면 브라우저가 열리며 로그인합니다.
| 항목 | 공식 요구사항 |
|---|---|
| 운영체제 | macOS 13.0+, Windows 10 1809+, Ubuntu 20.04+, Debian 10+ |
| 메모리 | 4GB 이상 |
| 계정 | Pro, Max, Team, Enterprise 구독 또는 Console(API) |
| 네트워크 | 인터넷 연결 필수 |
클로드 코드는 어떤 요금제로 써야 할까요?
공식 설치 문서에 따르면 무료 요금제로는 클로드 코드를 쓸 수 없습니다. 선택지는 구독(Pro·Max·Team)과 API 종량제 두 갈래입니다. 요금제별 가격과 한도는 클로드 요금제 정리에 따로 모았습니다.
| 방식 | 비용(2026년 10월) | 맞는 사람 |
|---|---|---|
| Pro | 월 $20, 연간 결제 시 월 $17 | 하루 몇 번 막히는 작업을 맡기는 개인 |
| Max | 월 $100부터, Pro 대비 사용량 5배·20배 | 하루 종일 클로드 코드로 개발하는 사람 |
| API(Console) | 쓴 토큰만큼 | 자동화·CI처럼 사람이 없는 작업 |
구독은 5시간 단위로 초기화되는 사용량 한도가 있습니다. 그래서 순서가 중요합니다. Pro로 시작해 한도에 자주 걸릴 때만 Max로 올리면, 처음부터 Max를 결제하는 것보다 실제로 필요한 만큼만 냅니다. 요금제별 차이는 AI 비용 절감 카테고리의 요금제 글에서 더 자세히 다룹니다.
API는 사용량 한도 대신 돈이 한도입니다. 공식 비용 문서는 기업 환경 평균을 개발자 1명당 활동일 기준 약 $13, 월 $150~250으로 안내합니다. 혼자 쓰는 개인에게는 대체로 구독이 더 예측하기 쉽습니다.
CLAUDE.md는 무엇이고 어떻게 써야 하나요?
CLAUDE.md는 클로드 코드가 세션을 시작할 때마다 읽는 프로젝트 설명서입니다. 프로젝트 루트의 ./CLAUDE.md는 팀과 공유하고, ~/.claude/CLAUDE.md는 모든 프로젝트에 적용되는 개인 설정입니다. 처음엔 /init을 실행하면 코드베이스를 분석해 초안을 만들어 줍니다.
여기에 넣을 것은 클로드가 스스로 알아낼 수 없는 것입니다. 빌드·테스트 명령, 건드리면 안 되는 디렉터리, 과거에 겪은 함정 같은 것들입니다. 이 블로그의 CLAUDE.md에도 "공유 DB에서 이 접두어의 테이블만 쓴다", "한글 강조 표기가 깨진 이유" 같은 실제로 겪은 규칙이 들어 있습니다.
팁
공식 문서는 CLAUDE.md를 200줄 이하로 유지하라고 권합니다. 길수록 매 세션 컨텍스트를 차지하고, 지시를 따르는 정도도 떨어집니다.
스킬과 MCP는 언제 써야 할까요?
스킬: 반복하는 작업 절차를 저장
스킬은 .claude/skills/<이름>/SKILL.md에 절차를 적어 두는 기능입니다. /스킬이름으로 직접 부르거나, 요청이 설명(description)과 맞으면 클로드가 알아서 꺼내 씁니다. CLAUDE.md와 달리 필요할 때만 로드되므로 특정 작업에만 쓰는 긴 절차는 스킬로 옮기는 편이 컨텍스트를 아낍니다. 이 블로그의 글 초안도 mjblog-write라는 프로젝트 스킬로 검색량 조사부터 검사기 통과까지 같은 순서를 밟습니다.
MCP: 외부 서비스와 연결
MCP는 클로드 코드가 Notion, 데이터베이스 같은 외부 도구를 쓰게 해 주는 연결 규격입니다. 웹·데스크톱 앱까지 포함한 연결 방법은 클로드 MCP 연결 방법에 정리했습니다. 원격 서버는 claude mcp add --transport http 이름 주소 한 줄로 붙입니다. 범위는 나만 쓰는 local(기본), 팀과 .mcp.json으로 공유하는 project, 모든 프로젝트에 쓰는 user가 있습니다.
다만 공식 문서는 gh, gcloud 같은 CLI가 있으면 MCP보다 CLI가 컨텍스트를 덜 쓴다고 안내합니다. 쓰지 않는 서버는 /mcp에서 꺼 두는 것이 좋습니다.
클로드 코드 비용과 사용량은 어떻게 줄이나요?
클로드 코드는 매 요청마다 지금까지의 대화를 함께 보냅니다. 그래서 비용을 줄이는 핵심은 컨텍스트를 작게 유지하는 것입니다.
- 다른 일로 넘어가면
/clear: 관계없는 이전 대화가 매 메시지마다 비용이 됩니다. - 모델을 일에 맞추기: 공식 문서는 대부분의 코딩은 Sonnet으로 충분하고, Opus는 복잡한 설계에 아껴 쓰라고 권합니다.
/model로 바꿉니다. - 구체적으로 요청하기: "코드 개선해 줘"는 전체를 훑게 만들고, "auth.ts 로그인 함수에 입력 검증 추가"는 필요한 파일만 읽게 합니다.
- 복잡한 작업은 계획 모드부터: Shift+Tab으로 계획 모드를 켜면 수정 전에 접근 방식을 먼저 확인할 수 있어, 방향이 틀린 작업을 되돌리는 비용이 줄어듭니다.
지금 얼마나 썼는지는 /usage, 무엇이 컨텍스트를 차지하는지는 /context로 봅니다.
긴 세션에서 사용량이 빨리 닳는 이유
하루 종일 같은 세션을 켜 두면 질문 한 줄에도 그날 대화 전체가 함께 전송됩니다. 대화 기록은 프롬프트 캐시로 싸게 다시 읽히지만, 캐시에도 수명이 있습니다. 공식 문서 기준으로 구독은 1시간, API 키는 기본 5분입니다. 점심을 먹고 돌아와 처음 보내는 메시지는 캐시가 식어 전체 대화를 다시 처리하게 됩니다.
그래서 작업 단위가 바뀌면 /rename으로 세션에 이름을 붙이고 /clear로 새로 시작하는 습관이 유리합니다. 이전 작업으로 돌아가야 하면 /resume으로 다시 엽니다. /compact는 대화를 요약해 줄이지만, 요약 자체가 큰 요청이라는 점도 공식 문서에 나와 있습니다. 이어갈 필요가 없다면 /clear가 비용이 들지 않습니다.
방향이 틀렸을 때 빨리 멈추기
클로드가 엉뚱한 방향으로 가기 시작하면 Esc를 눌러 바로 멈춥니다. Esc를 두 번 누르거나 /rewind를 쓰면 대화와 코드를 이전 지점으로 되돌릴 수 있습니다. 틀린 방향으로 열 개 파일을 고치고 나서 되돌리는 것보다, 첫 파일에서 멈추는 쪽이 사용량을 훨씬 덜 씁니다. 테스트 케이스나 기대 결과를 요청에 함께 주면 클로드가 스스로 결과를 확인할 수 있어 다시 고쳐 달라고 요청하는 횟수도 줄어듭니다.
클로드 코드가 맞지 않는 경우는 언제인가요?
- 코드를 읽고 검토할 사람이 없는 경우: 클로드 코드는 빠르게 많이 고칩니다. 결과를 확인할 사람이 없으면 고친 만큼 위험도 늘어납니다.
- 가끔 한두 줄만 묻는 경우: 이 정도면 채팅으로 충분하고, 구독료 대비 얻는 것이 적습니다.
- 편집기 안에서 자동완성 위주로 쓰고 싶은 경우: 클로드 코드는 일을 통째로 맡기는 데 강합니다. 타이핑 보조가 목적이라면 편집기형 도구가 더 맞을 수 있습니다. 구글 쪽 터미널 도구가 궁금하다면 제미나이 CLI 사용법과 바뀐 점도 함께 보세요.
- 회사 정책상 코드를 외부로 보낼 수 없는 경우: 사내 보안 기준부터 확인해야 합니다.
그래서 클로드 코드는 어떻게 시작하면 될까요?
- Pro 구독으로 로그인하고 네이티브 설치 명령으로 설치합니다.
- 프로젝트 폴더에서
/init으로 CLAUDE.md 초안을 만들고, 빌드 명령과 주의사항을 다듬습니다. - 같은 지시를 세 번 이상 반복하게 되면 그 절차를 스킬로 옮깁니다. 스킬을 설치하고 직접 만드는 방법은 클로드 스킬 사용법에 따로 정리했습니다.
- 한도에 자주 걸리면 그때 Max를 검토합니다.
바이브코딩으로 만든 시제품을 실제 서비스로 운영하는 과정은 바이브코딩 카테고리에서 계속 다룹니다. 이 블로그를 운영하는 사람에 대해서는 블로그 소개에 적어 두었습니다.
