Qoder自定义模型添加成功但未显示，需依次验证：一、执行qoder models list确认后端注册；二、点击齿轮图标→Reload Models刷新前端缓存；三、检查name、model_name、base_url、api_key四字段是否齐全合规；四、确认模型类型为chat或text-generation并支持补全接口。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Qoder自定义模型添加成功但未在下拉列表或AI补全中显示，说明模型注册已写入配置，但未被前端界面识别或未完成加载校验。常见原因是模型标识未被Qoder运行时索引、配置字段缺失关键校验项，或模型类型与当前上下文不兼容。
确认模型是否已真正注册进运行时
第一步：打开终端，执行以下命令查看当前生效模型列表：
qoder models list
若返回结果中包含你刚添加的模型名（如 gitcodedeepseek3.2），说明后端已注册；若无，则添加操作未落库，需重试添加命令并检查终端输出是否含 Successfully added 字样。
第二步：若列表中有该模型，但在Qoder GUI的模型选择下拉框里仍不出现，说明前端未触发模型元数据同步。此时需手动刷新模型缓存：
点击右上角Qoder齿轮图标 →「Reload Models」→ 等待进度条结束（约3–5秒）→ 再次展开模型选择器。
检查模型配置字段是否完整且合规
Qoder对自定义模型启用有强校验：必须同时满足四项字段存在且非空——【name、model_name、base_url、api_key】。缺一不可，且字段名不能带下划线或空格（如 base_ur l 是典型错误）。
方法一：通过 CLI 查看配置细节
执行：qoder models show gitcodedeepseek3.2（将 gitcodedeepseek3.2 替换为你实际的模型名）
重点核对输出中是否每行都含有效值，尤其注意 base_url 是否以 https:// 开头、末尾是否误加斜杠（如 https://api-ai.gitcode.com/v1/ 错误，应为 https://api-ai.gitcode.com/v1）。
方法二：直接编辑配置文件校验
打开 ~/.qoder/config.json（macOS/Linux）或 %USERPROFILE%\.qoder\config.json（Windows），定位到 "models" 数组，找到对应模型对象，确认以下字段全部存在且格式正确：
"name": "gitcodedeepseek3.2","model_name": "deepseek-ai/DeepSeek-V3.2-Exp","base_url": "https://api-ai.gitcode.com/v1","api_key": "sk-xxxxxxxxxx"
⚠️ 注意：若 model_name 值含空格或特殊字符（如 Qwen/Qwen3-Coder-480B-A35B-Instruct），必须用英文双引号包裹，且不能换行。
验证模型是否被当前功能模块支持
Qoder不同功能对模型有类型限制：AI代码补全仅支持文本生成类模型（text-generation 或 chat 类型），不支持 embedding、vision 或 audio 模型。
第一步：在 Qoder 设置 →「Model Configuration」中，点击你添加的模型右侧的「Test Connection」按钮。
第二步：观察测试结果——若返回 HTTP 200 OK 但提示 model not supported for code completion，说明该模型虽能通信，但未声明兼容能力。
第三步：前往模型提供方文档（如 GitCode AI 文档），确认你选用的模型是否明确标注支持 chat completions 接口；若仅支持 completions 接口，需在 Qoder 配置中显式添加字段："type": "chat"。
这一步操作起来很简单，直接在 config.json 的模型对象内加一行即可，加完保存后重启 Qoder 客户端。
