Claude Code macOS 설치 방법 2026 — M1, M2, M3 칩별 주의사항 정리

      u_a395b12a

      Claude Code macOS 설치 방법 2026 — M1, M2, M3 칩별 주의사항 정리

      macOS에서 Claude Code 설치, 가장 쉬운 환경이다

      세 가지 운영체제 중 Claude Code를 설치하기 가장 편한 환경은 macOS입니다. WSL 같은 별도의 사전 작업 없이 터미널에서 명령어 한 줄로 설치가 끝납니다.

      다만 최근 Apple이 Intel 칩에서 Apple Silicon(M1, M2, M3) 칩으로 전환하면서 몇 가지 확인해야 할 사항이 생겼습니다. 칩 종류에 따라 설치 환경이 조금씩 다르고, 일부 도구와의 호환성에서 주의할 점이 있습니다.

      이 글에서는 macOS 환경에서 Claude Code를 설치하는 방법을 2026년 기준으로 정리하고, M1, M2, M3 칩 사용자가 특히 확인해야 할 사항을 함께 안내합니다.

      설치 전 확인사항

      내 Mac의 칩 종류 확인하기

      화면 왼쪽 상단 Apple 로고를 클릭한 뒤 이 Mac에 관하여를 선택합니다. 개요 탭에서 칩 항목을 확인하면 됩니다.

      • Apple M1, M2, M3, M4로 표시되면 Apple Silicon 칩입니다.
      • Intel Core i5, i7, i9 등으로 표시되면 Intel 칩입니다.

      macOS 버전 확인하기

      같은 화면에서 macOS 버전도 확인할 수 있습니다. Claude Code는 최신 macOS 버전에서 가장 안정적으로 작동합니다. 가능하면 최신 버전으로 업데이트한 뒤 설치하는 것을 권장합니다.

      터미널 열기

      macOS에서 터미널을 여는 방법은 두 가지입니다.

      첫 번째는 Spotlight 검색을 이용하는 방법입니다. Command + Space를 누르고 터미널을 입력한 뒤 엔터를 누르면 됩니다.

      두 번째는 Finder를 이용하는 방법입니다. 응용 프로그램 폴더에서 유틸리티 폴더를 열면 터미널 앱을 찾을 수 있습니다.

      터미널 대신 iTerm2를 사용하는 분도 많습니다. iTerm2는 macOS 기본 터미널보다 기능이 많고 편리해서 개발자들이 선호하는 터미널 앱입니다. Claude Code는 기본 터미널과 iTerm2 모두에서 정상적으로 작동합니다.

      Claude Code 설치 — 명령어 한 줄로 끝난다

      터미널을 열고 아래 명령어를 입력합니다.

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

      엔터를 누르면 설치가 자동으로 진행됩니다. 인터넷 연결 속도에 따라 수십 초에서 1~2분 정도 소요됩니다. 설치가 완료되면 터미널에 완료 메시지가 표시됩니다.

      설치 후 아래 명령어로 정상 설치 여부를 확인합니다.

      claude --version

      버전 번호가 출력되면 설치가 정상적으로 완료된 것입니다.

      Homebrew를 이용한 설치 방법

      macOS 개발자라면 Homebrew를 이미 사용하고 있을 가능성이 높습니다. Homebrew를 통해서도 Claude Code를 설치할 수 있습니다.

      brew install --cask claude-code

      다만 Homebrew 설치 방식은 자동 업데이트가 되지 않는다는 점을 알아두세요. 새 버전이 출시됐을 때 아래 명령어로 수동으로 업데이트해야 합니다.

      brew upgrade claude-code

      또한 업그레이드 후에도 이전 버전이 디스크에 남아있어 용량을 차지할 수 있습니다. 주기적으로 아래 명령어를 실행해 정리해주는 것이 좋습니다.

      brew cleanup claude-code

      네이티브 설치 방식(curl 명령어)은 백그라운드에서 자동으로 업데이트되기 때문에, 별도의 관리가 번거롭다면 curl 방식을 사용하는 것이 편합니다.

      M1, M2, M3 칩 사용자 주의사항

      Apple Silicon 칩 사용자라면 아래 사항을 확인해야 합니다.

      Rosetta 2 설치 여부 확인

      일부 도구들이 아직 Apple Silicon을 완전히 지원하지 않아 Rosetta 2를 통해 Intel 버전으로 실행되는 경우가 있습니다. Claude Code 자체는 Apple Silicon을 지원하지만, 함께 사용하는 다른 도구가 Rosetta 2를 필요로 할 수 있습니다.

      Rosetta 2가 설치되어 있지 않다면 아래 명령어로 설치할 수 있습니다.

      softwareupdate --install-rosetta

      Homebrew 경로 확인

      Apple Silicon Mac에서 Homebrew를 사용하는 경우 설치 경로가 Intel Mac과 다릅니다.

      • Intel Mac: /usr/local
      • Apple Silicon Mac: /opt/homebrew

      Homebrew를 통해 설치한 도구가 정상적으로 인식되지 않는다면 경로 설정을 확인해야 합니다. 아래 명령어를 .zshrc 파일에 추가하면 해결되는 경우가 많습니다.

      eval "$(/opt/homebrew/bin/brew shellenv)"

      메모리 관리

      M1, M2, M3 칩은 통합 메모리 구조를 사용합니다. 대규모 프로젝트를 Claude Code로 처리할 때 메모리 사용량이 높아질 수 있습니다. 8GB 모델보다 16GB 이상 모델에서 더 쾌적하게 작동합니다.

      로그인 설정

      설치 완료 후 터미널에서 아래 명령어를 입력해 Claude Code를 실행합니다.

      claude

      처음 실행하면 브라우저가 자동으로 열리면서 Claude.ai 로그인 화면이 나타납니다. Pro 플랜 이상의 계정으로 로그인하면 터미널과 자동으로 연동됩니다.

      로그인이 완료되면 브라우저를 닫고 터미널로 돌아오면 바로 사용할 수 있습니다.

      자동 업데이트 설정

      네이티브 설치 방식으로 설치한 경우 Claude Code는 백그라운드에서 자동으로 업데이트됩니다. 별도로 업데이트 명령어를 입력할 필요가 없습니다.

      자동 업데이트 채널은 두 가지입니다.

      • latest: 새 기능이 출시되는 즉시 업데이트됩니다. 최신 기능을 빠르게 사용하고 싶은 분에게 적합합니다.
      • stable: 출시 후 약 1주일이 지난 안정화된 버전을 사용합니다. 안정성을 우선시하는 분에게 적합합니다.

      기본값은 latest입니다. stable 채널로 변경하고 싶다면 설정 파일에서 autoUpdatesChannel 값을 stable로 변경하면 됩니다.

      macOS 설치 시 자주 겪는 문제

      curl 명령어 실행 시 권한 오류가 발생한다

      macOS 보안 설정으로 인해 발생하는 경우가 있습니다. 시스템 설정에서 개인 정보 보호 및 보안 항목을 확인하고, 터미널의 접근 권한을 허용해주면 해결됩니다.

      claude 명령어를 입력했는데 찾을 수 없다고 나온다

      터미널을 완전히 닫고 다시 열어서 시도해보세요. 그래도 해결되지 않는다면 사용 중인 셸 설정 파일(.zshrc 또는 .bashrc)에 PATH 설정이 제대로 되어 있는지 확인해야 합니다.

      zsh를 사용하는 경우 아래 명령어로 설정 파일을 다시 불러옵니다.

      source ~/.zshrc

      Homebrew로 설치했는데 버전이 오래됐다고 표시된다

      Homebrew 방식은 자동 업데이트가 되지 않습니다. 아래 명령어로 수동 업데이트를 진행하세요.

      brew upgrade claude-code

      업그레이드가 실패하는 경우 새 버전이 아직 Homebrew에 반영되지 않은 것일 수 있습니다. 잠시 기다렸다가 다시 시도해보세요.

      VS Code와 연동하기

      macOS 환경에서 VS Code와 Claude Code를 함께 사용하는 방법은 간단합니다. VS Code를 열고 내장 터미널(Control + 백틱)을 실행한 뒤 claude 명령어를 입력하면 됩니다.

      VS Code 내장 터미널은 macOS 기본 터미널과 동일한 환경이기 때문에 별도의 설정 없이 바로 사용할 수 있습니다. VS Code에서 코드를 보면서 Claude Code로 명령을 내리는 방식으로 작업하면 두 도구의 장점을 모두 활용할 수 있습니다.

      마무리

      macOS는 Claude Code를 설치하기 가장 간단한 환경입니다. 명령어 한 줄로 설치가 끝나고, Apple Silicon 칩을 사용하는 경우에도 몇 가지 사항만 확인하면 문제없이 사용할 수 있습니다.

      설치 후 바로 프로젝트 폴더에서 claude 명령어를 실행해보세요. 처음 몇 가지 명령어를 입력해보는 것만으로도 Claude Code가 어떤 도구인지 빠르게 파악할 수 있습니다. 다음 글에서는 Claude Code를 VS Code와 연동하는 방법을 설정부터 실전 활용까지 자세하게 정리해드리겠습니다.

      다음 글 예고: Claude Code VS Code 연동 방법 2026 — 설정부터 실전 활용까지

      8번 글로 바로 이어서 작성할까요? “네”라고 답해주시면 진행하겠습니다.

      Related Posts

      답글 남기기

      이메일 주소는 공개되지 않습니다. 필수 필드는 *로 표시됩니다