Mac에서 Claude Code를 사용하고 싶은데 어디서부터 시작해야 할지 모르겠다고요? 이 가이드는 macOS에서 Claude Code를 설치하고 설정하는 방법을 단계별로 보여줄 거예요. MacBook Air M1, Mac Studio, 또는 Intel iMac 중 어떤 것을 사용하든 10분 안에 모든 것을 준비할 수 있는 지침을 찾을 수 있어요. 시스템 요구사항, 다양한 설치 방법, 초기 설정, 그리고 가장 흔한 문제들의 해결책을 모두 다루고 있습니다.

macOS에서 Claude Code를 설치하기 위한 요구사항은 뭔가요?

macOS에서 Claude Code를 설치하려면 최소 macOS 10.15(Catalina), 4GB RAM, 500MB 디스크 공간, 그리고 활성화된 Anthropic 계정이 필요해요. 이 요구사항들은 의도적으로 낮게 설정되어 있어서 최대한 많은 사람들이 이 도구에 접근할 수 있도록 했어요.

기술 요구사항의 세부 사항은 다음과 같습니다:

  • 운영 체제: macOS 10.15(Catalina) 이상. Monterey, Ventura, Sonoma 버전은 완벽하게 호환됩니다.
  • 프로세서: Intel 칩과 Apple Silicon(M1, M2, M3) 모두 호환됩니다. 두 아키텍처 간에 기능 차이는 없어요.
  • 메모리: 최소 4GB, 여러 프로젝트를 열어서 작업할 때는 8GB를 권장합니다.
  • 디스크 공간: 애플리케이션용 500MB, 그리고 종속성과 프로젝트용 1~2GB가 필요해요.
  • 인터넷 연결: 초기 설치와 사용에 필요합니다(Claude Code는 온라인으로 작동합니다).

사용자 계정 쪽에서는 Anthropic 계정이 있어야 해요. Anthropic 공식 웹사이트에서 무료로 계정을 만들 수 있습니다. 무료 플랜으로 시작할 수 있는데, 이것만으로도 시작하기에 충분한 월간 할당량을 제공합니다. 유료 플랜(Pro는 월 $20, Team은 사용자당 월 $30)은 Anthropic 공식 문서에 따라 더 높은 할당량을 제공합니다.

macOS 버전을 확인하려면 왼쪽 상단의 Apple 로고를 클릭한 후 "이 Mac에 관하여"를 선택하세요. Catalina보다 이전 버전을 사용 중이라면 계속하기 전에 시스템을 업데이트해야 합니다.

Mac에서 Claude Code를 어떻게 다운로드하고 설치하나요?

macOS에서 Claude Code를 설치하려면 Anthropic 공식 웹사이트에서 .dmg 파일을 다운로드한 후 애플리케이션을 Applications 폴더로 드래그하면 돼요. 전체 과정은 약 5분이 걸립니다.

다음 단계를 정확히 따라하세요:

  1. 공식 웹사이트 방문: claude.ai로 가서 Anthropic 계정으로 로그인하세요.

  2. Claude Code 다운로드: 메인 메뉴에서 "Downloads"를 클릭한 후 "Claude Code for macOS"를 선택하세요. .dmg 파일(약 150MB)의 다운로드가 자동으로 시작됩니다.

  3. .dmg 파일 열기: 다운로드가 완료되면 Downloads 폴더에서 "ClaudeCode-macOS.dmg" 파일을 더블클릭하세요.

  4. 애플리케이션 설치: Claude Code 아이콘과 Applications 폴더로의 바로가기가 있는 창이 열립니다. Claude Code 아이콘을 Applications 폴더로 드래그하세요.

  5. Claude Code 실행: Finder에서 Applications 폴더를 열고(Cmd + Shift + A) Claude Code를 더블클릭하세요.

  6. 애플리케이션 승인: 처음 실행할 때 macOS가 보안 메시지를 표시합니다. "열기"를 클릭해서 확인하세요. "열기" 버튼이 나타나지 않으면 시스템 설정 > 개인정보 보호 및 보안으로 가서 Claude Code 관련 메시지 옆의 "어쨌든 열기"를 클릭하세요.

  7. 로그인: 애플리케이션이 Anthropic 계정으로 인증하도록 요청합니다. 이메일과 비밀번호를 입력하세요.

설치가 완료되었어요. Claude Code가 Dock에 나타나고, 아이콘을 우클릭한 후 "옵션" > "Dock에 보관"을 선택해서 빠른 접근을 위해 고정할 수 있습니다.

Command Line을 선호하는 고급 사용자를 위해 brew install --cask claude-code 명령어로 Homebrew를 통한 설치도 가능하지만, 초보자에게는 .dmg 방법이 가장 간단합니다.

설치 후 Claude Code를 어떻게 설정하나요?

Claude Code의 초기 설정은 선호하는 모델(Claude 3.5 Sonnet 권장)을 선택하고, 프로젝트 폴더를 정의하고, 코드 생성 설정을 조정하는 것으로 구성돼요. 이 단계는 2~3분이 걸리며 사용 경험을 크게 향상시킵니다.

필수적으로 해야 할 설정은 다음과 같습니다:

모델 선택

오른쪽 상단의 톱니바퀴 아이콘을 클릭한 후 "모델"을 선택하세요. 여러 Claude 버전에 접근할 수 있습니다:

  • Claude 3.5 Sonnet: 코드 작업에 최적의 균형입니다. 빠르고 정확하며 초보자에게 탁월해요. 기본값이며 우리가 추천하는 선택입니다.
  • Claude 3 Opus: 더 강력하지만 더 느리고 크레딧을 더 많이 소비합니다. 복잡한 프로젝트를 위해 남겨두세요.
  • Claude 3 Haiku: 매우 빠르고 간단한 질문과 가벼운 수정에 이상적입니다.

시작할 때는 Claude 3.5 Sonnet을 유지하세요. 필요에 따라 언제든지 변경할 수 있습니다.

프로젝트 폴더

설정의 "프로젝트" 섹션에서 Claude Code가 프로젝트를 생성하고 저장할 위치를 정의하세요. 기본값은 ~/Documents/ClaudeCode입니다. Mac의 어느 폴더로든 변경할 수 있어요.

실용적인 팁: ~/Projets-Claude 같은 전용 폴더를 만들어서 조직을 깔끔하게 유지하세요. 특히 다른 개발 도구를 이미 사용 중이라면 더욱 그렇습니다.

생성 설정

"설정" > "코드 생성"에서 다음을 조정할 수 있습니다:

  • 주석 상세도: "중간"은 배우기에 완벽해요. "높음"은 생성된 코드에 더 많은 설명을 추가합니다.
  • 코드 스타일: "현대식"(권장) 또는 "고전식" 중에서 선택하세요.
  • 자동 검증: 이 옵션을 활성화하면 Claude가 코드를 제시하기 전에 검증합니다.

키보드 단축키

"설정" > "단축키"에서 빠른 키를 사용자 정의하세요. 가장 유용한 것들:

  • Cmd + N: 새 프로젝트
  • Cmd + Shift + P: 명령 팔레트 열기
  • Cmd + K: 코드 생성 시작

이 설정들을 완료한 후 설정 창 하단의 "적용" 버튼으로 저장하세요.

macOS에서 Claude Code 설치 시 흔한 오류는 뭐고 어떻게 해결하나요?

macOS에서 Claude Code를 설치할 때 가장 흔한 세 가지 오류는 Gatekeeper의 차단, 권한 문제, 그리고 다른 개발 도구와의 충돌입니다. 이들을 식별하고 수정하는 방법을 알려드릴게요.

"애플리케이션을 열 수 없습니다" 오류

Gatekeeper가 Claude Code를 차단할 때 이 메시지가 나타납니다. 해결책:

  1. 시스템 설정 > 개인정보 보호 및 보안으로 가세요
  2. Claude Code 관련 메시지가 보일 때까지 아래로 스크롤하세요
  3. "어쨌든 열기"를 클릭하세요
  4. 관리자 비밀번호로 확인하세요
  5. Claude Code를 다시 실행하세요

문제가 계속되면 Terminal을 열고 다음을 입력하세요:

xattr -cr /Applications/ClaudeCode.app

이 명령어는 때때로 다운로드된 애플리케이션을 차단하는 격리 속성을 제거합니다.

서버 연결 오류

ClaudeCode가 인증 후 연결할 수 없다면:

  • 인터넷 연결을 확인하세요(브라우저를 열어서 테스트해보세요)
  • VPN을 사용 중이라면 일시적으로 비활성화하세요
  • 방화벽이 Claude Code를 차단하지 않는지 확인하세요(시스템 설정 > 보안 > 방화벽 > 방화벽 옵션)
  • 애플리케이션을 다시 시작하세요

오류가 계속되면 Anthropic 서버 문제일 수 있습니다. status.anthropic.com에서 서비스 상태를 확인하세요.

프로젝트 폴더 권한 문제

Claude Code가 "프로젝트 폴더에 쓸 수 없습니다"라고 표시하면:

  1. Finder를 열고 해당 폴더로 이동하세요
  2. 우클릭 > "정보 보기"를 선택하세요
  3. 하단의 자물쇠를 클릭해서 권한을 잠금 해제하세요
  4. "읽기 전용"을 "읽기 및 쓰기"로 변경하세요
  5. 톱니바퀴 > "포함된 항목에 적용"을 클릭하세요

다른 코드 편집기와의 충돌

VS Code, Cursor, 또는 다른 IDE를 이미 설치했다면 Claude Code와 충돌할 수 있습니다. 해결책: 시스템 설정 > 확장 > 기본 텍스트 편집기에서 Claude Code를 기본 편집기로 지정하세요.

Cursor와 Claude Code 중 어느 것을 선택할지 고민하는 사용자들을 위해 우리의 Cursor vs Claude Code 기사에서 각 솔루션의 강점과 약점을 자세히 비교합니다.

설치가 제대로 작동하는지 어떻게 확인하나요?

Claude Code 설치를 테스트하려면 웹 페이지에 "Hello World"를 표시하는 간단한 첫 프로젝트를 만드세요. 이 테스트는 2분이 걸리며 모든 구성 요소가 작동하는지 확인합니다.

완전한 테스트는 다음과 같습니다:

  1. Claude Code 실행: Applications 폴더에서 실행하세요

  2. 새 프로젝트 만들기: "새 프로젝트"를 클릭하거나 Cmd + N을 누르세요

  3. 이름 지정: "test-installation"이라고 부르세요

  4. Claude에 요청: 채팅 바에 정확히 이렇게 입력하세요: "Create a simple HTML page that displays 'Hello World' in large text centered on the screen with a light blue background"

  5. 생성 확인: Claude Code가 몇 초 안에 index.html 파일을 생성해야 합니다. 오른쪽 편집기에 코드가 나타나는 것을 볼 수 있어요.

  6. 결과 미리보기: 오른쪽 상단의 "미리보기" 버튼을 클릭하세요. 웹 페이지가 있는 창이 열립니다.

  7. 수정 테스트: Claude에 "Change the background color to mint green"이라고 요청하세요. 코드가 자동으로 업데이트되어야 합니다.

이 모든 단계가 작동하면 설치가 완벽합니다. Claude Code로 첫 번째 실제 프로젝트를 만들 준비가 되었어요.

도구 사용을 더 깊이 있게 배우려면 고급 기능과 모범 사례를 다루는 우리의 초보자를 위한 완전한 Claude Code 튜토리얼을 참고하세요.

macOS에서 Claude Code를 어떻게 업데이트하나요?

Claude Code는 시작할 때 자동으로 업데이트되지만, 메뉴 도움말 > 업데이트 확인에서 수동으로 업데이트를 강제할 수 있어요. 업데이트는 정기적으로 새로운 기능과 버그 수정을 제공합니다.

자동 업데이트 프로세스:

  • 매번 실행할 때마다 Claude Code가 새 버전이 있는지 확인합니다
  • 있다면 오른쪽 상단에 알림이 나타납니다
  • "업데이트"를 클릭해서 새 버전을 다운로드하세요
  • 설치 후 애플리케이션이 자동으로 다시 시작됩니다
  • 프로젝트와 설정은 유지됩니다

수동 업데이트의 경우:

  1. Claude Code를 열어요
  2. 화면 상단의 "도움말" 메뉴로 가세요
  3. "업데이트 확인"을 클릭하세요
  4. 더 최신 버전이 있으면 "다운로드 및 설치"를 클릭하세요
  5. 다운로드가 완료될 때까지 기다리세요(보통 1~2분)
  6. 애플리케이션이 다시 시작되도록 하세요

주요 업데이트(1.0에서 2.0으로 변경 같은)는 Mac을 완전히 다시 시작해야 할 수 있습니다. Claude Code가 진행하기 전에 알려줄 거예요.

업데이트 빈도: Anthropic은 23주마다 마이너 업데이트를 발표하고 23개월마다 주요 버전을 발표합니다. Anthropic 공식 웹사이트에서 각 업데이트의 새로운 기능을 보는 전체 릴리스 노트를 확인할 수 있습니다.

팁: 설정 > 일반 > "업데이트 자동 설치"에서 자동 업데이트를 활성화해서 생각할 필요 없이 항상 최신 개선사항을 받으세요.

결론

macOS에서 Claude Code를 설치하는 것은 10분 미만이 걸리는 간단한 과정입니다. 애플리케이션이 설정되면 프로그래밍 사전 지식 없이 웹사이트, 애플리케이션, 스크립트를 만들 수 있는 강력한 AI 어시스턴트를 갖게 됩니다. 자동 업데이트는 항상 최신 개선사항을 받을 수 있도록 보장합니다.

이 가이드에서 다루지 않은 문제가 발생하면 Anthropic 공식 문서와 Discord의 Claude Code 커뮤니티가 빠르게 도움을 받을 수 있는 귀중한 자료입니다.