qoder中模型名称必须严格匹配本地服务api返回的id字段值。需访问http://localhost:1234/v1/models获取真实id，如qwen3；图形界面或cli配置时须精确填写该id，大小写敏感且不可加引号；base url末尾不能有斜杠。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在Qoder中配置本地部署的大模型时，模型名称不是随意填写的字符串，而是必须严格匹配模型服务实际暴露的模型ID标识，否则Qoder无法正确路由请求到对应服务端点。
确认本地模型服务的真实模型ID
启动本地模型服务（如Ollama、LMStudio、Text Generation WebUI）后，打开其API文档页或健康检查接口（通常是http://localhost:1234/v1/models），直接访问该地址获取JSON响应。响应体中data数组内的每个对象都有一个id字段——这个id值就是Qoder要求填写的“模型名称”。
例如Ollama返回：{"id":"qwen3","object":"list","data":[{"id":"qwen3","object":"model"}]} → 此处模型名称只能填【qwen3】，填Qwen3、qwen-3或qwen3:latest均会失败。
在Qoder中填写模型名称的两种路径
方法一：图形界面添加自定义模型
用户设置→qoder设置→模型→添加→提供商选“OpenAI兼容”→模型类型选chat→在“模型ID”输入框中粘贴上一步查到的精确id值（如qwen3）→Base URL填http://localhost:1234/v1→填写API Key（可填任意非空字符串，如sk-xxx）→点击Validate验证连通性。
PHP中文网提供Qwen-1.0.2.6 MacOS官方客户端下载，专为苹果电脑优化的阿里通义千问桌面应用。本版本深度适配Mac系统，支持本地高效运行与多模态交互，集成超长上下文处理、AI写作、代码生成及智能体构建等核心功能。通过官方渠道下载，确保安全稳定，助您实现智能办公与创作升级。
方法二：CLI命令行临时指定
启动Qoder CLI时直接用--model参数传入该ID：qoderclicn --model qwen3。注意此处不加引号，且大小写完全敏感——qwen3有效，QWEN3会报错退出。
常见错误排查
第一步：验证本地服务是否真正运行并监听预期端口。执行curl -X GET http://localhost:1234/v1/models，若返回Connection refused说明服务未启动或端口不对。
第二步：检查Qoder日志中的错误提示。如果显示"model not found"或"invalid model id"，说明填写的模型名称与服务端暴露的id不一致，必须回到第一步重新抓取真实值。
第三步：确认Base URL末尾不含多余斜杠。填http://localhost:1234/v1/（带尾斜杠）会导致Qoder拼接出http://localhost:1234/v1//chat/completions而404，必须改为【http://localhost:1234/v1】（无尾斜杠）。
