Início rápido

Esta página leva você do zero a um ChatCLI funcionando. Cada passo aponta para o guia completo quando você quiser os detalhes.

Instale o ChatCLI

Homebrew
go install
Binário
Docker

brew tap diillson/chatcli && brew install chatcli

go install github.com/diillson/chatcli@latest

Requer Go 1.27 ou mais novo.

Baixe o binário da sua plataforma em Releases e depois:

chmod +x chatcli && sudo mv chatcli /usr/local/bin/

docker pull ghcr.io/diillson/chatcli:latest

Confira se ele roda:

chatcli --version

Build a partir do código-fonte, Helm e todas as outras opções: Instalação.

Conecte um provedor

O ChatCLI lê as configurações de um arquivo .env: primeiro ./.env, depois ~/.chatcli/.env e por fim ~/.env. Escolha um provedor e adicione a chave:

echo 'LLM_PROVIDER=OPENAI' > .env
echo 'OPENAI_API_KEY=sk-xxx' >> .env

echo 'LLM_PROVIDER=CLAUDEAI' > .env
echo 'ANTHROPIC_API_KEY=sk-ant-xxx' >> .env

echo 'LLM_PROVIDER=GOOGLEAI' > .env
echo 'GOOGLEAI_API_KEY=AIza...' >> .env

echo 'LLM_PROVIDER=OLLAMA' > .env
echo 'OLLAMA_BASE_URL=http://localhost:11434' >> .env
echo 'OLLAMA_MODEL=llama3.1' >> .env

echo 'LLM_PROVIDER=OPENROUTER' > .env
echo 'OPENROUTER_API_KEY=sk-or-xxx' >> .env

Tem plano ChatGPT, Claude ou GitHub Copilot? Pule a chave: inicie o ChatCLI e rode /auth login openai-codex, /auth login anthropic ou /auth login github-copilot. Veja Autenticação OAuth.

Cada provedor tem um modelo default; defina <PROVEDOR>_MODEL para escolher outro. Os catorze provedores e seus modelos estão em Modelos suportados.

Faça seu primeiro chat

chatcli

Digite uma pergunta e tecle Enter. Dentro do prompt, /config mostra o provedor e o modelo ativos, /switch troca os dois sem reiniciar e /help lista todos os comandos.

Dê o contexto do seu projeto

Os comandos @ trazem o seu ambiente para dentro do prompt:

@file ./cmd explique como a CLI inicializa
@git escreva a mensagem de commit das mudanças staged
@command go test ./... > por que isso está falhando?

Mais em Comandos de contexto.

Passe uma tarefa de código

O coder mode lê, edita, roda testes e faz rollback em loop, pedindo confirmação antes de qualquer coisa arriscada:

/coder corrija os testes que estão falhando

Veja o Coder mode para o fluxo de aprovação e as regras de segurança.

Próximos passos

Uso básico

O prompt, os comandos essenciais e a navegação pelo teclado.

Modo agente

Delegue tarefas de vários passos que rodam comandos com a sua aprovação.

Contexto persistente

Anexe um projeto uma vez e reutilize em várias sessões.

Cookbook

Receitas passo a passo para fluxos reais.

Comece aqui

Documentação

Início rápido

Próximos passos

Uso básico

Modo agente

Contexto persistente

Cookbook

​Próximos passos

Uso básico

Modo agente

Contexto persistente

Cookbook

Próximos passos