Ollama Cloud 模型认证问题排查指南

当你在 Claude Code 中使用 deepseek-v4-flash:cloud 模型遇到报错时，这通常意味着 Ollama 账号未登录或认证配置有误。本文将帮你快速定位并解决这个问题。

报错现象

使用 claude --model deepseek-v4-flash:cloud 启动时，提示模型不存在或无法访问。

根本原因

Cloud 模型使用的是 ollama.com 上的推理算力，需要登录 ollama.com 才能使用。直接调用 claude 命令时，它会把模型名发给 Anthropic API，而不是 Ollama，绕开了 Ollama 的认证层，所以找不到这个云端模型。

正确的使用方式

方式一：通过 ollama launch 启动（推荐）

这是最简单的方式，Ollama 会帮你处理认证和模型路由：

# 第一步：确认已登录 Ollama
ollama whoami

# 如果没登录，先登录
ollama login

# 第二步：通过 ollama launch 启动 Claude Code
ollama launch claude --model deepseek-v4-flash:cloud

方式二：手动配置环境变量

如果你坚持要直接用 claude 命令，需要手动设置环境变量指向 Ollama 本地代理：

ANTHROPIC_BASE_URL=http://localhost:11434 \
ANTHROPIC_API_KEY=ollama \
claude --model deepseek-v4-flash:cloud --dangerously-skip-permissions

使用此方式的前提条件：

• Ollama 本地服务已经在运行（ollama serve）
• 已经通过 ollama login 登录账号

为什么直接 claude 命令不行

直接调用 claude 时，模型请求会直接发送到 Anthropic API，而不是经过 Ollama 的本地代理层（http://localhost:11434）。Ollama 的 cloud 模型必须通过 Ollama 的代理层才能访问，因此需要通过 ollama launch 或手动配置环境变量来路由请求。

常见问题

Q: Ollama 版本太旧怎么办？

# 检查当前版本
ollama --version

# 升级到最新版本
brew upgrade ollama

Q: 登录后仍然报错？

确认 Ollama 本地服务正在运行：

ollama list

如果服务未启动，执行 ollama serve 或重启 Ollama 应用。

Q: 支持哪些 cloud 模型？

在 ollama.com 查看所有可用的 cloud 模型列表，带有 :cloud 后缀的模型都需要通过上述方式使用。