Bun 1.4.4 무료 다운로드·설치, 타입스크립트 파일 바로 실행하기
Bun은 JavaScript·TypeScript 파일을 실행하고 프로젝트 패키지를 설치하는 무료 명령줄 프로그램입니다. 공식 1.4.4 릴리스에서 Windows x64, Mac Apple Silicon, Linux x64용 ZIP을 고를 수 있습니다. 운영체제와 CPU 종류를 먼저 확인한 뒤 맞는 파일을 받으세요. Bun 자체는 MIT 라이선스로 공개됩니다.
Bun 1.4.4 운영체제별 공식 ZIP
Windows x64는 `bun-windows-x64.zip`, Apple Silicon Mac은 `bun-darwin-aarch64.zip`, Linux x64는 `bun-linux-x64.zip`입니다. Intel Mac, Windows ARM, Linux ARM은 공식 릴리스에서 이름이 맞는 별도 파일을 선택하세요.
파일 이름과 내 컴퓨터 환경 맞추기
Windows에서 받은 파일 이름이 bun-windows-x64.zip이면 64비트 x64용입니다. Bun 공식 설치 문서는 Windows 10 버전 1809 이상을 요구하므로 설정의 Windows 정보에서 버전을 먼저 확인하세요. ARM 기반 Windows 기기에 x64용 파일을 무조건 권할 수는 없습니다. 공식 릴리스의 bun-windows-aarch64.zip을 확인하세요.
Mac에서 aarch64 표기는 Apple Silicon을 뜻합니다. Intel Mac이라면 bun-darwin-x64.zip처럼 이름에 x64가 들어간 파일을 고르세요. 공식 문서가 안내하는 macOS 최소 버전은 13입니다. Apple 메뉴의 이 Mac에 관하여에서 칩과 OS 버전을 함께 확인할 수 있습니다.
Linux에서 x64 컴퓨터라도 배포판의 libc 조건에 따라 일반 bun-linux-x64.zip과 musl 계열 파일 중 선택이 달라질 수 있습니다. 공식 설치 문서는 glibc 2.17 이상과 musl 대안을 설명합니다. ARM64 기기는 x64 파일 대신 aarch64 이름이 들어간 배포 파일을 확인하세요.
- 운영체제 버전과 CPU 종류를 확인합니다.
- 공식 1.4.4 릴리스의 파일명에서 OS와 CPU 표기를 맞춥니다.
- 맞는 ZIP 하나만 선택해 받습니다.
Windows에서 ZIP과 설치 스크립트 중 선택하기
위의 Windows 파일은 GitHub 릴리스가 직접 제공하는 ZIP입니다. 받은 파일의 이름이 bun-windows-x64.zip인지 확인하고 압축을 풉니다. Bun은 단일 실행 파일을 배포하는 도구이므로 압축 해제 위치에서 파일을 찾을 수 있습니다. 터미널 어디에서나 bun을 입력하려면 실행 파일이 놓인 폴더가 PATH에 포함되어야 합니다.
공식 설치 문서는 Windows용 PowerShell 설치 스크립트도 제공합니다. 스크립트로 설치하기로 했다면 공식 설치 안내의 현재 명령과 주소를 읽고 그 경로 하나를 사용하세요. ZIP을 직접 받은 경우에는 자동 설치 스크립트를 다시 실행할 필요가 없습니다. 두 방식의 차이는 파일을 직접 관리하느냐 설치 과정에서 경로 설정까지 진행하느냐입니다.
설치 방식과 관계없이 새 PowerShell 창에서 bun --version을 입력하고 1.4.4가 표시되는지 확인하세요. 이미 다른 버전의 Bun을 사용 중이라면 PATH에서 어느 실행 파일이 먼저 잡히는지 확인해야 할 수 있습니다. 단순히 ZIP을 다시 받아 같은 오류를 반복하기보다 현재 설치 경로를 확인하는 편이 빠릅니다.
- Windows x64 ZIP을 받았다면 압축을 풀고 실행 파일의 위치를 확인합니다.
- 설치 스크립트를 선택했다면 Bun 공식 설치 문서의 Windows 절차를 따릅니다.
- 새 PowerShell 창에서
bun --version을 실행해 설치된 버전을 확인합니다.
Mac과 Linux에서 파일을 받는 순서
Mac Apple Silicon용 ZIP은 파일명에 darwin-aarch64가 들어 있습니다. Intel Mac이라면 이 버튼의 파일과 칩 종류가 다르므로 공식 릴리스에서 darwin-x64 파일을 찾으세요. macOS 버전까지 확인한 뒤 한 종류만 받으면 됩니다. 운영체제의 보안 확인 화면이 나오면 내려받은 파일의 출처와 파일명을 공식 릴리스에서 대조하세요.
Linux x64용 ZIP은 bun-linux-x64.zip입니다. glibc가 오래되었거나 Alpine처럼 musl을 쓰는 환경에는 공식 문서가 musl용 파일을 따로 안내합니다. ARM64 장치도 별도 파일입니다. 사용 중인 배포판·CPU·libc를 확인하고 릴리스의 해당 항목을 선택하세요.
공식 문서에는 Mac과 Linux를 위한 설치 스크립트, Homebrew, Docker 등 다른 방법도 있습니다. 터미널에서 버전이 표시되는지 확인하는 마지막 단계는 같습니다. 직접 받은 ZIP을 사용한다면 압축을 푼 파일의 위치가 셸 PATH에 포함되어야 다른 폴더에서도 bun 명령을 사용할 수 있습니다.
- Mac 칩 또는 Linux CPU와 배포판 조건을 확인합니다.
- 공식 릴리스에서 해당 이름의 파일을 받거나 설치 문서의 한 가지 설치 방식을 택합니다.
- 새 터미널에서
bun --version결과를 확인합니다.
다운로드와 버전 확인이 막힐 때
릴리스의 ZIP 파일이 내려받아지지 않으면 먼저 GitHub 1.4.4 릴리스 페이지가 열리는지 확인하세요. 파일 버튼의 주소가 github.com/oven-sh/bun/releases/download/bun-v1.4.4/로 시작하는지와 선택한 파일명이 맞는지 대조할 수 있습니다. 웹 브라우저가 오래된 파일명을 기억한다면 릴리스 목록에서 현재 버전의 자산을 다시 고르세요.
파일은 받았는데 bun 명령이 없다고 나온다면 다운로드 오류와 설치 경로 문제를 구분해야 합니다. Windows 공식 문서는 & "$env:USERPROFILE\.bun\bin\bun" --version으로 설치 위치를 직접 확인하는 방법을 제시합니다. 여기서는 동작하고 bun --version만 안 되면 PATH를 확인하고 새 터미널을 여세요. 직접 ZIP을 푼 위치는 다를 수 있습니다.
버전은 보이지만 TypeScript 파일 실행에 실패한다면 파일을 저장한 폴더에서 bun run index.ts를 실행했는지 확인하세요. 확장자와 파일명도 맞춰 보세요. 기존 Node.js 앱만 실패한다면 Bun 설치보다 패키지나 API 호환 문제일 수 있으므로 공식 호환성 문서를 참고해 재현되는 명령을 좁혀 보는 것이 좋습니다.
- 공식 릴리스 주소와 선택한 ZIP 이름을 대조합니다.
- 새 터미널에서
bun --version을 실행합니다. - 명령어가 없으면 PATH를, 프로젝트만 실패하면 파일 경로와 호환성을 확인합니다.
자주 묻는 질문
Bun 1.4.4 파일을 무료로 받을 수 있나요?
네. Bun 자체는 MIT 라이선스이며 공식 oven-sh/bun 릴리스에서 OS별 ZIP을 받을 수 있습니다.
Windows ARM에서는 x64 ZIP을 선택하나요?
x64 ZIP은 ARM 전용 파일이 아닙니다. 공식 1.4.4 릴리스의 bun-windows-aarch64.zip을 확인하세요.
Intel Mac은 어떤 파일을 찾나요?
이 글의 Apple Silicon 파일 대신 공식 릴리스에서 bun-darwin-x64.zip을 찾고, macOS 13 이상인지 확인하세요.
ZIP을 받은 뒤 버전은 어디서 확인하나요?
설치 경로를 설정한 뒤 새 터미널에서 bun --version을 실행합니다. 직접 푼 ZIP은 그 폴더의 경로가 PATH에 들어가야 합니다.
터미널에서 Bun이 없다고 나오면 다시 받아야 하나요?
먼저 새 터미널과 PATH를 확인하세요. Windows에서는 공식 문서의 설치 위치에 있는 실행 파일로 버전 확인을 해 볼 수 있습니다.
파일 선택을 마친 뒤
운영체제와 CPU에 맞는 Bun 1.4.4 파일 하나를 받고 새 터미널에서 버전이 출력되면 준비가 끝납니다. Windows의 버전 조건, Mac의 칩 종류, Linux의 libc 구분을 파일명과 함께 확인하면 다른 플랫폼의 ZIP을 받는 일을 줄일 수 있습니다.
첫 작업은 작은 index.ts 파일을 만들고 bun run index.ts로 출력이 나오는지 확인하는 것입니다. 그다음 기존 프로젝트의 패키지와 실행 스크립트를 차례로 시험하세요.