> ## Documentation Index
> Fetch the complete documentation index at: https://chatcli.edilsonfreitas.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Início rápido

> Instale o ChatCLI, conecte um provedor e faça seu primeiro chat, sua primeira pergunta com contexto e sua primeira tarefa no coder em cerca de cinco minutos.

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

<Steps>
  <Step title="Instale o ChatCLI">
    <Tabs>
      <Tab title="Homebrew">
        ```bash theme={"system"}
        brew tap diillson/chatcli && brew install chatcli
        ```
      </Tab>

      <Tab title="go install">
        ```bash theme={"system"}
        go install github.com/diillson/chatcli@latest
        ```

        Requer Go 1.27 ou mais novo.
      </Tab>

      <Tab title="Binário">
        Baixe o binário da sua plataforma em [Releases](https://github.com/diillson/chatcli/releases) e depois:

        ```bash theme={"system"}
        chmod +x chatcli && sudo mv chatcli /usr/local/bin/
        ```
      </Tab>

      <Tab title="Docker">
        ```bash theme={"system"}
        docker pull ghcr.io/diillson/chatcli:latest
        ```
      </Tab>
    </Tabs>

    Confira se ele roda:

    ```bash theme={"system"}
    chatcli --version
    ```

    Build a partir do código-fonte, Helm e todas as outras opções: [Instalação](/pt/start/installation).
  </Step>

  <Step title="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:

    <CodeGroup>
      ```bash OpenAI theme={"system"}
      echo 'LLM_PROVIDER=OPENAI' > .env
      echo 'OPENAI_API_KEY=sk-xxx' >> .env
      ```

      ```bash Claude theme={"system"}
      echo 'LLM_PROVIDER=CLAUDEAI' > .env
      echo 'ANTHROPIC_API_KEY=sk-ant-xxx' >> .env
      ```

      ```bash Gemini theme={"system"}
      echo 'LLM_PROVIDER=GOOGLEAI' > .env
      echo 'GOOGLEAI_API_KEY=AIza...' >> .env
      ```

      ```bash Ollama (local) theme={"system"}
      echo 'LLM_PROVIDER=OLLAMA' > .env
      echo 'OLLAMA_BASE_URL=http://localhost:11434' >> .env
      echo 'OLLAMA_MODEL=llama3.1' >> .env
      ```

      ```bash OpenRouter theme={"system"}
      echo 'LLM_PROVIDER=OPENROUTER' > .env
      echo 'OPENROUTER_API_KEY=sk-or-xxx' >> .env
      ```
    </CodeGroup>

    <Tip>
      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](/pt/providers/oauth-authentication).
    </Tip>

    Cada provedor tem um modelo default; defina `<PROVEDOR>_MODEL` para escolher outro. Os catorze provedores e seus modelos estão em [Modelos suportados](/pt/providers/supported-models).
  </Step>

  <Step title="Faça seu primeiro chat">
    ```bash theme={"system"}
    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.
  </Step>

  <Step title="Dê o contexto do seu projeto">
    Os comandos `@` trazem o seu ambiente para dentro do prompt:

    ```text theme={"system"}
    @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](/pt/usage/context-commands).
  </Step>

  <Step title="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:

    ```text theme={"system"}
    /coder corrija os testes que estão falhando
    ```

    Veja o [Coder mode](/pt/usage/coder-mode) para o fluxo de aprovação e as regras de segurança.
  </Step>
</Steps>

## Próximos passos

<CardGroup cols={2}>
  <Card title="Uso básico" icon="terminal" href="/pt/usage/basic-usage">
    O prompt, os comandos essenciais e a navegação pelo teclado.
  </Card>

  <Card title="Modo agente" icon="robot" href="/pt/usage/agent-mode">
    Delegue tarefas de vários passos que rodam comandos com a sua aprovação.
  </Card>

  <Card title="Contexto persistente" icon="layer-group" href="/pt/context/persistent-context">
    Anexe um projeto uma vez e reutilize em várias sessões.
  </Card>

  <Card title="Cookbook" icon="kitchen-set" href="/pt/cookbook/agent-refactoring">
    Receitas passo a passo para fluxos reais.
  </Card>
</CardGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.