Todos os produtos
Search
Central de documentação

Qoder CN Series:Perguntas frequentes

Última atualização: Oct 20, 2026

Encontre respostas para dúvidas comuns sobre o Qoder CN, incluindo inicialização e login, linguagens suportadas, segurança de dados, faturamento e OpenAPI.

Nota

O novo site de documentação do Qoder CN já está disponível. O conteúdo desta página pode não refletir os recursos e as alterações mais recentes do produto. Acesse docs.qoder.cn para consultar a documentação mais recente.

Caso enfrente algum problema, reinicie sua IDE primeiro. Se a questão persistir, entre no grupo 53770000738 do DingTalk para obter ajuda.

Perguntas frequentes sobre o plugin Qoder CN (JetBrains / VS Code)

Nota

Alguns processos do plugin Qoder CN ainda utilizam o nome Lingma. Os caminhos e nomes de processos relacionados usam .lingma e Lingma.exe.

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

Se a mensagem "Qoder CN is starting" surgir durante o uso do 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 suportados.

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

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

    • Certifique-se de que estes endpoints estejam acessíveis. Caso estejam bloqueados, solicite à equipe de TI que os adicione à lista de permissões:

      • Execute o comando:

        A resposta esperada é pong Execute o comando: O código de status esperado é 302. .

        curl -I https://qoder.console.aliyun.com
      • curl https://lingma.alibabacloud.com/algo/api/v1/ping

        O código de status esperado é 302.

    • Se o firewall bloquear 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

      • Caso as configurações de proxy não surtam 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:

    Depois que o service iniciar com êxito, clique 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 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 -> Firewall do Windows Defender -> 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 corporativo:

      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 Qoder CN para JetBrains 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 no botão de login, um navegador é aberto para autenticação na Alibaba Cloud. Se o login falhar ou exibir "sem permissão", verifique os seguintes pontos:

  • Os parâmetros de login podem ter expirado. Aguarde um momento e clique 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 hosts abaixo estão acessíveis. Se não estiverem, adicione-os à sua lista de permissões. {{XREF_0}}.

    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. {{XREF_1}}.

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 {{XREF_2}}.

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 projeto contiver muitos arquivos. Crie um arquivo .tongyiignore na raiz do projeto para excluir diretórios ou arquivos da indexação. O arquivo .tongyiignore utiliza 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, consumindo cerca de 500 MB de memória. Caso não precise do modelo offline, desative a conclusão por modelo offline nas configurações.

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

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

Causa: Geralmente indica um vazamento de memória em uma extensão. Utilize o método extension bisect 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 o 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 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 indicam a causa inicial da falha, ajudando os técnicos a localizar o problema no código da extensão mais rapidamente. Por exemplo:

  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:

  • 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?

Normalmente, 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"

Se o Qoder CN falhar ao iniciar e relatar 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 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 se funciona corretamente.

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

Se 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 corrige esse problema.

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

Perguntas frequentes sobre a Qoder CN IDE

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

Se a mensagem "Qoder CN is starting up" aparecer durante o uso da 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 suportados.

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

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

    • Certifique-se de que este endpoint esteja acessível. Caso esteja bloqueado, solicite à equipe de TI que o adicione à lista de permissões:

      A resposta esperada é pong.

    • curl https://lingma.alibabacloud.com/algo/api/v1/ping
    • Se o firewall bloquear 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 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/

    Depois que o service iniciar com êxito, clique 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 no firewall: Acesse Painel de Controle -> Sistema e Segurança -> Firewall do Windows Defender -> Permitir um aplicativo pelo firewall e adicione o Qoder CN.

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

      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 ambiente local. Após uma atualização da IDE ou no primeiro uso, os resources remotos devem ser instalados no servidor, o que pode levar algum tempo.

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

  • Caso o problema persista após essa limpeza, reporte os logs de "Remote-SSH" ou "Remote-WSL" no 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 projeto contiver muitos arquivos. Crie um arquivo .qoderignore na raiz do projeto para excluir diretórios ou arquivos da indexação. O arquivo .qoderignore utiliza 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, utilizando cerca de 500 MB de memória. Caso não precise dele, desative a conclusão por modelo offline nas configurações.

Problemas de rede

1. Configurar um proxy de rede

O Qoder CN suporta proxies HTTP, HTTPS e SOCKS5. Configure-os na página de configurações do plugin. {{XREF_3}}.

2. Testar conectividade de rede

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

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

.

3. Solucionar problemas de rede

Para nos ajudar a resolver seu problema, siga estas etapas e forneça as informações relevantes:

  1. Acesse "Qoder CN Settings" > "Network" > Run diagnostics e envie-nos o relatório de diagnóstico completo.

  2. Você está usando VPN, proxy ou rede corporativa no momento? Nesse caso, tente desativar esses services ou mudar para uma conexão de rede diferente.

  3. Na interface de chat, tente selecionar modelos de diferentes níveis para verificar se a velocidade de resposta melhora.

  4. Se o problema persistir após essas etapas, forneça as seguintes informações para investigação adicional:

    • Exemplos específicos de prompts que causam atrasos e seus respectivos timestamps;

    • Acesse "Help" > "Toggle Developer Tools", visualize o console e envie-nos uma captura de tela de quaisquer erros no console;

    • Esse problema ocorre em todos os projetos ou apenas em um workspace específico?

    • Outros usuários na mesma rede conseguem reproduzir esse problema?

    Envie as informações acima através do recurso "Report Issue".

Faturamento

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. {{XREF_4}}. Faturamento empresarial: {{XREF_5}}.

2. Emissão de nota fiscal

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

Conta

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

  • Para o Tongyi Lingma original: É necessário usar uma conta Alibaba Cloud e garantir que você tenha Credits disponíveis. Na janela do assistente Qoder CN do cliente da IDE Qoder CN, clique no botão de login para concluir o acesso à 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 Credits disponíveis em sua conta pessoal ou empresarial.

Se ainda não se registrou para uma conta Alibaba Cloud, {{XREF_8}}

primeiro.

Qoder CN

IDEs, sistemas operacionais e linguagens suportados

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 suportados

  • 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 suportadas

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#.

Segurança e qualidade dos dados

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 pertencem inteiramente a você e são controlados por você.

  • Para perguntas e respostas com IA, coletamos apenas registros de chat (excluindo código) quando você fornece feedback (positivo/negativo). 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 pertencem inteiramente a você e são controlados por você.

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.

OpenAPI

1. Limite de dados por consulta paginada

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 Qoder CN, clique no seu avatar e depois em Admin Console. Na página Basic Information, copie o Organization ID.

QoderWork/Qoder CLI

1. O plano de assinatura Teams

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

  • Pagamento centralizado das faturas da organização

  • Admin Console centralizado, com suporte para 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 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 visa 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 Credits por vaga

Os Credits por vaga são calculados proporcionalmente com base no momento da compra. Se você entrar no meio do ciclo, os Credits alocados serão reduzidos proporcionalmente. O valor total é restaurado no próximo ciclo.