Qoder CN Series:Perguntas frequentes

**1. O que fazer se a mensagem "Qoder CN is starting" aparecer?**

Se a mensagem "Qoder CN is starting" aparecer ao usar o Qoder CN, siga estas etapas para solucionar o problema.

1. Verifique sua versão e ambiente:

   • Atualize o Qoder CN para a versão mais recente. Confirme se seu sistema operacional e arquitetura são compatíveis.

   • Se estiver usando uma IDE JetBrains, garanta que ela tenha memória heap suficiente. Para limpar o cache, selecione File -> Invalidate Caches e reinicie a IDE.

2. Verifique a conexão de rede e as configurações de proxy:

   • Confirme se estes endpoints estão acessíveis. Se estiverem bloqueados, solicite à equipe de TI que os adicione à lista de permissões:

     • Execute o comando:

       curl https://lingma.alibabacloud.com/algo/api/v1/ping

       A resposta esperada é pong.

   • Caso seu firewall bloqueie esses endpoints, configure um proxy manualmente (obtenha o endereço com a equipe de TI):

     Formato do proxy: http(s)://username:password@proxy-server-address:port

     • Se as configurações de proxy não surtirem efeito, modifique o arquivo de configuração manualmente:

       Caminho: C:\Users\[Your Username]\AppData\Local\.lingma\config.json

       Após modificar o campo http_proxy, encerre o processo do Qoder CN e reinicie-o.

   • Limpe o cache de DNS:

     • No Windows, execute o comando ipconfig /flushdns.

     • No macOS, execute o comando sudo killall -HUP mDNSResponder.

3. Limpe o cache local e reinicie com privilégios de administrador. Abra um projeto não vazio e então:

   1. Encerre o processo do Qoder CN.

   2. Exclua o diretório .lingma:

      1. Caminho no Windows: C:\Users\[Your Username]\.lingma

      2. Caminho no macOS: ~/.lingma

   3. Após concluir essas etapas, reinicie a IDE.

4. Se o problema não for resolvido, inicie o service manualmente:

   Acesse o diretório: .lingma/bin/x.x.x/[CPU_Architecture]_64_[OS]/

   Execute o comando:

   Lingma.exe start

   Depois que o service for iniciado com êxito, clique em novamente no botão de login.

5. Resolva o problema de "programa incompatível": Se o Windows exibir um aviso de "programa incompatível", isso pode indicar uma extração incompleta. Para corrigir:

   • Clique em no ícone do Qoder CN no canto inferior direito e selecione Advanced Settings.

   • Altere o caminho de extração para um local fora da unidade C, garantindo que o caminho termine em uma pasta vazia.

   • Reinicie a IDE e tente novamente.

   Nota

   Nota: Algumas redes corporativas podem bloquear programas binários, impedindo sua execução.

6. Restrições de firewall ou software de segurança: Se o processo do Qoder CN ainda falhar ao iniciar ou se o login não responder, seu firewall ou software de segurança pode estar bloqueando-o:

   • Adicione à lista de permissões do firewall:

     Acesse Painel de Controle -> Sistema e Segurança -> Windows Defender Firewall -> Permitir um aplicativo pelo firewall e adicione o Qoder CN à lista de permissões.

   • Adicione o arquivo de processo à lista de permissões do software de segurança da sua empresa:

     Exemplo de caminho: C:\Users\xxx\.lingma\bin\2.1.x\x86_64_windows\lingma.exe

     (Entre em contato com a equipe de suporte de TI para obter assistência.)

   • Se o seu plugin JetBrains do Qoder CN for da versão 2.1.4 ou posterior, acesse Advanced Settings no plugin Qoder CN e defina Communication Connection Type como stdio (a outra opção é websocket).

2. Falha no login ou erro de "sem permissão"

Ao clicar em no botão de login, um navegador é aberto para autenticação na Alibaba Cloud. Se o login falhar ou exibir "sem permissão", verifique o seguinte:

• Os parâmetros de login podem ter expirado. Aguarde um momento e clique em no botão de login no cliente da IDE para tentar novamente.

• Seu ambiente de rede pode exigir um proxy para acessar a internet. Atualize o Qoder CN para a versão mais recente e verifique se os seguintes hosts estão acessíveis. Se não estiverem, adicione-os à sua lista de permissões. Configuração de proxy de rede.

curl  https://lingma.alibabacloud.com/algo/api/v1/ping

• Após a configuração, encerre o processo do Qoder CN no gerenciador de tarefas, retorne à IDE e faça login novamente.

**3. Ao usar Remote SSH, WSL ou outras ferramentas para desenvolvimento remoto, como faço login no Qoder CN?**

Para desenvolvimento remoto no VS Code ou em IDEs JetBrains, faça login com o AccessKey ID/AccessKey Secret da sua conta Alibaba Cloud para usar o Qoder CN. Instalação e login.

4. É possível usar o Qoder CN na Web IDE?

Sim. Você pode fazer login com o AccessKey ID/AccessKey Secret da sua conta Alibaba Cloud. Consulte Instalação e login.

5. Uso excessivo de CPU ou memória

• Cenário 1: A indexação de código pode causar alto uso de CPU ou memória se o seu projeto contiver muitos arquivos. Crie um arquivo .tongyiignore na raiz do projeto para excluir diretórios ou arquivos da indexação. O arquivo .tongyiignore usa o formato .gitignore. Após modificá-lo, encerre o processo do Qoder CN para aplicar as alterações.

• Cenário 2: O modelo offline local pode estar ativado, o que consome cerca de 500 MB de memória. Se não precisar do modelo offline, desative a conclusão por modelo offline nas configurações.

6. Erro no VS Code: "Extension host terminated unexpectedly"

Esta mensagem de erro aparece como "extension host terminated unexpectedly 3 times within the last 5 minutes".

Causa: Geralmente é um vazamento de memória em uma extensão. Use o método de bissecção de extensões para confirmar se a extensão Qoder CN é a causa.

Solução: Se confirmar que a extensão é a causa, tente o seguinte:

• Reinstale o VS Code e reinicie o sistema (recomendado).

• Usuários do Windows: Desative seu software de segurança ou adicione code.exe à lista de permissões.

Se o problema persistir, entre no grupo 53770000738 do DingTalk e forneça as seguintes informações:

1. Versão do seu sistema operacional e versão do VS Code.

2. Coleta de logs detalhados:

   1. Saia completamente do VS Code.

   2. Execute code --verbose na linha de comando para iniciar o VS Code.

   3. Realize a ação que causa a falha.

   4. Verifique os logs de saída. As primeiras linhas geralmente fornecem a causa inicial da falha, ajudando os técnicos a localizar o problema no código da extensão mais rapidamente. Por exemplo:

      [main 2025-05-02T14:35:31.249Z] [UtilityProcess id: 3, type: extensionHost, pid: 25816]: received exit event with code 18446744072635810000
      [main 2025-05-02T14:35:31.249Z] Extension host with pid 25816 exited with code: 18446744072635810000, signal: unknown.
      [main 2025-05-02T14:35:31.250Z] [UtilityProcess id: 3, type: extensionHost, pid: 25816]: crashed with code -1073741819 and reason 'crashed'
      [19684:0502/223531.251:INFO:CONSOLE(3255)] "Extension host (LocalProcess pid: 25816) terminated unexpectedly. Code: 18446744072635810000, Signal: unknown", source: vscode-file://vscode-app/d:/Microsoft%20VS%20Code/resources/app/out/vs/workbench/workbench.desktop.main.js (3255)

3. Se os logs não confirmarem um problema no código da extensão, colete logs de falha mais detalhados conforme descrito em Native-Crash-Issues:

   1. Saia completamente do VS Code.

   2. Execute code --crash-reporter-directory <absolute path> na linha de comando.

   3. Realize a ação que causa a falha.

   4. Procure um arquivo com sufixo .dmp no diretório da Etapa 2 e envie-o para a equipe técnica.

7. Erro na página de perfil da extensão do VS Code

Se você vir a mensagem de erro "Error loading webview: Error: Could not register service worker: InvalidStateError: Failed to register a ServiceWorker: The document is in an invalid state."

Este é um problema conhecido no VS Code 1.56 que ocorre quando alguns usuários do Windows executam o VS Code como administrador. Tente uma das soluções a seguir.

• Método 1: Inicie o VS Code com o sinalizador de linha de comando --no-sandbox:

  $ code --no-sandbox

• Método 2: Feche o VS Code e, em seguida, no terminal, tente executar: killall code

8. Em IDEs JetBrains, após a conclusão da instalação do Qoder CN, o que fazer se a barra lateral não exibir o botão Qoder CN?

Geralmente, após a instalação, o botão do assistente Qoder CN é exibido na barra lateral da IDE por padrão. Se o botão não aparecer, selecione view > Tool Windows > Qoder CN ( View > Tool Windows > Qoder CN ) para exibi-lo manualmente.

9. Falha na inicialização: erro "File path not found"

Activating extension 'Alibaba-Cloud.tongyi-lingma' failed: ENOENT: no such file or directory, mkdir 'D:\Program Files\Microsoft VS Code\https:\xxx\sharedClientCache\logs'.
$onExtensionActivationError @ mainThreadExtensionService.ts:107

Se o Qoder CN falhar ao iniciar e relatar um erro informando que o caminho do arquivo não existe ou não foi encontrado, siga estas etapas para resolver o problema:

1. Pressione Ctrl+Shift+P (ou Cmd+Shift+P no macOS) no editor para abrir a Paleta de Comandos, pesquise e abra User Settings (Open User Settings (JSON)).

2. No arquivo settings.json, localize o item de configuração: Lingma.LocalMachineStoragePath.

3. Se existir:

   1. Verifique se o caminho existe e está acessível. Caso contrário, corrija-o para um caminho válido; ou

   2. Exclua o item de configuração diretamente.

4. Após salvar a configuração, reinicie ou recarregue a janela e inicie o Qoder CN novamente para confirmar que funciona corretamente.

10. Erro "Sem permissão" após upgrade para plano empresarial

Se você receber um erro de "sem permissão" após atualizar para o Enterprise Exclusive Plan, faça login novamente para resolver o problema.

11. Falha no login devido a caracteres especiais no caminho de armazenamento

Se o caminho de armazenamento personalizado contiver espaços ou outros caracteres especiais, o Qoder CN poderá falhar ao iniciar ou fazer login corretamente.

• Solução recomendada: Atualize para a versão mais recente, que corrigiu este problema.

• Solução alternativa: Altere o caminho de armazenamento personalizado para um que não contenha caracteres especiais e reinicie a IDE JetBrains.

1. IDE travada em "Qoder CN is starting up"

Se a mensagem "Qoder CN is starting up" aparecer enquanto você usa a Qoder CN IDE, siga estas etapas.

1. Verifique sua versão e ambiente:

   • Garanta que você atualizou a Qoder CN IDE para a versão mais recente e que seu sistema operacional e arquitetura são compatíveis.

   • A Qoder CN IDE leva algum tempo para iniciar (cerca de 5 segundos em um ambiente local, mais tempo em um ambiente remoto, dependendo da velocidade da rede). Se não iniciar normalmente após um minuto, isso indica uma anomalia no service.

2. Verifique a conexão de rede e as configurações de proxy:

   • Confirme se este endpoint está acessível. Se estiver bloqueado, solicite à equipe de TI que o adicione à lista de permissões:

     curl https://lingma.alibabacloud.com/algo/api/v1/ping

     A resposta esperada é pong.

   • Caso seu firewall bloqueie este endpoint, configure um proxy manualmente (obtenha o endereço com a equipe de TI):

     Formato do proxy: http(s)://username:password@proxy-server-address:port

     Se as configurações de domínio não forem aplicadas, modifique manualmente o arquivo C:\Users\<username>\AppData\Local\.qodercn\config.json: atualize o campo http_proxy, encerre e reinicie o processo do Qoder CN.

   • Limpe o cache de DNS:

     • Windows: Execute o comando ipconfig /flushdns

     • macOS: Execute o comando sudo killall -HUP mDNSResponder

3. Limpe o cache local e reinicie. Tente o seguinte:

   1. Encerre o processo do Qoder CN.

   2. Exclua o diretório .qodercn:

      • Windows: O caminho é C:\Users\[Username]\.qodercn

      • macOS: O caminho é ~/.qodercn

   3. Após essas etapas, reinicie a Qoder CN IDE.

4. Se o problema não for resolvido, inicie o service do Qoder CN manualmente:

   Acesse o diretório: .qodercn/bin/x.x.x/CPU_architecture_64_system/

   QoderCN.exe start

   Depois que o service for iniciado com êxito, clique em novamente no botão de login.

   Nota

   Nota: Algumas redes corporativas podem bloquear programas binários, impedindo sua execução.

5. Restrições de firewall ou software de segurança: Se o processo do Qoder CN ainda falhar ao iniciar ou se o login não responder, seu firewall ou software de segurança pode estar bloqueando-o:

   • Adicione uma exceção ao firewall: Acesse Painel de Controle -> Sistema e Segurança -> Windows Defender Firewall -> Permitir um aplicativo pelo firewall e adicione o Qoder CN.

   • Adicione o arquivo de processo à lista de permissões do software de segurança da sua empresa:

     Exemplo de caminho: C:\Users\xxx\.qodercn\bin\2.1.x\x86_64_windows\QoderCN.exe

     (Entre em contato com a equipe de suporte de TI para obter assistência.)

2. Login durante desenvolvimento remoto

Ao usar a Qoder CN IDE para desenvolvimento remoto, o processo de login é o mesmo do local. Após uma atualização da IDE ou no primeiro uso, os recursos remotos devem ser instalados no servidor, o que pode levar algum tempo.

• Se você já usou o service remoto antes, mas a conexão falhar, exclua o service .qoder-cn-server no servidor remoto, encerre os processos do QoderCN e tente conectar novamente.

• Se o problema persistir após essa limpeza, relate os logs de "Remote-SSH" ou "Remote-WSL" do painel "Output" para obter assistência.

3. Uso excessivo de CPU ou memória

• Cenário 1: A indexação de código pode causar alto uso de CPU ou memória se o seu projeto contiver muitos arquivos. Crie um arquivo .qoderignore na raiz do projeto para excluir diretórios ou arquivos da indexação. O arquivo .qoderignore usa o formato .gitignore. Após modificá-lo, encerre o processo do Qoder CN para que as alterações tenham efeito.

• Cenário 2: O modelo offline local pode estar ativado, o que usa cerca de 500 MB de memória. Se não precisar dele, desative a conclusão por modelo offline nas configurações.

1. Configurar um proxy de rede

O Qoder CN oferece suporte a proxies HTTP, HTTPS e SOCKS5. Configure-os na página de configurações do plugin. Configuração de proxy de rede.

2. Testar conectividade de rede

Tente executar o seguinte comando no Terminal. Se retornar "pong", você consegue se conectar ao servidor do Qoder CN.

curl  https://lingma.alibabacloud.com/algo/api/v1/ping

**1. Como funciona o preço do Qoder CN?**

Para desenvolvedores individuais, oferecemos a Individual Basic Edition e a Individual Pro Edition. A oferta gratuita por tempo limitado da Individual Pro Edition terminará às 18:00:00 de 20 de maio de 2026 (horário de Pequim), após o qual será convertida automaticamente para a Individual Basic Edition. Faturamento. Faturamento empresarial: Faturamento.

2. Emissão de nota fiscal

Sim, você pode enviar uma solicitação de nota fiscal através da página de Gerenciamento de Notas Fiscais no console da Alibaba Cloud ou no aplicativo da Alibaba Cloud.

1. Qual conta devo usar para fazer login e utilizar o Qoder CN?

• Para o Tongyi Lingma original: Você precisa usar uma conta Alibaba Cloud e garantir que tenha Créditos disponíveis. Na janela do assistente Qoder CN do cliente da IDE Qoder CN, clique em no botão de login para concluir o login na Alibaba Cloud.

• Para QoderWork/Qoder CLI e outros: Usuários individuais ou empresariais precisam assinar e comprar na Alibaba Cloud, garantindo que tenham um pedido válido e Créditos disponíveis em sua conta pessoal ou empresarial.

Se você ainda não se registrou para obter uma conta Alibaba Cloud, registre uma conta primeiro.

1. Versões compatíveis de IDEs JetBrains

Atualmente, as IDEs JetBrains são compatíveis com as versões 2020.3 (203.x) e posteriores, incluindo IntelliJ IDEA, PyCharm, GoLand, WebStorm, entre outras.

2. Versão compatível do Visual Studio Code

Atualmente, o Visual Studio Code é compatível com as versões 1.68.0 e posteriores.

3. Versão compatível do Visual Studio 2022

Atualmente compatível com as versões 17.3.0 e posteriores do Visual Studio 2022.

4. Sistemas operacionais compatíveis

• Sistemas operacionais compatíveis para IDEs JetBrains: Windows 7 e posteriores, macOS, Linux.

• Sistemas operacionais compatíveis para Visual Studio Code: Windows 7 e posteriores, macOS, Linux.

• Sistemas operacionais compatíveis para Visual Studio 2022: Windows 10 e posteriores.

5. Linguagens de programação compatíveis

O Qoder CN oferece suporte total às principais linguagens de programação e apresenta melhor desempenho em cenários de codificação Java, Python, Go, JavaScript, TypeScript, C/C++ e C#.

1. O Qoder CN armazena meus dados de código?

Não armazenamos seus dados de código:

• Para conclusão de código, precisamos acessar o contexto do seu código para fornecer sugestões, mas as informações de contexto não são armazenadas nem usadas para qualquer outra finalidade. Esses dados são de sua total propriedade e controle.

• Para Perguntas e Respostas com IA, coletamos apenas registros de chat (excluindo código) quando você fornece feedback (polegar para cima/baixo). Esses dados são anonimizados e desidentificados antes de serem usados para atualizações e iterações de algoritmos.

Nossos compromissos estão documentados na Política de Privacidade do Qoder CN.

**2. Quais dados de treinamento o Qoder CN utiliza?**

Os dados de treinamento incluem principalmente código open-source de alta qualidade, artigos e documentação de comunidades técnicas, documentação de services da Alibaba Cloud e documentos de uso de sdk/api da Alibaba Cloud.

3. Compartilhamento de trechos de código

Não. Seu código nunca é compartilhado. Embora usemos o contexto do seu código para gerar sugestões, as informações de contexto não são armazenadas nem usadas para qualquer outra finalidade. Esses dados são de sua total propriedade e controle.

4. O código gerado pelo Qoder CN pode ser usado diretamente?

O código gerado pelo Qoder CN é apenas uma sugestão. Revise todo o código gerado antes de adotá-lo.

1. Limite de dados por consulta de página

Recomendamos um tamanho de página de no máximo 10.000 entradas. Ajuste esse limite com base nas necessidades do seu aplicativo e no desempenho do sistema.

2. Frequência de atualização de dados da api

As atualizações de dados da api começam à meia-noite diariamente, ocorrendo a cada 15 minutos. O conjunto completo de dados do dia anterior fica disponível até as 2h da manhã.

3. Requisitos de frequência de uso da api

Para garantir um service estável e eficiente, a api impõe um limite de taxa de 100 QPS.

4. Obtendo o Organization ID

No canto superior direito do console do Qoder CN, clique em no seu avatar e, em seguida, clique em Admin Console. Na página Basic Information, copie o Organization ID.

1. O plano de assinatura Teams

Nosso plano de assinatura Teams oferece os seguintes recursos para organizações e está em constante evolução:

• Pagamento centralizado de faturas da organização

• Admin Console centralizado, com suporte a gerenciamento obrigatório de direitos de acesso dos membros, modos de privacidade de dados, etc.

• Suporte para restrições de domínio de conta e controle de acesso para contas fora do domínio

• Suporte para single sign-on (SSO)

2. Erro "Failed to join organization"

Se você encontrar um erro "Failed to join organization" durante o login, significa que o administrador da sua empresa associou seu domínio de e-mail a uma organização Qoder Teams. Essa configuração foi projetada para adicionar automaticamente todas as contas desse domínio à organização. No entanto, o processo falhou porque a organização ficou sem vagas disponíveis.

Entre em contato com o administrador de TI para comprar mais vagas. Assim que houver vagas disponíveis, faça login novamente para ser adicionado automaticamente à organização.

3. Menos Créditos por vaga

Os Créditos por vaga são calculados proporcionalmente com base no momento em que a vaga foi comprada. Se você entrar no meio do ciclo, os Créditos alocados serão reduzidos proporcionalmente. O valor total é restaurado no próximo ciclo.