써보고 남기기 2026년 5월 9일 수정일 2026년 5월 9일

Mac에 Claude Code 설치해서 사용하는 방법

macOS에서 Claude Code를 설치하고 로그인한 뒤, 실제 프로젝트에서 활용하는 방법과 토큰 사용량에 따른 예상 비용을 정리합니다.

#ClaudeCode #Claude #AI코딩 #macOS #개발도구

들어가며

코딩을 하다 보면 ChatGPT나 Claude 같은 AI 챗봇에게 코드를 물어보는 일은 많다.

하지만 브라우저에서 코드를 복사하고 붙여넣는 방식은 점점 불편해진다.

특히 프로젝트 파일이 많아지면 이런 문제가 생긴다.

어떤 파일을 보여줘야 할지 고민해야 한다
수정된 코드를 직접 복사해서 붙여넣어야 한다
여러 파일을 동시에 고치기 어렵다
터미널 에러와 코드 맥락을 따로 설명해야 한다
Git 변경사항을 직접 확인해야 한다

Claude Code는 이런 불편함을 줄여주는 터미널 기반 AI 코딩 도구다.

프로젝트 폴더 안에서 Claude Code를 실행하면, Claude가 파일 구조를 읽고, 코드를 이해하고, 수정 제안을 하고, 필요한 경우 파일 변경까지 도와준다.

이번 글에서는 Mac에서 Claude Code를 설치하고 사용하는 방법, 실제 활용 예시, 그리고 토큰 사용량에 따라 예상되는 비용까지 정리한다.

Claude Code란?

Claude Code는 Anthropic이 제공하는 AI 코딩 도구다.

터미널에서 실행하고, 현재 프로젝트 폴더를 기준으로 Claude와 대화하면서 코드를 분석하거나 수정할 수 있다.

일반적인 AI 챗봇과 다른 점은 프로젝트 안에서 직접 작업할 수 있다는 것이다.

일반 챗봇
→ 코드를 복사해서 물어보고 답변을 다시 붙여넣음

Claude Code
→ 프로젝트 폴더 안에서 실행
→ 파일 구조와 코드를 읽음
→ 수정 제안
→ 승인하면 파일 변경
→ Git 변경사항 확인 가능

즉, Claude Code는 단순한 질문 답변 도구라기보다 로컬 프로젝트 안에서 함께 작업하는 AI 개발 도구에 가깝다.

설치 전에 필요한 것

Mac에서 Claude Code를 사용하려면 먼저 아래가 필요하다.

macOS 터미널
작업할 코드 프로젝트
Claude 계정
Claude Pro, Max, Team, Enterprise 구독 또는 Claude Console API 사용 권한

Anthropic 공식 문서에서도 Claude Code를 사용하려면 Claude 구독 계정, Claude Console 계정, 또는 지원되는 클라우드 제공자를 통한 접근이 필요하다고 안내한다.

블로그나 개인 프로젝트에서 사용한다면 보통 아래 두 가지 중 하나를 선택하게 된다.

Claude Pro / Max 구독으로 사용
Claude Console API 과금 방식으로 사용

구독 방식은 월 구독료 안에서 사용량 제한이 있고, API 방식은 사용한 토큰만큼 비용이 발생한다.

1. Mac 터미널 준비

Mac에서는 기본 Terminal 앱을 사용해도 되고, VS Code 내장 터미널을 사용해도 된다.

현재 셸을 확인한다.

echo $SHELL

대부분의 최신 macOS에서는 아래처럼 나온다.

/bin/zsh

이 글에서는 zsh 기준으로 진행한다.

2. Claude Code 설치 방법

Claude Code 설치는 공식 문서 기준으로 Native Install 방식이 권장된다.

macOS, Linux, WSL에서는 아래 명령어를 사용할 수 있다.

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

설치가 끝난 뒤 터미널을 새로 열고 Claude Code를 실행한다.

claude

또는 버전을 확인한다.

claude --version

만약 claude: command not found가 나오면 터미널을 완전히 닫고 다시 열어본다.

그래도 안 되면 설치 과정에서 PATH가 제대로 반영되지 않았을 수 있으니, 설치 메시지에 나온 경로 설정 안내를 확인해야 한다.

3. Homebrew로 설치하는 방법

Homebrew를 사용한다면 아래 방식도 가능하다.

brew install --cask claude-code

Homebrew 설치는 자동 업데이트가 아니므로, 나중에 업데이트하려면 아래 명령어를 사용한다.

brew upgrade claude-code

공식 문서 기준으로 Homebrew에는 stable 채널인 claude-code와 최신 채널인 claude-code@latest가 있다.

처음 사용하는 경우에는 안정적인 claude-code를 추천한다.

brew install --cask claude-code

4. Claude 계정으로 로그인

설치 후 프로젝트 폴더에서 Claude Code를 실행한다.

claude

처음 실행하면 로그인을 요구한다.

로그인 방식은 보통 아래 중 하나다.

Claude Pro / Max / Team / Enterprise 계정
Claude Console API 계정
Amazon Bedrock, Google Vertex AI, Microsoft Foundry 같은 클라우드 제공자

개인 사용자는 보통 Claude 구독 계정 또는 Claude Console API 계정을 선택한다.

로그인 후에는 자격 증명이 저장되므로 매번 로그인할 필요는 없다.

계정을 바꾸고 싶다면 Claude Code 안에서 아래 명령어를 사용할 수 있다.

/login

5. 프로젝트 폴더에서 실행하기

Claude Code는 프로젝트 폴더 안에서 실행하는 것이 중요하다.

예를 들어 Astro 블로그 프로젝트라면 다음처럼 이동한다.

cd ~/Dev/projects/chailmon-blog
claude

Claude Code를 시작한 뒤 이렇게 물어볼 수 있다.

이 프로젝트는 어떤 구조로 되어 있어?

또는 더 구체적으로 물어볼 수 있다.

이 Astro 블로그의 글 작성 흐름을 설명해줘.

Claude Code는 프로젝트 파일을 읽고 구조를 파악한 뒤 설명해준다.

6. 처음 물어보기 좋은 질문

Claude Code를 처음 사용할 때는 바로 수정을 맡기기보다, 먼저 프로젝트를 이해하게 하는 것이 좋다.

예를 들어 이런 질문이 좋다.

이 프로젝트가 어떤 기술 스택으로 구성되어 있는지 설명해줘.

src 폴더 구조를 설명해줘.

블로그 글이 어디에 저장되는지 찾아줘.

빌드와 배포에 어떤 명령어를 쓰는지 package.json을 보고 설명해줘.

처음부터 “이거 다 고쳐줘”라고 요청하기보다, 먼저 구조 분석을 요청하면 더 안정적으로 사용할 수 있다.

7. 코드 수정 요청하기

프로젝트 구조를 파악한 뒤에는 실제 수정을 요청할 수 있다.

예를 들어 블로그 프로젝트에서는 이런 요청을 할 수 있다.

글 상세 페이지에서 코드블록 스타일을 더 읽기 좋게 개선해줘.

src/content/blog 안의 MDX 글 frontmatter 형식을 점검해줘.

PostCard 컴포넌트에서 모바일 레이아웃이 깨질 가능성이 있는지 확인해줘.

npm run build 에러가 나는 이유를 찾아줘.

Claude Code는 관련 파일을 찾고, 수정이 필요한 부분을 제안한다.

파일을 실제로 수정하기 전에는 보통 승인 과정을 거친다.

이 점이 중요하다.

Claude Code가 바로 마음대로 파일을 바꾸는 것이 아니라,
변경 내용을 보여주고 사용자 승인을 요청한다.

8. Git 작업과 함께 사용하기

Claude Code는 Git 작업을 도와줄 수 있다.

예를 들어 이렇게 물어볼 수 있다.

어떤 파일이 변경됐는지 설명해줘.

이번 변경사항에 어울리는 커밋 메시지를 추천해줘.

이 변경사항이 의도한 파일만 포함하는지 확인해줘.

공식 빠른 시작 문서에서도 Claude Code가 변경 파일 확인, 커밋 메시지 작성, 브랜치 생성, 커밋 확인, 병합 충돌 해결 같은 Git 작업을 도울 수 있다고 안내한다.

다만 실제 커밋과 push는 사용자가 직접 확인한 뒤 하는 것이 좋다.

내가 추천하는 흐름은 다음과 같다.

git status
git diff
npm run build
git add .
git commit -m "작업 내용"
git push

Claude Code에는 설명과 검토를 맡기고, 최종 Git 명령어는 직접 실행하는 방식이 안전하다.

9. 자주 쓰는 Claude Code 명령어

Claude Code에서 자주 쓰는 명령어는 다음과 같다.

claude
→ 대화형 모드 시작

claude "작업 내용"
→ 일회성 작업 실행

claude -p "질문"
→ 일회성 질문 실행 후 종료

claude -c
→ 현재 디렉토리의 최근 대화 계속

claude -r
→ 이전 대화 재개

/clear
→ 대화 기록 지우기

/help
→ 사용 가능한 명령 보기

exit 또는 Ctrl+D
→ Claude Code 종료

처음에는 claude로 대화형 모드를 실행해서 사용하는 것이 가장 쉽다.

10. 블로그 작업에서 활용하는 방법

Claude Code는 블로그 운영에도 꽤 유용하다.

특히 Astro와 MDX 기반 블로그에서는 아래 작업에 활용할 수 있다.

새 글 초안 작성
기존 글 구조 정리
frontmatter 오류 찾기
category 값 검증
MDX 문법 오류 찾기
코드블록 닫힘 누락 확인
글 목록 페이지 수정
글 상세 페이지 디자인 개선
검색엔진용 title/description 개선
Git 변경사항 요약

예를 들어 이렇게 요청할 수 있다.

src/content/blog 안의 글들 중 frontmatter 오류가 날 만한 파일이 있는지 확인해줘.

이 글의 description을 검색 결과에 더 잘 맞게 다듬어줘.

이 블로그 글을 더 읽기 좋게 h2 기준으로 구조화해줘.

글 상세 페이지에서 모바일 가독성을 개선할 수 있는 부분을 찾아줘.

11. Claude Code를 쓸 때 주의할 점

Claude Code는 강력하지만, 프로젝트 파일을 수정할 수 있기 때문에 조심해야 한다.

내가 지키는 원칙은 다음과 같다.

작업 전 git status 확인
큰 수정 전 커밋 또는 백업
한 번에 너무 많은 작업을 맡기지 않기
수정 후 git diff 확인
수정 후 npm run build 실행
민감한 파일은 읽히지 않도록 주의
.env 파일은 절대 커밋하지 않기

특히 .env 파일에는 API 키나 AdSense ID 같은 값이 들어갈 수 있다.

Claude Code를 사용할 때도 민감한 값이 불필요하게 노출되지 않도록 주의해야 한다.

12. 좋은 요청 방식

Claude Code에 요청할 때는 구체적으로 말할수록 좋다.

나쁜 예시는 다음과 같다.

이거 고쳐줘.

좋은 예시는 다음과 같다.

npm run build에서 발생하는 Astro Content Collection 오류를 찾아줘.
수정 전에는 어떤 파일을 바꿀지 먼저 설명해줘.

또는:

src/pages/blog/[id].astro의 글 상세 페이지 레이아웃을 개선하고 싶어.
본문 폭, 제목 영역, 코드블록 스타일을 중심으로 수정안을 먼저 제안해줘.

Claude Code를 사용할 때는 아래처럼 단계적으로 요청하는 것이 좋다.

1. 먼저 현재 구조를 설명해줘
2. 문제 가능성을 찾아줘
3. 수정 계획을 제안해줘
4. 내가 승인하면 수정해줘
5. 수정 후 확인할 명령어를 알려줘

이렇게 하면 예상치 못한 대규모 수정을 줄일 수 있다.

13. 비용 구조 이해하기

Claude Code 비용은 사용 방식에 따라 다르게 느껴질 수 있다.

크게 두 가지 방식이 있다.

Claude 구독 플랜으로 사용
Claude Console API 기반으로 사용

Claude Pro, Max, Team, Enterprise 같은 구독 플랜에는 Claude Code 사용이 포함된다.

Claude Pro는 월 $20, Max는 월 $100부터 시작하는 플랜이다.

구독 플랜 사용자는 일정 사용량이 포함되어 있고, 사용량 제한에 도달하면 더 기다리거나 상위 플랜을 고려해야 한다.

반면 Claude Console API 기반으로 사용하면 토큰 사용량에 따라 비용이 계산된다.

Claude Code 공식 비용 문서도 Claude Code가 API 토큰 사용량에 따라 과금되며, 모델 선택, 코드베이스 크기, 사용 패턴에 따라 비용이 크게 달라질 수 있다고 설명한다.

14. /usage로 사용량 확인하기

Claude Code 안에서는 /usage 명령어로 사용량을 확인할 수 있다.

/usage

공식 문서에 따르면 /usage는 현재 세션의 토큰 사용량 통계를 보여준다.

다만 API 사용자에게 표시되는 달러 비용은 로컬에서 토큰 수를 기준으로 계산한 추정치이며, 실제 청구 금액은 Claude Console의 Usage 페이지를 보는 것이 더 정확하다.

구독 플랜 사용자의 경우에는 세션 비용 숫자가 실제 청구액과 직접 대응되지 않을 수 있다.

따라서 비용을 볼 때는 이렇게 구분해야 한다.

Claude Pro / Max 구독 사용자
→ 월 구독료와 사용량 제한 중심으로 보기

Claude Console API 사용자
→ 토큰 사용량과 모델별 단가 중심으로 보기

15. 토큰 기준 예상 비용

API 기반으로 사용한다고 가정하면 비용은 대략 아래 공식으로 계산할 수 있다.

예상 비용
= 입력 토큰 수 × 입력 단가
+ 출력 토큰 수 × 출력 단가

Anthropic의 API 가격표 기준으로, 2026년 5월 현재 주요 모델의 기본 단가는 다음과 같다.

Claude Sonnet 4.6
입력: $3 / 1M tokens
출력: $15 / 1M tokens

Claude Opus 4.7
입력: $5 / 1M tokens
출력: $25 / 1M tokens

Claude Haiku 4.5
입력: $1 / 1M tokens
출력: $5 / 1M tokens

예를 들어 Sonnet 4.6 기준으로 입력 1M 토큰, 출력 0.2M 토큰을 사용하면 다음과 같다.

입력 비용:
1M × $3 = $3

출력 비용:
0.2M × $15 = $3

합계:
약 $6

16. 사용량별 비용 예시

아래 표는 단순 계산 예시다.

캐시, 요금제, 할인, 모델 변경, 사용 패턴에 따라 실제 비용은 달라질 수 있다.

사용량 시나리오	입력 토큰	출력 토큰	Sonnet 4.6 예상 비용	Opus 4.7 예상 비용	Haiku 4.5 예상 비용
가벼운 사용	1M	0.2M	약 $6	약 $10	약 $2
보통 사용	5M	1M	약 $30	약 $50	약 $10
많은 사용	20M	4M	약 $120	약 $200	약 $40
매우 많은 사용	50M	10M	약 $300	약 $500	약 $100

이 표에서 알 수 있는 점은 출력 토큰이 비용에 큰 영향을 준다는 것이다.

입력보다 출력 단가가 높기 때문에, Claude가 긴 코드를 많이 생성하거나 긴 설명을 반복하면 비용이 빠르게 늘 수 있다.

17. Claude Code 공식 비용 감각

Claude Code 공식 비용 문서에서는 기업 배포 기준으로 평균 비용이 대략 다음 수준이라고 설명한다.

개발자 1명당 active day 평균 약 $13
개발자 1명당 월 $150~250 수준
90% 사용자는 active day당 $30 미만

이 숫자는 기업 사용 사례 기준이며, 개인 사용자의 비용과 똑같이 적용되지는 않는다.

하지만 Claude Code를 많이 쓰면 일반적인 채팅보다 토큰 사용량이 커질 수 있다는 점을 이해하는 데 도움이 된다.

특히 큰 코드베이스를 자주 읽거나, 여러 인스턴스를 동시에 실행하거나, 자동화에 연결하면 비용이 늘어날 수 있다.

18. 비용을 줄이는 방법

Claude Code 비용을 줄이려면 토큰을 아끼는 방식으로 사용해야 한다.

실제로 도움이 되는 방법은 다음과 같다.

한 번에 너무 큰 작업을 맡기지 않기
필요한 폴더와 파일 범위를 좁혀서 요청하기
수정 전 계획을 먼저 요청하기
긴 설명보다 변경 요약을 요청하기
같은 내용을 반복해서 분석하게 하지 않기
작업이 끝나면 /clear로 컨텍스트 정리하기
작은 단위로 커밋하며 진행하기

예를 들어 이런 요청은 비용이 커질 수 있다.

이 프로젝트 전체를 다 분석하고 모든 문제를 고쳐줘.

더 좋은 방식은 이렇다.

src/pages/blog/[id].astro와 src/styles/global.css만 보고
글 상세 페이지 가독성 개선 포인트를 제안해줘.
수정은 아직 하지 말고 계획만 알려줘.

범위를 좁히면 Claude가 읽어야 할 파일과 토큰이 줄어든다.

19. 개인 개발자 기준 추천 사용법

개인 개발자라면 처음부터 Claude Code에 모든 작업을 맡기기보다, 아래 방식이 좋다.

구조 분석
→ Claude Code 활용

오류 원인 찾기
→ Claude Code 활용

수정 계획 만들기
→ Claude Code 활용

실제 대규모 변경
→ 단계별로 승인하면서 진행

최종 확인
→ 내가 직접 git diff와 npm run build로 검증

Claude Code는 매우 유용하지만, 최종 책임은 사용자에게 있다.

그래서 내가 추천하는 기본 루틴은 다음과 같다.

git status
claude
# Claude에게 분석과 수정 요청
git diff
npm run build
git add .
git commit -m "작업 내용"
git push

20. 블로그 작업에서 추천하는 활용 루틴

Astro 블로그 기준으로는 이렇게 사용하면 좋다.

1. 작업 전 git status 확인
2. Claude Code 실행
3. 수정할 범위 설명
4. 먼저 계획만 요청
5. 승인 후 파일 수정
6. git diff로 변경사항 확인
7. npm run build 실행
8. 문제가 없으면 commit / push

예시 요청:

이 Astro 블로그에서 새 글 작성 흐름을 개선하려고 해.
templates/blog-post-template.mdx와 src/content.config.ts를 확인하고,
frontmatter 실수를 줄일 수 있는 개선안을 먼저 제안해줘.
수정은 내가 승인한 뒤 진행해줘.

이런 방식으로 사용하면 Claude Code를 안전하게 프로젝트에 적용할 수 있다.

마무리

Claude Code는 Mac에서 설치도 간단하고, 실제 프로젝트 안에서 바로 사용할 수 있는 강력한 AI 코딩 도구다.

정리하면 다음과 같다.

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

실행:
claude

프로젝트에서 사용:
cd 프로젝트폴더
claude

사용량 확인:
/usage

종료:
exit 또는 Ctrl+D

활용 측면에서는 코드 작성, 오류 수정, Git 변경사항 요약, 블로그 글 구조 정리, MDX 오류 확인 등에 유용하다.

다만 비용과 안전성은 항상 신경 써야 한다.

특히 API 기반으로 사용한다면 토큰 사용량이 곧 비용이 되므로, 작업 범위를 좁히고, 불필요하게 큰 코드베이스를 반복 분석하지 않도록 주의해야 한다.

개인 개발자 기준으로는 Claude Code를 “내가 시키는 대로 코드를 대신 고치는 도구”라기보다, “프로젝트를 함께 읽고 수정 계획을 제안해주는 개발 파트너”로 사용하는 것이 가장 현실적이다.

참고한 공식 문서

Claude Code 빠른 시작
- https://code.claude.com/docs/ko/quickstart
Claude Code 비용 관리
- https://code.claude.com/docs/en/costs
Claude API 가격표
- https://platform.claude.com/docs/en/about-claude/pricing
Claude 플랜 가격
- https://claude.com/pricing