명령어 라인 도구 (Xcode Command Line Tool) 설치하기

오늘 자바를 설치하는 도중에 조금 당황스러운 오류 메시지를 만났다. 메시지는 다음과 같았다:

Error: python@3.13: the bottle needs the Apple Command Line Tools to be installed.
You can install them, if desired, with:
xcode-select --install

이 오류는 내가 python@3.13을 설치하려고 했을 때 나타났는데, "Apple Command Line Tools가 설치되어 있어야 한다"는 메시지가 나왔다. 처음에는 "그게 뭐지?" 하며 조금 헷갈렸지만, 곧 이 도구들이 내가 개발을 할 때 필요한 핵심적인 도구들임을 알게 되었다.

Apple Command Line Tools는 Xcode에서 제공하는 도구들이지만, Xcode를 설치하지 않고도 필요한 도구들만 따로 설치할 수 있는 패키지다. 이 도구들에는 gcc(C 컴파일러), git(버전 관리 도구) 그리고 make(빌드 자동화 도구)와 같은 중요한 프로그램들이 포함되어 있다. Python을 비롯한 다양한 개발 도구들을 설치할 때 이 도구들이 필수적으로 요구된다.

그래서, 바로 터미널을 열고 다음 명령어를 입력했다:

xcode-select --install

그럼 몇 초 후, "Command Line Tools 설치"라는 팝업이 떠서 확인을 클릭하고 기다리기만 하면 됐다. 설치가 완료된 후, 문제가 해결되었는지 확인하기 위해 python@3.13을 다시 설치하려 했더니, 이제 오류 없이 잘 진행되었다. 덕분에 Python도 잘 설치됐다.

이 도구들이 설치된 이유는 여러 개발 작업을 원활하게 하기 위한 것인데, 사실 macOS에서 개발을 하려면 이 도구들이 없으면 꽤 불편하다. 예를 들어, git을 사용하려면 반드시 이 도구들이 설치되어 있어야 하고, Python과 같은 언어를 설치할 때도 필수적으로 필요하다.

설치가 완료된 후, 정상적으로 동작하는지 확인하기 위해 몇 가지 명령어를 실행해봤다. gcc와 git 명령어를 통해 설치가 제대로 되었는지 체크할 수 있다. gcc는 C 언어 컴파일러고, git은 버전 관리 도구로, 개발을 하면서 자주 쓰이는 도구들이기 때문이다.

터미널에 다음 명령어를 입력해봤다:

$ gcc --version

그랬더니 버전 정보가 잘 출력되었다! 마찬가지로 git 버전도 확인할 수 있었다:

$ git --version

이 명령어들도 문제 없이 작동했다. 덕분에 명령어 라인 도구가 제대로 설치되었음을 확인할 수 있었다. 이제 Python을 설치한 후에도 명령어 라인 도구들이 정상적으로 동작하니, 다음 단계로 넘어갈 준비가 된 셈이다.

Xcode vs Xcode Command Line Tools

설치를 진행하면서 Xcode와 Xcode Command Line Tools의 차이점도 알게 됐다. Xcode는 macOS에서 제공하는 통합 개발 환경(IDE)인데, 그래픽 디자인 도구와 iOS/macOS 앱 개발을 위한 다양한 기능들이 포함되어 있다. 반면, Command Line Tools는 Xcode에서 제공하는 텍스트 기반 도구들만 따로 모아놓은 것이다.

그래서 Xcode를 설치하지 않고도 Command Line Tools만 설치하면, 기본적인 개발 환경을 갖출 수 있다. 사실 Xcode를 설치하는 것보다 Command Line Tools만 설치하는 것이 훨씬 가볍고 빠르다. 내가 필요한 건 주로 터미널에서 작업할 도구들이었기 때문에, 이 선택이 더 적합했다.

업데이트

한 가지 더 중요한 점은 명령어 라인 도구들이 자동으로 업데이트되지 않는다는 것이다. 그래서 주기적으로 수동으로 업데이트를 해주어야 한다. 업데이트는 아래 명령어로 진행할 수 있다:

$ softwareupdate --install --all

이 명령어는 macOS의 모든 소프트웨어 업데이트를 설치하며, 그 안에 포함된 명령어 라인 도구도 최신 버전으로 업데이트된다. 업데이트를 놓치지 않도록 주의해야겠다.

문제 해결

만약 설치 후 도구들이 제대로 작동하지 않거나 문제가 생긴다면, xcode-select를 통해 도구들을 재설정할 수 있다. 예를 들어, 도구들이 제대로 연결되지 않으면 다음 명령어로 경로를 재설정할 수 있다:

$ sudo xcode-select --reset

또는, Xcode의 경로를 수동으로 설정해 줄 수도 있다:

$ sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer

이 명령어들이 제대로 실행되면 문제가 해결될 가능성이 크다.

오늘 하루는 조금 복잡했던 과정들이지만, 하나하나 해결하면서 배운 점도 많고, 이제 더 원활하게 개발을 진행할 수 있을 것 같다. 특히, 명령어 라인 도구가 개발에 필수적이라는 걸 다시 한 번 실감했다.