Roo Code 离线模式快速上手指南Ollama 本地模型 断网编程 5 分钟配齐【免费下载链接】Roo-CodeRoo Code gives you a whole dev team of AI agents in your code editor.项目地址: https://gitcode.com/GitHub_Trending/ro/Roo-Code高铁过隧道、酒店 Wi-Fi 抽风屏幕右下角的网络图标又灰了。把本地模型跑起来之后Roo Code 的离线模式照样能在编辑器里读代码、改文件、答问题——AI 编程助手第一次不依赖云端。快速上手本地模型 Roo Code 三步跑通装好之后Roo Code 里的代码生成、文件编辑、终端命令等全部照常可用。全程只在第一次拉模型时需要联网之后断网也不受影响。5 分钟装好 Ollama 本地推理环境Ollama 是一个在电脑本地运行大模型的命令行工具可以理解成AI 模型播放器把模型文件放进来它就在本机提供推理服务。从 Ollama 官网下载对应系统的安装包按向导装完即可。安装完成后服务默认监听http://localhost:11434Roo Code 会用这个地址连接。嫌命令行麻烦的话也可以选 LM Studio它提供图形界面默认端口是 1234。选一个支持工具调用的模型这点比参数量更重要。Roo Code 靠工具调用读写文件、执行命令不支持这个能力的模型会被自动过滤下拉列表里根本看不到它。下载模型只需一条命令ollama pull qwen2.5-coder:7b。16GB 显存可以上qwen2.5-coder:32b只有 8GB 显存7B 更稳妥。在 Roo Code 里选中 ollama 这个 Provider打开 Roo Code 侧边栏点齿轮进设置把 API Provider 选成ollama模型名填上一步拉取时的名字。Base URL 保持默认即可如果 Ollama 跑在别的机器上再把地址改过去。填完保存模型列表会从本地服务自动读出来。它是怎么做到离线的离线的秘密其实就两根支柱都不神秘。第一根是本地推理。Roo Code 把对话请求直接发给本机的 Ollama不经过任何云端 API源码在 src/api/providers/native-ollama.ts连不上时它会明确报出地址让你排查。第二根是本地项目索引。Roo Code 的代码库索引功能在本机把你的项目切成片段并建立向量索引实现位于 src/services/code-index/。索引建好后断网时模型仍能检索到相关代码片段上下文不缺斤少两。一句话总结模型在本地跑索引在本地存断网只剩速度损失没有功能损失。断网时你能干成的 3 件事写代码和改文件本地模型支持 Roo Code 的原生工具调用所以它不只会说还能做读文件、改代码、跑命令。在 Chat 面板里直接说把这个函数加上错误处理它会定位、修改、验证和在云端模型下没有流程差别。区别只是响应速度取决于你的显卡。给项目做一次离线体检先在有网时建好代码库索引之后断网照样能问。比如这个模块里有没有潜在的空指针问题模型会检索到相关文件再分析。对旅途中 review 代码、或者机房临时断网时的紧急排查这条链路非常实用。顺手补文档给这个类写注释根据代码生成 API 说明这类活交给本地模型就够。生成的文档格式和在线时一致只是措辞质量取决于模型本身——这是所有本地模型的共性不是配置问题。让它更快固定上下文 预加载本地模型跑不快多半不是显卡不行而是上下文没固定。第一次请求时 Ollama 会冷启动加载模型此时如果上下文窗口没设上限它可能按默认最大值申请内存直接把显存撑爆。官方文档apps/docs/docs/providers/ollama.md建议用 Modelfile 把num_ctx钉死FROM qwen2.5-coder:32b PARAMETER num_ctx 32768然后ollama create my-model -f Modelfile。Roo Code 会自动读取这个配置你不需要在它里面再设一次。经验值8GB 显存配 1638416GB 配 32768。另外先ollama run把模型提前加载并保持在运行状态Roo Code 发请求时就是热的首条回复的等待时间能省掉大半。常见卡点排查现象报错 Ollama service is not running at http://localhost:11434。检查ollama ps看服务是否在跑。解决先启动服务或把 Roo Code 里的 Base URL 改成实际地址和端口。现象Provider 选了 ollama模型下拉列表却是空的。检查ollama list里模型名是否支持 tools 能力Roo Code 会把不支持的静默过滤掉。解决换一个支持工具调用的模型。现象第一次请求 OOM内存不足之后手动启动模型又好了。检查是否固定了num_ctx、是否提前加载。解决按上一节用 Modelfile 钉死上下文并保持模型常驻。现在就动手打开终端装好 Ollamaollama pull一个支持工具调用的编码模型在 Roo Code 设置里把 Provider 切成 ollama——三步不超过 5 分钟。然后做一件事拔掉网线发一条消息。如果模型照常回复你的离线编程环境就算真正成立了。【免费下载链接】Roo-CodeRoo Code gives you a whole dev team of AI agents in your code editor.项目地址: https://gitcode.com/GitHub_Trending/ro/Roo-Code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考