Clojure 설치하기

Clojure 설치하기

Clojure 언어는 JAR 파일 형태로 제공돼요. 보통 Maven Central Repository라는 JVM 아티팩트용 공개 저장소에서 받을 수 있는데요, 이 페이지가 다루는 건 바로 이 언어가 아니라, 그 언어를 내려받고 실행하는 명령줄 도구(Clojure CLI) 쪽이에요. 이 도구는 clojure와 clj라는 명령으로 쓰이며, Clojure 자체와 그 외 Clojure·JVM 라이브러리들을 내려받을 수 있어요. 더 자세한 버전 정보는 Releases 페이지에서 확인할 수 있죠.

여기서 꼭 짚고 넘어갈 점이 하나 있어요. 어떤 버전의 Clojure CLI든, 어떤 버전의 Clojure 언어든 서로 마음대로 조합해서 쓸 수 있어요. 둘은 완전히 독립적이거든요. 다만 버전 번호가 서로 연결되어 있어서 헷갈리기 쉬운데요, 언어는 3자리 버전(예: 1.12.0)을 쓰고 CLI는 4자리 버전(예: 1.12.0.1456)을 써요. CLI 버전 앞 3자리가 REPL에서 기본으로 쓰일 언어 버전을 가리켜요. 물론 deps.edn 설정 파일에 따로 지정하면 그걸 따르게 되고요.

출처: Clojure 공식문서

본문

Mac OS에서 설치하기

필요한 것: Java, brew

먼저 Clojure tap을 신뢰하는 tap으로 추가해요. 이것은 한 번만 하면 되는 작업이에요.

brew trust clojure/tools

그다음 tap에서 Clojure 레시피를 설치하면, clojure와 clj 명령이 시스템에 추가돼요.

brew install clojure/tools/clojure

이미 CLI가 설치되어 있다면, 이 명령으로 최신 버전으로 업그레이드할 수 있어요.

brew upgrade clojure/tools/clojure

Linux에서 설치하기

필요한 것: Java, bash, curl, rlwrap

Linux 스크립트 설치기로 설치하는 방법이에요.

  1. 다음 의존성이 설치되어 있는지 확인해요: bash, curl, rlwrap, 그리고 Java.
  2. linux-install 스크립트로 설치를 다운로드해 실행해요. 그러면 실행 파일 /usr/local/bin/clj, /usr/local/bin/clojure와 디렉터리 /usr/local/lib/clojure가 만들어져요.
curl -L -O https://github.com/clojure/brew-install/releases/latest/download/linux-install.sh
chmod +x linux-install.sh
sudo ./linux-install.sh

다른 위치(예: /opt/infrastructure/clojure)에 설치하고 싶다면 --prefix 옵션을 쓰면 돼요.

sudo ./linux-install.sh --prefix /opt/infrastructure/clojure

매뉴얼 페이지를 쓰고 싶다면, /etc/man_db.conf의 MANPATH에 그 경로를 추가해도 좋아요.

MANPATH_MAP /opt/infrastructure/clojure/bin /opt/infrastructure/clojure/man

설치가 끝나면 linux-install 스크립트는 지워도 돼요.

POSIX에서 설치하기

linux 설치기의 POSIX 버전도 함께 제공되고 있어요. 이 설치기는 Linux, BSD, 심지어 Mac에서도 동작하는데요, 다만 brew와 충돌하니 주의하세요.

  1. 다음 의존성이 설치되어 있는지 확인해요: bash, curl, rlwrap, 그리고 Java.
  2. posix-install 스크립트로 설치를 다운로드해 실행해요. 역시 /usr/local/bin/clj, /usr/local/bin/clojure와 /usr/local/lib/clojure가 만들어져요.
curl -L -O https://github.com/clojure/brew-install/releases/latest/download/posix-install.sh
chmod +x posix-install.sh
sudo ./posix-install.sh

커스텀 위치 설치는 linux 설치기와 똑같이 --prefix 옵션으로 해요.

sudo ./posix-install.sh --prefix /opt/infrastructure/clojure

매뉴얼 페이지가 필요하면 /etc/man_db.conf에 이렇게 추가해요.

MANPATH_MAP /opt/infrastructure/clojure/bin /opt/infrastructure/clojure/man

posix-install 스크립트는 설치 후 지우면 돼요.

Windows에서 설치하기

필요한 것: Java

Windows Subsystem for Linux (WSL)

아직 WSL을 쓰고 있지 않다면, 이걸 쓰는 걸 추천해요. 기존의 대부분 Clojure 튜토리얼·문서와 가장 잘 맞거든요. WSL을 설치한 뒤에는 Linux 설치 방법을 그대로 따라가면 돼요.

Windows 설치기

대안으로 clj-msi를 써서 시스템에 clojure.exe를 설치할 수도 있어요. 다른 방식들에서 쓰는 clojure 스크립트와 비슷하게 사용할 수 있죠.

brew (Mac 또는 Linux)

brew는 Mac OS X 또는 Linux용 패키지 관리자예요. 설치하려면 brew.sh에 가서 자기 OS에 맞는 설치 안내를 따라가면 돼요.

Java — 사전 요구 사항

Clojure는 Java가 필요해요. Clojure는 공식적으로 Java LTS 릴리스를 지원하는데(현재 Java 8, 11, 17, 21, 25), 중간 버전들도 잘 동작하도록 노력하고 있어요. 배포판은 뭐든 써도 돼요 — Oracle의 상용 릴리스든, Temurin 같은 OpenJDK 기반 오픈소스라도요. Clojure 도구가 요구하는 건 딱 하나예요. java 명령이 PATH에 있거나, JAVA_HOME 환경 변수가 설정되어 있으면 됩니다.

Java가 아직 없다면 Adoptium Temurin 25 설치를 추천해요. 설치기는 이렇게 쓰면 돼요.

  • adoptium.net에 가서
  • 자기 플랫폼에 맞는 설치기를 내려받아 실행하고
  • java가 시스템 PATH에 있는지 확인해요

Mac에서는 brew로도 Temurin을 설치할 수 있어요.

  • brew install --cask temurin@25 (이전 이름은 AdoptOpenJDK)

java --version을 실행해 Java 버전을 확인해 보세요. Temurin 25가 아니라면, java를 PATH에 직접 추가해야 할 수도 있어요.

echo 'export PATH="/Library/Java/JavaVirtualMachines/temurin-25.jdk/Contents/Home/bin:$PATH"' >> ~/.zshrc

CLI의 아카이브·시험판 버전 설치하기

다른 버전의 Clojure CLI를 원한다면, 버전 역사는 changelog에서, 이전 버전이나 최신 시험판 설치 방법은 Clojure tap에서 확인할 수 있어요.

더 알아보기