FAQ

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

If "Qoder CN is starting" appears when using Qoder CN, follow these steps to troubleshoot.

1. Check your version and environment:

   • Upgrade Qoder CN to the latest version. Verify your OS and architecture are supported.

   • If you are using a JetBrains IDE, ensure it has sufficient heap memory. To clear the cache, select File -> Invalidate Caches, then restart the IDE.

2. Check network connection and proxy settings:

   • Verify these endpoints are accessible. If blocked, ask IT to whitelist them:

     • Run the command:

       curl https://lingma-api.tongyi.aliyun.com/algo/api/v1/ping

       The expected response is pong.

     • Run the command:

       curl -I https://qoder.console.aliyun.com

       The expected status code is 302.

   • If your firewall blocks these endpoints, configure a proxy manually (get the address from IT):

     Proxy format: http(s)://username:password@proxy-server-address:port

     • If the proxy settings do not take effect, modify the configuration file manually:

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

       After modifying the http_proxy field, terminate the Qoder CN process and restart it.

   • Clear the DNS cache:

     • On Windows, run the command ipconfig /flushdns.

     • On macOS, run the command sudo killall -HUP mDNSResponder.

3. Clear the local cache and restart with administrator privileges. Open a non-empty project, then:

   1. Terminate the Qoder CN process.

   2. Delete the .lingma directory:

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

      2. macOS path: ~/.lingma

   3. After completing these steps, restart the IDE.

4. If unresolved, start the service manually:

   Navigate to the directory: .lingma/bin/x.x.x/[CPU_Architecture]_64_[OS]/

   Run the command:

   Lingma.exe start

   After the service starts successfully, click the logon button again.

5. Resolve the "incompatible program" issue: If Windows shows an "incompatible program" prompt, this may indicate 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, ensuring the path ends with an empty folder.

   • Restart the IDE and try again.

   Note

   Note: Some corporate networks may lock binary programs, preventing them from running.

6. Firewall or security software restrictions: If the Qoder CN process still fails to start or logon is unresponsive, your firewall or security software may be blocking it:

   • Add to firewall whitelist:

     Go to Control Panel -> System and Security -> Windows Defender Firewall -> Allow an app through firewall, and add Qoder CN to the whitelist.

   • Add the process file to your corporate security software's whitelist:

     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 is version 2.1.4 or later, you can switch to stdio mode as shown in the following figure:

2. Logon failure or "no permission" error

Clicking the logon button opens a browser for Alibaba Cloud authentication. If logon fails or shows "no permission", check the following:

• Logon parameters may have expired. Wait a moment and click the logon button in the IDE client to try again.

• Your network environment may require a proxy to access the internet. Upgrade Qoder CN to the latest version and verify that the following hosts are accessible. If unreachable, add them to your whitelist. Network proxy configuration.

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

• After configuration, terminate the Qoder CN process in your task manager, then return to the IDE and log on again.

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

For remote development in VS Code or JetBrains IDEs, log in with your Alibaba Cloud account's AccessKey ID/AccessKey Secret to use Qoder CN. Installation and logon.

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

Yes. You can log in with the AccessKey ID/AccessKey Secret of your Alibaba Cloud account. See Installation and logon.

5. Excessive CPU or memory usage

• Scenario 1: Code indexing may cause high CPU or memory usage if your project contains many files. Create a .tongyiignore file in the project root to exclude directories or files from indexing. The .tongyiignore file uses .gitignore format. After modifying it, terminate the Qoder CN process to apply changes.

• 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 error: "Extension host terminated unexpectedly"

This error message appears as "extension host terminated unexpectedly 3 times within the last 5 minutes."

Cause: Typically a memory leak in an extension. Use the extension bisect method to confirm whether the Qoder CN extension is the cause.

Solution: If you confirm the extension is the cause, try the following:

• Reinstall VS Code and restart your system (recommended).

• Windows users: Disable your security software or add code.exe to the allowlist.

If the problem persists, join DingTalk group 53770000738 and provide the following information:

1. Your operating system version and VS Code version.

2. Collecting verbose logs:

   1. Completely exit VS Code.

   2. Run code --verbose in the command line to start VS Code.

   3. Perform the action that causes the crash.

   4. Check the output logs. The first few lines will often provide the initial cause of the crash, helping technicians locate the issue in the extension's 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)

3. If the logs do not confirm an issue in the extension's code, collect more detailed crash logs per Native-Crash-Issues:

   1. Completely exit VS Code.

   2. Run code --crash-reporter-directory <absolute path> in the command line.

   3. Perform the action that causes the crash.

   4. Look for a file with a .dmp suffix in the directory from Step 2 and send it to the technical team.

7. Error on the VS Code extension profile page

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 one of the following solutions.

• Method 1: Launch VS Code with the --no-sandbox command-line flag:

  $ code --no-sandbox

• Method 2: Close VS Code, and then, in the terminal, try running: killall code

8. In JetBrains IDEs, after the installation of Qoder CN is complete, what should I do if the sidebar does not display the Qoder CN button?

Generally, after installation, the Qoder CN assistant button is displayed in the IDE sidebar by default. If the button does not appear, you can select view > Tool Windows > Qoder CN ( View > Tool Windows > Qoder CN ) to manually display it.

9. Startup failure: "File path not found" error

If Qoder CN fails to start and reports an error that the file path does not exist or cannot be found, follow these steps to resolve the issue:

1. Press Ctrl+Shift+P (or Cmd+Shift+P on macOS) in the editor to open the Command Palette, then search for and open User Settings (Open User Settings (JSON)).

2. In the settings.json file, find the configuration item: Lingma.LocalMachineStoragePath.

3. If it exists:

   1. Verify that the path exists and is accessible. If not, correct it to a valid path; or

   2. Delete the configuration item directly.

4. After saving the configuration, restart or reload the window, then start Qoder CN again to confirm that it works correctly.

10. "No permission" error after enterprise plan upgrade

If you receive a "no permission" error after upgrading to the Enterprise Exclusive Plan, log in again to resolve the issue.

11. Logon failure due to special characters in storage path

If the custom storage path contains spaces or other special characters, Qoder CN may fail to start or log on properly.

• Recommended solution: 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.

1. IDE stuck on "Qoder CN is starting up"

If "Qoder CN is starting up" appears while using Qoder CN IDE, follow these steps.

1. Check your version and environment:

   • Ensure you have upgraded Qoder CN IDE to the latest version and that your operating system and architecture are supported.

   • Qoder CN IDE takes some time to start up (about 5 seconds in a local environment, longer in a remote environment depending on network speed). If it does not start normally after one minute, it indicates a service anomaly.

2. Check network connection and proxy settings:

   • Verify this endpoint is accessible. If blocked, ask IT to whitelist it:

     curl https://lingma-api.tongyi.aliyun.com/algo/api/v1/ping

     The expected response is pong.

   • If your firewall blocks this endpoint, configure a proxy manually (get the address from IT):

     Proxy format: http(s)://username:password@proxy-server-address:port

     If the domain settings are not applied, manually modify C:\Users\<username>\AppData\Local\.qodercn\config.json: update the http_proxy field, then terminate and restart the Qoder CN process.

   • Clear the DNS cache:

     • Windows: Run the command ipconfig /flushdns

     • macOS: Run the command sudo killall -HUP mDNSResponder

3. Clear local cache and restart. Try the following:

   1. Terminate the Qoder CN process.

   2. Delete the .qodercn directory:

      • Windows: The path is C:\Users\[Username]\.qodercn

      • macOS: The path is ~/.qodercn

   3. After these steps, restart Qoder CN IDE.

4. If unresolved, start the Qoder CN service manually:

   Go to the directory: .qodercn/bin/x.x.x/CPU_architecture_64_system/

   QoderCN.exe start

   After the service starts successfully, click the logon button again.

   Note

   Note: Some corporate networks may lock binary programs, preventing them from running.

5. Firewall or security software restrictions: If the Qoder CN process still fails to start or logon is unresponsive, your firewall or security software may be blocking it:

   • Add a firewall exception: Go to Control Panel -> System and Security -> Windows Defender Firewall -> Allow an app through firewall, and add Qoder CN.

   • Whitelist the process file in your corporate security software:

     Example path: C:\Users\xxx\.qodercn\bin\2.1.x\x86_64_windows\QoderCN.exe

     (Contact your IT support staff for assistance.)

2. Logon during remote development

When using Qoder CN IDE for remote development, the logon process is the same as local. After an IDE update or on first use, remote resources must be installed on the server, which may take some time.

• If you have used the remote service before but the connection fails, you can delete the .qoder-cn-server service on the remote server, terminate the QoderCN processes, and then try to connect again.

• If the issue persists after performing this cleanup, report the "Remote-SSH" or "Remote-WSL" logs from the "Output" panel for assistance.

3. Excessive CPU or memory usage

• Scenario 1: Code indexing can cause high CPU or memory usage if your project contains many files. Create a .qoderignore file in the project root to exclude directories or files from indexing. The .qoderignore file uses .gitignore format. After modifying it, terminate the Qoder CN process for the changes to take effect.

• Scenario 2: The local offline model may be enabled, which uses about 500 MB of memory. If you do not need it, you can disable offline model completion in the settings.

1. Configure a network proxy

Qoder CN supports HTTP, HTTPS, and SOCKS5 proxies. Configure them on the plugin settings page. Network proxy configuration.

2. Test network connectivity

You can try running the following command in the Terminal. If it returns "pong", you can connect to the Qoder CN server.

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

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 on May 20, 2026 (Beijing time), after which it will automatically convert to the Individual Basic Edition. Billing.

For enterprise customers, we offer the Enterprise Standard Plan and the Enterprise Exclusive Plan. Enterprise billing: Billing.

2. Invoice issuance

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

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

• For the original Tongyi Lingma: You need to use an Alibaba Cloud account and ensure that you have Credits available. In the Qoder CN IDE client's Qoder CN assistant window, click the logon button to complete the Alibaba Cloud login.

• For QoderWork/Qoder CLI and others: Individual or enterprise users need to subscribe and purchase on Alibaba Cloud, ensuring you have a valid order and available Credits in your personal or enterprise account.

If you have not yet registered for an Alibaba Cloud account, please register an account first.

2. Can RAM users use Qoder CN?

If the main account of a RAM user has not subscribed to the Enterprise Standard Plan, the RAM user can use Qoder CN as an individual developer. In the IDE client, click logon, switch to the RAM user logon page, and complete the logon process to start using Qoder CN.

3. How can enterprises try Qoder CN?

To try the enterprise edition, follow the Enterprise Standard Plan Quick Start tutorial.

1. Compatible JetBrains IDE versions

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

2. Compatible Visual Studio Code version

Currently, Visual Studio Code is compatible with versions 1.68.0 and later.

3. Compatible Visual Studio 2022 version

Currently compatible with Visual Studio 2022 versions 17.3.0 and later.

4. Supported operating systems

• Compatible operating systems for JetBrains IDEs: Windows 7 and later, macOS, Linux.

• Compatible operating systems for Visual Studio Code: Windows 7 and later, macOS, Linux.

• Compatible operating systems for Visual Studio 2022: Windows 10 and later.

5. Supported programming languages

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

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 AI Q&A, we only collect chat logs (excluding code) when you provide feedback (thumbs up/down). This data is anonymized and de-identified before being used for algorithm upgrades and iterations.

Our commitments are documented in the Qoder CN Privacy Policy.

2. What training data does Qoder CN use?

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. Sharing of code snippets

No. Your code is never shared. While we use your code context to generate suggestions, the context information is not stored or used for any other purpose. This data is entirely owned and controlled by you.

4. Can Qoder CN generated code be used directly?

Code generated by Qoder CN is a suggestion only. Review all generated code before adopting it.

1. Data limit per page query

We recommend a page size of no more than 10,000 entries. Adjust this limit based on your application's needs and system performance.

2. API data update frequency

API data updates begin at midnight daily, occurring every 15 minutes. The complete dataset from the previous day is available by 2 a.m.

3. API usage frequency requirements

To ensure stable and efficient service, the API enforces a rate limit of 100 QPS.

4. Getting the Organization ID

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

1. The Teams subscription plan

Our Teams subscription plan offers the following features for organizations and is continuously evolving:

• Centralized payment of organization bills

• Centralized Admin Console, supporting mandatory management of member access rights, data privacy modes, etc.

• Support for account domain restrictions and access control for non-domain accounts

• Support for single sign-on (SSO)

2. "Failed to join organization" error

If you encounter a "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.

Contact your IT administrator to purchase more seats. Once seats are available, log in again to be automatically added to the organization.

3. Fewer Credits for a seat

Credits per seat are prorated based on when the seat was purchased. If you join mid-cycle, the allocated Credits are reduced proportionally. The full amount is restored in the next cycle.