Qoder本地模型端口无法连接是因网络层拦截或服务未暴露在预期地址，需先验证服务是否运行、统一使用127.0.0.1而非localhost、修正baseUrl路径、确保模型绑定0.0.0.0、必要时关闭证书校验。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Qoder本地模型提示端口无法连接，说明框架尝试访问模型服务时被网络层拦截或服务未暴露在预期地址上。这不是模型本身没启动，而是Qoder找不到它——就像寄快递写错门牌号，包裹根本送不到。
先确认模型服务真正在运行
打开终端，执行：
curl -s http://localhost:8000/health | head -c 50
如果返回空或报错，说明模型服务压根没起来；如果返回类似{"status":"healthy"}，证明服务存活但可能绑定错了地址。这一步跳过等于盲调，后续所有配置都白改。
注意：很多教程默认用vllm启动，但实际监听地址可能是127.0.0.1:8000，而Qoder尝试连的是localhost:8000——二者在某些系统（尤其是macOS）下解析行为不一致，【必须统一用127.0.0.1或0.0.0.0】。
检查Qoder配置里的baseUrl是否带路径后缀
打开~/.qoder/config.json，定位到模型配置段：
方法一：直接修正为标准OpenAI兼容格式
"baseUrl": "http://127.0.0.1:8000/v1"
方法二：若服务是Uvicorn/FastAPI类框架，且未挂载/v1前缀，则去掉路径
"baseUrl": "http://127.0.0.1:8000"
⚠️ 错误示例："http://127.0.0.1:8000/v1/"（末尾斜杠会导致404）；"http://localhost:8000/v1"（localhost在Docker或某些防火墙下不可靠）。
代码编辑 CLI 工具集合：Cursor CLI（agent）和 Qoder CLI（qodercli），用于代码修改、重构、Code Review 及自动化代码任务。
验证端口是否被占用或监听范围不对
第一步：查端口占用
lsof -i :8000
第二步：若无输出，说明服务没监听该端口；若有输出但PID不是你的模型进程，记下PID并kill -9 $PID
第三步：强制服务绑定到全网卡
启动模型时加参数：--host 0.0.0.0（vLLM）或--host 0.0.0.0（Uvicorn）
这一步漏掉，服务就只响应本机回环请求，Qoder从外部调用必然失败。很多用户卡在这里两天，其实就差一个--host参数。
临时关闭证书校验（仅HTTPS场景）
如果baseUrl用的是https且报CERT_HAS_EXPIRED错误：
在config.json对应模型段加入：
"rejectUnauthorized": false
这不会修复证书问题，但能绕过校验让连接通起来——先跑通再修证书，别卡在第一步。
