Bun 무료 다운로드·설치 방법, 타입스크립트 파일 바로 실행하기

Q: Windows에서 어떤 파일을 선택하나요?

Windows 10 버전 1809 이상의 x64 PC라면 1.4.4 릴리스의 `bun-windows-x64.zip`을 고릅니다. ARM PC는 ARM용 배포 파일명을 확인하세요.

Q: 타입스크립트 파일은 어떻게 실행하나요?

파일이 있는 폴더에서 `bun run index.ts`를 실행하고 터미널의 출력을 확인합니다. 기본 실행과 타입 검사는 별개이며 필요하면 `bun --check index.ts`를 사용하세요.

Q: `bun` 명령어가 인식되지 않으면 어떻게 하나요?

새 터미널을 연 뒤 `bun --version`을 다시 확인하세요. Windows에서는 공식 설치 경로의 실행 파일을 직접 확인하고 PATH에 Bun 폴더가 들어 있는지 살펴보세요.

Q: 기존 npm 프로젝트를 바로 전부 바꿔도 되나요?

프로젝트 폴더에서 `bun install`을 시험할 수 있지만, 의존성의 설치 스크립트와 Node.js API 호환을 확인해야 합니다. 기존 테스트와 실제 실행 결과를 먼저 보세요.

Bun으로 타입스크립트 파일을 바로 실행하려면 운영체제에 맞는 무료 설치 파일을 받은 뒤 터미널에서 bun --version을 확인하세요. 공식 배포는 Bun 설치 문서와 oven-sh/bun의 1.4.4 릴리스에서 찾을 수 있습니다.

Bun은 JavaScript·TypeScript 런타임에 패키지 관리자, 번들러, 테스트 도구를 함께 담은 명령줄 프로그램입니다. 처음 시작하는 사람은 새 폴더에 작은 index.ts 파일을 만든 뒤 bun run index.ts로 결과를 확인하면 됩니다.

Bun

Oven (oven-sh/bun)

1.4.4버전

3종 OS환경

무료가격

TS 실행용도

Bun 1.4.4 Windows·Mac·Linux 공식 다운로드·설치

Bun으로 무엇을 할 수 있나요

Bun은 별도의 그래픽 창에서 코드를 편집하는 앱이 아닙니다. VS Code 같은 편집기에서 파일을 만들고 PowerShell이나 터미널에서 명령어를 실행하는 방식입니다. 공식 문서는 bun run index.ts로 TypeScript 파일을 실행할 수 있으며 JSX 파일도 설정 없이 실행할 수 있다고 안내합니다. 파일 내용은 실행 시 변환되지만, 그 과정이 정적 타입 오류를 모두 검사한다는 뜻은 아닙니다.

프로젝트에 package.json이 있다면 같은 폴더에서 bun install로 의존성을 설치할 수 있습니다. Bun은 설치 결과를 bun.lock에 기록합니다. 기존 npm 프로젝트에서 패키지 설치와 런타임 실행을 한꺼번에 바꾸기보다, 먼저 작은 작업을 실행해 필요한 패키지가 동작하는지 확인하세요. 공식 호환성 문서도 Node.js API와의 호환을 계속 보완하고 있다고 설명합니다.

공식 문서에 나온 Bun 터미널 화면

제작자의 테스트 문서에 실린 터미널 벤치마크 이미지입니다. 명령어를 입력하고 결과를 읽는 형태를 보여 주지만, 이 수치가 모든 PC에서 재현되는 속도나 1.4.4 설치 화면을 뜻하지는 않습니다. Bun은 별도 GUI 없이 터미널에서 사용합니다.

Bun 1.4.4 Windows·Mac·Linux 공식 다운로드·설치

프로그램	Bun
공식 안정 버전	1.4.4 (2026년 10월 28일 확인)
지원 환경	Windows 10 1809 이상, macOS 13 이상, Linux
가격·라이선스	무료 오픈소스 · MIT
공식 배포	Bun 설치 문서와 oven-sh/bun GitHub 릴리스
주요 작업	TypeScript·JavaScript 실행, 패키지 설치, 테스트

운영체제에 맞는 Bun 1.4.4 파일 고르기

Windows 64비트 PC는 공식 1.4.4 릴리스의 bun-windows-x64.zip을 선택할 수 있습니다. Bun 설치 문서는 Windows 10 버전 1809 이상을 요구합니다. 시스템 설정에서 Windows 버전과 64비트 여부를 먼저 확인하고, ARM 장치라면 x64용 ZIP을 ARM 전용 파일로 오해하지 마세요. 공식 릴리스의 Windows ARM 파일명은 bun-windows-aarch64.zip입니다.

Mac의 Apple Silicon 기기에는 bun-darwin-aarch64.zip, Intel Mac에는 bun-darwin-x64.zip이 따로 있습니다. Apple 메뉴의 이 Mac에 관하여에서 칩 종류를 확인하세요. 공식 설치 문서의 최소 macOS 버전은 13입니다. Linux x64는 bun-linux-x64.zip을 볼 수 있지만, 배포판의 libc와 CPU에 따라 다른 Linux 파일을 골라야 할 수 있습니다.

ZIP은 공식 릴리스에서 직접 받을 수 있는 배포 파일이고, 운영체제별 설치 스크립트나 패키지 관리자는 Bun 설치 문서의 별도 경로입니다. Windows에서 설치 스크립트를 선택한다면 공식 문서에 있는 PowerShell 명령을 먼저 확인하세요. 파일을 직접 받는 길과 스크립트로 설치하는 길을 동시에 진행할 필요는 없습니다.

공식 문서는 Bun 자체를 MIT 라이선스로 공개합니다. 따라서 Bun 실행 파일을 받는 데 별도의 구독 결제가 필요하지 않습니다. 프로젝트가 사용하는 외부 패키지나 서비스에는 각자의 비용·라이선스 조건이 있을 수 있으므로 Bun의 무료 배포와 구별해 살펴보세요.

컴퓨터의 Windows 버전·CPU 종류 또는 Mac 칩·Linux 배포판을 확인합니다.
Bun 1.4.4 공식 릴리스에서 해당 플랫폼 이름이 들어간 ZIP을 고릅니다.
설치를 마친 뒤 새 터미널을 열어 bun --version 결과가 1.4.4인지 확인합니다.

타입스크립트 파일 바로 실행하기

처음에는 다른 프로젝트의 설정에 영향을 주지 않는 빈 폴더에서 시작하세요. 편집기로 index.ts를 만들고 console.log("Bun 시작");을 입력해 저장합니다. 터미널에서 그 폴더로 이동한 뒤 bun run index.ts를 실행하면 출력에 Bun 시작이 나타나는지 확인할 수 있습니다. 공식 런타임 문서는 bun index.ts처럼 run을 생략한 형태도 지원한다고 안내합니다.

명령이 실행되었는데 파일을 못 찾는다면 터미널의 현재 폴더와 저장한 파일의 이름부터 맞춰 보세요. index.ts.txt처럼 확장자가 더 붙은 경우에도 원하는 스크립트로 인식되지 않습니다. 편집기의 탐색기에서 파일명을 확인하고, 터미널에서 파일이 있는 폴더로 이동한 후 같은 명령을 다시 입력하면 경로 문제를 구분하기 쉽습니다.

Bun은 TypeScript를 실행하기 전에 변환하지만 기본 실행이 타입 검사 전체를 대신하지는 않습니다. 타입 오류를 실행 전에 확인해야 한다면 공식 런타임 문서의 bun --check index.ts 옵션을 사용하세요. 편집기에서 Bun의 내장 API 타입이 보이지 않으면 공식 TypeScript 문서의 bun add -d @types/bun 안내를 프로젝트에 적용할 수 있습니다.

실제 앱에서는 다른 파일을 불러오거나 환경 변수를 읽는 코드가 추가됩니다. 처음 한 줄이 출력된 다음에는 기존 프로젝트의 진입 파일을 bun run으로 실행해 보세요. Node.js에서 동작하던 패키지라도 차이가 날 수 있으므로, 오류가 생기면 Bun의 Node.js 호환성 문서에서 해당 API의 지원 상태를 확인하는 편이 정확합니다.

새 폴더에 index.ts를 만들고 console.log("Bun 시작");을 저장합니다.
터미널에서 그 폴더로 이동해 bun run index.ts를 입력합니다.
출력에 Bun 시작이 보이는지 확인하고, 타입 검사까지 필요하면 bun --check index.ts로 다시 확인합니다.

기존 JavaScript 프로젝트의 패키지 설치하기

기존 프로젝트를 이어서 작업한다면 먼저 package.json이 있는 폴더를 열어야 합니다. 그 위치에서 bun install을 실행하면 Bun이 의존성을 설치하고 잠금 파일 bun.lock을 작성합니다. 설치가 끝난 뒤에는 프로젝트가 제공하는 package.json의 scripts 이름을 확인하고 bun run dev처럼 그 이름으로 실행하세요. dev 스크립트가 없는 프로젝트에서는 이 명령이 시작 명령이 아닙니다.

새 패키지를 프로젝트 의존성으로 더할 때에는 bun add 패키지명을 사용합니다. @types/bun처럼 개발용 타입 정의는 bun add -d @types/bun으로 넣습니다. 설치와 실행을 구분하면 오류 원인을 찾기 쉽습니다. bun install이 성공했는지, 실행 스크립트가 있는지, 애플리케이션이 실제로 시작됐는지를 순서대로 확인하세요.

Bun 문서에 따르면 설치된 의존성의 임의 생명주기 스크립트는 기본적으로 실행되지 않습니다. 설치 자체는 끝났는데 일부 패키지의 준비 작업이 빠졌다면 그 패키지의 공식 지침과 Bun의 trustedDependencies 설명을 함께 읽으세요. 필요 여부를 모른 채 모든 의존성에 설치 스크립트 실행을 허용하는 방법은 권하지 않습니다.

package.json이 있는 프로젝트 폴더에서 bun install을 실행합니다.
생성된 bun.lock과 설치 완료 출력을 확인합니다.
package.json의 실제 scripts 이름을 확인하고 해당 bun run 이름을 입력해 실행 결과를 봅니다.

Bun 명령어가 인식되지 않을 때

설치 후 PowerShell에서 bun을 찾지 못한다면 먼저 터미널을 닫고 새 창을 여세요. 설치 도중 변경된 PATH는 이미 열려 있던 창에 바로 반영되지 않을 수 있습니다. 그래도 같으면 공식 문서가 제시한 & "$env:USERPROFILE\.bun\bin\bun" --version으로 설치 위치의 실행 파일을 찾을 수 있는지 확인합니다.

위 경로에서는 버전이 보이는데 bun --version만 실패한다면 PATH에 %USERPROFILE%\.bun\bin이 빠진 상태일 수 있습니다. Bun 설치 문서의 Windows PATH 추가 예시를 따라 사용자 환경 변수에 해당 폴더를 추가하고 새 터미널에서 다시 확인하세요. 직접 받은 ZIP을 다른 폴더에 두었다면 실제 압축 해제 위치를 기준으로 경로를 확인해야 합니다.

Windows 버전이 공식 최소 조건보다 낮거나 CPU에 맞지 않는 파일을 선택했다면 PATH를 바꿔도 실행되지 않을 수 있습니다. 설치 오류 메시지와 시스템 정보를 먼저 확인해 배포 파일을 다시 고르세요. Linux에서 실행 라이브러리 오류가 보이는 경우에는 공식 설치 문서의 glibc·musl 구분을 참고할 수 있습니다.

기존 Node.js 프로젝트가 Bun에서 멈춘다면 설치 실패로 단정하지 말고 bun --version과 한 줄짜리 index.ts 실행을 각각 시험해 보세요. 둘은 성공하는데 프로젝트만 실패한다면 해당 패키지나 Node.js API의 호환 여부를 확인할 차례입니다. 이를 분리해야 운영체제 설치 문제와 코드 실행 문제를 헷갈리지 않습니다.

새 터미널에서 bun --version을 다시 실행합니다.
Windows라면 공식 문서의 설치 경로에서 직접 버전 명령을 실행해 파일 존재를 확인합니다.
직접 실행만 된다면 PATH를 점검하고, 둘 다 안 되면 Windows 버전·CPU·선택한 파일을 다시 확인합니다.

Bun과 Node.js를 함께 쓰는 프로젝트에서 확인할 점

Bun은 많은 Node.js 패키지와 API를 지원하지만 공식 호환성 문서도 모든 세부 기능이 완전히 동일하다고 설명하지 않습니다. 회사 프로젝트나 기존 배포 서버에서 런타임을 바꿀 때에는 패키지 설치만으로 전환이 끝났다고 보지 말고 기존 테스트와 실제 실행을 확인해야 합니다.

팀에서 잠금 파일과 CI 명령을 공유한다면 bun.lock이 추가되는 시점을 확인하세요. 기존 패키지 관리자를 그대로 유지하면서 Bun으로 스크립트만 먼저 실행해 볼 수도 있습니다. 어떤 방식이 맞는지는 프로젝트의 의존성·배포 환경에 따라 달라집니다.

공식 터미널 예시의 벤치마크는 특정 테스트를 실행한 결과입니다. 내 프로젝트의 속도나 호환성을 보증하는 숫자로 해석하지 마세요. 처음에는 간단한 TypeScript 파일, 다음에는 현재 프로젝트의 테스트와 실행 순서로 범위를 넓히는 편이 안전합니다.

자주 묻는 질문

Bun은 무료로 받을 수 있나요?

네. Bun 자체는 MIT 라이선스로 공개되고 공식 GitHub 릴리스에서 운영체제별 파일을 받을 수 있습니다. 프로젝트의 별도 유료 서비스·패키지 조건은 각각 확인하세요.

Windows에서 어떤 파일을 선택하나요?

Windows 10 버전 1809 이상의 x64 PC라면 1.4.4 릴리스의 bun-windows-x64.zip을 고릅니다. ARM PC는 ARM용 배포 파일명을 확인하세요.

타입스크립트 파일은 어떻게 실행하나요?

파일이 있는 폴더에서 bun run index.ts를 실행하고 터미널의 출력을 확인합니다. 기본 실행과 타입 검사는 별개이며 필요하면 bun --check index.ts를 사용하세요.

`bun` 명령어가 인식되지 않으면 어떻게 하나요?

새 터미널을 연 뒤 bun --version을 다시 확인하세요. Windows에서는 공식 설치 경로의 실행 파일을 직접 확인하고 PATH에 Bun 폴더가 들어 있는지 살펴보세요.

기존 npm 프로젝트를 바로 전부 바꿔도 되나요?

프로젝트 폴더에서 bun install을 시험할 수 있지만, 의존성의 설치 스크립트와 Node.js API 호환을 확인해야 합니다. 기존 테스트와 실제 실행 결과를 먼저 보세요.

Bun 설치 후 첫 결과 확인하기

Bun 1.4.4 파일을 운영체제에 맞게 받고 새 터미널에서 버전이 표시되면 설치 확인은 끝입니다. 이제 빈 폴더의 index.ts에서 한 줄을 출력해 보세요. 실행 결과가 확인되면 필요한 프로젝트로 넘어가 bun install과 실제 script 실행을 차례대로 확인할 수 있습니다.

Bun은 터미널 도구라 편집기나 운영체제의 선택에 따라 화면이 달라집니다. 공식 문서의 설치 조건과 릴리스 파일명을 기준으로 시작하고, 기존 프로젝트에서는 호환성을 테스트해 사용 범위를 정하세요.