Use o Agent
no Cursor
e no VS Code.

Aqui o Agent é o GitHub Copilot. Sem o Copilot conectado, o seletor não aparece. Se a organização bloqueou o modo, a opção Agent também some. Quem cobra depende do modelo escolhido. O passo a passo está em Modelos e consumo. O medidor do Copilot fica na barra de status.

Abrir o chat certo

1. File > Open Folder. Se o VS Code pedir confiança na pasta, aceite em Trust.
2. Pressione Ctrl+Alt+I, ou use Chat > Open Chat.
3. Comece uma conversa nova se já houver uma antiga. Com o chat em foco, o atalho documentado é Ctrl+N. A conversa anterior continua na lista de sessões.
4. No seletor de agente, escolha Agent.

A Agents window serve para distribuir tarefas maiores e trocar de projeto. O chat ao lado do código, na pasta atual, é a Chat view.

Modos

Quatro controles da sessão

Enter envia. Contexto explícito usa #: arquivo, pasta, símbolo, #codebase, #terminalSelection, #fetch. O @ no VS Code chama um participante de chat. / lista comandos e skills. Imagem e elemento do navegador integrado também entram como contexto.

Um ! no começo da mensagem roda um comando na hora, sem passar pelo agente e sem pedir aprovação, por exemplo !npm test. Esse atalho fica de fora em sessão local, nuvem ou integração por extensão.

Enquanto a resposta corre

• Add to Queue espera esta resposta terminar.
• Steer with Message desvia depois da ferramenta que está rodando.
• Stop and Send cancela o pedido atual e envia o novo.

Parar preserva edição e comando que já concluíram. Para voltar os arquivos do workspace, restaure o checkpoint. Serviço externo fica como ficou.

No modo Manual, comandos de leitura costumam passar. del, rm e equivalentes pedem confirmação. A lista fica na configuração chat.tools.terminal.autoApprove. Uma regra falsa exige aprovação. Ela não bloqueia o comando. Comando ofuscado pode escapar da detecção. Em pasta sensível, mantenha a aprovação manual.

O sandbox do terminal limita arquivo e rede do comando. No Windows ele está em estágio experimental e não cobre toda ferramenta. Cada ferramenta MCP pode ser aprovada uma vez, na sessão, no workspace ou para sempre, em Chat: Manage Tool Approval (Ctrl+Shift+P).

A sessão Cloud roda fora da sua máquina e abre um pull request. No harness Copilot, /delegate manda uma tarefa já delimitada para a nuvem. Numa sessão Local, o Session Target ainda pode levar o histórico para Copilot, Claude, Codex ou Cloud. Sessão que já nasceu em Copilot ou Claude não troca de harness por esse menu.

Há duas escolhas. O Session Target define o harness, o programa que conduz ferramentas e contexto. O Language model define qual modelo responde. Trocar o modelo não troca o harness. Um modelo Claude dentro do Copilot continua no Copilot e usa os créditos do Copilot.

Conectar

1. Abra um chat novo. Com o chat em foco, Ctrl+N. Na Agents window, use New.
2. No Session Target, escolha o harness antes do primeiro pedido. A lista só mostra o que já está configurado nesta janela.
3. No seletor de agente, escolha Agent, Ask, Plan ou um agente seu.
4. No seletor de modelo, escolha o modelo. Com duas contas ativas, os modelos vêm em grupos. O grupo escolhido é quem cobra o próximo pedido.

Claude com a sua chave

1. Defina ANTHROPIC_API_KEY no ambiente do Windows, ou no objeto env de %USERPROFILE%\.claude\settings.json.
2. Confira se o harness está ligado. A configuração é github.copilot.chat.claudeAgent.enabled. Uma política da empresa pode desligá-lo.
3. No chat novo, escolha Claude no Session Target e depois o modelo do grupo Anthropic.

Agentes no formato Claude ficam em .claude/agents/, só neste projeto, ou em %USERPROFILE%\.claude\agents\, em todas as pastas. Escolha o harness Claude antes de criar o agente, para o arquivo cair na pasta certa. Cada arquivo é um tipo de agente e aparece no seletor daquela sessão.

O que gasta token

• Gravar o arquivo do agente não chama modelo e não consome.
• Cada mensagem consome. As instruções do agente entram em todo pedido, então um texto longo deixa o pedido maior.
• Um subagente é outro pedido e consome de novo.
• O prefixo que se repete na mesma sessão pode ser reaproveitado pelo provedor. O pedido seguinte continua contando. O custo não fica só na primeira configuração.

Dá para ter vários agentes especializados no mesmo editor. Cada um é um arquivo de instruções. Criar o arquivo não consome token. Cada mensagem enviada com ele selecionado consome, porque as instruções entram no pedido.

Escolha o harness antes de criar o arquivo, para ele cair na pasta certa.

Criar

1. Ctrl+Shift+P e o comando Chat: New Custom Agent. No chat, /agents abre o mesmo menu.
2. Escolha Workspace, para este projeto, ou User, para todas as pastas.
3. Preencha nome, descrição, ferramentas e o texto do papel. Salve o .agent.md.
4. No seletor de agente do chat novo, escolha o nome que você deu.

---
name: Revisor
description: Revisa mudanças sem editar arquivos
tools: ['read', 'search']
---
Revise o diff contra o pedido.
Aponte arquivo fora do combinado e teste que não prova a tela.
Não edite arquivos.

Se omitir tools, o agente recebe todas as ferramentas. Um agente só de leitura lista ferramentas de leitura e busca. O campo model fixa o modelo no harness Copilot. Sem esse campo, vale o modelo escolhido no seletor.

Um handoff é um botão que aparece no fim da resposta e abre outro agente com um pedido já escrito. Serve para ir do plano à implementação, ou da implementação à revisão, com você confirmando o passo.

O pedido tem quatro partes. Anexe a referência com # quando você já souber o arquivo. Para uma mudança grande, comece com /plan.

No fechamento mensal, adicione um filtro por competência na lista de lançamentos.
Use o mesmo padrão visual dos filtros que já existem.
Não altere o cálculo dos totais.
Rode os testes dessa tela e me diga o que falhou.

Montar o pedido

O pedido montado aparece aqui.

Quando a resposta citar arquivos alterados, abra o diff. Na Agents window, o painel é Changes.

• Abra o arquivo citado na resposta e leia o diff com o pedido ao lado.
• Restaure o checkpoint para devolver os arquivos do workspace.
• Parar a resposta preserva o que já foi concluído.
• Checkpoint não desfaz chamada já feita a um serviço externo.
• Em Manual permissions, comando destrutivo pede confirmação.

Sinais de que o rumo saiu

• O diff toca arquivo que o pedido não citou.
• O agente reescreve um cálculo que deveria permanecer.
• O teste que ele diz ter rodado não é o teste que prova a tela.
• A conversa já acumulou várias correções em cima da primeira tentativa.

Nesses casos, restaure o checkpoint, abra um chat novo e reenvie o pedido. Se a tarefa for grande, comece de novo com /plan.

1. Abra a pasta e confie nela.
2. Chat novo com Ctrl+Alt+I. Escolha o harness e o agente. Agent para executar, Plan ou /plan se o caminho ainda estiver em aberto, Ask se a dúvida for só de leitura.
3. Deixe Permissions em Manual permissions.
4. Anexe os arquivos conhecidos com #.
5. Envie o pedido com resultado, limite e prova.
6. Abra o diff. Restaure o checkpoint se o rumo estiver errado.
7. Aprove o terminal depois de ler o comando.
8. Rode você mesmo o teste que importa e faça o commit no Git.

Marque cada prática quando concluir. As marcas ficam neste navegador. Nada é enviado para fora.

Atalhos, harness e agentes lidos na documentação pública em 25 de outubro de 2026.