claude code 使用局域网ollama大模型
如果你的 Ollama 模型运行在局域网(LAN)的另一台 Ubuntu/Windows 计算机上,而你想在当前的本地电脑上运行 Claude Code,你需要进行两步配置:
让远端计算机的 Ollama 允许局域网访问(默认它只听 localhost)。
在本地电脑上配置环境变量指向远端 IP。
以下是完美的配置流程:
步骤一:配置远端计算机(运行 Ollama 的那一台)
默认情况下,Ollama 出于安全考虑,只接受 127.0.0.1(本地循环地址)的请求。你需要修改它的监听配置。
- 如果远端是 Ubuntu 系统:
打开终端,编辑 Ollama 的 systemd 服务配置文件:
Bash
sudo systemctl edit ollama.service
系统会打开一个文本编辑器,在空行中输入或粘贴以下内容:
Ini, TOML
[Service]
Environment="OLLAMA_HOST=0.0.0.0"
Environment="OLLAMA_ORIGINS=*"
💡 0.0.0.0 表示允许任意 IP 访问它,OLLAMA_ORIGINS=* 允许跨域请求(对 Claude Code 握手很重要)。
保存并退出编辑器(如果是 nano,按 Ctrl+O 确认,再按 Ctrl+X 退出)。
刷新配置并重启 Ollama 服务:
Bash
sudo systemctl daemon-reload
sudo systemctl restart ollama
- 如果远端是 Windows 系统:
在 Windows 任务栏右下角找到 Ollama 图标,右键点击并选择 Quit Ollama 退出。
打开 Windows 高级系统设置 -> 环境变量。
在“用户变量”或“系统变量”中,点击新建,添加以下两个变量:
变量名:OLLAMA_HOST ,变量值:0.0.0.0
变量名:OLLAMA_ORIGINS ,变量值:*
重新在开始菜单启动 Ollama 软件。
步骤二:获取远端计算机的局域网 IP
在远端计算机上查看它的局域网内网 IP(形如 192.168.x.x):
Ubuntu 终端输入:hostname -I 或 ip route show
Windows 终端输入:ipconfig
假设我们获取到的远端 IP 是:192.168.1.100
步骤三:在本地电脑连接并启动 Claude Code
回到你当前写代码的这台 Ubuntu 本地电脑上,打开终端,将接口地址重定向到远端:
方法 A:直接注入环境变量启动(推荐)
Bash
1. 将 Base URL 指向远端计算机的 11434 端口
export ANTHROPIC_BASE_URL="http://100.99.36.102:11434"
2. 绕过授权验证(固定写法)
export ANTHROPIC_AUTH_TOKEN="ollama"
export ANTHROPIC_API_KEY=""
export ANTHROPIC_MODEL="qwen3.5:4b"
3. 启动并指定远端已拉取好的模型
claude --model qwen3.5:14b
方法 B:使用你之前安装的 cc-switch 快速管理
如果你已经装好了 cc-switch 命令行或图形端,你只需要进入配置,新建一个名为 Ollama-Remote 的节点:
Provider URL: http://192.168.1.100:11434
API Key / Token: (留空或填 ollama)
之后每次切到这个配置,直接在终端敲 claude --model 模型名 就能直接白嫖另一台电脑的显卡算力了!
🛠️ 网络连通性排查
如果在本地输入 claude 提示连接超时(Timeout)或无法连接,请在本地终端运行以下命令,测试是否能穿透到远端:
Bash
curl http://192.168.1.100:11434
如果成功:会返回一行文字 Ollama is running。
如果失败:说明被远端计算机的防火墙拦截了。
解决办法(远端是 Ubuntu):在远端运行 sudo ufw allow 11434/tcp 放行端口。
解决办法(远端是 Windows):在Windows高级安全防火墙中,新建入站规则,允许 11434 端口的 TCP 连接。