常見問題_Qoder CN_智能編碼助手 - Qoder CN 系列

Qoder CN的啟動和登入、支援語言、資料安全、收費和OpenAPI等相關問題，可以在本文找到相關答案。

說明

Qoder CN 系列全新文檔網站現已上線。當前網站的文檔內容可能無法反映產品的最新功能與變化，請訪問 docs.qoder.cn擷取最新產品文檔。

如果在使用的過程中遇到問題，可先嘗試重啟 IDE。重啟後依然無法解決，可加入DingTalk群：53770000738，我們將儘快為您解決問題。

Qoder CN 外掛程式常見問題（JetBrains / VS Code）

說明

Qoder CN 外掛程式中的相關進程仍為 Lingma，相關路徑和進程名以 .lingma / Lingma.exe 為準。

1. 提示"Qoder CN啟動中"怎麼辦？

如果在使用Qoder CN時看到"Qoder CN啟動中"的提示，您可以按照以下步驟逐一排查並解決問題。

檢查版本與運行環境：
- 確保您已將Qoder CN升級至最新版本，並確認您的作業系統和系統架構支援Qoder CN運行。
- 如果您使用的是 Jetbrains IDE，請進行以下檢查：保證 IDE 的堆記憶體大小足夠。操作步驟：依次點擊 File -> Invalidate Caches，清理緩衝後重啟 IDE。
網路連接與代理配置：
- 確保以下地址可以正常訪問。如果無法訪問，請聯絡公司 IT 部門將其加入白名單：
  - 執行命令：
```
curl https://lingma.alibabacloud.com/algo/api/v1/ping
```
    傳回值應為 pong。
- 如果公司防火牆限制且無法加白名單，需手動設定Proxy 位址（具體地址請聯絡公司 IT 提供）：
  
  代理格式：http(s)://使用者名稱:密碼@Proxy 伺服器地址:連接埠
  - 如果網域名稱儲存未生效，可手動修改設定檔：
    
    路徑：C:\Users\使用者名稱\AppData\Local\.lingma\config.json
    
    修改 http_proxy 欄位後，結束Qoder CN進程並重啟。
- 清理 DNS 緩衝：
  - Windows：執行命令 ipconfig /flushdns
  - macOS：執行命令 sudo killall -HUP mDNSResponder
清理本機快取並重新啟動 IDE。以管理員權限啟動 IDE，開啟一個非空專案檔夾後，嘗試以下操作：
1. 結束 Qoder CN 進程。
2. 刪除 .lingma 目錄：
  1. Windows：路徑為 C:\使用者\[使用者名稱]\.lingma
  2. macOS：路徑為 ~/.lingma
3. 完成上述操作後，重新啟動 IDE。
手動啟動 Qoder CN 服務。如果問題仍未解決，可嘗試手動啟動 Qoder CN 服務：

進入目錄：.lingma/bin/x.x.x/CPU架構_64_系統/

執行命令：
```
Lingma.exe start
```
等待啟動成功後，重新點擊登入按鈕。
解決"不相容的程式"問題：如果在 Windows 上收到"不相容的程式"提示，可能是由於解壓不完整導致的。解決方案如下：
- 點擊右下角的Qoder CN表徵圖，選擇 進階設定。
- 修改解壓路徑為非 C 盤的其他路徑，並確保路徑以空檔案夾結尾。
- 重啟 IDE 後重試。
說明
注意：部分公司內網會對二進位程式進行加鎖，導致無法運行。
防火牆或安全軟體限制：如果 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.alibabacloud.com/algo/api/v1/ping

配置完成後從進程管理器裡找到 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進行加白。

如果問題依舊存在，請加入DingTalk群：53770000738，並提供以下資訊：

作業系統版本和 VS Code 版本。

收集 verbose 日誌：

完全退出 VS Code。
命令列中執行code --verbose啟動 VS Code。
執行導致崩潰的操作。

檢查輸出的日誌，類似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)

若上述日誌無法確認是外掛程式裡的代碼引起，需參考 Native-Crash-Issues 收集更詳細的崩潰日誌：
1. 完全退出 VS Code。
2. 命令列中執行 code --crash-reporter-directory <絕對路徑>。
3. 執行會導致崩潰的操作。
4. 尋找第二步的目錄下是否有一個.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. 在 JetBrains IDEs 中安裝Qoder CN完成後，側邊欄不顯示`Qoder CN`按鈕怎麼辦？

一般來說，安裝完成後，Qoder CN助手按鈕會預設顯示到 IDE 側邊欄。如遇到不顯示的情況，您可選擇view > Tool Windows > Qoder CN（視圖 > 工具視窗 > Qoder CN ）手動顯示。

9. 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 啟動失敗並報錯提示檔案路徑不存在/找不到時，可按以下步驟排查並修複：

在編輯器中使用 Ctrl/Cmd + Shift + P 開啟命令選擇區，搜尋並進入 User Settings（Open User Settings (JSON)）。
在開啟的 settings.json 中尋找是否存在配置項：Lingma.LocalMachineStoragePath。
若存在：
1. 檢查該配置項對應的路徑是否真實存在且可訪問，並按需修正為有效路徑；或
2. 直接刪除該配置項。
儲存配置後，重啟/重新載入視窗，再次啟動 Qoder CN，確認是否恢複正常。

10. 企業專屬版升級之後提示暫無使用許可權

企業專屬版升級後提示暫無使用許可權時，請重新登入帳號即可恢複正常。

11. 因自訂儲存路徑包含空格等特殊字元導致無法登入

當自訂儲存路徑中包含空格或其他特殊字元時，可能導致 Qoder CN 無法正常啟動或登入。

推薦方案：升級至最新版本，新版已修複此問題。
臨時方案：修改自訂儲存路徑為不含特殊字元的路徑，然後重新啟動 JetBrains IDE。

Qoder CN IDE 常見問題

1. 提示"Qoder CN啟動中"怎麼辦？

如果在使用 Qoder CN IDE 時看到"Qoder CN啟動中"的提示，您可以按照以下步驟逐一排查並解決問題。

檢查版本與運行環境：
- 確保您已將 Qoder CN IDE 升級至最新版本，並確認您的作業系統和系統架構支援運行。
- Qoder CN IDE 存在一定的啟動時間（本地環境 5s 左右，Remote 遠程環境受網速影響），如果靜待一分鐘後仍未正常啟動，則表示服務異常。
網路連接與代理配置：
- 確保以下地址可以正常訪問。如果無法訪問，請聯絡公司 IT 部門將其加入白名單：
```
curl https://lingma.alibabacloud.com/algo/api/v1/ping
```
  傳回值應為 pong。
- 如果公司防火牆限制且無法加白名單，需手動設定Proxy 位址（具體地址請聯絡公司 IT 提供）：
  
  代理格式：http(s)://使用者名稱:密碼@Proxy 伺服器地址:連接埠
  
  如果網域名稱儲存未生效，可手動修改設定檔：路徑為 C:\Users\使用者名稱\AppData\Local\.qodercn\config.json，修改 http_proxy 欄位後，結束 Qoder CN 進程並重啟。
- 清理 DNS 緩衝：
  - Windows：執行命令 ipconfig /flushdns
  - macOS：執行命令 sudo killall -HUP mDNSResponder
清理本機快取並重新啟動。嘗試以下操作：
1. 結束 Qoder CN 進程。
2. 刪除 .qodercn 目錄：
  - Windows：路徑為 C:\使用者\[使用者名稱]\.qodercn
  - macOS：路徑為 ~/.qodercn
3. 完成上述操作後，重新啟動 Qoder CN IDE。
手動啟動 Qoder CN 服務。如果問題仍未解決，可嘗試手動啟動：

進入目錄：.qodercn/bin/x.x.x/CPU架構_64_系統/
```
QoderCN.exe start
```
等待啟動成功後，重新點擊登入按鈕。

說明
注意：部分公司內網會對二進位程式進行加鎖，導致無法運行。
防火牆或安全軟體限制：如果 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.alibabacloud.com/algo/api/v1/ping

3. 遇到網路問題如何排查？

為了更好地協助你解決問題，請按照以下步驟操作並提供相關資訊：

請進入"Qoder CN 設定" > "網路" > 運行診斷，並將完整的診斷結果發送給我們。
你當前是否正在使用 VPN、代理或商業網路？如果是，請嘗試關閉這些服務或將網路切換至其他串連。
嘗試在聊天介面中選擇不同分級的模型，觀察響應速度是否有改善。
如果以上操作後問題仍然存在，請進一步提供以下資訊以便我們深入調查：
- 發生延遲的具體樣本提示及對應的時間戳記；
- 開啟"協助">"切換開發人員工具"> 查看控制台錯誤記錄檔並截圖發送；
- 此問題是在所有專案中都出現，還是僅限於某個特定的工作區？
- 此問題在相同網路下的其他使用者是否能複現？
以上資訊通過"問題上報"功能進行反饋。

關於收費

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額度。

如果您還未註冊阿里雲帳號，請首先完成帳號註冊。

關於支援的 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會儲存My Code資料嗎？

我們不會儲存您的代碼資料：

代碼補全時，我們需要擷取您的代碼上下文資訊以完成補全，但上下文資訊不會被儲存或用於其他任何目的，該等資料完全由您所有及控制。
研發智能問答時，我們僅會在您點踩/點贊後，僅針對聊天記錄（不包含代碼），並將資料進行脫敏、去標識化處理後，用於演算法的升級、迭代。

更多隱私政策，可前往Qoder CN隱私政策。

2. Qoder CN的訓練資料包含哪些？

訓練資料主要包含優質開原始碼、技術社區文章和技術文檔、阿里雲的雲端服務文檔、阿里雲 SDK/API 使用文檔等。

3. My Code片段會與其他使用者共用嗎？

不會。使用大模型進行代碼補全時，我們需要擷取您的代碼上下文資訊以完成補全，但上下文資訊不會被儲存或用於其他任何目的，該等資料完全由您所有及控制。

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 外掛程式常見問題（JetBrains / VS Code）

1. 提示"Qoder CN啟動中"怎麼辦？

2. 顯示登入失敗、無許可權怎麼辦？

3. Remote SSH、WSL 等進行遠程開發時，如何登入Qoder CN？

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

5. 如果發現 Qoder CN 進程佔用 CPU 或記憶體過高怎麼辦？

6. VS Code 提示延伸主機意外終止

7. VS Code外掛程式中的個人中心頁面報錯怎麼辦？

8. 在 JetBrains IDEs 中安裝Qoder CN完成後，側邊欄不顯示Qoder CN按鈕怎麼辦？

9. Qoder CN 啟動失敗，提示"檔案路徑找不到"怎麼辦？

10. 企業專屬版升級之後提示暫無使用許可權

11. 因自訂儲存路徑包含空格等特殊字元導致無法登入

Qoder CN IDE 常見問題

1. 提示"Qoder CN啟動中"怎麼辦？

2. Remote SSH、WSL 等進行遠程開發時，如何登入 Qoder CN？

3. 如果發現 Qoder CN 進程佔用 CPU 或記憶體過高怎麼辦？

關於網路問題

1. 如何配置網路代理程式？

2. 如何測試網路連通性？

3. 遇到網路問題如何排查？

關於收費

1. Qoder CN如何收費？

2. Qoder CN 可以開具發票嗎？

關於帳號

1. 使用什麼帳號進行登入並使用Qoder CN？

關於支援的 IDE、系統、語言

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

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

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

4. 支援作業系統版本有哪些？

5. 支援哪些程式設計語言？

關於資料安全和品質

1. Qoder CN會儲存My Code資料嗎？

2. Qoder CN的訓練資料包含哪些？

3. My Code片段會與其他使用者共用嗎？

4. Qoder CN產生的程式碼可以直接使用嗎？

OpenAPI相關問題

1. 每頁查詢的資料量是否有上限？

2. API的資料在每天淩晨更新，更新頻率是什嗎？

3. API使用頻率有沒有要求？

4. organizationId 擷取方式

QoderWork/Qoder CLI使用相關問題

1. 什麼是 Teams 訂用計畫？

2. 為什麼我嘗試登入時會收到"加入組織失敗"的錯誤提示？

3. 我席位的 Credits 額度為什麼比別人少？

8. 在 JetBrains IDEs 中安裝Qoder CN完成後，側邊欄不顯示`Qoder CN`按鈕怎麼辦？