1. 为什么要把 deepseek-r1 从命令行搬到日常工具里很多人第一次跑通 deepseek-r1都是在终端里敲一句ollama run deepseek-r1:7b然后对着黑底白字的窗口一问一答。这个阶段能证明模型确实跑起来了但离“能用来干活”还差得远聊天记录没法保存、代码片段不能直接塞进项目、每次都要切窗口复制粘贴。真正影响效率的是把它接进你每天已经打开的网页界面和代码编辑器里。这篇就聚焦 deepseek-r1 在本地开发环境的落地路径先用 Ollama 把模型服务拉起来再分别接入 web-ui 做网页对话接入 VS Code 的 Cline / Continue 做本地代码助手。中间会给出可复制的config.toml、settings.json骨架以及 TaoToken 统一 Key / API 通道的配置示例最后附上逐步验证动作——服务连通、模型响应、编辑器调用争取一次跑通本地 AI 编码工作流。适合谁看已经装好 Ollama、能跑起 deepseek-r1但不知道怎么把它变成“顺手工具”的开发者或者想给团队搭一套隐私可控的本地编码助手的人。全程不需要额外硬件一台能跑动 7B/8B 模型的机器就够起步。2. 前置准备Ollama 服务与 TaoToken 通道骨架2.1 确认 Ollama 服务在监听Ollama 默认在11434端口提供 HTTP 服务web-ui 和编辑器插件都是通过这个端口跟模型通信的。先确认它活着ollama list curl http://localhost:11434/api/tags第一条能看到你拉下来的deepseek-r1:7b、deepseek-r1:8b等模型第二条返回一段 JSON里面models数组就是可用模型列表。如果curl报连接拒绝说明 Ollama 没启动Windows 下在开始菜单搜 Ollama 打开即可macOS/Linux 用ollama serve。注意Ollama 默认只监听127.0.0.1。如果你打算让 Docker 里的 web-ui 访问宿主机模型需要设置环境变量OLLAMA_HOST0.0.0.0再重启服务否则容器里连不上。2.2 TaoToken 统一 Key / API 通道本地模型适合隐私敏感、离线场景但遇到需要更强模型或统一管理多个模型通道时用 TaoToken 做一层统一入口会省事很多。它的作用是给你一个兼容 OpenAI 风格的 API 地址和 Key编辑器插件、web-ui 都能指向它不用每个工具单独配一遍。配置骨架长这样先记下三个值# ~/.taotoken/config.toml 骨架示例 [api] base_url https://taotoken.net/api api_key sk-你的Key # 模型对话入口 chat_endpoint https://taotoken.net/api/v1/chat/completionsKey 在控制台的 API Keys 页面生成接入文档里有各语言的调用示例。这一步不用急着填后面接编辑器时会用到。如果你只是纯本地跑 deepseek-r1TaoToken 可以先跳过等需要混合调用时再回来配。3. 可复制配置web-ui 与代码编辑器接入3.1 用 Docker 拉起 Open WebUIweb-ui 我选的是 Open WebUI界面接近 ChatGPT支持多会话管理和模型切换。前提是装好 Docker Desktop然后一条命令docker run -d -p 3000:8080 \ --add-hosthost.docker.internal:host-gateway \ -v open-webui:/app/backend/data \ --name open-webui \ --restart always \ ghcr.io/open-webui/open-webui:main-p 3000:8080把容器内 8080 映射到宿主机 3000--add-host让容器能通过host.docker.internal访问宿主机的 Ollama-v把数据持久化重启不丢会话。等镜像拉完浏览器打开http://localhost:3000注册一个本地账号就能进。进去后点右上角设置找到“连接”或“模型”一栏把 Ollama 地址填成http://host.docker.internal:11434。保存后模型下拉框里应该能看到deepseek-r1:7b。如果列表为空回到容器日志看报错docker logs open-webui --tail 50常见的是地址填成了localhost容器里的 localhost 指向容器自己不是宿主机。3.2 VS Code Cline 配置骨架Cline 是 VS Code 里的 Agent 型插件能读写文件、跑命令。在扩展市场搜 Cline 安装后打开设置API Provider 选 OllamaBase URL 填http://localhost:11434Model 填deepseek-r1:8b。对应的settings.json骨架{ cline.apiProvider: ollama, cline.ollamaBaseUrl: http://localhost:11434, cline.model: deepseek-r1:8b, cline.customInstructions: 使用中文回答代码给出必要注释。 }如果你想让 Cline 走 TaoToken 通道调用云端模型把 provider 换成 OpenAI CompatibleBase URL 填https://taotoken.net/api/v1Key 填控制台生成的模型名按接入文档里支持的填。这样本地和云端可以按任务切换。3.3 VS Code Continue 配置骨架Continue 更偏补全和对话配置文件在~/.continue/config.json。在models数组里加两项{ models: [ { title: deepseek-r1:8b, provider: ollama, model: deepseek-r1:8b, apiBase: http://localhost:11434, systemMessage: You are an expert software developer. Keep answers concise. }, { title: deepseek-r1:14b, provider: ollama, model: deepseek-r1:14b, apiBase: http://localhost:11434, systemMessage: You are an expert software developer. Keep answers concise. } ] }保存后左侧 Continue 面板的模型下拉里就能选到这两个。14B 对显存要求更高8G 显存的机器建议先用 7B/8B跑 14B 会明显变慢甚至 OOM。4. 验证请求从服务连通到编辑器调用4.1 验证 Ollama 直连先用最原始的方式确认模型能响应curl http://localhost:11434/api/generate -d { model: deepseek-r1:8b, prompt: 用一句话说明什么是快速排序, stream: false }返回 JSON 里的response字段就是模型输出。这一步通了说明模型服务本身没问题后面出问题就集中在插件配置上。4.2 验证 web-ui 对话在 Open WebUI 里新建对话选deepseek-r1:8b问一句“写一个 Python 读取 CSV 并打印前五行的函数”。正常情况几秒内开始流式输出。如果一直转圈按 F12 看 Network 里对/api/chat的请求是否 500再对照容器日志。4.3 验证编辑器调用Cline 里输入一个具体任务比如“在当前目录创建一个 hello.py打印 1 到 10”。观察它是否弹出文件写入确认、是否执行成功。Continue 则在侧边栏选中模型后直接提问看是否返回代码块。实测下来8B 模型在简单任务上响应稳定复杂重构建议换更大模型或走 TaoToken 通道。5. 本篇常见错排查连不上 11434先curl本机确认 Ollama 活着Docker 场景检查是否用了host.docker.internalWindows 防火墙可能拦了端口临时放行测试。web-ui 模型列表为空九成是地址填错。容器内访问宿主机必须用host.docker.internal不是localhost。改完保存刷新页面。Cline 报 404 或 model not found模型名要和ollama list里完全一致包括:8b这种 tag。少写 tag 会找不到。Continue 配置不生效config.json是 JSON 格式多一个逗号就整份失效。改完在 Continue 面板点重新加载或重启 VS Code。响应特别慢先看任务管理器里 GPU/内存占用。7B 模型量化版约 4-5G 显存14B 要 9G 以上。显存不够会退到 CPU速度断崖式下降。TaoToken 调用返回 401Key 没填对或过期去控制台 API Keys 页面重新生成Base URL 注意带不带/v1以接入文档为准。6. 把本地模型接进日常工具才算真正落地跑通之后我的习惯是隐私相关的代码和文档走本地 deepseek-r1需要更强推理或长上下文时切到 TaoToken 通道的模型两套配置在编辑器里一键切换。web-ui 留着做资料整理和长对话编辑器插件负责写代码和改 bug。如果你还在命令行阶段建议先按第 3 节的骨架把 Open WebUI 和 Cline 配起来再回头补 TaoToken 的统一入口。模型对话入口、Coding Plan、控制台和 API Keys 都在官网能找到接入文档里有各工具的详细参数。先把一条链路跑通再逐步加工具比一次性全配齐更不容易踩坑。
