# Como usar o Cline CLI: guia passo a passo do Cline no terminal

URL: https://agentvera.dev/pt/blog/how-to-use-cline-cli/ · Publicado: 2026-11-15

Como usar o Cline CLI: instale via npm, faça login ou use sua chave, alterne Plan e Act, rode headless com --json, retome sessões e adicione regras e MCP.

**Resumo:**

- Instale com npm install -g cline, rode cline auth para entrar numa conta Cline ou adicionar sua própria chave de provedor e depois rode cline num projeto e descreva a tarefa. Tab alterna entre Plan e Act.
- As confirmações vêm desligadas: --auto-approve é true, e execuções avulsas ou com entrada por pipe usam o modo yolo. Passe --auto-approve false se quiser que o Cline pergunte antes de cada ferramenta.
- A CLI é gratuita; a inferência é paga com créditos Cline, ClinePass (US$ 9,99 por mês em novembro de 2026) ou suas chaves de API. Regras vão em .clinerules/ ou AGENTS.md; servidores MCP, em cline_mcp_settings.json.

Para usar o Cline CLI, você instala com `npm install -g cline`, roda `cline auth` para fazer login ou adicionar uma chave de provedor e depois roda `cline` dentro de um projeto e descreve a tarefa. **Ao contrário da maioria das CLIs de programação, o Cline aprova as próprias chamadas de ferramenta por padrão, então passe `--auto-approve false` em qualquer repositório que importe para você.**

Este guia cobre o Cline CLI 3.0 em novembro de 2026 (versão 3.0.74): instalação, login, Plan e Act, aprovações, execuções headless com `--json`, sessões, modelos, regras, MCP e quanto custa.

## O que é o Cline CLI

O [Cline](https://cline.bot "Cline") começou como extensão do VS Code e é um dos agentes de programação abertos mais usados. O Cline CLI leva o mesmo agente para o terminal. A versão 3.0, lançada em maio de 2026, foi uma reescrita sobre o novo SDK do Cline com uma nova interface de terminal, então guias escritos para a CLI 2.x estão desatualizados.

O Cline não depende de um modelo específico. Você pode usar uma conta Cline com créditos, uma assinatura ClinePass ou sua própria chave da Anthropic, OpenAI, Gemini, OpenRouter, Bedrock, Vertex, DeepSeek, um modelo local via Ollama ou LM Studio e mais de trinta outros provedores.

## Passo 1: instale a CLI

```bash
npm install -g cline
```

É o único método de instalação oficial. Há binários prontos para macOS, Linux e Windows, em arm64 e x64; use o Node 22 por segurança, já que a documentação e o pacote discordam sobre a versão mínima. Para atualizar depois, `cline update`. Se quiser o build mais novo, `npm install -g cline@nightly` instala o canal nightly.

## Passo 2: faça login ou adicione uma chave

```bash
cline auth
```

Isso abre uma configuração interativa. `cline auth cline` faz login numa conta Cline pelo navegador. Para definir um provedor sem perguntas, por exemplo num servidor:

```bash
cline auth -p anthropic -k "$ANTHROPIC_API_KEY" -m claude-sonnet-5-5
```

O Cline também lê chaves do ambiente (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, `OPENROUTER_API_KEY`, `CLINE_API_KEY` e outras). As credenciais salvas vão para `~/.cline/data/settings/providers.json`.

## Passo 3: trabalhe na visão interativa

```bash
cd my-project
cline
```

Descreva a tarefa com suas palavras, ou já comece com uma: `cline -i "add tests for the price formatter"`. Teclas e comandos úteis:

- `Tab` alterna entre **Plan** e **Act**. O modo Plan lê e discute, mas não pode editar arquivos; o modo Act, o padrão, faz as mudanças. `cline -p` começa em Plan.
- `Shift+Tab` liga ou desliga a aprovação automática.
- `@file` adiciona um arquivo (ou uma imagem) à mensagem.
- `/model` e `/settings` mudam a configuração; `/mcp` gerencia servidores; `/compact` encurta uma conversa longa; `/undo` desfaz a última mudança; `/history` abre sessões anteriores.
- `Ctrl+C` interrompe o turno atual; pressione duas vezes, ou `Ctrl+D`, para sair.

Um bom hábito para tarefas maiores: comece em Plan, combine os passos e depois mude para Act.

## Passo 4: decida quanto o Cline pode fazer sozinho

Esta é a configuração que mais surpreende. No Cline CLI:

| Situação | O que acontece |
|---|---|
| `cline` (interativo) | `--auto-approve` fica ligado, a menos que você desligue |
| `cline --auto-approve false` | Pergunta `Approve tool …? [y/N]` antes de cada ferramenta |
| `cline "task"` (avulso) ou entrada por pipe | Roda em modo yolo |
| `cline -y` | Modo yolo; a própria ajuda do Cline o chama de perigoso fora de um sandbox |

Não existe lista de permissão ou bloqueio para comandos de shell. Para bloquear um comando, adicione um hook `PreToolUse` (passo 7). Num repositório real, comece com `--auto-approve false` ou trabalhe numa branch limpa para que qualquer mudança seja fácil de descartar.

## Passo 5: execuções headless e CI

O Cline roda sem a visão interativa quando você passa `--json`, envia algo por pipe ou redireciona a saída:

```bash
git diff | cline "review this diff for bugs"
cline --json "summarize the changes on this branch" | jq -r 'select(.type=="run_result") | .text'
```

`--json` imprime um evento JSON por linha e termina com um `run_result` que traz o texto final, o motivo de término e o uso de tokens. Outros flags que vale conhecer: `-c` define a pasta de trabalho, `--worktree` roda num git worktree, `-t` define um timeout em segundos e `--data-dir` guarda o estado numa pasta isolada.

Na CI, instale via npm, rode `cline auth` com uma chave do cofre de segredos e depois rode a tarefa. Lembre que execuções avulsas aprovam tudo, então dê ao job só as permissões de que ele precisa.

## Passo 6: sessões e modelos

`cline history` lista as sessões anteriores num seletor onde você pode retomá-las ou apagá-las. Para reabrir uma diretamente:

```bash
cline history --json --limit 10
cline --id <session-id>
```

As sessões ficam em `~/.cline/data/sessions/`. `cline history export <session-id> -o session.html` salva uma como página.

Para escolher o modelo de uma execução, use `-P` para o provedor e `-m` para o modelo; `--thinking` aceita `none`, `low`, `medium`, `high` ou `xhigh`. Na visão interativa, use `/model`. Com uma conta Cline e nenhum modelo escolhido, o padrão é o Claude Sonnet 5.5 desde a versão 3.0.73.

## Passo 7: regras, hooks e servidores MCP

**Regras.** Coloque as regras do projeto em `.clinerules/` ou `.cline/rules/`, e as globais em `~/.cline/rules`. O Cline também lê o `AGENTS.md` na raiz do projeto, então um arquivo que você já mantém para o Codex ou outros agentes funciona do jeito que está. Nosso guia sobre [CLAUDE.md e AGENTS.md](/pt/blog/claude-md-agents-md/ "CLAUDE.md e AGENTS.md") explica o que colocar nele.

**Skills e hooks.** Skills ficam em `.cline/skills/` ou `.agents/skills/` e rodam como `/skill-name`; `cline skill add <owner/repo>` instala uma. Hooks são scripts executáveis com o nome do evento, como `.cline/hooks/PreToolUse.sh`, e são a forma de bloquear comandos arriscados.

**MCP.** Adicione servidores pela linha de comando:

```bash
cline mcp add memory --yes -- npx -y @modelcontextprotocol/server-memory
cline mcp add docs https://example.com/mcp --transport http --yes
```

Eles são salvos em `mcpServers` no `~/.cline/data/settings/cline_mcp_settings.json`. `cline mcp` abre um menu, e `cline mcp remove <name>` remove um.

## Quanto custa o Cline CLI (em novembro de 2026)

| Opção | Preço | Observações |
|---|---|---|
| Cline CLI | Grátis | A ferramenta em si |
| Créditos Cline | Pague pelo uso | Comprados em app.cline.bot; alguns modelos gratuitos com cota pequena |
| ClinePass | US$ 9,99/mês | Limites maiores em modelos abertos selecionados |
| Sua própria chave | Preço do seu provedor | Anthropic, OpenAI, OpenRouter, modelos locais e mais |
| Enterprise | Sob consulta | SSO, SLA, acesso por função, cobrança centralizada |

Confira a [página de preços do Cline](https://cline.bot/pricing "Preços do Cline") antes de decidir.

## Armadilhas comuns

- **Aprovação automática ligada por padrão.** Desligue com `--auto-approve false` até confiar na configuração.
- **Seguir guias da 2.x.** A reescrita 3.0 mudou comandos e flags. Na dúvida, rode `cline --help` na sua versão; alguns flags, como `-y`, não aparecem na referência online.
- **OAuth em headless.** Provedores OAuth nunca abrem navegador em execuções headless. Rode `cline auth <provider>` uma vez nessa máquina antes.
- **Processos em segundo plano travados.** `cline doctor` verifica a configuração, e `cline doctor fix` encerra processos antigos.
- **`.clineignore` está de saída.** Use um hook `PreToolUse` para manter o Cline longe de certos arquivos.

## Rodando o Cline CLI ao lado de outras CLIs no AgentVera

Se o Cline é o único agente que você usa, a própria interface dele pode bastar. Fica mais difícil quando o Cline roda ao lado do Claude Code, do Codex ou do Gemini CLI no mesmo projeto. O [AgentVera](/pt/ "AgentVera") é um app desktop que roda essas CLIs lado a lado em terminais reais, com as suas próprias instalações e chaves. O [suporte ao Cline](/pt/agents/cline/ "Cline CLI no AgentVera") funciona assim:

- **Uma sessão por agente.** O AgentVera encontra a sessão que o Cline cria via `cline history --json` e a reabre com `cline --id <id>` nas próximas execuções, então a conversa sobrevive a um reinício do app.
- **Modelo e esforço.** O modelo que você escolhe é passado com `--model` e o nível de esforço com `--thinking`.
- **Uma conta por agente.** Em Configurações → Contas você pode adicionar chaves da Anthropic, OpenAI ou OpenRouter; cada conta Cline ganha o próprio arquivo de provedores, e todo o resto continua compartilhado.
- **MCP e tokens.** Os servidores do [gerenciador de MCP](/pt/features/mcp-manager/ "Gerenciador de MCP") do AgentVera chegam ao Cline pelo arquivo de configurações MCP dele, e o AgentVera lê o uso de tokens do Cline para os [orçamentos de tokens](/pt/features/token-budgets/ "Orçamentos de tokens").
- **Painéis e revisão.** Rode o Cline na grade do [workspace](/pt/features/workspace/ "Workspace") ao lado de outros agentes e confira as mudanças com a [revisão de código](/pt/features/code-review/ "Revisão de código").

O plano gratuito executa 2 agentes ao mesmo tempo e inclui MCP, Git, Docker, SSH, revisão de código e economia de tokens. O Pro custa US$ 9,99 por mês e não tem limite de agentes; se você nunca teve um teste, seu primeiro login no app ativa o Pro por 7 dias sem cartão. Para experimentar, [baixe o AgentVera](/pt/download/ "Baixar o AgentVera").

## Conclusão

Para começar com o Cline CLI bastam três comandos: `npm install -g cline`, `cline auth` e `cline`. As escolhas que importam vêm logo depois: desligue a aprovação automática em trabalho real, planeje antes de agir em tarefas maiores, mantenha as regras do projeto no `AGENTS.md` ou em `.clinerules/` e dê às execuções avulsas de CI só o acesso de que elas precisam.

Fontes: [referência do Cline CLI](https://docs.cline.bot/cli/cli-reference "Referência do Cline CLI"), [visão geral da CLI](https://docs.cline.bot/usage/cli-overview "Visão geral do Cline CLI"), [autorização](https://docs.cline.bot/getting-started/authorizing-with-cline "Autorização com o Cline"), [regras do Cline](https://docs.cline.bot/customization/cline-rules "Regras do Cline"), [MCP](https://docs.cline.bot/mcp/mcp-overview "Cline MCP"), [changelog da CLI](https://github.com/cline/cline/blob/main/apps/cli/CHANGELOG.md "Changelog do Cline CLI").

## Perguntas frequentes

**O Cline CLI é gratuito?** A CLI em si não custa nada. Você paga pelo modelo: créditos Cline comprados em app.cline.bot, uma assinatura ClinePass (US$ 9,99 por mês em novembro de 2026, para modelos abertos selecionados) ou sua própria chave de API da Anthropic, OpenAI, OpenRouter e muitos outros provedores. Alguns modelos gratuitos vêm com uma cota pequena.

**O Cline CLI pergunta antes de editar arquivos?** Não por padrão. --auto-approve vem como true, e uma execução avulsa como cline "task" roda em modo yolo. Comece com --auto-approve false para receber uma pergunta de sim ou não a cada ferramenta, ou ligue e desligue a aprovação automática com Shift+Tab na visão interativa.

**Como retomo uma sessão do Cline CLI?** Rode cline history para escolher uma sessão anterior numa lista, ou cline --id <session-id> para reabrir uma diretamente. cline history --json lista as sessões com seus ids, o que ajuda em scripts.

**O Cline CLI lê o AGENTS.md?** Sim. Além das próprias pastas de regras (.clinerules/ ou .cline/rules/ no projeto, ~/.cline/rules globalmente), o Cline lê o AGENTS.md na raiz do projeto, e também .cursorrules e .windsurfrules.

**Posso usar minha assinatura do Claude Code ou do ChatGPT com o Cline CLI?** O Cline lista um provedor Claude Code e um login do ChatGPT (openai-codex) entre os seus provedores. Confira os termos do próprio provedor antes de usar uma assinatura por meio de outra ferramenta.

---

**Sobre o AgentVera.** AgentVera é um app desktop para macOS, Windows e Linux, desenvolvido pela Solviera Teknoloji. Ele roda 18 agentes de programação com IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) lado a lado, por projeto, em terminais reais com as instalações e logins de CLI do próprio usuário. O plano gratuito roda 2 agentes ao mesmo tempo. Baixar: https://agentvera.dev/pt/download/ · Preços: https://agentvera.dev/pt/pricing/