Qoder需手动配置本地大模型服务端点才能调用,先验证localhost:8080/v1/chat/completions接口可用,再编辑config.json添加含api_base、supports_vision等字段的模型定义,最后重启选择并测试图文输入。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

Qoder添加本地大模型需要绕过其默认的云端模型列表,直接指向你本地已部署好的模型服务端点,否则界面里永远只显示“Qwen3-VL”“Qwen2.5-VL”等占位名称,根本无法真正调用你硬盘上的模型。
确认本地模型服务已运行并监听正确端口
先验证你的本地模型是否真的在后台稳定提供API。Qwen系列多模态模型(如Qwen2.5-VL或Qwen3-VL)通常通过FastAPI或vLLM暴露/v1/chat/completions接口。打开终端执行:
curl -X POST http://localhost:8080/v1/chat/completions -H "Content-Type: application/json" -d '{"model":"qwen2.5-vl","messages":[{"role":"user","content":"你好"}]}'
如果返回JSON且含"choices"字段和有效"content",说明服务正常;若报Connection refused,请先启动Ollama或Docker容器——Qoder不会帮你启动服务,它只消费API。
在Qoder中手动注入本地模型配置
Qoder不提供图形化“添加模型”按钮,必须编辑配置文件。关闭Qoder主程序后,定位到其配置目录:
Windows:%APPDATA%\Qoder\config.json
macOS/Linux:~/.config/Qoder/config.json
用文本编辑器打开config.json,找到"models"数组,在末尾插入一段新模型定义:
{"id": "qwen2.5-vl-local", "name": "Qwen2.5-VL 本地版", "api_base": "http://localhost:8080/v1", "api_key": "not-needed", "supports_vision": true}
【注意:api_base必须以/v1结尾,不能是/v1/chat/completions】否则Qoder构造请求时会拼出/v1/v1/chat/completions导致404。
启用模型并测试图文输入
重启Qoder,点击左上角模型选择框 → 滑到底部 → 选中“Qwen2.5-VL 本地版”。此时界面上方应显示“✅ 已连接”绿色提示。
拖入一张JPG图片到输入区,再输入“这张图里有什么?用中文描述”,点击发送。
如果5秒内返回结构化文本(非报错信息),说明视觉编码器、文本解码器、跨模态对齐全部通路畅通;若卡住超过20秒,大概率是本地服务未启用vision processor或qwen-vl-utils缺失——Qoder本身不校验这些依赖,它只转发请求。


















