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 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
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
cline authIsso 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:
cline auth -p anthropic -k "$ANTHROPIC_API_KEY" -m claude-sonnet-5-5O 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
cd my-project
clineDescreva a tarefa com suas palavras, ou já comece com uma: cline -i "add tests for the price formatter". Teclas e comandos úteis:
Tabalterna 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 -pcomeça em Plan.Shift+Tabliga ou desliga a aprovação automática.@fileadiciona um arquivo (ou uma imagem) à mensagem./modele/settingsmudam a configuração;/mcpgerencia servidores;/compactencurta uma conversa longa;/undodesfaz a última mudança;/historyabre sessões anteriores.Ctrl+Cinterrompe o turno atual; pressione duas vezes, ouCtrl+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:
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:
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 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:
cline mcp add memory --yes -- npx -y @modelcontextprotocol/server-memory
cline mcp add docs https://example.com/mcp --transport http --yesEles 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 antes de decidir.
Armadilhas comuns
- Aprovação automática ligada por padrão. Desligue com
--auto-approve falseaté confiar na configuração. - Seguir guias da 2.x. A reescrita 3.0 mudou comandos e flags. Na dúvida, rode
cline --helpna 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 doctorverifica a configuração, ecline doctor fixencerra processos antigos. .clineignoreestá de saída. Use um hookPreToolUsepara 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 é 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 funciona assim:
- Uma sessão por agente. O AgentVera encontra a sessão que o Cline cria via
cline history --jsone a reabre comcline --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
--modele 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 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.
- Painéis e revisão. Rode o Cline na grade do workspace ao lado de outros agentes e confira as mudanças com a 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.
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, visão geral da CLI, autorização, regras do Cline, MCP, changelog da CLI.