요즘 개발자들 사이에서 가장 뜨거운 도구 중 하나가 바로 Claude Code입니다. Anthropic이 만든 에이전트형 코딩 도구로, 코드베이스를 이해하고, 파일을 직접 수정하며, 명령어를 실행하고, git 작업까지 자연어로 처리해줍니다.
저도 최근에 본격적으로 써보면서 깨달은 게 있습니다. "맥에서 Claude Code를 써보자"라고 결심하고 검색해 보면 정보가 너무 분산되어 있다는 겁니다. 어떤 글은 터미널 설치만 다루고, 어떤 글은 VS Code 확장만 다루고, 데스크톱 앱이 있다는 사실조차 모르는 사람도 많더라고요. "그래서 뭘로 시작해야 하지?"라는 질문에 한 번에 답해주는 글이 잘 안 보였습니다.
그래서 이번 글에서는 맥에서 Claude Code를 실행할 수 있는 모든 공식 방법을 한자리에 정리해 봤습니다. 모든 내용은 Anthropic 공식 문서와 Claude.com을 기준으로 작성했고, 추측이 아닌 직접 확인된 사실만 담았습니다.
📌 이 글이 다루는 것: 맥에서 Claude Code에 접근할 수 있는 공식 진입점 10가지를 4가지 카테고리(터미널, 다른 설치 방식, IDE, GUI/웹/협업 도구)로 정리했습니다.
시작하기 전: 꼭 알아둘 사항
시스템 요구사항
Claude Code 공식 setup 페이지에 따르면, 맥에서 Claude Code를 실행하려면:
- macOS 13.0 이상 (Ventura 이상)
- 4GB 이상의 RAM, x64 또는 ARM64 프로세서 (M1/M2/M3 모두 지원)
- 인터넷 연결
- Bash 또는 Zsh 셸 (맥은 기본으로 Zsh 사용)
유료 플랜이 필요합니다
Claude Code는 무료 플랜에서는 사용할 수 없습니다. Claude 공식 가격 페이지에 따르면:
- Pro 플랜: 월 $20 (연간 결제 시 $17/월)
- Max 플랜: 월 $100 (5x) 또는 $200 (20x)
- Team 플랜: 시트당 월 $20부터
- Enterprise 플랜: 영업 문의
또는 Anthropic Console에서 API 키를 발급받아 사용량 기반으로 결제할 수도 있습니다.
💡 참고: 가격과 플랜 정책은 자주 변경됩니다. 최신 정보는 반드시 공식 가격 페이지에서 확인하세요.
카테고리 1. 터미널에서 사용하기
가장 기본적이고 강력한 방법입니다. Claude Code의 모든 기능을 활용할 수 있습니다.
방법 1. macOS 기본 터미널 (Terminal.app)
가장 단순한 방법입니다. 맥에 기본 내장된 터미널 앱을 사용합니다.
터미널 열기
Cmd + Space로 Spotlight를 띄우고 "터미널" 또는 "Terminal"을 입력해서 실행합니다.
Native Installer로 설치 (공식 권장)
Claude Code 공식 setup 가이드가 가장 권장하는 방법은 네이티브 설치 프로그램입니다. Node.js가 필요 없고, 백그라운드에서 자동으로 업데이트됩니다.
터미널에 다음 명령어를 입력합니다:
curl -fsSL https://claude.ai/install.sh | bash
설치가 끝나면 새 터미널 창을 열고 다음 명령으로 확인합니다:
claude --version
실행하기
프로젝트 폴더로 이동한 후 claude만 입력하면 됩니다:
cd ~/projects/my-app
claude
처음 실행하면 브라우저가 열리면서 로그인 화면이 뜹니다. Claude 계정으로 로그인하면 됩니다.
방법 2. iTerm2
iTerm2는 맥 개발자들이 가장 많이 쓰는 서드파티 터미널입니다. 분할 창, 검색, 자동완성 등 기본 터미널보다 훨씬 풍부한 기능을 제공합니다.
설치 방법은 동일합니다. iTerm2에서 위와 같은 curl 명령어를 실행하면 됩니다.
iTerm2 사용 시 추가 팁
Claude Code 터미널 설정 공식 문서에 따르면, iTerm2에서는:
- Shift+Enter로 줄바꿈이 별도 설정 없이 작동합니다.
- 데스크톱 알림을 받으려면 iTerm2 설정 → Profiles → Terminal에서 "Notification Center Alerts"를 활성화하고, "Filter Alerts" → "Send escape sequence-generated alerts"를 켜야 합니다.
- Option 키 단축키(예: Option+P로 모델 전환)를 사용하려면 Settings → Profiles → Keys → General에서 Left/Right Option key를 "Esc+"로 설정합니다.
방법 3. Ghostty
Ghostty는 비교적 최근에 등장한 GPU 가속 터미널입니다. Claude Code 공식 문서에 따르면, Ghostty, Kitty, iTerm2 세 가지 터미널만이 데스크톱 알림을 별도 설정 없이 자동 지원합니다.
공식 터미널 설정 문서에 따르면 Ghostty에서는 Shift+Enter 줄바꿈이 기본 동작하고, OS 알림 센터로 알림이 자동 전달됩니다.
카테고리 2. 다른 설치 방식 (터미널 사용은 동일)
Native Installer 외에 익숙한 패키지 매니저로 설치하고 싶다면 아래 방법을 선택할 수 있습니다. 설치 후 터미널에서 claude 명령으로 실행하는 것은 동일합니다.
방법 4. Homebrew로 설치하기
Homebrew를 이미 사용 중이라면 더 익숙한 방법일 수 있습니다.
Homebrew 공식 cask 페이지에서 확인할 수 있듯이, Claude Code는 Homebrew 캐스크로 제공됩니다:
brew install --cask claude-code
공식 setup 문서에 따르면 두 가지 cask가 있습니다:
claude-code: 안정 버전 (보통 최신보다 약 1주일 늦게 배포되며, 큰 회귀 버그가 있는 릴리스는 건너뜀)claude-code@latest: 최신 버전 즉시 반영
업데이트는 다음 명령으로 수동 실행해야 합니다 (네이티브 인스톨러와 달리 자동 업데이트되지 않음):
brew upgrade claude-code
방법 5. npm으로 설치하기
Node.js를 이미 사용하고 있다면 npm으로도 설치할 수 있습니다. 공식 문서에 따르면 Node.js 18 이상이 필요합니다.
npm install -g @anthropic-ai/claude-code
⚠️ 주의: 공식 문서는
sudo npm install -g를 사용하지 말라고 명시합니다. 권한 문제와 보안 리스크가 발생할 수 있습니다. 권한 에러가 난다면 공식 트러블슈팅 문서를 참고하세요.
npm 패키지 페이지에서 패키지 자체도 확인할 수 있습니다.
카테고리 3. IDE에서 사용하기
코드 에디터/IDE 안에서 Claude Code를 시각적으로 다루고 싶다면 아래 방법들이 있습니다. 시각적 diff 리뷰, 진단 자동 공유 등 IDE 통합 기능을 활용할 수 있습니다.
방법 6. VS Code 확장 프로그램
터미널이 부담스럽다면 Visual Studio Code에서 직접 사용할 수 있습니다.
Anthropic이 발표한 공식 블로그에서 소개한 대로, Claude Code 네이티브 VS Code 확장(베타)이 출시되었습니다. 사이드바 패널에서 인라인 diff를 실시간으로 보여주는 그래픽 인터페이스를 제공합니다.
설치 방법
- VS Code를 실행합니다.
Cmd + Shift + X로 확장 프로그램 패널을 엽니다.- "Claude Code"를 검색합니다.
- publisher가 Anthropic인지 반드시 확인한 뒤 설치합니다.
또는 Visual Studio Marketplace에서 직접 설치할 수도 있습니다.
공식 VS Code 문서에 따르면 VS Code 1.98.0 이상이 필요합니다.
주요 기능
공식 문서에 명시된 기능들입니다:
- 인라인 diff 리뷰: 변경 사항을 사이드바에서 바로 확인하고 승인/거부
- @-mention 파일 참조:
@filename으로 파일을 컨텍스트에 추가 - Plan 리뷰: Plan Mode에서 Claude의 계획을 마크다운 문서로 열고 인라인 코멘트
- 다중 탭/창 세션: 여러 대화를 병렬로 진행
- 세션 히스토리: 키워드 검색으로 과거 세션 찾기
- 자동 진단 공유: TypeScript 에러, ESLint 경고 등을 Claude가 자동으로 인식
- 체크포인트: Claude가 편집한 파일을 추적해 이전 상태로 되돌릴 수 있음
Cursor에서도 사용 가능
공식 VS Code 문서는 Cursor용 별도 설치 버튼("Install for Cursor")도 제공합니다. Cursor가 VS Code 기반이기 때문에 동일한 확장이 동작합니다. Cursor 사용자는 자체 AI 에이전트와 Claude Code를 같은 창에서 함께 쓸 수 있다는 점이 흥미롭습니다.
방법 7. JetBrains IDE 플러그인 (IntelliJ, WebStorm, PyCharm 등)
JetBrains 제품군을 사용한다면 전용 플러그인이 있습니다.
설치 방법
공식 JetBrains 통합 문서에 따르면:
- JetBrains IDE를 실행합니다.
- Settings → Plugins로 이동합니다.
- Marketplace에서 "Claude Code"를 검색합니다.
- 설치 후 IDE를 재시작합니다.
JetBrains Marketplace에서 직접 확인할 수도 있습니다. 단, 이 플러그인을 사용하려면 Claude Code CLI가 별도로 설치되어 있어야 합니다.
지원 IDE
공식 문서에 명시된 지원 IDE는 다음과 같습니다 — IntelliJ IDEA, PyCharm, Android Studio, WebStorm, PhpStorm, GoLand.
사용 방법
공식 문서에 따르면 두 가지 방식으로 사용할 수 있습니다:
- IDE의 통합 터미널에서 직접: 통합 터미널에서
claude를 실행하면 모든 통합 기능이 활성화됩니다. - 외부 터미널에서 연결: 외부 터미널에서
claude를 실행한 후/ide명령을 입력하면 JetBrains IDE에 연결됩니다.
주요 기능
- 빠른 실행: macOS에서는
Cmd+Esc로 IDE에서 바로 Claude Code 실행 - diff 뷰어: 변경 사항을 IDE의 diff 뷰어로 보기
- 선택 컨텍스트 자동 공유: 현재 선택한 코드/탭이 자동으로 Claude에 전달
- 파일 참조 단축키: macOS에서
Cmd+Option+K로 파일 참조 삽입 (예:@File#L1-99) - 진단 자동 공유: IDE의 lint, syntax 에러를 Claude가 자동 인식
카테고리 4. GUI 앱과 웹/협업 도구
터미널이나 IDE 없이도 Claude Code를 사용할 수 있습니다. 비개발자나 가벼운 작업, 이동 중 작업에 적합합니다.
방법 8. Claude 데스크톱 앱
터미널 없이 GUI만으로 사용하고 싶다면 Claude 데스크톱 앱이 가장 편한 선택입니다.
설치
Claude 다운로드 페이지에서 macOS용 설치 파일을 받습니다. 일반 사용자는 DMG 파일을 다운로드해 Applications 폴더로 드래그해서 설치하면 됩니다 (기업 배포용으로는 PKG 인스톨러가 별도로 제공됩니다 — 기업 배포 가이드 참고).
설치 후 Applications 폴더에서 Claude를 실행하고 계정으로 로그인합니다.
Claude Code 사용
데스크톱 quickstart 공식 문서에 따르면, 앱 상단의 Code 탭을 클릭하면 Claude Code 인터페이스로 진입합니다.
데스크톱 앱은 CLI와 동일한 엔진을 사용하며, 같은 프로젝트에서 동시에 실행할 수도 있습니다. 설정도 공유됩니다 (CLAUDE.md 파일, MCP 서버, hooks, skills, settings 등). 공식 desktop 가이드에 따르면, CLI에서 진행하던 세션을 터미널에서 /desktop 명령으로 데스크톱 앱으로 그대로 옮길 수도 있습니다.
💡 데스크톱 앱은 Code 탭에서 Local 세션 외에도 Remote(Anthropic 클라우드 인프라에서 실행, 앱을 닫아도 계속 작동), SSH(원격 머신에 접속) 옵션도 제공합니다. 환경 선택, 프로젝트 폴더 지정, 모델 선택, 권한 모드 설정을 프롬프트 영역에서 직접 할 수 있습니다.
방법 9. Claude Code on the Web (브라우저)
claude.ai/code에 접속하면 브라우저에서 Claude Code를 사용할 수 있습니다.
Claude Code 제품 페이지의 설명에 따르면, 웹 버전은 GitHub 리포지토리와 연결해 사용하는 형태입니다. 브라우저에서 빠르게 접근할 수 있어서 병렬 작업이나 이동 중 코딩에 적합합니다. 클라우드 인프라에서 실행되기 때문에 노트북을 닫아도 작업이 계속 진행됩니다.
💡 로컬 파일 작업이 필요하다면 데스크톱 앱이나 CLI를 쓰는 게 낫습니다. 웹 버전은 GitHub 리포지토리 기반 작업에 최적화되어 있습니다.
방법 10. Slack 통합
팀과 Slack에서 협업한다면, Slack에서 직접 Claude Code 작업을 시작할 수 있습니다.
공식 Slack 통합 문서에 따르면:
- Slack에서
@Claude로 멘션하고 코딩 작업을 요청합니다. - Claude가 자동으로 코딩 작업인지 감지하고, claude.ai/code에서 새 세션을 생성합니다.
- 진행 상황이 Slack 스레드에 업데이트됩니다.
- 완료되면 PR 생성 버튼이 제공됩니다.
Claude for Slack 페이지에서 더 자세한 내용을 확인할 수 있습니다. 단, Claude Code on the web 접근 권한이 필요하며, 현재는 GitHub 리포지토리만 지원합니다.
어떤 방법을 선택해야 할까?
각 사용자 유형별 추천을 정리하면 다음과 같습니다:
- 터미널이 익숙한 개발자: 기본 터미널 또는 iTerm2/Ghostty + 네이티브 인스톨러 조합이 가장 빠르고 가볍습니다.
- VS Code를 주력으로 쓰는 개발자: VS Code 확장이 시각적인 diff 리뷰 측면에서 가장 편합니다.
- JetBrains IDE 사용자: 전용 플러그인 + CLI 조합으로 IDE 컨텍스트를 그대로 활용할 수 있습니다.
- 터미널이 부담스러운 분: Claude 데스크톱 앱이 가장 진입 장벽이 낮습니다.
- 이동 중에도 코딩하고 싶다면: 웹 버전이나 Slack 통합을 활용하세요.
- Homebrew를 이미 쓰는 분:
brew install --cask claude-code가 익숙한 방식이라 편합니다.
공식 문서에서는 네이티브 인스톨러를 가장 권장합니다. Node.js 같은 의존성이 필요 없고, 백그라운드 자동 업데이트가 되기 때문입니다.
설치 후 확인 명령어
어떤 방법으로 설치했든, 설치가 잘 되었는지 확인할 때 유용한 명령어입니다:
# 버전 확인
claude --version
# 설치/설정 진단 (Node 버전, 인증 상태, 파일 권한 등을 자동 점검)
claude doctor
claude doctor는 공식 트러블슈팅 문서에서 자주 언급되는 진단 도구입니다. 뭔가 이상한데 원인을 모르겠을 때 가장 먼저 실행해보면 됩니다.
마치며
이렇게 맥에서 Claude Code를 사용할 수 있는 공식 방법들을 모두 정리해 봤습니다. 처음에는 "터미널에서 claude만 치면 되는 도구"라고 생각했는데, 정리해보니 IDE, 데스크톱 앱, 웹, Slack까지 정말 다양한 진입점이 있어서 저도 정리하면서 새로 알게 된 것들이 꽤 있었습니다. 특히 CLI 세션을 /desktop 명령으로 데스크톱 앱으로 옮길 수 있다는 부분은 처음 알았네요.
저는 개인적으로 iTerm2 + 네이티브 인스톨러 조합으로 시작해서, 시각적인 리뷰가 필요할 때 VS Code 확장을 쓰는 패턴을 선호합니다. 같은 계정이라면 공식 문서에서 설명하듯이 설정과 세션이 공유되기 때문에 자유롭게 오갈 수 있다는 게 큰 장점입니다.
이 글이 처음 Claude Code에 입문하는 분들께 작은 길잡이가 되었으면 좋겠습니다. 자주 변경되는 정보(가격, 새 기능, 지원 플랫폼)는 반드시 다음 공식 자료에서 다시 한번 확인하세요:
다음 글에서는 실제로 Claude Code를 사용하면서 느낀 점과 워크플로우 팁을 정리해보겠습니다. 즐거운 바이브 코딩 되세요! 🚀
댓글 없음:
댓글 쓰기