反馈编号:c65ee79b-3843-4807-9a23-f7d76ddcb240
版权声明：本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
Qoder CN 子代理唤起失败，大概率是权限或环境配置卡住了。别慌，按下面三步排查：
检查 API Key 和 Endpoint
去设置里确认你的 Qoder API Key 没过期，且 Endpoint 指向的是国内节点（通常是 api.qoder.cn 或类似域名）。有时候网络波动会导致握手超时，换个 DNS 试试。
查看终端日志
打开 Qoder 的 Output 面板，过滤 error 关键字。如果是 403 Forbidden，说明密钥权限不足；如果是 Connection Refused，可能是本地端口被占用或防火墙拦截。重点看有没有“子进程启动失败”的报错，这通常意味着环境变量缺失。
重启与重装
先彻底杀掉 Qoder 后台进程（任务管理器里找相关进程），再重启 IDE。如果还不行，尝试更新到最新版本，旧版可能不兼容新的子代理协议。
实在搞不定，直接截图报错信息去 GitHub Issues 或官方 Discord 提问，带上你的 OS 版本和 Qoder 版本号，效率最高。别死磕，有时候就是个小配置问题。
官方最新解决方案：https://www.aliyun.com/product/qoder
Qoder CN 是 Qoder CN 系列中面向软件开发场景的核心子产品（原“通义灵码”），提供 IDE、JetBrains 插件、Visual Studio Code 插件等多种使用形态。Qoder CN 持续提供代码智能生成、智能问答、多文件修改、编程智能体等能力，并在模型选择、专家协作、任务规划等方向全面升级，为开发者带来高效、流畅的编码体验。同时面向企业客户提供企业标准版、企业专属版，具备企业级场景自定义、私域知识增强等能力，助力企业研发智能化升级。
