qoder自定义模型调用失败时，需依次检查注册状态、配置字段、base_url结尾、配置文件model值、api连通性及缓存清理；执行qoder models list确认启用、qoder conf model核对激活名、curl测试端点、qoder models reload重载并删除providers目录彻底解决。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Qoder自定义模型调用失败时，无法生成响应、报错“model not found”或卡在“loading”，说明模型注册未生效、配置路径错误或服务端未正确加载该模型标识。
检查模型是否成功注册并启用
第一步：在终端执行 qoder models list，确认输出中包含你添加的模型名称（如 gitcodeqw3），且状态为 【enabled】。若未出现，说明注册命令未成功执行或被静默忽略。
第二步：回溯注册命令，必须使用 add_provider 而非旧版 add_model；字段名必须严格为 name、model_name、base_url、api_key，任意拼写偏差（如 base_ur l 中带空格）会导致注册失败但无提示。
第三步：检查 base_url 是否以 /v1 结尾。GitCode AI 接口要求完整路径为 https://api-ai.gitcode.com/v1/chat/completions，若只填 https://api-ai.gitcode.com，Qoder 会拼接错误路径导致 404。
验证模型配置是否已生效
执行 qoder conf model，查看当前激活模型名是否为你注册的别名（如 gitcodeqw3）。若显示为 qwen3 或空值，说明配置未写入运行时上下文。
打开配置文件 ~/.lingma/config.json（macOS/Linux）或 C:\Users\[用户名]\AppData\Local\.lingma\config.json（Windows），搜索 "model" 字段。该字段值必须与 add_provider 中的 name 完全一致，且不能加引号外层包裹——错误示例："model": "gitcodeqw3" 是合法的，但 "model": "\"gitcodeqw3\"" 会导致解析失败。
测试模型端点连通性与认证有效性
方法一：手动构造 curl 请求验证基础可用性
在终端中运行以下命令（将 YOUR_API_KEY 替换为真实 key）：
curl -X POST https://api-ai.gitcode.com/v1/chat/completions \-H "Authorization: Bearer YOUR_API_KEY" \-H "Content-Type: application/json" \-d '{"model":"Qwen/Qwen3-Coder-480B-A35B-Instruct","messages":[{"role":"user","content":"hi"}]}'
若返回 JSON 响应含 "choices" 字段，说明 API 层正常；若返回 401，证明 api_key 过期或权限不足，需重新获取。
方法二：绕过 Qoder 直接触发一次最小化调用
在 IDE 中新建空白文件，输入提示词：“用一句话介绍你自己”，然后按 Ctrl+Enter（Windows/Linux）或 Cmd+Enter（macOS）强制使用当前配置模型发送请求。这一步可排除插件 UI 缓存干扰，直击模型路由逻辑。
重载模型注册表并清理残留状态
1、执行 qoder models reload 强制刷新本地模型注册表，该命令会重新扫描所有 provider 并重建映射索引。
2、若仍失败，删除 ~/.lingma/providers/ 目录（Windows 对应 %LOCALAPPDATA%\.lingma\providers\），该目录存储 provider 元数据缓存，损坏后会导致模型名解析为空。
3、重启 IDE 并重新执行 qoder models list，确认列表已更新。此时再运行 qoder conf model:gitcodeqw3 激活模型，调用即可生效。
