Qoder启用本地大模型有三种方式:一、CLI启动时用--ollama参数临时指定;二、永久修改~/.qoder/config.yaml的llm区块,需严格遵循YAML缩进与/v1路径格式;三、IDE插件中通过图形化设置面板配置Custom Endpoint或Ollama选项,且不读取全局config.yaml。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在Qoder中启用本地运行的大模型(如Ollama、vLLM或XInference托管的Qwen2.5、DeepSeek-Coder等),必须准确找到并修改其模型配置入口,否则所有请求仍将默认走云端API,产生计费且无法调用本地算力。
CLI启动时临时指定本地模型入口
这一步适用于快速验证本地模型连通性,不改动任何配置文件,适合多模型轮换调试场景。
在终端中执行qoderclicn命令时,直接追加--ollama参数即可覆盖默认模型端点:
qoderclicn --ollama http://127.0.0.1:11434/v1 --model qwen2.5-coder:14b
注意:该参数仅对本次CLI会话生效;若未提前运行ollama run qwen2.5-coder:14b,将报“model not found”错误。
永久修改全局配置入口 ~/.qoder/config.yaml
这是最常用、最稳定的本地模型配置方式,所有Qoder Agent模式(Quest/TUI/Memory)均从此文件读取LLM设置。
第一步:打开用户级配置文件
Linux/macOS路径为~/.qoder/config.yaml;Windows路径为%USERPROFILE%\.qoder\config.yaml
第二步:确保llm区块存在且结构完整
若文件为空或无llm字段,需手动写入以下四行(缩进必须为两个空格,YAML对空白符敏感):
llm:
base_url: "http://127.0.0.1:11434/v1"
api_key: "sk-ollama"
model: "qwen2.5-coder:14b"
【base_url末尾必须带/v1,否则Qoder会向http://127.0.0.1:11434/api/chat发起非标准请求而失败】
第三步:保存后重启Qoder CLI或关闭重开Qoder编辑器界面,新配置才会加载
IDE插件中的模型后端配置入口
当使用Qoder CN IDE或JetBrains插件时,模型入口不在config.yaml,而藏在图形化设置面板深处。
方法一(Qoder CN IDE):
打开Settings → Qoder → Model Backend → 选择“Custom Endpoint” → 填入http://127.0.0.1:11434/v1 → 在Model Name栏输入qwen3-4B-Instruct-2507
方法二(JetBrains系列):
Settings → Qoder → Model Backend → 切换为Ollama → Host URL填http://10.1.10.5:11434(若Ollama部署在局域网服务器)→ 点击Test Connection确认绿色对勾出现
JetBrains插件不会读取~/.qoder/config.yaml,它只认自己面板里的设置,这点容易踩坑。


















