Pular para o conteúdo principal
Usuários do WindowsO ClickHouse roda nativamente em Linux e macOS. No Windows, execute estas etapas dentro do Windows Subsystem for Linux (WSL).
A ClickHouse CLI (clickhousectl) ajuda você a instalar e gerenciar versões locais do ClickHouse, iniciar servidores e executar consultas.
1

Instale a ClickHouse CLI

Um alias chctl também é criado automaticamente para sua conveniência.
2

Instale o ClickHouse

Instale a versão mais recente do ClickHouse e defina-a como padrão:
local use instala a versão, caso ela ainda não esteja presente, define-a como padrão e cria um symlink clickhouse em ~/.local/bin (no seu PATH) para que você possa invocar diretamente o binário clickhouse. Assim, qualquer etapa posterior nesta documentação que execute um comando clickhouse funcionará sem alterações.Você também pode selecionar uma versão específica:
Use vs installclickhousectl local use <version> instala uma versão e a define como padrão, atualizando o symlink clickhouse no seu PATH. Para baixar uma versão sem alterar a versão padrão nem atualizar o symlink, use clickhousectl local install <version>.
3

Inicie o clickhouse-server

O servidor é executado em segundo plano. Para verificar se ele está em execução:
4

Inicie o clickhouse-client

Você verá algo assim:
Agora você já pode começar a enviar comandos SQL ao ClickHouse!
O Quick Start orienta você nas etapas para criar tabelas e inserir dados.
Última modificação em 2 de julho de 2026