Table of Contents

Claude Code 사용법 완전 가이드｜초보자부터 고급 활용까지 전 단계【2026 최신】

Claude Code 사용법을 처음부터 알고 싶다. 그 마음으로 이 페이지를 열었다면, 제대로 찾아온 거다.

설치 방법부터 CLAUDE.md 설정, MCP 연동, 서브에이전트 병렬 처리까지——이 글 한 편으로 Claude Code의 모든 것을 파악할 수 있다. 2026년 최신 공식 문서와 실전 지식을 바탕으로 작성했다.

코드를 몰라도 괜찮다. AI 지식이 없어도 괜찮다. 이 가이드를 위에서부터 읽어 내려가기만 하면 누구든 Claude Code를 활용할 수 있게 된다.

1. Claude Code란 무엇인가

한 마디로 말하면, “내 컴퓨터 폴더에 직접 접근해 파일을 읽고, 정리하고, 결과물을 만들어주는 AI 에이전트”다.

ChatGPT나 Claude.ai 웹 버전과 무엇이 다른가. 비교표로 확인해보자.

비교 항목	Claude.ai（웹 버전）	Claude Code
파일 접근	파일 1개씩 업로드	폴더째 자동 접근
동시 처리	1개씩	수십~수백 파일 병렬 처리
명령어 실행	불가	터미널 명령어 직접 실행
기억 영속화	세션 내에서만	CLAUDE.md로 영구 지시 가능
자동화	제한적	Hooks·Skills로 완전 자동화
병렬 작업	불가	서브에이전트로 최대 4배 빠름
외부 툴 연동	제한적	MCP로 GitHub·Slack·DB 직접 조작

혼동하기 쉬운 “Cowork（구 Computer Use）”와의 차이도 정리해두자.

비교 항목	Claude Code	Cowork
조작 방식	텍스트 기반（터미널）	화면 조작 기반（마우스·클릭）
속도	빠름	느림
자유도	높음	낮음
주요 용도	코드·파일·데이터 처리	GUI 앱 조작 자동화

2. 무엇을 할 수 있나——비개발자도 사용 가능

“Code”라는 이름 때문에 개발자 전용이라고 생각하는 사람이 많다. 아니다. Claude Code는 범용 AI 에이전트다.

비개발자가 할 수 있는 것

문서 일괄 정리：회의록 30개를 읽어 이달의 결정사항 목록을 자동 생성
데이터 분석：Excel이나 CSV를 넘기면 집계·그래프 생성（Python 지식 불필요）
리서치 자동화：키워드를 주면 웹페이지를 순회해 정보를 정리
콘텐츠 제작：블로그 글·뉴스레터·SNS 게시글을 소재에서 일괄 생성
포맷 변환：Markdown을 HTML화, PDF를 텍스트화 등
폴더 관리：네이밍 규칙에 따른 파일 정리, 중복 삭제

개발자가 할 수 있는 것

코드 작성·디버깅·리팩토링
테스트 자동 생성
풀 리퀘스트 작성
바이브코딩：한국어로 지시하기만 해도 앱을 통째로 만들어줌
CI/CD 파이프라인 자동화
코드 리뷰 자동화

Claude Code를 한 마디로 표현하면, “내 지시대로 움직이는 상주 자동화 팀원”이다.

3. 요금제 선택 방법

솔직히 말하면, 요금제를 잘못 선택하면 Claude Code의 진짜 실력을 경험하지 못한 채 끝난다.

플랜	월 요금	맞는 사람	주의사항
Pro	$20	체험·가벼운 사용	사용 한도에 빠르게 도달. 멀티세션 불가
Max ($100)	$100	본격 활용 유저（강력 추천）	멀티세션·서브에이전트 사용 가능
Max ($200)	$200	헤비유저·팀 활용	더 높은 한도
API 이용	종량제	개발자·자사 서비스 내장	비용 관리 필요

Claude Code를 Pro 플랜으로 사용하는 건 스포츠카를 시속 20km 제한 도로에서 모는 것과 같다. Max ($100)부터 시작하기를 강력히 권한다.

API 이용 시 모델별 단가（2026년 4월 기준）

API로 종량 과금하는 경우의 정확한 요금은 아래와 같다. 구독 유저는 이 요금을 신경 쓸 필요 없다.

모델	입력（100만 토큰당）	출력（100만 토큰당）	컨텍스트 윈도우	최대 출력
Opus 4.6	$5	$25	100만 토큰	128k 토큰
Sonnet 4.6（기본값）	$3	$15	100만 토큰	64k 토큰
Haiku 4.5	$1	$5	20만 토큰	64k 토큰

Anthropic 공식 데이터에 따르면 개발자 1인당 평균 비용은 하루 약 $6. 90% 유저가 하루 $12 이하에 수렴한다. 팀에서 Sonnet 4.6을 쓸 경우 월 $100~200/인이 기준이다.

4. 설치 방법（macOS / Windows 대응）

macOS·Linux·WSL（권장 방법）

터미널을 열고, 아래 1행을 붙여넣고 실행하면 된다.

curl -fsSL https://claude.ai/install.sh | bash

설치 후 claude를 입력하고 Enter를 누르면 브라우저가 자동으로 열리며 로그인 화면이 나온다.

macOS（Homebrew）

brew install --cask claude-code

주의: Homebrew로 설치하면 자동 업데이트가 되지 않는다. 정기적으로 brew upgrade claude-code를 실행할 것.

Windows（PowerShell）

irm https://claude.ai/install.ps1 | iex

Windows（WinGet）

winget install Anthropic.ClaudeCode

Windows에서 설치할 경우 사전에 Git for Windows를 설치해야 한다.

설치 확인

claude -v

버전 번호가 표시되면 성공. 표시되지 않는다면 아래를 시도해보자.

source ~/.zshrc

그래도 안 된다면 터미널을 재시작한다.

5. 초보자 워크플로우——첫 1주일

Step 1：프로젝트 폴더로 이동

cd ~/Desktop/my-project

어떤 폴더든 상관없다. 블로그 글 폴더도, Excel이 들어있는 데스크톱 폴더도.

Step 2：Claude Code 시작

claude

Step 3：CLAUDE.md 생성

/init

이 명령을 실행하면 Claude Code가 폴더 안을 자동으로 읽어 CLAUDE.md（프로젝트 설명서）를 생성해준다. 이후 직접 편집하며 발전시켜 나간다.

Step 4：작업 지시하기

자연어로 말을 걸기만 하면 된다.

NG（모호한 지시）	OK（구체적인 지시）
“코드 고쳐줘”	“login.js 42번째 줄 TypeError 수정해줘”
“다 해줘”	“먼저 유저 등록 기능만 만들어줘”（하나씩 요청）
“뭔가 좋게 만들어줘”	“이 CSV를 월별 매출 그래프 HTML로 변환해줘”

특정 파일을 지정하고 싶을 때는 @파일명 기법을 사용한다.

@report.csv 데이터를 월별로 집계해서 그래프 HTML 만들어줘

Step 5：Plan 모드 사용（중요）

Shift+Tab 키로 Plan 모드에 진입할 수 있다. 여러 파일을 변경하기 전에 Claude Code의 계획을 확인할 수 있다. 의도치 않은 변경을 막는 안전장치다.

Step 6：피드백하며 반복

한 번에 완벽한 결과가 나오는 경우는 드물다. “좀 더 자세하게”, “이 형식으로” 등 피드백을 주고받으며 완성시켜 나간다.

6. CLAUDE.md 완전 공략

Claude Code의 진짜 힘은 CLAUDE.md에 있다. 이걸 제대로 만드느냐에 따라 생산성이 10배 달라진다.

CLAUDE.md란 무엇인가

Claude에 대한 “영구 기억 + 프로젝트 지시서”다. 세션을 넘어도 지시가 이어진다. 매번 “그 건 말이죠”라고 설명하는 수고가 없어진다.

저장 위치의 종류

파일	위치	적용 범위	용도
CLAUDE.md	프로젝트 폴더 바로 아래	해당 프로젝트 전체	팀 공유 규칙（Git 커밋 권장）
~/.claude/CLAUDE.md	홈 디렉토리	전체 프로젝트 공통	개인 취향·전체 규칙
CLAUDE.local.md	프로젝트 폴더 바로 아래	해당 프로젝트（로컬 전용）	나만의 설정（.gitignore 권장）

CLAUDE.md에 써야 할 5가지 요소


# 프로젝트 개요
이 폴더는 〇〇를 위한 프로젝트입니다.

# 사용 도구·환경
- 언어: Python 3.11
- 프레임워크: FastAPI
- DB: PostgreSQL

# 작업 규칙
- 주석은 한국어로 작성
- 함수명은 스네이크 케이스

# 금지사항
- 프로덕션 DB를 직접 조작하지 않는다
- 파일 삭제 전 반드시 확인한다

# 자주 쓰는 패턴
- 테스트 실행: pytest tests/
- 서버 시작: uvicorn main:app --reload

Auto Memory 기능（2026년 신기능）

Claude Code는 작업하면서 자동으로 메모리를 구축한다. 빌드 명령이나 디버깅에서 발견한 것들을 자동으로 기록해준다. 아무것도 쓰지 않아도, 계속 사용하다 보면 Claude Code가 점점 영리해진다.

📩 매주 월요일, AI 트렌드를 정리한 뉴스레터 발송 중

회원 등록하면 매주 월요일 “이번 주 AI·바이브코딩 최신 정보”를 받을 수 있습니다.
기사에는 쓰지 못한 실전 노하우도 회원 한정으로 공개합니다.

무료 회원 등록하기（30초）→

7. 커스텀 명령어（Skills）와 공식 플러그인

Claude Code는 커스텀 명령어와 플러그인으로 기능을 확장할 수 있다.

공식 Discover Plugins

Claude Code에는 공식 플러그인 마켓플레이스가 있다. /plugin marketplace 명령으로 열람·설치할 수 있다.

/plugin marketplace

PRD 생성·리서치·Git 관리 등 다양한 플러그인이 커뮤니티에서 공개되어 있다. 용도에 맞는 걸 골라 설치하기만 하면 기능 확장이 가능하다.

커스텀 Skills 만들기

자주 쓰는 워크플로우를 .claude/commands/ 폴더에 Markdown 파일로 저장하면, /명령어명으로 호출할 수 있다.

# .claude/commands/review-pr.md
PR의 변경 파일을 모두 확인하고 아래 관점에서 리뷰해주세요:
1. 보안 리스크
2. 퍼포먼스 문제
3. 코드 규약 위반

저장 후 Claude Code에서 /review-pr이라고 입력하기만 하면 실행된다. 팀에서 공유하려면 Git 저장소에 포함시키면 된다.

8. 핵심 개념 5가지

이것만 알면 Claude Code의 동작 원리를 이해할 수 있다.

개념	설명	실용상 주의사항
Context（컨텍스트）	Claude가 지금 가진 “기억”의 총량. 대화가 길어질수록 오래된 것부터 밀려남	`/compact`로 정기적으로 압축
Tools（도구）	파일 읽기·쓰기·명령어 실행·웹 검색 등 “실제 행동”의 수단	권한 설정으로 제어 가능
Permissions（권한）	Allow（항상 허용）/ Ask（매번 확인）/ Deny（금지）로 도구 사용을 제어	위험한 조작은 반드시 Ask로 설정
Memory（기억）	CLAUDE.md에 의한 영속적 지시. 세션을 넘어도 유효	글로벌·프로젝트·로컬의 3계층
Session（세션）	Claude Code를 시작해서 종료할 때까지의 작업 단위	`/rename`으로 이름을 붙이면 나중에 재개하기 쉬움

에이전트 루프의 구조

Claude Code는 다음 사이클을 자율적으로 반복한다.

지시를 받는다（유저 입력）
컨텍스트를 수집한다（관련 파일 읽기·웹 검색）
행동한다（파일 편집·명령어 실행）
결과를 검증한다（테스트 실행·오류 확인）
1로 돌아간다

이 루프가 자동으로 돌아가기 때문에 복잡한 작업도 완결할 수 있다.

9. 명령어·단축키 목록

CLI 명령어（터미널에서 실행）

명령어	설명
`claude`	Claude Code 시작
`claude -v`	버전 확인
`claude --continue`	직전 세션을 이어받아 시작
`claude --resume`	세션 목록에서 선택해 재개
`claude --resume [이름]`	이름 붙인 세션을 직접 재개
`claude -p "지시"`	원라이너로 지시 실행（스크립트 연동에 편리）

슬래시 명령어（Claude Code 내부에서 사용）

명령어	설명	사용 타이밍
`/compact`	대화를 압축해 컨텍스트를 절약（최중요）	대화가 길어지기 시작했을 때
`/clear`	완전 초기화（컨텍스트 리셋）	같은 오류가 반복될 때
`/cost`	이 세션의 토큰 비용 확인	비용 관리
`/clone`	현재 대화를 분기（백업 목적）	실험적 변경 전에
`/rename [이름]`	세션에 이름 붙이기	장기 작업 관리
`/init`	CLAUDE.md 자동 생성	새 프로젝트를 시작할 때
`/status`	현재 설정·권한 상태 확인	동작 확인
`/schedule`	정기 실행 태스크 생성	자동화 워크플로우 구축 시

키보드 단축키

단축키	기능
`Ctrl+C`	실행 중인 작업 취소
`Shift+Enter`	Enter 없이 줄바꿈（긴 지시 작성 시）
`Esc Esc`（2번 연속）	직전 상태로 되감기（실행 취소 버튼）
`Shift+Tab`	Plan 모드 전환（변경 전 계획 확인）
`↑`（위 키）	직전 입력 불러오기

10. 세션과 컨텍스트 관리

Claude Code를 쓰다 보면 점점 응답이 느려지거나, 전에 한 말을 잊어버리는 경우가 생긴다. 이건 컨텍스트 윈도우 때문이다.

컨텍스트 윈도우란

AI가 한 번에 기억할 수 있는 최대 용량. 대화가 길어지면 오래된 내용부터 자동으로 삭제된다.

해결책

증상	해결책
응답이 느려졌다	`/compact`로 대화 압축
같은 오류를 반복한다	`/clear` 후 새 세션으로 재시도
세션을 재개하고 싶다	`claude --continue` 또는 `claude --resume`
대량 파일 변경 전	`Shift+Tab`으로 Plan 모드에 진입해 계획 확인

경험적으로 30분마다 한 번씩 /compact를 실행하는 습관을 들이면 속도가 안정된다.

11. GitHub 연동

비개발자의 경우

파일 버전 관리는 폴더 복사나 Google Docs 버전 이력으로 충분하다. 굳이 Git을 배울 필요는 없다.

개발자의 경우——Claude Code로 직접 Git 조작

Claude Code는 자연어로 Git 조작이 가능하다. 별도 플러그인 없이 기본 기능으로 사용할 수 있다.

지시	Claude Code가 실행하는 것
“변경 사항 커밋해줘”	변경 내용 분석 → 적절한 커밋 메시지 생성 → git add + commit
“풀 리퀘스트 만들어줘”	브랜치 생성 → push → PR 작성（제목·설명도 자동 생성）
“차이점 보여줘”	git diff 실행 후 변경 내용 해설

GitHub Actions로 CI/CD 자동화

Claude Code는 GitHub Actions와 조합하면 풀 리퀘스트 코드 리뷰나 이슈 분류를 완전 자동화할 수 있다. 설정 방법은 공식 문서의 “GitHub Actions” 섹션을 참조하자.

12. 자주 하는 실수와 해결법

문제	원인	해결책
`claude` 명령어를 못 찾음	PATH가 통하지 않음	`source ~/.zshrc` 실행, 또는 터미널 재시작
너무 느림	컨텍스트가 너무 길어짐	`/compact` 실행
원하는 대로 수정이 안 됨	지시가 모호함	파일명·줄 번호·구체적인 변경 내용을 명시
파일을 실수로 변경함	지시 해석 오류	`Esc Esc`로 직전 상태 되감기, 또는 `/rewind`
비용이 높음	긴 컨텍스트로 고비용 모델 사용	`/compact` 습관화, 단순 작업은 Haiku 모델 지정
한글 깨짐	터미널 문자 코드 설정	터미널 인코딩을 UTF-8로 설정
같은 오류 반복	컨텍스트에 잘못된 정보 축적	`/clear`로 초기화 후 다시 시작
Windows 설치 실패	Git for Windows 미설치	먼저 Git for Windows 설치

13. 디버깅 3단계

Step 1：에러를 그대로 보여준다

스크린샷도, 에러 메시지 복붙도 상관없다. “오류가 났어”가 아니라, 오류 내용을 그대로 붙여넣는 것이 가장 효과적이다.

Step 2：원인을 못 찾으면 되감는다

Esc Esc 또는 /rewind로 문제가 생기기 전 상태로 돌아간다.

Step 3：반복되면 새 세션으로

같은 오류가 3번 이상 반복된다면, 컨텍스트가 오염된 신호다. /clear로 리셋해서 새 세션으로 처음부터 다시 시작한다.

CLAUDE.md에 주의사항 기록

디버깅에서 배운 것을 CLAUDE.md에 써두자. 다음번에 같은 문제가 생겼을 때 Claude가 자동으로 회피해준다.

🔧 여기부터 고급편

기본 조작에 익숙해진 후에 읽는 것을 권장합니다. 북마크 추천.

14. 고급 기능——MCP·Hooks·Skills·서브에이전트

MCP（Model Context Protocol）

MCP는 AI 도구와 외부 서비스를 연결하는 공개 표준 규격이다. MCP를 설정하면 Claude Code가 직접 GitHub·Slack·데이터베이스·Google Drive 등을 조작할 수 있게 된다.

MCP 서버	할 수 있는 것
GitHub MCP	PR 생성·코드 리뷰·이슈 관리
Slack MCP	채널 읽기·쓰기·알림 발송
PostgreSQL MCP	DB 직접 쿼리·데이터 업데이트
Google Drive MCP	문서·스프레드시트 읽기·쓰기
Jira MCP	티켓 생성·상태 업데이트
Notion MCP	페이지 생성·데이터베이스 조작

MCP 서버는 ~/.claude/settings.json에 설정을 추가하는 것만으로 사용할 수 있다.

Hooks（훅）——자동 품질 체크

Hooks는 Claude Code의 액션 전후에 셸 명령어를 실행할 수 있는 기능이다.

활용 예시：

파일 편집 후 자동 포맷（prettier 등）
커밋 전 Lint 체크
위험한 명령어（rm -rf 등）를 자동 차단
작업 완료 후 Slack 알림 발송

Skills（스킬）——반복 작업을 명령어화

자주 사용하는 워크플로우를 /명령어명으로 저장할 수 있는 기능이다.

예시：

/review-pr：PR 코드 리뷰 실행
/deploy-staging：스테이징 환경에 배포
/write-blog：블로그 글 초안 생성

만든 Skills는 팀에서 공유할 수 있다. CLAUDE.md에 동봉해 저장소에서 관리하는 것이 정석.

서브에이전트（Sub-Agents）——병렬 처리로 4배 빠름

여러 Claude Code 에이전트가 동시에 각각 다른 작업을 담당하는 기능이다.

내장 서브에이전트 3종

Claude Code에는 처음부터 3개의 서브에이전트가 내장되어 있다. Claude가 자동으로 판단해 사용한다.

이름	모델	용도	특징
Explore	Haiku（고속·저비용）	코드베이스 검색·분석	읽기 전용. 파일 수정 불가
Plan	부모 세션과 동일	구현 전 코드베이스 조사	읽기 전용. Plan 모드 시 사용
General-purpose	부모 세션과 동일	복잡한 다단계 태스크	전 도구 사용 가능

커스텀 서브에이전트 만들기

.claude/agents/ 폴더에 Markdown 파일을 넣기만 하면 오리지널 서브에이전트를 만들 수 있다.

# .claude/agents/code-reviewer.md
---
name: code-reviewer
description: 코드 품질·보안·베스트 프랙티스 검사
tools: Read, Grep, Glob, Bash
model: sonnet
---
코드 리뷰어로서, 변경된 파일을 분석하고
우선도별（Critical / Warning / Suggestion）로 피드백을 돌려주세요.

저장하기만 하면 바로 사용 가능. /agents 명령으로 GUI 생성도 된다.

비용의 진실——서브에이전트 5개 ≒ 1개 비용

2026년 3월 Claude Code 소스코드 분석에서 밝혀진 사실이 있다. 서브에이전트를 생성하면 부모의 컨텍스트가 바이트 단위로 동일한 카피로 상속된다. 이 때문에 프롬프트 캐시가 공유된다.

항목	일반 토큰	캐시 토큰	할인율
Opus 입력	$5.00 / MTok	$0.50 / MTok	90% OFF
Sonnet 입력	$3.00 / MTok	$0.30 / MTok	90% OFF
Haiku 입력	$1.00 / MTok	$0.10 / MTok	90% OFF

즉 “서브에이전트를 5개 띄워도 비용은 거의 1개분”이라는 놀라운 사실. 병렬 처리를 두려워할 이유가 없다.

"이 앱의 프론트엔드와 백엔드를 동시에 만들어줘.
프론트는 React, 백엔드는 FastAPI로.
각각 별도 에이전트로 병렬 처리해줘"

에이전트 팀（Agent Teams）——여러 Claude가 협조

서브에이전트의 한 단계 위가 “에이전트 팀”이다. 여러 Claude Code 인스턴스가 서로 메시지를 주고받으며 협조해서 작업한다.

아키텍처：허브 & 스포크 구조

구성 요소	역할
리더	팀을 생성하고 태스크를 배분하며 결과를 통합하는 메인 세션
팀메이트	할당된 태스크를 독립 실행하는 각 Claude Code 인스턴스
공유 태스크 리스트	전 멤버가 참조·업데이트하는 작업 항목 리스트
메일박스	에이전트 간 직접 메시지 통신 시스템

서브에이전트와의 차이는 팀 멤버끼리 직접 대화할 수 있다는 것. “보안 담당이 버그를 발견하면 퍼포먼스 담당에게 전달”하는 자율적 연계가 가능해진다.

실전 예시

PR #142의 코드 리뷰를 에이전트 팀으로 실행해줘.
3명의 리뷰어를 만들어：
- 1명은 보안 관점
- 1명은 퍼포먼스 관점
- 1명은 테스트 커버리지 관점
각각 리뷰하고 결과를 보고해줘.

활성화 방법

에이전트 팀은 실험적 기능. settings.json에 아래를 추가해 활성화한다.

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

서브에이전트 vs 에이전트 팀

비교 항목	서브에이전트	에이전트 팀
통신	메인에 결과를 반환만	멤버끼리 직접 메시지
컨텍스트	부모 캐시를 공유（저비용）	각자 독립 컨텍스트（고비용）
어울리는 작업	결과만 필요한 집중 태스크	논의·협업이 필요한 복잡 태스크
추천 팀 사이즈	2~8개	3~5명

15. 환경별 사용법——VS Code·데스크톱·브라우저

Claude Code는 여러 환경에서 사용할 수 있다. 모든 환경에서 동일한 엔진이 작동하며, CLAUDE.md 설정·MCP 서버·Skills가 공유된다.

환경	특징	어울리는 용도
터미널 CLI	전 기능 사용 가능·자유도 최고	개발·자동화·스크립트 연동
VS Code 확장기능	인라인 diff·@멘션·계획 검토	코딩·디버깅
JetBrains 플러그인	IntelliJ·PyCharm·WebStorm 대응	Java/Kotlin/Python 개발
데스크톱 앱	시각적 diff 확인·여러 세션 관리·스케줄 실행	장시간 자동화 태스크 관리
브라우저（claude.ai/code）	로컬 설치 불필요·장시간 태스크 실행	서버사이드 저장소 조작

16. 원격 조작·스케줄 실행

원격 컨트롤

책상을 떠나도 스마트폰이나 다른 브라우저에서 로컬 세션을 계속할 수 있다.

/teleport：브라우저 세션을 터미널로 이동
/desktop：터미널 세션을 데스크톱 앱으로 이동（시각적 diff 확인）

스케줄 실행（정기 태스크）

Claude Code는 정기 태스크를 자동 실행할 수 있다.

방법	설명
클라우드 스케줄	Anthropic 관리 인프라에서 실행. PC 전원이 꺼져 있어도 동작. 웹/데스크톱 앱/`/schedule`로 설정
데스크톱 스케줄	자신의 PC에서 실행. 로컬 파일에 직접 접근 가능
`/loop`	CLI 세션 내에서 프롬프트를 반복 실행（예：`/loop 5m /check-status`）

Channels 기능

Telegram·Discord·자체 Webhook에서 Claude Code 세션으로 이벤트를 보낼 수 있다. “Slack에 버그 리포트가 오면 자동으로 PR을 만든다”는 워크플로우가 실현 가능하다.

17. 비용 최적화

Claude Code의 비용은 모델 선택과 컨텍스트 양으로 결정된다.

작업 복잡도	추천 모델	입력/출력（100만 토큰 단가）	컨텍스트
단순 변환·정형	Haiku 4.5	$1 / $5	20만 토큰
일반 개발·작성	Sonnet 4.6（기본값）	$3 / $15	100만 토큰
복잡한 설계·분석	Opus 4.6（최후의 수단）	$5 / $25	100만 토큰

Anthropic 공식에 따르면 개발자 1인당 평균 비용은 하루 $6. 90% 유저가 하루 $12 이하. 모델 전환은 /model 명령으로 세션 도중에도 가능하다.

비용 절감 실천 테크닉

/compact 습관화：컨텍스트가 길어질수록 비용이 오른다. 30분마다 압축
필요한 파일만 지정：폴더 전체가 아니라, 필요한 파일만 @파일명으로 지정
/cost로 실시간 확인：세션 비용을 그 자리에서 파악
사용량 상한 설정：설정 파일에서 1세션 최대 비용을 상한 설정 가능

18. 하네스 엔지니어링——Claude Code의 진짜 설계 사상

Claude Code를 제대로 활용하려면, ‘하네스 엔지니어링’이라는 개념을 알아두는 게 좋다.

AI 모델 단독으로는 에이전트가 아니다. 모델에 “하네스（제어 장치）”를 장착해야 비로소 자율적으로 움직이는 실용적 에이전트가 된다. Claude Code의 하네스는 다음 4가지 기능으로 구성된다.

기능	역할	Claude Code에서의 구현
Constrain（제약）	할 수 있는 것을 제한	Permissions 설정, Hooks（위험 명령어 차단）, 비용 상한
Inform（교시）	무엇을 해야 하는지 알림	CLAUDE.md, Skills, 컨텍스트 엔지니어링
Verify（검증）	올바르게 실행됐는지 확인	자동 테스트, 셀프 밸리데이션, Hooks（파일 편집 후 자동 lint）
Correct（수정）	실수를 고침	에러 복구 로직, /rewind 되감기, 휴먼 인 더 루프

“모델은 커머디티, 하네스가 경쟁 우위”——이것이 2026년 AI 개발의 핵심이다. Claude Code가 다른 AI 툴과 차별화되는 이유는 바로 이 하네스 설계에 있다.

CLAUDE.md·Skills·Hooks 세 가지를 제대로 조합하면, “시킨 것만 하는 AI”가 “스스로 판단해 움직이는 AI 팀원”으로 바뀐다.

（→ 자세한 내용은 「하네스 엔지니어링 완전 가이드」를 참조）

19. 실전 자동화 프롬프트——복붙해서 바로 쓰는 5선

Claude Code의 진짜 가치는 “한 번 하는 작업”이 아니라 “반복 자동화”에 있다. 아래는 실제로 복붙해서 바로 쓸 수 있는 프롬프트 예시다.

① 블로그 → SNS 자동 크로스포스팅

블로그에 새 글이 올라가면 WordPress REST API로 감지하고,
본문을 Threads용 4개 시리즈로 재구성해서 Threads API로 자동 게시해줘.
/schedule로 매일 아침 9시에 체크하게 설정해.

② 경쟁사 블로그 모니터링 → Slack 알림

경쟁사 5곳의 블로그 RSS를 매일 아침 7시에 체크해서 새 글이 있으면
한국어로 요약하고 Slack #competitive-intel 채널에 올려줘.
/schedule로 설정해.

③ arXiv 논문 모니터링 → Notion 저장

매일 아침 arXiv에서 'on-device LLM', 'edge inference' 관련 신규 논문을 검색하고,
각 논문의 핵심 주장과 실험 결과를 3줄로 요약해서 Notion 리서치 DB에 추가해줘.
/schedule로 매일 8시.

④ 서버 에러 감지 → 분석 → PR 생성

AWS CloudWatch에서 에러율 5% 이상이면 최근 로그를 분석해서
원인 후보 3가지 뽑고, 관련 코드 파일 찾아서 수정 PR 올려줘.
Slack #incidents에 '현재 상태 → 추정 원인 → PR 링크' 올려.

⑤ 주간 뉴스레터 자동 제작

매주 일요일 밤에 이번 주 블로그 글, Threads 게시물, GitHub 커밋 내역을
전부 모아서 주간 뉴스레터 초안을 만들어줘. 3분 안에 읽을 수 있는 분량으로.
Mailchimp에 드래프트로 올려놔. /schedule로 매주 일요일 22시.

모두 /schedule 명령으로 정기 실행을 설정하면 완전 자동화 가능하다. 대부분의 경우 API 이용료는 $0이다.

（→ 전체 10선의 상세는 「Claude Code 자동화 프롬프트 10선」을 참조）

마무리——’AI 사무실’을 만드는 3가지 기둥

Claude Code를 제대로 활용하기 위한 핵심은 이 3가지다.

기둥	역할
CLAUDE.md	팀원이 기억해야 할 것（영속적 지시）
Skills	팀원이 반복 실행해야 할 것（반복 작업 자동화）
Hooks	팀원이 놓쳐서는 안 될 것（품질 체크 자동화）

이 3가지가 갖춰졌을 때, Claude Code는 “AI 어시스턴트”에서 “자율적인 AI 사무실”로 바뀐다.

📩 무료 회원 등록으로 매주 월요일 뉴스레터 받기 →

18. 자주 묻는 질문（FAQ）

Q: Claude Code 사용법은 코드를 모르는 사람도 배울 수 있나요?

A: 전혀 문제없다. Claude Code는 “Code”라는 이름이지만, 코딩하지 않는 업무（문서 작성·데이터 정리·리서치）에도 사용할 수 있는 범용 AI 에이전트다. 코딩 지식은 전혀 필요 없다.

Q: Claude Code 사용법을 익히는 데 시간이 얼마나 걸리나요?

A: 기본 조작은 하루 안에 익힐 수 있다. 설치→CLAUDE.md 생성→첫 태스크 실행까지 소요 시간은 약 30분. 본격 활용은 1~2주 실전으로 몸에 밴다.

Q: Pro 플랜과 Max 플랜은 어떻게 다른가요?

A: Pro는 월 $20이지만 사용 한도에 쉽게 도달하고 멀티세션·서브에이전트를 사용할 수 없다. 본격 활용에는 월 $100의 Max 플랜이 필수. 멀티세션과 빠른 응답이 해제된다.

Q: CLAUDE.md에 무엇을 써야 하나요?

A: ①프로젝트 개요 ②사용 기술·환경 ③작업 규칙 ④금지사항 ⑤자주 쓰는 명령어 패턴——이 5가지 요소를 쓰면 충분하다. /init 명령으로 자동 생성도 가능하다.

Q: MCP 서버 설정은 어렵나요?

A: 기본적인 MCP 서버 설정은 ~/.claude/settings.json에 JSON 몇 줄을 추가하는 것만으로 된다. 다만 각 서비스의 API 키 취득 등 서비스 측 설정도 필요한 경우가 있다.

Q: 서브에이전트는 몇 명까지 사용할 수 있나요?

A: 이론적인 제한은 없지만, 실용적으로는 2~8 에이전트가 많다. 병렬 처리로 비용도 병렬로 늘어나기 때문에 Max ($100) 플랜에서 실행하는 것이 현실적이다.

19. 참고 소스

저자: VibeCoding Tailor（Lovable 공식 앰배서더）
운영: テイラーの隠れ家（shuntailor.net）

Post Views: 74