Skip to main content
Support

FAQ

Find answers to common questions about Qoder CN, including startup and logon, supported languages, data security, billing, and OpenAPI.
If you encounter an issue while using the product, first try restarting the IDE. If restarting does not resolve the issue, join DingTalk group 53770000738 and we will help you as soon as possible.

Qoder CN plugin FAQ (JetBrains / VS Code)

Some processes in the Qoder CN plugin are still named Lingma. Related paths and process names use .lingma / Lingma.exe.

1. What to do if "Qoder CN is starting" appears?

If you see the prompt "Qoder CN is starting" while using Qoder CN, follow these steps to troubleshoot and resolve the issue.
  1. Check your version and environment:
  • Ensure that Qoder CN is upgraded to the latest version and that your operating system and system architecture support running Qoder CN.
  • If you are using a JetBrains IDE, do the following: ensure the IDE has sufficient heap memory. Steps: click File -> Invalidate Caches, clear the cache, and restart the IDE.
  1. Network connection and proxy configuration:
  • Ensure the following addresses can be accessed. If they cannot, ask your IT department to add them to the allowlist:
    • Run the command: 
      curl https://lingma-api.tongyi.aliyun.com/algo/api/v1/ping
      The expected return value is pong.
    • Run the command: 
      curl -I https://qoder.console.aliyun.com
      The expected status code is 302.
  • If the corporate firewall blocks these endpoints and cannot be added to the allowlist, manually configure a proxy (obtain the address from your IT team): Proxy format: http(s)://username:password@proxy-server-address:port
    • If the domain settings are not applied, manually modify the configuration file: Path: C:\Users\Username\AppData\Local.lingma\config.json. After modifying the http_proxy field, terminate the Qoder CN process and restart it.
  • Clear the DNS cache:
    • Windows: run the command ipconfig /flushdns
    • macOS: run the command sudo killall -HUP mDNSResponder
  1. Clear the local cache and restart the IDE. Start the IDE as an administrator, open a non-empty project folder, and then:
  2. Terminate the Qoder CN process.
  3. Delete the .lingma directory:
  4. Windows: the path is C:\Users[Username].lingma
  5. macOS: the path is ~/.lingma
  6. After the steps above, restart the IDE.
  7. Start the Qoder CN service manually. If the issue persists, try starting the Qoder CN service manually: Go to the directory: .lingma/bin/x.x.x/CPU_architecture_64_OS/, and run: 
    Lingma.exe start
    Wait for the service to start successfully, then click the logon button again.
  8. Resolve the "incompatible program" issue: If Windows shows an "incompatible program" prompt, this may be caused by incomplete extraction. To fix this:
  • Click the Qoder CN icon in the bottom-right corner and select Advanced Settings.
  • Change the extraction path to a location outside the C drive, and ensure the path ends with an empty folder.
  • Restart the IDE and try again.
Note: Some corporate networks may lock binary programs, preventing them from running.
  1. Firewall or security software restrictions: If the Qoder CN process still fails to start or logon is unresponsive, the firewall or corporate security software may be blocking it. Do the following:
  • Add to the firewall allowlist: Open Control Panel -> System and Security -> Windows Defender Firewall -> Allowed apps, and add Qoder CN to the allowlist.
  • Add the process file to your corporate security software's allowlist: Example path: C:\Users\xxx.lingma\bin\2.1.x\x86_64_windows\lingma.exe (Contact your IT support staff for assistance.)
  • If your Qoder CN JetBrains plugin version is 2.1.4 or later, in the Tongyi Lingma plugin's Advanced Settings, set Communication Connection Type to stdio (the other option is websocket).

2. What to do if logon fails or shows "no permission"?

When you click the logon button in the IDE client, it opens a browser to sign in to Alibaba Cloud. If logon fails or shows "no permission", there are two possible causes:
  • When the logon parameters have expired, logon may fail. Wait a moment and click the logon button in the IDE client to try again.
  • If your network environment requires a proxy to access the internet, logon may fail or show "no permission". Upgrade Qoder CN to the latest version and ensure the following hosts are accessible; if the network is unreachable, add them to the allowlist. Refer to Network proxy configuration to resolve the issue.
curl https://lingma-api.tongyi.aliyun.com/algo/api/v1/ping
curl -I https://qoder.console.aliyun.com
  • After configuration, find the Qoder CN process in the task manager, terminate it, then return to the IDE and log on again.

3. When using Remote SSH, WSL, or other remote development tools, how do I log on to Qoder CN?

When connecting to a remote server for development in VS Code or JetBrains IDEs, you can log on with your Alibaba Cloud account's AK/SK and then use Qoder CN. For details, see: Installation and logon.

4. Can Qoder CN be used in the Web IDE?

Yes. You can log on with your Alibaba Cloud account's AK/SK, see Installation and logon.

5. What to do if the Qoder CN process uses excessive CPU or memory?

  • Scenario 1: This may be caused by many files in your code project, leading to high CPU or memory usage during code indexing. You can create a .tongyiignore file in the project root to exclude directories or files you do not want to index, thereby reducing CPU or memory usage during indexing. The .tongyiignore file uses the same format as .gitignore; after modifying .tongyiignore, manually terminate the Qoder CN process for the changes to take effect.
  • Scenario 2: The local offline model may be enabled, which consumes about 500 MB of memory. If you do not need the offline model, you can disable offline model completion in the settings.

6. VS Code shows "Extension host terminated unexpectedly"

If you see the error message: "extension host terminated unexpectedly 3 times within the last 5 minutes." Cause: This is typically caused by a memory leak in a plugin. You can first use the extension bisect method to confirm whether the crash is caused by the Qoder CN plugin. Solution: If the plugin is confirmed to be the cause, try the following:
  • Reinstall VS Code and restart the system (recommended).
  • Windows users: Disable your security software or allowlist code.exe.
If the problem persists, join DingTalk group 53770000738 and provide the following information:
  1. Operating system version and VS Code version.
  2. Collect verbose logs:
  3. Fully exit VS Code.
  4. In the command line, run code --verbose to start VS Code.
  5. Perform the action that causes the crash.
  6. Check the output logs; lines 2 and 3 will typically give the initial cause of the crash, allowing technicians to locate the issue in the plugin code more quickly. For example: 
    [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. If the logs above do not confirm that the issue is in the plugin code, collect more detailed crash logs per Native-Crash-Issues:
  8. Fully exit VS Code.
  9. In the command line, run code --crash-reporter-directory <absolute path>.
  10. Perform the action that causes the crash.
  11. Look for a file with a .dmp suffix in the directory from step 2 and send it to the technical team.

7. What to do if the personal center page in the VS Code plugin shows an error?

If you see the error message: "Error loading webview: Error: Could not register service worker: InvalidStateError: Failed to register a ServiceWorker: The document is in an invalid state." This is a known issue in VS Code 1.56 that occurs when some Windows users run VS Code as an administrator. Try the following methods to resolve it.
  • Method 1: Start VS Code with the --no-sandbox command-line flag: 
    $ code --no-sandbox
  • Method 2: Close VS Code, then try running in the terminal: killall code

8. Qoder CN fails to start with the "file path not found" error

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
When Qoder CN fails to start and reports that the file path does not exist or cannot be found, follow these steps to troubleshoot and resolve the issue:
  1. In the editor, press Ctrl/Cmd + Shift + P to open the Command Palette, then search for and open User Settings (Open User Settings (JSON)).
  2. In the opened settings.json, check whether the configuration item Lingma.LocalMachineStoragePath exists.
  3. If it exists:
  4. Check whether the path this configuration points to actually exists and is accessible, and correct it to a valid path as needed; or
  5. Delete the configuration item directly.
  6. After saving the configuration, restart or reload the window, then start Qoder CN again to confirm it works normally.

9. Enterprise Dedicated Edition prompts "no usage permission" after upgrade

If Enterprise Dedicated Edition prompts "no usage permission" after upgrade, log in again to restore normal use.

10. Custom storage path with spaces or special characters causes logon failure

When the custom storage path contains spaces or other special characters, Qoder CN may fail to start or log on properly.
  • Recommended: Upgrade to the latest version, which has fixed this issue.
  • Workaround: Change the custom storage path to one that does not contain special characters, then restart the JetBrains IDE.

Qoder CN IDE FAQ

1. What to do if "Qoder CN is starting" appears?

If you see the prompt "Qoder CN is starting" while using Qoder CN IDE, follow these steps to troubleshoot and resolve the issue.
  1. Check your version and environment:
  • Ensure that Qoder CN IDE is upgraded to the latest version and confirm that your operating system and system architecture are supported.
  • Qoder CN IDE has a startup time (about 5 seconds in a local environment; remote environments depend on network speed). If it still fails to start after waiting one minute, the service is abnormal.
  1. Network connection and proxy configuration:
  • Ensure the following address can be accessed. If it cannot, ask your IT department to add it to the allowlist: 
    curl https://lingma-api.tongyi.aliyun.com/algo/api/v1/ping
    The expected return value is pong.
  • If the corporate firewall blocks it and cannot be added to the allowlist, manually configure a proxy (obtain the address from your IT team): Proxy format: http(s)://username:password@proxy-server-address:port. If the domain settings are not applied, manually modify the configuration file: the path is C:\Users\Username\AppData\Local.qodercn\config.json. After modifying the http_proxy field, terminate the Qoder CN process and restart it.
  • Clear the DNS cache:
    • Windows: run the command ipconfig /flushdns
    • macOS: run the command sudo killall -HUP mDNSResponder
  1. Clear the local cache and restart. Try the following:
  2. Terminate the Qoder CN process.
  3. Delete the .qodercn directory:
  • Windows: the path is C:\Users[Username].qodercn
  • macOS: the path is ~/.qodercn
  1. After the steps above, restart Qoder CN IDE.
  2. Start the Qoder CN service manually. If the issue persists, try starting it manually: Go to the directory: .qodercn/bin/x.x.x/CPU_architecture_64_OS/ 
    QoderCN.exe start
    Wait for the service to start successfully, then click the logon button again.
    Note: Some corporate networks may lock binary programs, preventing them from running.
  3. Firewall or security software restrictions: If the Qoder CN process still fails to start or logon is unresponsive, the firewall or corporate security software may be blocking it. Do the following:
  • Add to the firewall allowlist: Open Control Panel -> System and Security -> Windows Defender Firewall -> Allowed apps, and add Qoder CN to the allowlist.
  • Add the process file to your corporate security software's allowlist: Example path: C:\Users\xxx.qodercn\bin\2.1.x\x86_64_windows\QoderCN.exe (Contact your IT support staff for assistance.)

2. When using Remote SSH, WSL, or other remote development tools, how do I log on to Qoder CN?

When using Qoder CN IDE to connect to a remote server for development, the logon method is the same as local development. After the IDE is updated or when used for the first time, remote resources need to be installed on the remote server, which takes some time.
  • If you have used remote services before but this connection fails, delete the .qoder-cn-server service on the remote server, terminate the QoderCN processes, and try to connect again.
  • If it still fails after cleanup, report the "Remote-SSH" ("Remote-WSL") logs from the "Output" panel to seek help from developers.

3. What to do if the Qoder CN process uses excessive CPU or memory?

  • Scenario 1: This may be caused by many files in your code project, leading to high CPU or memory usage during code indexing. You can create a .qoderignore file in the project root to exclude directories or files you do not want to index, thereby reducing CPU or memory usage during indexing. The .qoderignore file uses the same format as .gitignore; after modifying .qoderignore, manually terminate the Qoder CN process for the changes to take effect.
  • Scenario 2: The local offline model may be enabled, which consumes about 500 MB of memory. If you do not need the offline model, you can disable offline model completion in the settings.

Network issues

1. How do I configure a network proxy?

Qoder CN supports HTTP, HTTPS, and Socks5 network proxies. You can configure them on the plugin settings page. For details, see: Network proxy configuration.

2. How do I test network connectivity?

You can try running the following commands in the Terminal. If they return pong, you can most likely connect to the Qoder CN server. 
curl https://lingma-api.tongyi.aliyun.com/algo/api/v1/ping
curl -I https://qoder.console.aliyun.com

3. How do I troubleshoot network issues?

To better help you resolve the issue, follow these steps and provide the relevant information:
  1. Go to "Qoder CN Settings" > "Network" > Run diagnostics, and send us the complete diagnostic result.
  2. Are you currently using a VPN, proxy, or corporate network? If so, try disabling these services or switching to a different network connection.
  3. In the chat interface, try selecting models of different tiers to see whether the response speed improves.
  4. If the issue persists after the steps above, provide the following information for further investigation:
  • Specific example prompts that cause delays and their corresponding timestamps;
  • Open "Help" > "Toggle Developer Tools" > view console error logs and send us a screenshot;
  • Does this issue occur in all projects, or only in a specific workspace?
  • Can other users on the same network reproduce this issue?
Submit the above information through the "Report Issue" feature.

Billing

1. How is Qoder CN priced?

For individual developers, we offer the Individual Basic Edition and the Individual Pro Edition. The limited-time free offer for the Individual Pro Edition will end at 18:00:00 (Beijing time) on May 20, 2026, after which it will automatically convert to the Individual Basic Edition. For details, see Billing. For enterprise customers, we offer the Enterprise Standard Edition and the Enterprise Dedicated Edition. For enterprise billing information, see: Billing.

2. Can Qoder CN issue invoices?

Yes. You can submit an invoice request through the Invoice Management page in the Alibaba Cloud console or the Alibaba Cloud app.

Account

1. What account do I use to log on to and use Qoder CN?

  • Original Tongyi Lingma: You need to use an Alibaba Cloud account and ensure that you have Credits available for Qoder CN. In the Qoder CN assistant window in the IDE client, click the logon button to complete the Alibaba Cloud logon.
  • QoderWork / Qoder CLI, etc.: Individual or enterprise users need to activate and purchase on Alibaba Cloud, ensuring that there is a valid order and Credits balance under the personal or enterprise account.
If you have not yet registered for an Alibaba Cloud account, please register first.

2. Can RAM users try Qoder CN?

RAM users can use Qoder CN as an individual developer when their Alibaba Cloud master account has not yet activated the Enterprise Standard Edition. In the IDE client, click the logon button, switch to the RAM user logon page, and after logging on you can try Qoder CN.

3. How do enterprises try Qoder CN?

To try the enterprise version, refer to the Original Lingma Enterprise Standard Edition (for existing customers only) tutorial.

Supported IDEs, operating systems, and languages

1. Which JetBrains IDE versions are supported?

Currently JetBrains IDEs are compatible with 2020.3 (203.x) and later, including IntelliJ IDEA, PyCharm, GoLand, WebStorm, and other JetBrains IDEs.

2. Which Visual Studio Code versions are supported?

Currently Visual Studio Code is compatible with 1.68.0 and later.

3. Which Visual Studio 2022 versions are supported?

Currently compatible with Visual Studio 2022 17.3.0 and later.

4. Which operating system versions are supported?

  • JetBrains IDEs compatible operating systems: Windows 7 and later, macOS, Linux.
  • Visual Studio Code compatible operating systems: Windows 7 and later, macOS, Linux
  • Visual Studio 2022 compatible operating systems: Windows 10 and later

5. Which programming languages are supported?

Qoder CN fully covers mainstream programming languages and performs better in Java, Python, Go, JavaScript, TypeScript, C/C++, and C# coding scenarios.

Data security and quality

1. Does Qoder CN store my code data?

We do not store your code data:
  • For code completion, we need to access your code context to provide suggestions, but the context information is not stored or used for any other purpose. This data is entirely owned and controlled by you.
  • For R&D intelligent Q&A, we only collect chat logs (not including code) when you provide thumbs-up/thumbs-down feedback, and the data is anonymized and de-identified before being used for algorithm upgrades and iterations.
For more privacy details, see the Qoder CN Privacy Policy.

2. What does Qoder CN's training data include?

The training data mainly includes high-quality open-source code, articles and documentation from technical communities, Alibaba Cloud service documentation, and Alibaba Cloud SDK/API usage documents.

3. Are my code snippets shared with other users?

No. When using large models for code completion, we need to access your code context to provide suggestions, but the context information is not stored or used for any other purpose. This data is entirely owned and controlled by you.

4. Can code generated by Qoder CN be used directly?

Code generated by Qoder CN is only suggested code and its usability is not guaranteed. Developers must review the code themselves and decide whether to adopt it.

OpenAPI

1. Is there an upper limit on the data volume per page query?

We recommend no more than 10,000 entries. However, when performing data queries and displays, setting an upper limit on the data volume per page query is crucial for ensuring system performance and optimizing user experience; the specific value should be flexibly adjusted based on the actual application scenario and system capability.

2. API data is updated starting at midnight every day — what is the update frequency?

API data updates begin at midnight daily, occurring every 15 minutes, using a multi-layer verification mechanism to ensure real-time, reliable, and flexible data. Therefore, at 2 a.m., you can retrieve the complete, most up-to-date, and accurate dataset for the previous day.

3. Are there requirements on API usage frequency?

To ensure stable and efficient service, our API rate limit is 100 QPS, meaning a maximum of 100 requests per second.

4. How do I obtain the organizationId?

In the top-right corner of the Qoder CN console, click your avatar, click Admin Console, then on the Basic Information page copy the Organization ID.

QoderWork/Qoder CLI FAQ

1. What is the Teams subscription plan?

Aimed at organizations and teams, we offer the Teams subscription plan, which includes but is not limited to the following features and continues to evolve:
  • Centralized payment of organization bills
  • A centralized Admin Console that supports enforced management of member access permissions, data privacy mode, etc.
  • Support for account domain restrictions and access control for non-domain accounts
  • Support for single sign-on (SSO)

2. Why do I get the "Failed to join organization" error when I try to log on?

If you encounter the "Failed to join organization" error during logon, it means your company's administrator has associated your email domain with a Qoder Teams organization. This setup is designed to automatically add all accounts under that domain to the organization. However, the process failed because the organization has run out of available seats. To resolve this, contact your company's IT administrator and ask them to purchase more seats. Once seats are available, try logging on again. At that point you will be automatically added to the organization and can start using the Teams subscription plan.

3. Why does my seat have fewer Credits than others?

The Credits per seat depend on when the seat was purchased. If you joined mid-cycle, billing is prorated, and the allocated Credits may also be reduced proportionally. Don't worry — the full amount is restored in the next cycle.
Overview
Guides
Tutorials
  • Coding with Qoder CN
Support
Developer Reference