Mac M2에서 Claude Code 설치하는 방법 — curl 한 줄로 끝내기
Claude Code
Mac M2
Apple Silicon
Anthropic
AI Tools
Claude Code 설치 방법 | Mac M2 완전 정복 가이드
// Node.js 없이 curl 한 줄 · 로그인 · 모델 확인까지 — 삽질 없이 끝내는 실전 기록
작업 환경 · Environment
HardwareMacBook · Apple M2
OSmacOS (Apple Silicon)
Claude Codev2.1.63
설치 방식Native Installer (curl)
Node.js불필요 ✓
Claude Code는 Anthropic이 만든 터미널 기반 AI 코딩 어시스턴트다. 프로젝트 폴더에서 직접 실행하고, 파일을 읽고 수정하고, 코드를 실행까지 한다. 단순 자동완성이 아니라 코드베이스 전체를 이해하고 작업하는 에이전트형 도구다.
Mac M2 기준으로 설치부터 로그인, 모델 확인까지 실제로 진행한 과정을 그대로 기록한다. 삽질 없이 끝낼 수 있다.
설치 방법 3가지 — 뭘 써야 하냐면
01
Native Installer
curl 한 줄. Node.js 불필요. 백그라운드 자동 업데이트. M2 arm64 자동 감지. → 이걸 써라.
02
Homebrew
brew install claude-code. 자동 업데이트 없음 — brew upgrade 수동 필요.
03
npm (레거시)
Node.js 18.0+ 필수. 구형 방식. 신규 설치라면 굳이 쓸 이유 없다.
| 방식 | Node.js 필요 | 자동 업데이트 | M2 최적화 | 권장 |
|---|---|---|---|---|
| Native Installer | ✓ 불필요 | ✓ 자동 | ✓ arm64 | ✓ 권장 |
| Homebrew | ✓ 불필요 | ✗ 수동 | ✓ | — |
| npm | ✗ Node 18+ | ✗ 수동 | ✓ | — |
실전 설치 — Native Installer
01
설치 명령어 실행
Terminal · zsh
❯ curl -fsSL https://claude.ai/install.sh | bash
Setting up Claude Code...
✔ Claude Code successfully installed!
Version: 2.1.63
Location: ~/.local/bin/claude
✅ Installation complete!
M2는 arm64 네이티브 바이너리로 자동 설치된다. Rosetta 불필요.
02
PATH 설정
Terminal · zsh
❯ echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc
⚠️ 이 설정 안 하면
command not found 에러 난다. 반드시 실행할 것.
03
설치 확인
Terminal · zsh
❯ claude --version
claude 2.1.63
04
실행 및 로그인
Terminal · zsh
❯ claude
실행하면 로그인 방법 선택 메뉴가 뜬다:
어떤 걸 선택하냐면 —
Claude.ai 구독(Pro/Max) 있으면 1번. Enter 누르면 브라우저 열리고 로그인하면 끝.
API 키만 있으면 2번. AWS/Azure/GCP 경유면 3번.
Claude.ai 구독(Pro/Max) 있으면 1번. Enter 누르면 브라우저 열리고 로그인하면 끝.
API 키만 있으면 2번. AWS/Azure/GCP 경유면 3번.
05
폴더 신뢰 확인
로그인 후 현재 디렉토리 신뢰 여부를 묻는다. 본인 Mac이면 1번 Enter.
Terminal · Claude Code
Accessing workspace: /Users/endoflinux
Quick safety check: Is this a project you trust?
❯ 1. Yes, I trust this folder
2. No, exit
설치 후 — 모델 확인 방법
Claude Code 실행 상태에서 /status 명령어로 현재 모델을 확인할 수 있다.
Claude Code · /status
❯ /status
Version : 2.1.63
Login method : Claude Pro Account
Email : your@email.com
Model : Default Sonnet 4.6 · Best for everyday tasks
cwd : /Users/endoflinux
Pro 플랜인데 Opus로 보인다면?
Pro 플랜 기본 모델은 Sonnet 4.6이다. Opus처럼 보여도
Pro 플랜 기본 모델은 Sonnet 4.6이다. Opus처럼 보여도
/status로 확인하면 실제 모델을 알 수 있다. Opus는 Max 플랜 기본 모델이며 Pro에서 쓰려면 추가 과금 활성화가 필요하다.
플랜별 기본 모델
claude-sonnet-4-6
Pro 플랜 기본
일상 코딩 작업에 최적. 속도와 성능 균형. 대부분의 작업은 이걸로 충분하다.
claude-opus-4-6
Max 플랜 기본
복잡한 추론·아키텍처 설계에 강함. 1M 토큰 컨텍스트 지원. Pro는 추가 과금 필요.
claude-haiku-4-5
경량 작업용
가장 빠르고 저렴. 간단한 쿼리나 반복 작업에 적합.
세션 중 모델 변경
Claude Code · 모델 변경
# 세션 내 즉시 변경
❯ /model sonnet
❯ /model opus
❯ /model haiku
# 특정 모델로 시작
❯ claude --model claude-sonnet-4-6
# 영구 기본값 설정 (~/.zshrc)
❯ export ANTHROPIC_MODEL="claude-sonnet-4-6"
업데이트 관리
| 설치 방식 | 업데이트 방법 | 자동 여부 |
|---|---|---|
| Native Installer | 백그라운드 자동 | ✓ 자동 |
| Homebrew | brew upgrade claude-code |
✗ 수동 |
| npm | npm update -g @anthropic-ai/claude-code |
✗ 수동 |
자주 묻는 질문 (FAQ)
Claude Code 설치할 때 Node.js가 필요한가요?
Native Installer(curl 방식)는 Node.js가 전혀 필요 없다. npm 방식으로 설치할 때만 Node.js 18.0 이상이 필요하다. 2024년 이후 Anthropic이 네이티브 바이너리 설치 방식을 공식 권장 방법으로 변경했다.
Mac M2에서 Rosetta 설치 없이 Claude Code가 실행되나요?
된다. Native Installer는 Apple Silicon(arm64)을 자동 감지해서 네이티브 바이너리로 설치한다. Rosetta 없이 M2에 최적화된 상태로 실행되며, 체감 속도도 더 빠르다.
Claude Code의 기본 모델은 무엇인가요?
구독 플랜에 따라 다르다. Pro 플랜 기본 모델은 Sonnet 4.6이고, Max 플랜은 Opus 4.6이 기본이다. 세션 중
/model 명령어로 즉시 변경 가능하고, /status로 현재 모델을 확인할 수 있다.
Claude Code 로그인할 때 구독이 필요한가요?
반드시 유료 플랜이 있어야 한다. Pro, Max, Team, Enterprise 중 하나. 구독 없이 API 키로만 사용하려면 로그인 시 2번(Anthropic Console) 선택 후
console.anthropic.com에서 발급한 API 키를 입력하면 된다. 이 경우 사용량만큼 과금된다.
Claude Code는 어떤 구독 플랜이 가장 경제적인가요?
일상적으로 많이 사용한다면 Max 플랜(월 $100)이 가장 경제적이다. API pay-per-use는 사용량이 많아지면 금방 비용이 커진다. 사용 패턴을 먼저 API 크레딧 $20 정도로 테스트해보고 플랜 전환을 결정하는 걸 권장한다.
// 결론
curl -fsSL https://claude.ai/install.sh | bash 한 줄. PATH 설정 한 줄. 끝이다.
Node.js 설치할 필요도 없고, Rosetta도 필요 없다. M2에서 네이티브로 돌고 자동 업데이트까지 된다. Pro 플랜이면 Sonnet 4.6이 기본 모델이고, 이걸로 대부분의 코딩 작업은 충분하다.