Xcode Command Line Tool 설치하기 - updated. 2025

맥에서 개발환경을 세팅하면서 이것저것 설치할 때, 아래와 같은 에러가 발생하는 경우가 있다.

다양한 상황에서 발생하는 에러이지만 결국에는 Command Line Tool을 설치하라는 안내가 있다. 

 

맥에서 개발을 할 때 개발환경 구성을 위해 커맨드라인 명령어를 사용해야 하는데, 맥의 네이티브 앱 개발을 위한 무거운 Xcode를 설치하는 것은 부담스러운 일이다. 네이티브 앱을 개발할 일이 없을 때에는 위의 안내와 같이 Xcode 커맨드 라인 도구를 설치하면 된다.

 

명령어 라인 도구 설치 방법

먼저 위의 에러 메시지에서 하라는 대로 커맨드 라인에 입력한다.

$ xcode-select --install

 

위와 같이 입력하면 커맨드 라인에는 command line tool을 설치한다는 안내가 보여지고, 별도의 설치 안내 창이 실행된다.

설치를 눌러 진행한다.

 

사용자 계약 동의를 누르면 아래와 같이 소프트웨어 다운로드가 시작되고, 

다운로드가 완료되면 설치까지 완료된다.

설치가 완료되면, 커멘드 라인에서 사용할 수 있는 여러 도구들을 설치/사용할 수 있게 된다.

맥을 이용하여 개발을 하려고 한다면 필수적인 도구이니 꼭 설치하자.

 

---

 

설치 오류가 발생한다면? 해결 방법 정리 (2025년 기준)

간혹 xcode-select --install 명령어를 실행했을 때, 다음과 같은 오류 메시지가 뜨는 경우가 있다.

xcode-select: error: command line tools are already installed, use "Software Update" to install updates

이 메시지는 말 그대로 이미 Command Line Tools가 설치되어 있어서 다시 설치할 수 없다는 뜻이다.
그런데 문제는, 일부 업데이트가 누락되었거나 도구가 제대로 작동하지 않을 때도 이런 메시지가 뜰 수 있다는 점이다.

해결 방법 1 : 기존 설치본 삭제 후 재설치

이럴 땐 아래 명령어로 기존에 설치된 Command Line Tools를 완전히 삭제한 다음 다시 설치해본다.

sudo rm -rf /Library/Developer/CommandLineTools xcode-select --install

위 명령어를 실행하면, 기존 설치본이 삭제되고 다시 설치 창이 뜬다. 그대로 안내에 따라 설치하면 된다.

 

해결 방법 2 : 수동 설치 (Apple Developer 사이트 이용)

xcode-select --install이 제대로 작동하지 않거나, 최신 버전을 직접 받고 싶은 분들은 다음 방법도 있다.

1. Apple Developer 다운로드 페이지에 접속
2. Apple ID로 로그인
3. Command Line Tools for Xcode 검색
4. 사용하는 macOS 버전에 맞는 최신 버전 선택 후 다운로드
5. 다운로드한 .dmg 파일을 열어 설치 진행

이 방법은 특히 기업용 맥이나 개발 환경이 까다로운 경우에 유용하다.

 

설치 상태 확인 방법

설치가 제대로 되었는지 확인하고 싶다면 아래 명령어를 터미널에 입력해본다.

xcode-select -p

출력 결과가 /Library/Developer/CommandLineTools처럼 나오면 설치가 정상적으로 완료된 것이다.