Skip to main content
服务支持

常见问题

Qoder CN 的启动和登录、支持语言、数据安全、收费和OpenAPI等相关问题，可以在本文找到相关答案。
如果在使用的过程中遇到问题，可先尝试重启 IDE。重启后依然无法解决，可加入钉钉群：53770000738，我们将尽快为您解决问题。

Qoder CN 插件常见问题（JetBrains / VS Code）

Qoder CN 插件中的相关进程仍为 Lingma，相关路径和进程名以 .lingma / Lingma.exe 为准。

1.提示"Qoder CN 启动中"怎么办？

如果在使用 Qoder CN 时看到"Qoder CN 启动中"的提示，您可以按照以下步骤逐一排查并解决问题。
  1. 检查版本与运行环境：
  • 确保您已将 Qoder CN 升级至最新版本，并确认您的操作系统和系统架构支持 Qoder CN 运行。
  • 如果您使用的是 Jetbrains IDE，请进行以下检查：保证 IDE 的堆内存大小足够。操作步骤：依次点击 File -> Invalidate Caches，清理缓存后重启 IDE。
  1. 网络连接与代理配置：
  • 确保以下地址可以正常访问。如果无法访问，请联系公司 IT 部门将其加入白名单：
    • 执行命令： 
      curl https://lingma-api.tongyi.aliyun.com/algo/api/v1/ping
      返回值应为 pong。
    • 执行命令： 
      curl -I https://qoder.console.aliyun.com
      返回状态码应为 302。
  • 如果公司防火墙限制且无法加白名单，需手动配置代理地址（具体地址请联系公司 IT 提供）：代理格式：http(s)://用户名:密码@代理服务器地址:端口
    • 如果域名保存未生效，可手动修改配置文件：路径：C:\Users\用户名\AppData\Local.lingma\config.json修改 http_proxy 字段后，结束 Qoder CN 进程并重启。
  • 清理 DNS 缓存：
    • Windows：执行命令 ipconfig /flushdns
    • macOS：执行命令 sudo killall -HUP mDNSResponder
  1. 清理本地缓存并重新启动 IDE。以管理员权限启动 IDE，打开一个非空项目文件夹后，尝试以下操作：
  2. 结束 Qoder CN 进程。
  3. 删除 .lingma 目录：
  4. Windows：路径为 C:\用户[用户名].lingma
  5. macOS：路径为 ~/.lingma
  6. 完成上述操作后，重新启动 IDE。
  7. 手动启动 Qoder CN 服务。如果问题仍未解决，可尝试手动启动 Qoder CN 服务：进入目录：.lingma/bin/x.x.x/CPU架构_64_系统/执行命令： 
    Lingma.exe start
    等待启动成功后，重新点击登录按钮。
  8. 解决"不兼容的程序"问题：如果在 Windows 上收到"不兼容的程序"提示，可能是由于解压不完整导致的。解决方法如下：
  • 点击右下角的 Qoder CN 图标，选择 高级设置。
  • 修改解压路径为非 C 盘的其他路径，并确保路径以空文件夹结尾。
  • 重启 IDE 后重试。
注意：部分公司内网会对二进制程序进行加锁，导致无法运行。
  1. 防火墙或安全软件限制：如果 Qoder CN 进程仍然无法正常启动或登录无反应，可能是因为防火墙或公司安全软件限制了运行。请按以下步骤操作：
  • 添加防火墙白名单：打开控制面板 -> 系统和安全 -> Windows Defender 防火墙 -> 允许的应用，将 Qoder CN 加入白名单。
  • 在公司安全软件中添加进程文件白名单：路径示例：C:\Users\xxx.lingma\bin\2.1.x\x86_64_windows\lingma.exe（请联系公司 IT 支持人员协助完成。）
  • 如果 Qoder CN 的 JetBrains 插件版本为 2.1.4 或更高版本，可在通义灵码插件的高级设置中，将通信连接方式设置为 stdio（另一个可选值为 websocket）。

2. 显示登录失败、无权限怎么办？

当从 IDE 客户端单击登录后，会前往浏览器登录阿里云，出现登录失败或账号无权限，可能有 2 种情况：
  • 当登录参数失效时，可能会出现登录失败的情况，可稍后在 IDE 客户端单击登录，再次尝试登录。
  • 当所在的网络环境需要使用代理访问公网时，可能会提示登录失败或账号无权限，需将 Qoder CN 升级到最新版本，确保以下 host 可访问，如发现网络不通，需要添加白名单，可参考网络代理配置解决问题。
curl https://lingma-api.tongyi.aliyun.com/algo/api/v1/ping
curl -I https://qoder.console.aliyun.com
  • 配置完成后从进程管理器里找到 Qoder CN 进程，结束进程后，返回 IDE 重新登录。

3. Remote SSH、WSL等进行远程开发时，如何登录 Qoder CN？

在使用 VS Code、JetBrains IDEs 上连接远程服务器进行开发时，可使用阿里云账号的 AK/SK 进行登录后使用 Qoder CN。查看详细方式：安装和登录。

4. Web IDE 中可以使用 Qoder CN 吗？

可通过阿里云账号的 AK/SK 进行登录后使用，安装和登录。

5. 如果发现 Qoder CN 进程占用 CPU 或内存过高怎么办？

  • 情况1：可能因为您的代码工程文件较多，导致代码索引时消耗 CPU 或内存过高，可以在工程根目录创建 .tongyiignore 文件，将不需要索引的目录或文件排除，从而减少索引时的 CPU 或内存占用，.tongyiignore 内容格式与 .gitignore 相同，修改 .tongyiignore 内容后，手动结束 Qoder CN 进程后配置即可生效。
  • 情况2：可能是因为开启了本地离线模型，本模型会占用 500M 左右内存，如您无需使用离线模型，可在设置中关闭离线模型补全功能。

6.VS Code 提示扩展主机意外终止

如果您遇到以下错误信息："extension host terminated unexpectedly 3 times within the last 5 minutes 扩展主机在过去5分钟内意外终止3次"。 问题原因：这通常是由某个插件导致的内存泄漏。可先按照扩展二等分法确认崩溃是否由 Qoder CN 插件导致。 解决方案：如果确认是该插件引起，可按照以下方式解决：
  • 重装 VS Code 后重启系统（推荐）。
  • Windows 用户：关闭安全软件或对code.exe进行加白。
如果问题依旧存在，请加入钉钉群：53770000738，并提供以下信息：
  1. 操作系统版本和 VS Code 版本。
  2. 收集 verbose 日志：
  3. 完全退出 VS Code。
  4. 命令行中执行code --verbose启动 VS Code。
  5. 执行导致崩溃的操作。
  6. 检查输出的日志，类似2、3行会给出崩溃的初步原因，技术人员才能更快定位到插件里的代码。如： 
    [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)
  7. 若上述日志无法确认是插件里的代码引起，需参考 Native-Crash-Issues 收集更详细的崩溃日志：
  8. 完全退出 VS Code。
  9. 命令行中执行 code --crash-reporter-directory <绝对路径>。
  10. 执行会导致崩溃的操作。
  11. 查找第二步的目录下是否有一个.dmp后缀的文件，并将其发送给技术团队。

7. VS Code插件中的个人中心页面报错怎么办？

如果您看到以下报错信息，"Error loading webview: Error: Could not register service worker: InvalidStateError: Failed to register a ServiceWorker: The document is in an invalid state." 这是一个 VS Code 1.56 中的已知问题，当某些 Windows 用户以管理员身份运行 VS Code 时，就会发生这种情况。您可以尝试以下方式进行解决。
  • 方式1： --no-sandbox 命令行标志启动 VS Code： 
    $ code --no-sandbox
  • 方式2：关闭 VS Code，然后在终端中尝试运行：killall code

8. Qoder CN 启动失败，提示"文件路径找不到"怎么办？

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
当 Qoder CN 启动失败并报错提示文件路径不存在/找不到时，可按以下步骤排查并修复：
  1. 在编辑器中使用 Ctrl/Cmd + Shift + P 打开命令面板，搜索并进入 User Settings（Open User Settings (JSON)）。
  2. 在打开的 settings.json 中查找是否存在配置项：Lingma.LocalMachineStoragePath。
  3. 若存在：
  4. 检查该配置项对应的路径是否真实存在且可访问，并按需修正为有效路径；或
  5. 直接删除该配置项。
  6. 保存配置后，重启/重新加载窗口，再次启动 Qoder CN，确认是否恢复正常。

9. 企业专属版升级之后提示暂无使用权限

企业专属版升级后提示暂无使用权限时，请重新登录账号即可恢复正常。

10. 因自定义存储路径包含空格等特殊字符导致无法登录

当自定义存储路径中包含空格或其他特殊字符时，可能导致 Qoder CN 无法正常启动或登录。
  • 推荐方案：升级至最新版本，新版已修复此问题。
  • 临时方案：修改自定义存储路径为不含特殊字符的路径，然后重新启动 JetBrains IDE。

Qoder CN IDE 常见问题

1.提示"Qoder CN 启动中"怎么办？

如果在使用 Qoder CN IDE 时看到"Qoder CN 启动中"的提示，您可以按照以下步骤逐一排查并解决问题。
  1. 检查版本与运行环境：
  • 确保您已将 Qoder CN IDE 升级至最新版本，并确认您的操作系统和系统架构支持运行。
  • Qoder CN IDE 存在一定的启动时间（本地环境 5s 左右，Remote 远程环境受网速影响），如果静待一分钟后仍未正常启动，则表示服务异常。
  1. 网络连接与代理配置：
  • 确保以下地址可以正常访问。如果无法访问，请联系公司 IT 部门将其加入白名单： 
    curl https://lingma-api.tongyi.aliyun.com/algo/api/v1/ping
    返回值应为 pong。
  • 如果公司防火墙限制且无法加白名单，需手动配置代理地址（具体地址请联系公司 IT 提供）：代理格式：http(s)://用户名:密码@代理服务器地址:端口如果域名保存未生效，可手动修改配置文件：路径为 C:\Users\用户名\AppData\Local.qodercn\config.json，修改 http_proxy 字段后，结束 Qoder CN 进程并重启。
  • 清理 DNS 缓存：
    • Windows：执行命令 ipconfig /flushdns
    • macOS：执行命令 sudo killall -HUP mDNSResponder
  1. 清理本地缓存并重新启动。尝试以下操作：
  2. 结束 Qoder CN 进程。
  3. 删除 .qodercn 目录：
  • Windows：路径为 C:\用户[用户名].qodercn
  • macOS：路径为 ~/.qodercn
  1. 完成上述操作后，重新启动 Qoder CN IDE。
  2. 手动启动 Qoder CN 服务。如果问题仍未解决，可尝试手动启动：进入目录：.qodercn/bin/x.x.x/CPU架构_64_系统/ 
    QoderCN.exe start
    等待启动成功后，重新点击登录按钮。
    注意：部分公司内网会对二进制程序进行加锁，导致无法运行。
  3. 防火墙或安全软件限制：如果 Qoder CN 进程仍然无法正常启动或登录无反应，可能是因为防火墙或公司安全软件限制了运行。请按以下步骤操作：
  • 添加防火墙白名单：打开控制面板 -> 系统和安全 -> Windows Defender 防火墙 -> 允许的应用，将 Qoder CN 加入白名单。
  • 在公司安全软件中添加进程文件白名单：路径示例：C:\Users\xxx.qodercn\bin\2.1.x\x86_64_windows\QoderCN.exe（请联系公司 IT 支持人员协助完成。）

2. Remote SSH、WSL 等进行远程开发时，如何登录 Qoder CN？

在使用 Qoder CN IDE 连接远程服务器进行开发时，登录方式和本地开发一致。IDE 版本更新后或首次使用时，需要在远程服务器上完成远程资源的安装，存在一定的安装时间。
  • 如果之前使用过远程服务，而本次连接失败，可以删除远程服务器上 .qoder-cn-server 服务，并清理 QoderCN 进程后，重新尝试连接。
  • 如果清理完仍失败，可以将"输出"面板中的"Remote-SSH"（"Remote-WSL"）相关日志上报，来寻求开发人员帮助。

3. 如果发现 Qoder CN 进程占用 CPU 或内存过高怎么办？

  • 情况1：可能因为您的代码工程文件较多，导致代码索引时消耗 CPU 或内存过高，可以在工程根目录创建 .qoderignore 文件，将不需要索引的目录或文件排除，从而减少索引时的 CPU 或内存占用，.qoderignore 内容格式与 .gitignore 相同，修改 .qoderignore 内容后，手动结束 Qoder CN 进程后配置即可生效。
  • 情况2：可能是因为开启了本地离线模型，本模型会占用 500M 左右内存，如您无需使用离线模型，可在设置中关闭离线模型补全功能。

关于网络问题

1. 如何配置网络代理？

Qoder CN 支持 HTTP、HTTPS、Socks5 网络代理配置，可在插件设置页进行配置，具体操作参考：网络代理配置。

2.如何测试网络连通性？

可以尝试在 Terminal 中输入以下命令，如果返回 pong，则大概率可连通至 Qoder CN 服务端。 
curl https://lingma-api.tongyi.aliyun.com/algo/api/v1/ping
curl -I https://qoder.console.aliyun.com

3. 遇到网络问题如何排查？

为了更好地帮助你解决问题，请按照以下步骤操作并提供相关信息：
  1. 请进入"Qoder CN 设置" > "网络" > 运行诊断，并将完整的诊断结果发送给我们。
  2. 你当前是否正在使用 VPN、代理或企业网络？如果是，请尝试关闭这些服务或将网络切换至其他连接。
  3. 尝试在聊天界面中选择不同分级的模型，观察响应速度是否有改善。
  4. 如果以上操作后问题仍然存在，请进一步提供以下信息以便我们深入调查：
  • 发生延迟的具体示例提示及对应的时间戳；
  • 打开"帮助">"切换开发者工具"> 查看控制台错误日志并截图发送；
  • 此问题是在所有项目中都出现，还是仅限于某个特定的工作区？
  • 此问题在相同网络下的其他用户是否能复现？
以上信息通过"问题上报"功能进行反馈。

关于收费

1.Qoder CN 如何收费？

面向个人开发者提供个人基础版、个人专业版，个人专业版限时免费活动将于北京时间 2026年5月20日 18:00:00 结束，届时将自动转为个人基础版。详细信息请参见计费说明。 面向企业客户提供企业标准版、企业专属版，企业版计费信息可参考：计费说明。

2. Qoder CN 可以开具发票吗？

可以，您可通过阿里云控制台或阿里云App的 发票管理页面提交开票申请

关于账号

1. 使用什么账号进行登录并使用 Qoder CN？

  • 原通义灵码：您需要使用阿里云账号，且确保您的账号中有使用 Credits 额度 Qoder CN，在 IDE 客户端的 Qoder CN 助手窗口中单击登录按钮，即可完成阿里云登录。
  • QoderWork/CLI等：个人或者企业用户需在阿里云开通并购买，确保个人或企业级账号下有有效订单和Credtis额度。
如果您还未注册阿里云账号，请首先完成账号注册。

2. RAM 用户可以体验 Qoder CN 吗？

RAM 用户在其阿里云主账号尚未开通企业标准版的情况下，可以个人开发者身份使用 Qoder CN，在 IDE 客户端中单击登录，切换到 RAM 用户登录页面，完成登录后即可体验 Qoder CN。

3. 企业如何体验 Qoder CN？

如果需要体验企业版，可参考原灵码企业标准版（仅供存量客户参考）教程。

关于支持的 IDE、系统、语言

1. JetBrains IDEs 版本兼容是多少？

目前 JetBrains IDEs 兼容2020.3（203.x）及以上，包含 IntelliJ IDEA、PyCharm、GoLand、WebStorm 等 JetBrains IDEs。

2. Visual Studio Code 版本兼容是多少？

目前 Visual Studio Code 兼容 1.68.0 及以上。

3.Visual Studio 2022 版本兼容是多少？

目前兼容 Visual Studio 2022 17.3.0 及以上版本。

4. 支持操作系统版本有哪些？

  • JetBrains IDEs 兼容的操作系统：Windows 7 及以上、macOS、Linux。
  • Visual Studio Code 兼容的操作系统：Windows 7 及以上、macOS、Linux
  • Visual Studio 2022 兼容的操作系统：Windows 10 及以上

5. 支持哪些编程语言？

全面覆盖主流编程语言，在 Java、Python、Go、JavaScript、TypeScript、C/C++、C# 编码场景表现更优。

关于数据安全和质量

1. Qoder CN 会存储我的代码数据吗？

我们不会存储您的代码数据：
  • 代码补全时，我们需要获取您的代码上下文信息以完成补全，但上下文信息不会被存储或用于其他任何目的，该等数据完全由您所有及控制。
  • 研发智能问答时，我们仅会在您点踩/点赞后，仅针对聊天记录（不包含代码），并将数据进行脱敏、去标识化处理后，用于算法的升级、迭代。
更多隐私政策，可前往Qoder CN 隐私政策。

2.Qoder CN 的训练数据包含哪些？

训练数据主要包含优质开源代码、技术社区文章和技术文档、阿里云的云服务文档、阿里云 SDK/API 使用文档等。

3. 我的代码片段会与其他用户共享吗？

不会。使用大模型进行代码补全时，我们需要获取您的代码上下文信息以完成补全，但上下文信息不会被存储或用于其他任何目的，该等数据完全由您所有及控制。

4. Qoder CN 生成的代码可以直接使用吗？

Qoder CN 生成的代码只是建议代码，无法确保其可用性，需要开发人员自行对代码进行审核和决定是否采纳。

OpenAPI相关问题

1. 每页查询的数据量是否有上限？

建议不超过10000条。但是在进行数据查询与展示时，设定每页查询的数据量上限对于确保系统性能和优化用户体验至关重要，具体数值应根据实际应用场景及系统能力灵活调整。

2. API的数据在每天凌晨更新，更新频率是什么？

API 数据从每日凌晨开始每15分钟更新一次，通过多重校验机制确保数据的实时性、可靠性和灵活性。所以在凌晨两点是可以获取到昨天最新且准确的完整数据集。

3. API使用频率有没有要求？

为确保服务稳定高效，我们的 API 调用频率上限为 100 QPS，即每秒最多 100 次请求。

4. organizationId 获取方式

在 Qoder CN 控制台右上角的头像，单击管理后台，然后在基本信息页面复制组织ID 。

QoderWork/Qoder CLI使用相关问题

1. 什么是 Teams 订阅计划？

面向组织和团队的使用场景，我们推出了 Teams 订阅计划，包括并不限于以下特性，并在持续演进中：
  • 集中支付组织账单
  • 集中的管理员控制台，支持强制管理成员访问权限、数据隐私模式等
  • 支持账号域限制，非域内账号访问控制
  • 支持单点登录（SSO）

2. 为什么我尝试登录时会收到"加入组织失败"的错误提示？

如果你在登录时遇到 "加入组织失败" 错误，则表示你的企业管理员已将你的电子邮件域关联到 Qoder Teams 组织。此设置旨在自动将该域下的所有账户添加到组织中。但是，由于组织已用完可用席位，因此该过程失败。 要解决此问题，请联系你公司的 IT 管理员，并请他们购买更多席位。席位足够后，请尝试再次登录。届时，你将被自动添加到组织中，并可以开始使用 Teams 订阅计划。

3. 我席位的 Credits 额度为什么比别人少？

席位的 Credits 额度与席位购买使用的时间有关。如果在周期中途加入，将根据比例进行计费，同时分配的额度也可能会按比例减少。别担心，下一个周期将恢复为完整额度。
产品概述
操作指南
实践教程
  • 编码使用实践
服务支持
开发参考
常见问题 - Qoder CN