Claude Code with cloud model

快速结论：在 Windows 上通过 ollama launch claude 使用 cloud 模型时，如果 Claude Code 报 Connection refused，应优先确认所用模型名确实带 -cloud 后缀，并通过 ollama run 单独测试该 cloud 模型能否连通；该 Issue 未给出确认的一步修复方案。

适用环境：Ollama 0.40.11；Windows 11；CPU 为 Intel Core i3；无 GPU；Claude Code v2.1.310；使用 cloud 模型（如 gpt-oss:120b-cloud、gemma4:31b-cloud）。

最快修复方案：暂无确认的一步修复方案。可优先尝试：确认模型是 cloud 模型（带 -cloud 后缀），先用 ollama run gpt-oss:120b-cloud hello 验证 cloud 模型连通，再用相同模型启动 Claude Code。

注意事项：Issue 中 ollama run gpt-oss:120b-cloud hello 能正常回复，但仍会间歇出现 Connection refused，说明该现象未被完整解释，网络波动、代理或防火墙仍可能是影响因素；phi4-mini 不是 cloud 模型，不要用于 cloud 场景排查。

问题场景

用户在 Windows 11 上使用 Ollama 0.40.11 的 ollama launch claude --model <模型> 命令启动 Claude Code，并指定 cloud 模型（如 gpt-oss:120b-cloud）。长时间运行任务后，Claude Code 提示连接被拒绝并反复重试；也有人在首次提示时即出现该报错。

报错原文

* Connection refused - a firewall or proxy may be blocking it (ECONNREFUSED) . Retrying in 3s . attempt 4/10

[claude-code:unrecognized_model] {"model":"gemma4:31b-cloud","query_source":"sdk"}

原因分析

根据 Issue 讨论，可能原因包括：

所用模型并非 cloud 模型（例如 phi4-mini），无法通过云端接口调用。维护者明确指出 phi4-mini is not a cloud model。
Claude Code 与 Ollama 服务之间的连接被中断，报错本身提示“a firewall or proxy may be blocking it”，指向防火墙或代理可能的干扰。
使用 cloud 模型时出现 [claude-code:unrecognized_model]，说明 Claude Code 对模型名或模型类型的识别存在问题，但这在 Issue 中出现时并未导致任务失败。

环境排查

Ollama 版本（Issue 中为 0.40.11）
操作系统与硬件：Windows 11、无 GPU、Intel Core i3
Claude Code 版本（Issue 中为 v2.1.310）
模型名是否带 -cloud 后缀，且可在 Ollama cloud 模型列表中查到
系统中是否存在代理、VPN 或防火墙规则拦截连接
完整启动命令及完整报错日志（Issue 维护者要求提供配置、Claude 版本、所运行的命令和错误信息）

解决步骤

确认使用的是 cloud 模型。对照 Ollama cloud 模型列表，确认模型名形如 gpt-oss:120b-cloud；phi4-mini 等非 cloud 模型不能用于此场景。
先用 ollama run gpt-oss:120b-cloud hello 单独测试 cloud 模型。Issue 中该命令能正常返回 Hello! How can I help you today?，可作为连通性验证。
连通性正常后，再用同一模型启动 Claude Code：
```
ollama launch claude --model gpt-oss:120b-cloud
```
若仍出现 Connection refused，检查本机代理、VPN 与防火墙，确认没有拦截 Claude Code 到 Ollama 服务或云端模型的连接；这是报错文本本身提示的方向，但 Issue 中未给出验证结果。
复现时记录完整命令、Claude Code 版本、配置和完整报错，便于进一步定位。