Pular para o conteúdo

Seu primeiro chat

O Context Code gira em torno de uma ideia simples: você abre uma pasta do seu disco (o seu projeto) e conversa com um agente que pode trabalhar de verdade nela — ler arquivos, editá-los, executar comandos. Esta página leva você da abertura do app até a primeira resposta.

Na primeira vez que você abre o aplicativo aparece um guia de cinco passos que o deixa pronto para trabalhar. Todos os passos podem ser pulados, e você pode vê-lo de novo quando quiser pelo menu da sua conta («Ver o guia de novo») ou em Configurações → Geral.

  1. Em que idioma vamos conversar? — os 17 idiomas do app. Dá para mudar depois.

  2. Como você quer usar a IA? — três caminhos:

    • «Já tenho conta do Claude, ChatGPT ou Copilot» — o navegador abre, você entra com o seu usuário de sempre e o app detecta sozinho que você terminou. Se o provedor pedir um código de dispositivo, ele o mostra na tela.
    • «Tenho uma chave de API» — seis provedores com nível gratuito para começar, cada um com o seu link «Onde eu consigo a chave?». O botão Testar faz uma requisição real e responde «Funciona: N modelos disponíveis.» ou o erro concreto.
    • «Quero uma IA no meu computador, sem contas» — vê do que o seu computador é capaz, recomenda um modelo local e o baixa com barra de progresso. Se o seu computador ficar curto, ele avisa e propõe os outros caminhos.
  3. Sobre o que você vai trabalhar? — você escolhe uma pasta (e o agente poderá ler e escrever ali) ou segue sem ela com um chat comum.

  4. Quer falar com ela e que ela leia para você? — testa o microfone por três segundos e deixa você ouvir como soa a voz de leitura.

  5. Pronto — propõe três primeiras perguntas nas quais você pode clicar.

Ao terminar, o chat já fica com o perfil que você acabou de conectar.

  1. Abra (ou crie) um projeto.

    Na barra lateral, escolha a pasta com a qual você quer trabalhar. Pode ser um projeto de código já existente ou uma pasta vazia onde o agente começa do zero. A lista de projetos recentes fica na barra lateral para você voltar com um clique.

    A barra lateral: seus projetos e chats sempre à mão.
  2. Conecte um provedor de IA.

    No seletor de motor do chat (ou em Configuração) você verá a lista de Motores e IA Disponíveis, cada um com seu estado: Conectado ou Sem autenticação. Conecte o que preferir — com Anthropic (Claude), OpenAI ou GitHub Copilot basta fazer login no navegador (OAuth); Gemini, xKiro e os demais usam chave de API; e os locais (Ollama, LM Studio, Context Forge) não pedem conta. O detalhe completo está em Provedores de IA.

  3. Escolha o modelo.

    Ao lado do campo de escrita do chat está o seletor de provedor e modelo. Você pode trocar a qualquer momento, mesmo no meio da conversa: um modelo econômico para o simples, um potente para o difícil.

  4. Escolha o modo de aprovação.

    No mesmo compositor do chat está o seletor de permissões: Apenas Chat, Perguntar, Autorização Inteligente ou Autorização Completa. Ele define o que o agente pode fazer sem perguntar. Se é sua primeira vez, Perguntar é um bom ponto de partida. Explicação completa em Modos de aprovação.

  5. Escreva seu pedido.

    Peça o que precisar, no seu idioma e com contexto: “explique o que este projeto faz”, “adicione validação ao formulário de cadastro”, “descubra por que o login falha”. O agente vai mostrando cada passo no chat: quais arquivos lê, quais comandos executa e o que mudou.

    O agente mostra cada ferramenta que usa: leituras, edições, comandos.
  • Anexe arquivos e imagens à mensagem (ou arraste-os para o chat) para dar contexto ao agente.
  • Ditado por voz: você pode falar em vez de digitar — veja Voz. E se quiser uma conversa de ida e volta, com interrupções e resposta falada, ligue a Conversa em tempo real.
  • Ctrl+Shift+F busca texto em todo o projeto; o buscador rápido de arquivos e comandos também abre painéis e ações — veja Busca.
  • Parar: se o agente vai por um caminho errado, o botão de parar interrompe o turno em andamento.
  • O painel de uso de tokens mostra quanto você consumiu por projeto e por modelo — veja Uso de tokens.

Os chats abrem como abas na mesma barra dos arquivos do editor e do console SQL. A aba se chama «Projeto <nome> - <chat>», ou «Chat - <nome>» quando o chat não tem projeto; a largura é fixa, então um título longo é cortado e você o vê inteiro ao passar o mouse.

  • Um clique na barra lateral abre a aba daquele chat, ou salta para ela se já estava aberta.
  • Ativar uma aba muda para o projeto daquele chat: explorador de arquivos, editor e painel do Git vão junto.
  • Um ponto verde («Trabalhando») diz que o turno segue em andamento; um «!» («Aguardando sua resposta»), que o agente perguntou algo a você.
  • Ctrl+Tab e Ctrl+Shift+Tab percorrem a barra inteira, chats e arquivos por igual; arraste-as para reordenar.
  • Fechar a aba não interrompe o chat: nem no ×, nem no clique do meio, nem com Ctrl+W. Se ele estava trabalhando aparece um aviso —«O chat continua trabalhando», «Fechar a aba não interrompe nada: o chat continua trabalhando em segundo plano e você pode voltar a ele pela barra lateral.»— com a caixa «Não avisar de novo».
  • O clique direito sobre uma aba oferece «Fechar a aba (o chat continua trabalhando)» e «Fechar todas as abas de chat».

Navegar entre chats com um clique enchia a barra de abas. Por isso existe uma única aba provisória, como num editor de código: o clique simples num chat da barra lateral o abre ali, com o título em itálico («… (pré-visualização: dê dois cliques para fixá-la)»), e o próximo clique simples em outro chat reaproveita esse mesmo espaço, sem tirá-lo do lugar. Nunca há duas provisórias.

A aba é fixada por qualquer um destes três gestos: dois cliques no chat da barra lateral ou na própria aba, escrever uma mensagem nesse chat —já não é uma espiada— ou arrastar a aba dele. Voltar a um chat já fixo não o rebaixa.

Você desliga em Configurações → Geral com «Abrir chats em pré-visualização com um clique» (ligado de fábrica, e desabilitado se «Chats em abas» estiver desligado). Desligado, cada clique abre uma aba fixa; e ao desligar, a provisória que estivesse aberta fica fixada.

As abas abertas são lembradas e voltam ao reabrir o aplicativo. Se você prefere o de antes —um chat de cada vez—, desligue «Chats em abas» em Configurações → Geral; ao desligar, as abas de chat abertas são fechadas.

Na barra lateral, o clique direito sobre um chat —inclusive sobre os da aba «Chat», os que não têm projeto— abre um menu com «Fixar chat» / «Desafixar chat» e «Arquivar chat».

  • Os fixados sobem para o início da lista, o último que você fixou no topo, e continuam lá depois de reiniciar (fica salvo no banco de dados, não no navegador).
  • Os arquivados saem da lista de trabalho sem perder o histórico: ficam na seção «Arquivados», com o número ao lado, e voltam com «Devolver à lista» ou «Restaurar todos». Se você arquivar um que ainda trabalhava, ele fica marcado como «Arquivado, mas ainda trabalhando».
  • A busca da barra lateral também encontra os arquivados: o resultado traz o botão «Restaurar e abrir».

Na barra de cima há um coração que resume se o aplicativo está pronto: «Tudo pronto», «Funciona, mas há algo para revisar» ou «Falta algo para que ele possa responder», com o número de avisos.

Ele verifica quatro coisas: que haja uma IA conectada com credenciais, que o modelo escolhido continue existindo na sua conta, que haja internet e que os programas auxiliares estejam presentes (o de ditado, por exemplo). Cada aviso traz um botão Resolver que leva você direto ao passo do guia que falta.

Um chat recém-criado sugere por onde começar: código, SQL, Markdown, grafo ou um time de agentes.
Ao abrir um projeto novo, o Context Code mostra do que é capaz antes da primeira pergunta.