错误代码10061表明客户端无法与Qoder后端服务建立TCP连接，主因是lingma API不可达、代理未配置、DNS异常、qoder-cn进程未运行或IDE缓存损坏；需依次验证API连通性、配置http_proxy、刷新DNS、重启qoder-cn进程并清理IDE缓存。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 Qoder 时遇到“错误代码10061：由于目标计算机积极拒绝”的提示，这表明客户端无法与后端服务建立 TCP 连接。该错误本质是目标服务端口无响应或连接被明确拒绝，常见于 Qoder 所依赖的本地代理服务、API 网关或 lingma 后端服务未就绪。以下是修复此问题的具体操作路径：
一、确认 lingma API 服务可达性
Qoder 依赖 lingma-api.tongyi.aliyun.com 提供核心能力，若该域名解析失败或网络策略拦截，将直接触发 10061。需验证基础连通性是否正常。
1、打开命令提示符（Windows）或终端（macOS），执行：curl https://lingma-api.tongyi.aliyun.com/algo/api/v1/ping。
2、检查返回内容是否为纯文本 pong；若超时、返回空或 HTTP 非 200 状态码，则说明网络链路异常。
3、如公司内网启用防火墙策略，需联系 IT 部门将 lingma-api.tongyi.aliyun.com 加入白名单，并确保 HTTPS（443 端口）出站允许。
二、检查并配置代理设置
当企业网络强制走代理时，Qoder 若未继承系统或 IDE 代理配置，将无法抵达 lingma API，从而被目标服务器拒绝连接。必须显式指定有效代理参数。
1、获取公司 IT 提供的代理地址，格式应为：http://user:pass@proxy.company.com:8080 或 https://user:pass@proxy.company.com:8080。
2、定位配置文件：C:\Users\用户名\AppData\Local\.lingma\config.json（Windows）或 ~/Library/Application Support/.lingma/config.json（macOS）。
3、用文本编辑器打开 config.json，在根对象中添加字段："http_proxy": "http://user:pass@proxy.company.com:8080"，保存文件。
4、结束所有 qoder cn 进程（任务管理器或 killall -9 qoder-cn），重启 IDE 并重新加载项目。
三、清理 DNS 缓存与本地网络状态
DNS 解析异常可能导致域名指向错误 IP 或解析超时，使连接请求发往无效地址，最终被操作系统判定为“目标拒绝”。需强制刷新本地 DNS 映射表。
1、Windows 用户执行：ipconfig /flushdns。
2、macOS 用户执行：sudo killall -hup mDNSResponder。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
3、关闭当前 IDE，以管理员/Root 权限重新启动 IDE，并打开一个非空项目目录。
4、再次触发 Qoder 功能，观察错误是否消失。
四、验证并重启 Qoder 后台进程
Qoder 客户端依赖本地常驻进程（qoder-cn）作为桥接代理。若该进程崩溃、卡死或未拉起，所有请求均无法转发，表现为持续性的 10061 拒绝响应。
1、Windows：打开任务管理器 → “详细信息”选项卡 → 查找进程名 qoder-cn.exe；若存在，右键 → “结束任务”。
2、macOS：执行 ps aux | grep qoder-cn，对查到的 PID 执行 kill -9 PID。
3、删除残留锁文件（可选）：rm -f ~/.lingma/qoder-cn.lock（macOS）或 del "%LOCALAPPDATA%\.lingma\qoder-cn.lock"（Windows）。
4、重启 IDE，等待状态栏显示“qoder cn 已就绪”，再进行代码调用。
五、重置 IDE 缓存并校验运行环境
JetBrains IDE 的缓存损坏可能导致插件初始化失败，使 Qoder 无法正确加载网络模块或读取配置，间接造成连接通道未建立。
1、在 IDE 中依次点击：File → Invalidate Caches and Restart → Invalidate and Restart。
2、重启后，进入 Settings → Plugins → Qoder CN，确认插件状态为“Enabled”且版本号可见。
3、检查 IDE 堆内存是否充足：进入 Help → Change Memory Settings，将堆大小设为不低于 2048 MB。
4、确保操作系统架构（x64/arm64）与 Qoder 插件版本兼容，不支持 32 位 Windows 或已弃用的 JDK 8 以下版本。
