Guia de configuração

Guia de configuração de provedores

Veja o passo a passo de configuração e solução de problemas por ferramenta.

Guia de configuração de provedores/Configuração do VS Code

Configuração do VS Code

O VS Code é um editor de código, não um provedor de modelos. Quando você usa o Claude, GPT, Gemini ou um modelo de provedor no VS Code, isso geralmente é feito por meio de extensões como Cline, Continue ou GitHub Copilot; o local onde você realmente precisa inserir a Key, Base URL e o nome do modelo é nas configurações da extensão específica.

Primeiro, diferencie três conceitos

VS CodeÉ apenas um ambiente para escrever código, responsável por abrir projetos, editar arquivos e instalar extensões.
Extensões de IAExtensões como Cline, Continue, Copilot, etc., são responsáveis por enviar suas perguntas e o contexto do código para o modelo e exibir as respostas no VS Code.
Fontes de modelosClaude, GPT, Gemini, provedores de IA compatíveis com OpenAI, modelos locais, etc., são fontes de modelos; a possibilidade de usá-los depende do suporte oferecido pela extensão escolhida.
Portanto, esta página não é "configurável apenas com Cline / Roo Code". O entendimento mais correto é: no VS Code, selecione uma extensão de IA e, dentro dela, escolha serviços Claude, GPT, Gemini ou compatíveis com OpenAI.

Como escolher a fonte do modelo

O que você deseja usar?Como o provedor geralmente é escolhido?Como preencher Key / Base URLCenário indicado
ClaudeAnthropic / ClaudePreencha a Key da Anthropic; se estiver usando um provedor, siga as instruções dele para escolher OpenAI Compatible ou uma entrada personalizada.Indicado para compreensão de código, modificação de código e perguntas e respostas com contexto longo.
GPT / OpenAIOpenAIInsira a Key da OpenAI; normalmente não é necessário alterar a Base URL para uma conexão direta oficial, apenas ao usar um provedor é preciso preencher o link da API fornecido por ele.Indicado para perguntas e respostas gerais, explicação de código e pequenas alterações.
Provedor de IA / Serviço de agregaçãoOpenAI Compatible / Custom ProviderCopie a Key, Base URL e o Model ID exatamente como exibidos no painel do provedor; algumas Base URLs incluem /v1, enquanto outras não, siga o que for exibido no painel.Indicado para iniciantes que precisam acessar múltiplos modelos de forma unificada.
Gemini / Outros modelosGoogle Gemini ou o Provider correspondentePreencha a Key da plataforma correspondente; a Base URL só precisa ser preenchida quando a extensão oferecer uma opção personalizada.Indicado para comparação entre múltiplos modelos; a possibilidade de uso depende da versão da extensão.
GitHub CopilotLogin no GitHub / CopilotGeralmente, em vez de preencher Key e Base URL, você faz login na sua conta do GitHub e concede as permissões necessárias.Indicado para quem deseja apenas usar um assistente de código mais prático e sem complicações dentro do ecossistema oficial do VS Code.

Locais de configuração e etapas

  1. Primeiro instale o VS Code e, em seguida, abra o Extensions Marketplace no painel esquerdo.
  2. Escolha uma extensão de IA: iniciantes podem começar com o Cline; se você já usa o Continue, consulte a página dedicada ao Continue neste site; o Roo Code é mais adequado para usuários experientes e não é recomendado para iniciantes logo de início.
  3. Abra as configurações da extensão e procure primeiro por entradas do tipo Provider, Model Provider ou API Provider.
  4. Se quiser usar o Claude, selecione Anthropic / Claude; se quiser usar o GPT, selecione OpenAI; se quiser usar um provedor, selecione OpenAI Compatible ou Custom Provider.
  5. Preencha a Key. Ao usar a plataforma oficial do modelo, geralmente apenas a Key oficial é necessária; ao usar um provedor, tanto a Key quanto a Base URL precisam ser copiadas do painel do provedor.
  6. Selecione o modelo ou preencha manualmente o nome dele. Não altere o nome do modelo por conta própria; preencha exatamente como exibido no painel do provedor.
  7. Defina a execução automática de comandos, a modificação automática de arquivos e a aplicação automática de alterações como desativadas ou para solicitar confirmação a cada ação.

Instruções de teste de segurança

Recomenda-se fazer a primeira pergunta deste jeito
Read only the currently open file. Do not modify files or run commands. Explain what this code does in beginner-friendly language.
Quando houver execução de comandos ou modificação de arquivos, confirme primeiro o que a ferramenta pretende fazer. Iniciantes não devem ativar o modo totalmente automático.