qoder 401错误源于lingma api鉴权失败或ssh密钥信任中断。需依次校验lingma_api_token有效性与网络可达性、重置ssh known_hosts、清理ide缓存及.lingma目录、确认账号已加入lingma组织并具备algo:execute权限。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在使用 Qoder 时收到 HTTP 401 错误响应，这表明请求未通过身份验证，核心问题并非凭证本身已损坏，而是 API 认证链路中断或 SSH 主机密钥信任关系未建立。Qoder 依赖双重认证机制：前端调用需通过阿里云 Lingma API 的 Token 鉴权，后端远程执行则依赖 SSH 密钥对的可信握手。任一环节缺失或错配，均会触发 401 而非 403 或 404。以下是解决此问题的步骤：
一、校验 Lingma API 认证凭证与网络可达性
Qoder 启动时需向 https://lingma-api.tongyi.aliyun.com/algo/api/v1/ping 发起健康检查并携带有效 Bearer Token；若该请求失败，服务将拒绝后续所有操作并返回 401。此环节失败通常源于凭证未注入、域名不可达或代理拦截。
1、在终端执行：curl -i https://lingma-api.tongyi.aliyun.com/algo/api/v1/ping，确认返回状态码为 200 且响应体含 pong。
2、若返回 401 或连接超时，检查系统环境变量是否设置 LINGMA_API_TOKEN，值应为控制台生成的完整 Token 字符串（非密钥 ID）。
3、如公司启用企业防火墙，需确保 lingma-api.tongyi.aliyun.com 已加入白名单；否则手动配置代理，在 C:\Users\{用户名}\AppData\Local\.lingma\config.json 中填入 http_proxy 字段。
二、重置 SSH 主机密钥信任关系
Qoder 在执行远程代码时通过 SSH 连接目标主机，若本地 ~/.ssh/known_hosts 中记录的远程主机公钥与当前实际公钥不一致（如服务器重装系统、SSH 服务重置），OpenSSH 客户端将主动拒绝连接并触发上层 401 报错——此时错误源头实为 SSH 层的密钥验证失败，但被 Qoder 统一封装为认证异常。
1、定位目标主机 IP 或域名，执行：ssh-keygen -R [hostname_or_ip]，清除已知主机条目。
2、重新发起一次手动 SSH 连接：ssh user@[hostname_or_ip]，接受新指纹并写入 known_hosts。
3、确认 ~/.ssh/id_rsa.pub 已正确部署至目标主机的 ~/.ssh/authorized_keys，且权限为 600（私钥）和 644（公钥）。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
三、清理本地缓存与 IDE 运行时状态
Qoder 插件在 JetBrains IDE 中运行时，会将认证上下文缓存在内存及本地磁盘中；若缓存残留过期 Token 或损坏的会话结构，重启插件无法刷新，必须强制清空整个运行态环境。
1、在 IDE 中依次点击 File → Invalidate Caches and Restart → Invalidate and Restart。
2、关闭 IDE 后，手动删除以下目录：C:\Users\{用户名}\AppData\Local\.lingma\（Windows）或 ~/.lingma/（macOS/Linux）。
3、以管理员权限重新启动 IDE，并打开一个非空项目文件夹后再启用 Qoder 插件。
四、验证账户绑定与组织权限状态
Qoder 所调用的 Lingma API 服务受 Microsoft Entra ID 或阿里云主账号统一管控；若当前登录账号未被添加至对应 Lingma 组织的用户目录，或 UPN（用户主体名称）大小写不匹配，API 网关将在鉴权第一层直接拒绝，返回 401 而非跳转登录页。
1、访问 https://lingma.aliyun.com，确认右上角显示的账号邮箱与组织管理员添加的 UPN 完全一致（包括大小写）。
2、联系组织管理员，核查您的账号是否出现在 Lingma 控制台【成员管理】列表中，且角色具备 algo:execute 权限。
3、若使用 B2B 来宾身份，请确认 UPN 格式为 {username}_{homeDomain}#EXT#@{guestDomain}，且 {username}_{homeDomain} 部分与主租户 UPN 严格等价。
