Tutorial de Cline para iniciantes: instalação, primeira tarefa, Plan/Act, regras e MCP
Um tutorial de Cline passo a passo com 15 capturas verificadas: instale a extensão no VS Code, entregue um app real com um modelo gratuito e domine os modos Plan e Act, as regras e os servidores MCP.
Resumo rápido
- O Cline é um agente de programação com IA gratuito e de código aberto dentro do VS Code: instale pelo Marketplace de extensões, entre com Google ou GitHub e comece sem chave de API.
- O nível Absolutely Free roda em modelos hospedados como DeepSeek V4 Flash (1M de contexto) e GLM-5.3-Flash; este roteiro entrega um app de calculadora de IMC funcional em 15 passos.
- O modo Plan traça a estratégia com um modelo de raciocínio e o modo Act programa com um modelo rápido — toda a análise em Plan da demo custou US$ 0,0145.
- Evolua com sua própria chave Gemini, regras globais e de workspace e servidores MCP como GitHub e Context7 — os três pilares de uma configuração ideal do Cline.
I Found 2 Ways to Use Cline for FREE (Best Free AI Coding Agent)
Vídeo do roteiro:HMA WebCode5:26
Ideal Setup for Cline
Fonte dos fatos:Cline3:47
As capturas do roteiro vêm da demo de configuração gratuita do HMA WebCode; as capturas das configurações de Plan/Act, das regras e do marketplace de MCP vêm dos vídeos curtos do canal oficial do Cline, que também são a fonte dos fatos sobre o comportamento dos modos, o alcance das regras e a configuração de três pilares.
As capturas pertencem aos respectivos canais e são usadas com atribuição e links profundos; todas as descrições dos passos são de nossa própria redação.
O roteiro do Cline em 15 passos
Instale o Cline e libere o nível gratuito
- 1
Instale a extensão do Cline no VS Code
Abra a visão de extensões do VS Code, pesquise por Cline e clique em Install na ficha do agente de programação autônomo publicado por Cline Bot. Ao terminar, o ícone do robô do Cline aparece na barra de atividades: clique nele para abrir o painel do agente ao lado do editor.
A ficha do Cline no Marketplace de extensões do VS Code, pronta para instalar.Ver em 0:24 - 2
Escolha como vai usar o Cline
Na primeira vez que abrir o painel, o Cline pergunta como você quer usá-lo e oferece quatro caminhos: Absolutely Free (modelos gratuitos hospedados), ClinePlans (assinatura paga para modelos de pesos abertos), Frontier Model (pagamento por uso pela cobrança do Cline) e Bring my own API key. Iniciantes devem começar com Absolutely Free — sem chave de API nem cartão.
A tela inicial do Cline com as quatro opções de configuração.Ver em 0:34 - 3
Entre na sua conta e acesse o nível gratuito
Selecione Absolutely Free, clique em Log in to Cline e entre com sua conta Google ou GitHub — leva cerca de dez segundos e não pede forma de pagamento. Você chega à tela do provedor com o Cline Usage-Billing selecionado, que é o que alimenta os modelos gratuitos.
Depois de entrar, o Cline mostra o provedor Usage-Billing com suas abas de modelos.Ver em 1:46 - 4
Escolha um modelo gratuito e o esforço de raciocínio
Abra o seletor de modelos e vá para a aba Free: DeepSeek V4 Flash (1M de contexto), GLM-5.3-Flash, LongCat 2.0 e Laguna S 2.1 têm todos o selo FREE. Escolha o DeepSeek V4 Flash para trabalho rápido em vários arquivos e deixe o Reasoning Effort em Medium — Low é mais rápido, High raciocina mais fundo mas gasta mais tokens.
O ID de modelo deepseek/deepseek-v4-flash selecionado com Reasoning Effort em Medium.Ver em 2:12
Execute sua primeira tarefa de ponta a ponta
- 5
Abra uma caixa de tarefa vazia
Crie ou abra uma pasta de projeto no VS Code e clique no ícone do Cline. O painel o recebe com uma pergunta simples: esse campo é onde toda tarefa começa. A linha de Auto-approve e o alternador Plan/Act ficam na parte de baixo do painel.
O painel de tarefas do Cline pronto para o primeiro prompt, com Plan/Act no canto.Ver em 2:36 - 6
Envie sua primeira tarefa
Escreva um objetivo concreto na caixa de tarefa, por exemplo: crie um app web moderno de calculadora de IMC com HTML, CSS e JavaScript em que o usuário digita a altura em centímetros e o peso em quilogramas e o app mostra o IMC com um rótulo de categoria. Requisitos concretos de entradas, saídas e design rendem resultados muito melhores que um pedido de uma linha.
O prompt da calculadora de IMC digitado na caixa de tarefas do Cline.Ver em 2:58 - 7
Aprove cada ação — ou aprove automaticamente
O Cline trabalha passo a passo: quer executar um comando, criar um arquivo ou editar outro, e mostra um diff de cada mudança antes de aplicá-la. Aprove ação por ação ou ligue o Auto-approve para Read, Edit e Commands e deixe que ele cumpra a lista sozinho — os checkpoints tornam cada passo reversível de qualquer forma.
O Cline pede aprovação para criar o index.html, com o diff do CSS exibido.Ver em 3:06 - 8
Abra o app pronto
Em poucos minutos a tarefa termina com um resumo e um registro de BMI Calculation Checkpoint. Abra o index.html gerado com o Live Server ou qualquer servidor estático e teste: 175 centímetros e 70 quilogramas resultam em IMC de 22,9 — Normal. Um app completo e funcional sem escrever uma linha sequer.
A calculadora de IMC pronta no navegador ao lado do resumo do Cline no VS Code.Ver em 3:17
Modos Plan e Act sem tokens desperdiçados
- 9
Conheça os modos Plan e Act
O alternador na base do painel troca entre Plan e Act. No modo Plan, o Cline só investiga: lê arquivos, faz perguntas e propõe um plano de implementação. A janela de configurações tem abas com os mesmos nomes, para você atribuir um modelo diferente a cada modo — um bom raciocinador para o Plan, um codificador rápido para o Act.
Configurações do Cline com as abas Plan Mode e Act Mode para modelos por modo.Ver em 0:48 - 10
Deixe o modo Plan pensar antes de programar
Modelos de raciocínio brilham no modo Plan porque decompor uma tarefa é análise, não digitação. Como nada foi escrito ainda, investigar a fundo é barato — a análise de violações de DRY da demo custou apenas US$ 0,0145. Responda às perguntas do Cline enquanto ele planeja; cada correção aqui evita retrabalho depois.
Um cartão de tarefa em modo Plan com a análise, os tokens e US$ 0,0145 de custo de API.Ver em 1:10 - 11
Troque para o modo Act e escreva o código
Quando o plano estiver do seu jeito, troque para o Act — o plano é fixado e o Cline começa a editar arquivos. Modelos de código são mais baratos e rápidos nessa parte, e é exatamente daí que vem a economia de tokens de separar os modos. Na tela de retomar a tarefa, o Cline mostra o atalho: Win+Shift+A alterna entre os modos.
Configurações com a aba Act Mode selecionada e um modelo de código para a execução.Ver em 1:28
Sua chave, suas regras e o marketplace de MCP
- 12
Ou traga sua própria chave gratuita
Prefere sua própria cota em vez do pool gratuito compartilhado do Cline? Escolha Bring my own API key, selecione Google Gemini e clique em Get API key no Google AI Studio — o nível gratuito só pede uma conta Google. Cole a chave no campo de API key do Cline, escolha um modelo Gemini, salve, e você passa a rodar na sua própria cota.
O diálogo Create API key do Google AI Studio que gera a chave gratuita do Gemini.Ver em 3:54 - 13
Ensine seus padrões ao Cline com regras
Regras são instruções persistentes que o Cline lê em cada tarefa. Abra a aba Rules nas configurações do painel: as regras globais valem para todos os projetos da sua máquina, enquanto as regras de workspace vivem no repositório atual como arquivos .clinerules que você pode commitar e compartilhar. Use-as para princípios de código, práticas de segurança, diretrizes de documentação e estilo.
A aba Rules nas configurações do Cline com as seções Global Rules e Workspace Rules.Ver em 1:06 - 14
Escreva regras que um modelo consegue seguir
Regras vagas saem pela culatra — otimize o código quando possível dá ao Cline espaço para te ignorar. Escreva gatilhos mensuráveis: otimize o código quando testes unitários passarem de 100 milissegundos, use princípios SOLID ao usar classes, adicione comentários inline quando o código fizer suposições. Trate as regras como um documento vivo e elimine conflitos.
Um arquivo de regras com três regras concretas e mensuráveis aplicadas a cada tarefa.Ver em 1:45 - 15
Estenda o Cline com servidores MCP
O ícone do MCP Marketplace no painel abre servidores de um clique que dão novas habilidades ao Cline: GitHub para operações de repositório, Context7 para documentação atualizada de bibliotecas, Perplexity e Sequential Thinking para pesquisa e planejamento. Instale um servidor, aprove suas ferramentas e o Cline poderá chamá-lo no meio da tarefa — o terceiro pilar da configuração ideal.
O marketplace de MCP Servers do Cline com o cartão do servidor GitHub e o botão Install.Ver em 2:44