Helix 25.07.1 무료 다운로드·설치 방법, 터미널에서 코드 편집하기
Helix는 터미널에서 코드와 텍스트 파일을 편집하는 무료 오픈소스 프로그램입니다. 25.07.1 공식 릴리스는 Windows x86_64용 ZIP, Mac Intel·Apple Silicon과 Linux x86_64·ARM64용 tar.xz를 제공합니다. 운영체제와 CPU를 먼저 확인한 뒤 해당 파일 하나를 선택하세요.
Helix 25.07.1 운영체제별 공식 파일
Windows 64비트 PC는 x86_64-windows.zip, M 계열 맥은 aarch64-macos.tar.xz, Intel 맥은 x86_64-macos.tar.xz를 고릅니다. Linux는 x86_64와 aarch64 파일이 따로 있습니다. Windows 파일은 설치 마법사가 아니라 압축 파일입니다.
Windows·맥·Linux 파일 이름 구별하기
Windows 설정에서 시스템 종류가 64비트 x86 기반인지 확인하세요. 해당하면 helix-25.07.1-x86_64-windows.zip을 고릅니다. ZIP을 받으면 압축 해제가 필요하며, 클릭해서 진행하는 EXE 설치 파일로 설명된 배포는 아닙니다. 파일 이름에 25.07.1과 windows가 함께 있는지 살펴보세요.
맥에서는 Apple 메뉴의 이 Mac에 관하여에서 칩을 확인하세요. Apple Silicon의 M 계열이면 aarch64-macos.tar.xz, Intel이면 x86_64-macos.tar.xz입니다. 둘 다 macOS용이지만 실행 파일의 CPU 종류가 달라 서로 바꿔 쓸 수 없습니다.
Linux도 x86_64와 aarch64가 나뉩니다. PC 프로세서가 일반적인 x86-64인지 ARM64인지 확인한 뒤 같은 표기의 tar.xz를 선택하세요. 운영체제만 보고 고르지 말고 파일 이름의 CPU 표기까지 일치시켜야 합니다.
- 운영체제와 CPU 종류를 확인합니다.
- 25.07.1 릴리스에서 둘 다 일치하는 파일을 고릅니다.
- 브라우저 다운로드 목록에서 파일 저장이 끝났는지 확인합니다.
압축을 풀고 hx와 runtime 함께 준비하기
공식 설치 문서는 릴리스 압축 파일 안에 hx 편집기와 runtime 파일이 함께 있다고 설명합니다. 다운로드가 끝났다면 파일을 원하는 폴더에 풀고, 그 안의 구성 요소를 함께 보관하세요. hx만 복사해 다른 곳에 두면 Helix가 구문 강조나 테마 등에 쓰는 runtime을 못 찾을 수 있습니다.
터미널 어디에서나 hx를 실행하려면 hx가 있는 폴더를 명령 경로(PATH)에 넣어야 합니다. Windows에서 환경 변수 변경 후 이미 열려 있던 터미널은 새 값을 모를 수 있으므로 새 창을 열어 hx 명령을 확인하세요. Mac과 Linux도 사용하는 셸의 PATH 설정을 점검합니다. 정확한 runtime 배치 방법은 운영체제와 설치 위치에 따라 공식 문서의 탐색 순서를 따르세요.
준비 후 hx –health를 실행하면 Helix가 필요한 경로와 언어 기능을 어떻게 인식하는지 확인할 수 있습니다. runtime을 기본 탐색 위치와 다른 곳에 뒀다면 공식 문서의 HELIX_RUNTIME 환경 변수로 위치를 지정할 수 있습니다. 문제를 해결하려고 압축 파일 안의 구조를 임의로 버리지 말고 먼저 실제 설치 위치를 확인하세요.
- 압축을 풀고 hx와 runtime 폴더가 있는지 확인합니다.
- hx가 있는 폴더를 PATH에 등록하고 새 터미널을 엽니다.
- hx –health로 runtime 인식 상태를 확인합니다.
받은 뒤 첫 파일을 편집해 보기
터미널에서 연습용 텍스트 파일의 폴더로 이동하고 hx 파일이름으로 파일을 여세요. 기본은 일반 모드이므로 i를 눌러 입력 모드로 바꾼 다음 한 단어를 고칩니다. Esc로 일반 모드에 돌아와 :w로 저장하고 :q로 종료하세요.
같은 파일을 다시 열어 고친 내용이 남았다면 다운로드와 첫 실행, 저장까지 확인한 것입니다. 실제 서버 설정 파일을 고치기 전에는 원본 사본을 만들고, 저장 뒤 해당 서비스의 설정 검사나 반영 절차까지 따로 확인하세요. Helix 자체의 저장만으로 서비스에 새 설정이 자동 적용되는 것은 아닙니다.
- hx 파일이름으로 연습 파일을 엽니다.
- i로 입력 모드에 들어가 수정하고 Esc로 돌아옵니다.
- :w로 저장하고 :q로 종료한 뒤 다시 열어 확인합니다.
다운로드와 실행 문제가 생겼다면
다운로드한 파일이 열리지 않으면 먼저 파일 이름의 운영체제·CPU 표기를 확인하세요. Mac ARM64 파일은 Intel 맥용이 아니고 Linux 파일도 Windows에서 실행되지 않습니다. 저장이 중단됐거나 압축이 손상됐다면 브라우저 다운로드 목록에서 완료 상태를 확인하고 공식 릴리스의 같은 파일을 다시 받으세요.
hx가 없다는 오류는 PATH 설정이나 압축 해제 위치를 확인할 신호입니다. 압축을 푼 폴더에서 실제 hx 파일이 있는지 살피고, PATH를 바꿨다면 새 터미널에서 재시도하세요. Helix가 열리지만 테마·구문 강조가 이상하면 hx –health로 runtime 경로를 확인하고 공식 설치 문서와 비교합니다.
언어별 자동 완성이 없는 경우에는 편집기 실행 문제와 구분하세요. 공식 기능은 언어 서버와 연결될 수 있지만 필요한 언어 서버가 설치·설정되지 않았다면 완성 제안이 보이지 않을 수 있습니다. hx –health에서 언어별 상태를 확인한 후 그 언어의 설정을 살펴보면 됩니다.
자주 묻는 질문
Windows에서 어떤 파일을 받나요?
64비트 x86 PC라면 helix-25.07.1-x86_64-windows.zip입니다. ZIP을 풀어 hx와 runtime을 함께 준비하는 배포 방식입니다.
Apple Silicon 맥은 Intel 파일을 써도 되나요?
CPU용 파일이 분리돼 있습니다. M 계열 칩은 aarch64-macos.tar.xz, Intel 칩은 x86_64-macos.tar.xz를 선택하세요.
압축을 풀었는데 hx 명령이 안 됩니다.
hx가 있는 실제 폴더를 PATH에서 찾을 수 있는지 확인하고 새 터미널을 여세요. 공식 설치 문서에 운영체제별 배치 안내가 있습니다.
runtime은 왜 필요한가요?
Helix가 테마와 구문 정보 등을 찾는 데 쓰입니다. hx만 따로 옮겨 놓았다면 hx –health로 경로를 확인하세요.
내 기기에 맞는 Helix 파일로 시작하기
Helix 25.07.1은 운영체제뿐 아니라 CPU 종류에 따라 공식 압축 파일이 달라집니다. 파일 이름을 맞춰 받은 뒤 hx와 runtime을 함께 풀고, PATH와 hx –health 결과를 확인하세요.
첫 실행에서는 연습 파일 하나를 열어 수정하고 :w로 저장한 뒤 다시 열어 보세요. 이 과정이 끝나면 실제 코드나 설정 파일도 사본을 만들어 같은 흐름으로 편집할 수 있습니다.