跳转到主要内容
本常见问题解答覆盖与 Qoder 相关的常见疑问，包括安装、登录、支持的平台、语言兼容性、数据安全、计费、网络问题与故障排查。 如果遇到问题，请先尝试重启 Qoder。若仍未解决，请通过 contact@qoder.com 联系我们，我们的支持团队将尽快协助你。

​
快速入门

​
如果 Qoder 一直停在“Qoder starting”，我该怎么办？

请尝试以下步骤：
  1. 检查你的环境。 a. 确保 Qoder 已更新到最新版本。 b. 确认你的操作系统和系统架构支持 Qoder。
  2. 测试网络连接。
a. 在终端运行以下命令以检查连通性。如果收到 pong，表示网络已连接。否则，请检查防火墙，或请你的 IT 管理员将以下域名加入白名单。 
curl https://{hosts}/algo/api/v1/ping 

// 您可以将 {hosts} 替换为以下任一选项：
1. api1.qoder.sh
2. api2.qoder.sh
3. api3.qoder.sh
b. 如需使用代理，请按以下格式设置代理地址： 
http(s)://用户名:密码@代理服务器地址:端口
c. 清理 DNS 缓存：
  • Windows：ipconfig /flushdns。
  • macOS：sudo killall -HUP mDNSResponder。
  1. 清理本地缓存。 a. 结束 Qoder 进程。 b. 删除 .Qoder 目录：
  • Windows：
    • C:\Users\[username]\.Qoder
    • C:\Users\Username\AppData\Local\Programs\Qoder\
Windows: 
C:\Users\[username]\.Qoder
C:\Users\Username\AppData\Local\Programs\Qoder\

macOS: 
/Applications/Qoder.app
c. 重启 Qoder。
  1. 如果问题仍然存在，手动启动： a. 前往目录：.Qoder/bin/x.x.x/CPU_architecture_64_system/ 
    Windows：C:\Users\Username\AppData\Local\Programs\Qoder\resources\app\resources\bin$version`CPU_architecture_64_system`\Qoder.exe

Mac：/Applications/Qoder.app/Contents/Resources/app/resources\bin$versionCPU_ahicture_64_system\Qoder
    b. 运行： 
    Qoder.exe start 或 Qoder start
    c. 再次尝试登录。
  2. （可选）排查安全相关问题 a. 如果你看到“不兼容的程序”消息或 Qoder 无法启动： i. 点击右下角的 Qoder 图标，选择高级设置。 ii. 将解压路径移动到非 C 盘的文件夹（公司可能限制对 C 盘的读写权限），并确保该路径以一个空文件夹结尾。 iii. 重启 Qoder。 b. 将 Qoder 添加到防火墙/安全软件的允许列表： i. 控制面板 > 系统和安全 > Windows Defender 防火墙 > 允许的应用。 ii. 公司安全软件也可能要求你放行： 
Windows：
C:\Users\Username\AppData\Local\Programs\Qoder\resources\app\resources\bin\$version\CPU_architecture_64_system\Qoder.exe
C:\Users\Username\.qoder\bin\qoder.exe

Mac：
/Applications/Qoder.app/Contents/Resources/app/resources\bin\$version\CPU_architecture_64_system\Qoder


## 登录和权限

### 如果登录失败或看到权限被拒绝错误怎么办？

- 过期的登录会话需要您重新尝试。
- 确保您的网络允许访问下面列出的域名，并配置代理（如果需要）。详情请参阅 [配置网络代理](https://docs.qoder.com/user-guide/configure-network-proxy)。

```plaintext
api1.qoder.sh
api2.qoder.sh
api3.qoder.sh
  • 更改设置后，请完全退出 Qoder 并重新启动。

​
代理与连接

  • Qoder 支持 HTTP、HTTPS 和 SOCKS5 代理。请在 Qoder 的设置中进行配置。更多详情参见配置网络代理。
  • 要测试连接，请运行：
curl https://{hosts}/algo/api/v1/ping 

//您可以将 {hosts} 替换为以下任一选项：
1. api1.qoder.sh
2. api2.qoder.sh
3. api3.qoder.sh
如果返回 pong，说明你的网络已连接到 Qoder 服务器。

​
帐户管理

​
我的账户被暂停了。如何重新激活？

如果你的账户因创建过多免费试用账户而被暂停，你可以按照以下步骤重新激活：
  1. 登录 Qoder 官网，点击右上角头像，进入 Settings > Usage。
  2. 在 Usage 页面顶部找到暂停通知横幅，点击 Reactivate Account。
  3. 确认政策提示： 为防止滥用，我们的政策仅允许你的首个账户享受免费 Pro 试用。重新激活将放弃此账户剩余的 Credits（将被清零）。确认后，此账户将自动重新激活并恢复正常使用。

​
如何计费？

Qoder 提供灵活的定价以满足多样化需求。新用户可享受为期 2 周的 Pro 试用，期间可完整使用所有 Pro 专属功能。 试用结束后，您有以下选项：
  • 升级至 Pro 方案，$20/月
  • 升级至 Pro+ 方案，$60/月，获得更高的 Credits 配额
  • 不进行任何操作，将自动降级至我们的免费方案
在 Qoder 中的使用以 Credits 计量。每个付费方案都包含特定数量的 Credits ，便于您选择最符合需求的方案。了解更多详情，请访问我们的 Pricing 页面。 请注意，除非另有说明，所有显示的价格均不含适用税费（如增值税或销售税）。最终税额取决于多种因素，包括但不限于您的账单地址或税务登记号。 为确保所有用户都能获得公平的试用体验，Pro 试用每位用户仅限一个账户。任何额外创建的试用账户将被停用。

​
专业版试用如何运作？

当新用户首次登录 Qoder IDE（需使用最新版本；不支持在虚拟机上运行）时，将获得一次性的免费 2 周（14 天）专业版试用。试用包含 1,000 Credits 以及对专业版专属功能的完整访问权限。试用到期后，你的账户将自动降级为免费方案，任何未使用的试用 Credits 将被清空。 如果你在试用结束前升级为付费方案，剩余的试用 Credits 将自动转换为一个 Credit Pack，并以原有的到期日期保留在你的账户中。这样可确保你不会因提前升级而损失未使用的 Credits 。 为确保公平的试用体验，每位用户的专业版试用仅限一个账户。任何额外创建的试用账户将被停用。

​
试用期结束后会怎样？

当试用期结束时，你有以下选择：
  • 升级到付费方案：选择最符合你需求的订阅，解锁更多资源。
  • 切换到免费方案：你随时可以使用我们的免费方案，适合轻量使用场景。

​
试用期间如果我的 Credits 用完了会怎样？

你可以随时升级到 Pro 或 Pro+ 方案以获取更多 Credits 。如果你选择继续使用 Free 方案，也不用担心——我们会让你在基础模型上继续使用，但会有每日限额。 当使用基础模型时，将会有以下变化：
  • 你将切换到基础模型：你仍可继续使用我们的服务，但会有每日使用限额。
  • 性能可能会有所变化：基础模型在处理复杂任务时不如更高阶的模型强大。
  • 你可能会注意到 Agent 模式和 Quest 模式等功能的性能差异，尤其是在图像对话质量和整体效果方面。

​
支持的平台

  • macOS：11.0 及更高版本
  • Windows：10/11

​
支持的编程语言

Qoder 支持所有主流语言，并在以下语言上提供增强体验：
  • JavaScript、TypeScript、Python、Go、C/C++、C# 和 Java

​
数据安全

​
Qoder 会存储我的代码吗？

  • Qoder 不会存储或分享你的代码。在代码补全过程中会用到你的代码上下文，但这些内容不会被存储，也不会用于其他用途。
  • 仅当你明确提交反馈（例如点赞/点踩）时，聊天记录（不包含实际代码）才可能被匿名化，用于算法改进。
详情参见 隐私政策。

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

不会。系统不会将你的代码片段与其他用户共享。在使用大语言模型进行代码补全时，我们需要获取你的代码信息来完成补全，但这些上下文信息不会被存储，也不会用于任何其他用途。

​
我可以直接使用 Qoder 生成的代码吗？

Qoder 生成的代码仅作参考，无法保证其可用性。开发者应自行审查并决定是否采用。

​
疑难排查与常见问题

​
如果我在 Quest Mode 和 Repo Wiki 中遇到“System Error”，该怎么办？

请更新至 Qoder v0.2.1 或更高版本。旧版本不支持这些功能。

​
CPU 或内存占用过高

  • 大型项目在进行代码索引时可能会占用大量资源。
  • 将不需要索引的文件模式或目录添加到项目根目录的 .qoderignore（类似于 .gitignore）。
  • 编辑 .qoderignore 后，请重启 Qoder。

​
Qoder 扩展宿主崩溃

错误：“extension host terminated unexpectedly 3 times within the last 5 minutes”
  • 可能由内存泄漏引起。
  • 使用 extension bisect 确认是否由 Qoder 导致问题。
  • 尝试重新安装 Qoder 并重启。
  • 在 Windows 上，确保安全软件未拦截或阻止 Qoder。
如果问题仍然存在，请发送邮件至 contact@qoder.com。
  • 操作系统及 Qoder 版本
  • 复现步骤
  • Qoder 详细日志（运行 qoder --verbose）
  • 如需崩溃转储：运行 qoder --crash-reporter-directory <directory>，复现错误，并将生成的 .dmp 文件发送给我们。

​
支持

如需更多帮助，请通过 contact@qoder.com 与我们联系。
⌘I