> ## Documentation Index
> Fetch the complete documentation index at: https://docs.windsurf.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Visual Studio Code (VSCode) Solução de problemas

> Solucione problemas da extensão do VS Code, incluindo configurações de proxy, erros de certificado, configuração do servidor de API e problemas nas respostas do Chat.

<Note>
  Recomendamos fortemente usar o Windsurf Editor nativo ou o plugin local do JetBrains pelas suas capacidades avançadas de IA baseada em agentes e recursos de ponta.
  O plugin do VS Code está em modo de manutenção.
</Note>

VS Code 1.89 ou superior é compatível.

<div id="gathering-extension-logs">
  # Coletando logs da extensão
</div>

A partir da versão 1.10.0 da extensão para VS Code, os diagnósticos da extensão podem ser baixados pela página de Settings. Esse download conterá um conjunto de logs e parâmetros relevantes em um arquivo de texto.

*Para obter os logs completos de saída do VS Code:*

1. Abra a Paleta de Comando (`Ctrl/Cmd + Shift + P` ou vá em View > Command Palette)

2. Digite "Show logs" e selecione a opção `Developer: Show Logs`

3. No menu, selecione `Extension Host`

4. Você deverá ver algo semelhante à imagem abaixo:

<Frame>
  <img src="https://mintcdn.com/codeium/vRt4FQOyBeZpD2Pu/assets/plugins/troubleshooting-vscode-showlogs.jpg?fit=max&auto=format&n=vRt4FQOyBeZpD2Pu&q=85&s=8a5317496a257a1efffaf5191c7963c9" width="2244" height="410" data-path="assets/plugins/troubleshooting-vscode-showlogs.jpg" />
</Frame>

5. No canto superior direito, altere o menu que está em "Extension Host" para "Codeium"

6. Exporte ou copie os logs

<div id="known-ide-issues-and-solutions">
  # Problemas conhecidos no IDE e soluções
</div>

<div id="esplit-is-not-defined">
  ## e.split não está definido
</div>

Você está usando uma versão não suportada do VS Code. Atualize para uma versão suportada e tente novamente. Você pode encontrar uma lista de versões suportadas [aqui](/pt-BR/plugins/compatibility).

<div id="using-the-wrong-api-server">
  ## Uso do API Server incorreto
</div>

Se um usuário alterar a URL do API Server/Portal nas configurações do **workspace**, isso substituirá as configurações do usuário e pode resultar em um erro em que a extensão se comunica com o API Server errado.

Verifique se a URL do API Server/Portal está correta e não foi substituída acidentalmente pelas configurações do workspace.

<div id="not-seeing-codeium-chat-responses">
  ## Não está vendo respostas do Codeium Chat
</div>

Se você está tentando enviar mensagens para o Codeium Chat, mas não está vendo respostas, verifique se consegue cancelar a resposta. Se não for possível cancelar, isso significa que a resposta foi concluída, mas não foi exibida. Isso pode acontecer se o Chat Web Server perder a conexão com a extensão. Recarregar o VS Code e abrir novamente o painel do Codeium Chat deve exibir as respostas.

<div id="unable-to-read-file-packagejson">
  ## Não foi possível ler o arquivo .../package.json
</div>

```
Unable to read file .../.vscode/extensions/codeium.codeium-<version>/package.json
```

Se o erro acima aparecer nos logs do Codeium, tente excluir a pasta da extensão (.../.vscode/extensions/codeium.codeium-\<version>) e reinstalar a extensão.

Para fazer isso manualmente:

1. Abra a Paleta de Comandos (CTRL + SHIFT + P)
2. Execute 'Codeium Enterprise: Reset'
3. Selecione "Help" no pop-up
4. Selecione "Show Disabled Extensions"
5. Reative a extensão do Codeium

<div id="proxy-network-issues">
  ## Problemas de proxy / rede
</div>

Desmarcar a opção `Detect Proxy` nas configurações do Codeium no VS Code às vezes pode resolver problemas em que a extensão tenta usar um proxy indevidamente.

<div id="certificate-issues">
  ## Problemas com certificados
</div>

Se você encontrar os erros a seguir:

```
ConnectError: [internal] não foi possível obter o certificado do emissor
```

```
[ERRO]: [interno] não foi possível verificar o primeiro certificado
```

```
tls: falha ao verificar certificado: x509: certificado "<yourdomainurl>" não está em conformidade com os padrões
```

Isso sugere que a extensão do Codeium não consegue confiar na conexão TLS com seu portal/servidor de API corporativo porque não confia no certificado apresentado. Isso pode significar que o certificado apresentado pela implantação do Codeium não é confiável ou que o certificado apresentado por um proxy corporativo que intercepta a solicitação não é confiável.

Em ambos os casos, a solução mais recomendada é garantir que o certificado raiz que assinou esse certificado esteja devidamente instalado nas máquinas dos usuários finais, no local apropriado. O VS Code e a maioria dos outros IDEs carregam certificados do local padrão do sistema operacional.

Seu certificado é emitido e gerenciado pela equipe local de TI ou Administradores. Entre em contato com eles para obter ajuda na instalação dos certificados necessários no seu sistema.

É importante que a cadeia completa de certificação seja apresentada no ponto em que o TLS é encerrado. Com frequência, se apenas o certificado folha for apresentado, o VS Code e outros IDEs não conseguem verificar sua autenticidade porque não conhecem o certificado intermediário, que valida o certificado folha e é validado pelo certificado raiz. Os navegadores muitas vezes conseguem contornar esse problema, pois os usuários provavelmente já acessaram outro site que apresenta a cadeia completa de certificação; assim, o certificado intermediário é visto e armazenado em cache, mas aplicativos como o VS Code não têm essa vantagem.

A extensão Network Proxy (Text) do VS Code é útil para depurar problemas de certificação.
