설치

운영체제에 맞는 명령 하나를 실행하고 topaz가 실행되는지 확인하세요. npm 절부터는 다른 설치 방법과 공개 파일을 다룹니다.

명령 하나로 설치하기

macOS와 Linux에서는 터미널에서 다음 명령을 실행하세요.

curl -fsSL https://topaz.ooo/install.sh | sh

Windows에서는 PowerShell에서 다음 명령을 실행하세요.

irm https://topaz.ooo/install.ps1 | iex

설치 스크립트는 시스템에 맞는 최신 공개판을 골라 압축 프로그램을 내려받습니다. 내려받은 파일과 압축을 푼 프로그램은 해당 릴리스의 공개 SHA-256 체크섬과 비교합니다. topaz는 macOS와 Linux에서 ~/.topaz/bin에, Windows에서 %LOCALAPPDATA%\Topaz\bin에 설치됩니다.

설치 확인하기

새 터미널을 열고 토파즈 명령을 찾을 수 있는지 확인하세요.

topaz version

출력은 Topaz 다음에 설치한 버전 번호를 표시합니다. 설치를 확인하거나 문제를 보고할 때 이 버전을 기록하세요.

최신 공개판은 v5.20.4입니다.

명령을 찾지 못하면 새 터미널을 열고 설치 폴더가 PATH에 있는지 확인하세요. Windows 설치 스크립트는 설치 폴더를 사용자 PATH에 더합니다. macOS와 Linux 설치 스크립트는 폴더가 아직 PATH에 없으면 더할 export PATH=... 줄을 출력합니다.

topaz version이 동작하면 첫 프로그램으로 돌아가 첫 파일을 만들고 실행하세요.

설치 없이 시작하기

플레이그라운드에서는 CLI를 설치하지 않고 브라우저에서 토파즈를 편집하고 검사하고 실행합니다. 플레이그라운드는 컴파일러와 인터프리터 WASM을 Worker에서 불러옵니다. 내 JavaScript 애플리케이션에서 토파즈 함수를 부르려면 JavaScript에서 토파즈 함수 부르기를 보세요.

npm으로 설치하기

Node.js 18 이상이 있으면 npm으로 토파즈를 설치할 수 있습니다. topaz-lang 패키지는 설치 스크립트를 실행해 시스템에 맞는 프로그램을 내려받고 공개 SHA-256 체크섬과 비교합니다.

모든 폴더에서 쓰도록 설치하기

npm install -g --allow-scripts=topaz-lang topaz-lang
topaz version

--allow-scripts=topaz-lang은 npm이 topaz-lang의 설치 스크립트만 실행하게 합니다. 최신판 대신 아래 공개판 가운데 하나를 설치하려면 topaz-lang@ 뒤에 그 번호를 붙이세요.

한 폴더에만 설치하기

프로젝트 폴더 하나에만 토파즈를 두려면 그 폴더에서 설치하고 npx로 실행하세요.

npm install topaz-lang
npx topaz version

같은 명령은 node_modules/.bin/topaz에도 있습니다.

설치 스크립트 경고에 답하기

npm 11은 topaz-lang과 그 postinstall 스크립트를 가리키는 npm warn allow-scripts 경고를 출력합니다. 이때도 설치 스크립트는 이미 실행됐습니다. 허용 기록을 그 폴더의 package.json에 남기고 경고를 없애려면 그 폴더에서 다음 명령을 실행하세요.

npm approve-scripts topaz-lang

npm 12는 허용한 설치 스크립트만 실행합니다. npx topaz version이 binary not found를 알리면 설치 스크립트가 실행되지 않은 것입니다. 위처럼 허용한 뒤 설치 스크립트를 다시 실행하세요.

npm rebuild topaz-lang

파일 직접 받기

공개된 릴리스마다 실행파일과 그 크기, SHA-256 체크섬이 있습니다. .gz, .xz, .br 파일은 같은 프로그램을 압축한 것입니다. 아래 버전은 공개된 배포판입니다.

공개일 2026년 10월 17일 · 릴리스 매니페스트

• 전체 체크섬
• 서명
• 서명 정보
• 공개 키

실행하기 전에 파일을 확인하세요. Linux에서는 sha256sum으로 SHA-256 체크섬을 출력합니다.

sha256sum topaz-linux-x86_64

macOS에서는 받은 파일 이름으로 shasum -a 256 topaz-macos-aarch64를 실행하세요. Windows PowerShell에서는 Get-FileHash를 씁니다.

Get-FileHash .\topaz-windows-x86_64.exe -Algorithm SHA256

출력한 값은 표에 있는 그 파일의 SHA-256, 그리고 .sha256 파일의 값과 같아야 합니다. PowerShell은 대문자로 출력합니다. 압축 파일은 한 단계를 더 거칩니다. .gz 파일은 gzip -d로, .xz 파일은 xz -d로 풉니다. .br 파일은 Brotli 도구의 brotli -d로 풀고, 이 도구가 없으면 표에 있는 압축하지 않은 실행파일을 받으세요. 풀어 낸 프로그램은 실행파일의 SHA-256과 비교하세요.

프로그램은 PATH에 있는 폴더에 topaz라는 이름으로 두세요. Windows에서는 topaz.exe입니다. macOS와 Linux에서는 실행 권한도 주세요.

mkdir -p ~/.topaz/bin
mv topaz-linux-x86_64 ~/.topaz/bin/topaz
chmod +x ~/.topaz/bin/topaz

그다음 위처럼 topaz version으로 확인하세요.

네이티브·Web 빌드 도구 더하기

topaz check와 topaz run에는 다른 도구가 필요하지 않습니다. 네이티브 빌드에는 대상 플랫폼용 Cargo가 포함된 Rust 도구가 더 필요합니다. Web 빌드에는 Rust의 wasm32-unknown-unknown 대상도 필요합니다. 이 도구는 첫 애플리케이션에서 사용합니다.

편집기 설정하기

VS Code나 Open VSX 호환 편집기에서는 Visual Studio Marketplace 또는 Open VSX Registry에서 공식 토파즈 확장을 설치하세요. 확장은 .tpz 파일을 인식하고 토파즈 아이콘과 구문 강조를 제공합니다.

확장은 설치된 topaz lsp를 실행해 편집기에 오류 메시지를 보여 줍니다. 컴파일러는 별도로 설치합니다. 편집기가 PATH에서 컴파일러를 찾을 수 있게 하거나 topaz.executablePath에 경로를 지정하세요. 터미널에서 topaz check를 써도 됩니다.

릴리스 서명 확인하기

checksums.txt에는 릴리스의 모든 파일의 SHA-256이 있습니다. checksums.txt.sig는 그 파일의 Ed25519 서명입니다. 파일 표 아래 링크에서 두 파일과 릴리스 공개 키 topaz-release.pub를 받은 뒤, 그 폴더에서 OpenSSL 3으로 서명을 확인하세요.

openssl pkeyutl -verify -pubin -inkey topaz-release.pub -rawin -in checksums.txt -sigfile checksums.txt.sig

OpenSSL은 Signature Verified Successfully를 출력합니다. 릴리스 매니페스트에는 그 릴리스가 공개한 모든 파일이 있습니다.

소스와 라이선스

5.20.4는 전체 Rust 참조 소스를 Apache-2.0으로 보존합니다.

소스 둘러보기

구성요소별 이용 조건과 역사판 소스 스냅샷은 공개 소스와 라이선스에서 확인하세요.

배포 이력

공개된 버전을 선택하면 해당 파일과 소스를 볼 수 있습니다.