메인 콘텐츠로 건너뛰기
Windows 사용자ClickHouse는 Linux 및 macOS에서 네이티브로 실행됩니다. Windows에서는 Windows Subsystem for Linux (WSL) 환경에서 다음 단계를 실행하십시오.
ClickHouse CLI(clickhousectl)를 사용하면 로컬 ClickHouse 버전을 설치하고 관리하고, 서버를 시작하고, 쿼리를 실행할 수 있습니다.
1

ClickHouse CLI 설치

curl https://clickhouse.com/cli | sh
편의를 위해 chctl 별칭도 자동으로 생성됩니다.
2

ClickHouse 설치

최신 버전의 ClickHouse를 설치하고 기본값으로 설정합니다.
clickhousectl local use latest
local use는 해당 버전이 아직 설치되어 있지 않으면 설치하고, 이를 기본값으로 설정하며, ~/.local/bin(PATH에 포함됨)에 clickhouse 심볼릭 링크를 생성해 clickhouse 바이너리를 직접 실행할 수 있게 합니다. 따라서 이 문서의 이후 단계에서 clickhouse 명령을 그대로 실행할 수 있습니다.특정 버전을 선택할 수도 있습니다.
clickhousectl local use 26.5            # 최신 26.5.x.x
clickhousectl local use 26.5.2.39       # 정확한 버전
use와 install의 차이clickhousectl local use <version>은 버전을 설치하고 동시에 기본값으로 설정하며, PATHclickhouse 심볼릭 링크를 업데이트합니다. 기본값이나 심볼릭 링크는 변경하지 않고 버전만 다운로드하려면 clickhousectl local install <version>을 사용하십시오.
3

clickhouse-server 시작

clickhousectl local server start
서버는 백그라운드에서 실행됩니다. 실행 중인지 확인하려면 다음 명령을 실행하십시오.
clickhousectl local server list
4

clickhouse-client 시작

clickhousectl local client
다음과 비슷한 출력이 표시됩니다.
ClickHouse client version 24.5.1.117 (official build).
Connecting to localhost:9000 as user default.
Connected to ClickHouse server version 24.5.1.

local-host :)
이제 ClickHouse에 SQL 명령을 보낼 준비가 되었습니다!
Quick Start에서는 테이블을 생성하고 데이터를 삽입하는 방법을 단계별로 안내합니다.
마지막 수정일 2026년 6월 25일