Skip to main content
macOS에서 AI/ML 개발 환경을 구성하는 순서입니다. Windows 문서와 동일하게 단계별로 따라 할 수 있도록 구성했습니다.

​
사전 준비

  • macOS 13 이상 (권장: 최신 버전)
  • 관리자 권한 계정
  • 인터넷 연결
Apple Silicon(M1/M2/M3/M4)과 Intel Mac 모두 사용할 수 있습니다. 명령어는 대부분 동일하며, Homebrew 경로만 일부 다를 수 있습니다.

​
권장 설치 순서

  1. Homebrew
  2. Git
  3. Visual Studio Code
  4. Node.js
  5. uv + Python
  6. PyTorch (MPS)
  7. Rancher Desktop
  8. Ollama
  9. Claude Desktop
  10. Claude Code

​
기본 점검

터미널을 열고 아래 명령어를 실행합니다. 
sw_vers
uname -m
xcode-select -p
  • uname -m이 arm64면 Apple Silicon입니다.
  • uname -m이 x86_64면 Intel Mac입니다.
  • xcode-select -p에서 경로가 출력되지 않으면 Command Line Tools를 먼저 설치합니다.

​
설치 점검 목록

  • 관리자 권한/필수 도구 등 사전 요구사항을 먼저 확인했습니다.
  • 설치 후 버전 확인 명령어(--version)를 실행해 정상 설치를 검증했습니다.
  • PATH/환경변수 변경이 필요한 경우 터미널을 다시 열어 적용 여부를 확인했습니다.
  • 문제가 생겼을 때를 대비해 설치 로그 또는 스크린샷을 남겼습니다.

​
문제 해결 가이드

  • 설치 파일이 실행되지 않으면 관리자 권한으로 다시 실행합니다.
  • 명령어가 인식되지 않으면 터미널을 새로 열고 PATH 반영 여부를 확인합니다.
  • 버전이 맞지 않으면 기존 설치를 정리한 뒤 권장 버전으로 재설치합니다.
  • 설정 변경 후 동작이 이상하면 시스템 재시작 후 다시 확인합니다.

​
관련 문서

Setup 홈

운영체제별 설치 흐름을 다시 확인합니다.

다음: Homebrew

다음 설치 단계를 이어서 진행합니다.