必须确保ollama服务前台运行且11434端口可访问，并选用支持tool calling的模型（如llama3.2:3b-instruct-q8_0或hermes-2-pro），再在cursor中启用agent模式并正确配置模型名与端口，测试连接成功后方可执行工具调用。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Cursor接入Ollama后想启用Agent模式，必须确认Ollama服务已正确暴露API且模型支持工具调用能力，否则Agent会卡在初始化阶段无法响应任何指令，连最基础的文件读取都失败。
确认Ollama服务可被Cursor访问
打开终端执行 ollama serve，观察是否持续输出日志；若命令无反应或报错“address already in use”，说明Ollama后台服务未启动或端口被占。此时需先杀掉占用11434端口的进程，再手动启动服务。
在浏览器中访问 http://127.0.0.1:11434，页面应返回JSON格式的API根路径信息；如果显示“Connection refused”或空白页，Cursor将完全无法连接Ollama，Agent模式根本不会加载。
这一步是硬性前提，【Ollama必须处于前台运行状态（非仅安装）且11434端口对外可通】，后台静默服务或开机自启但未实际运行都不行。
选择支持Tool Calling的本地模型
方法一：拉取官方明确标注支持function calling的模型
在终端运行：ollama run llama3.2:3b-instruct-q8_0 → 等待加载完成 → 输入“你能调用工具吗”，若返回包含“tool_use”或“function call”的结构化响应，则该模型可用。
方法二：强制启用工具调用能力（仅限部分模型）
编辑 ~/.ollama/modelfile，添加一行 PARAMETER tool_calling true，然后重建模型：ollama create my-agent-model -f ~/.ollama/modelfile。注意：不是所有模型底层支持此参数，强行启用会导致推理崩溃。
方法三：改用Hermes-2-Pro或Qwen2.5-7B-Instruct等经实测能稳定触发tool call的模型，它们在Ollama社区镜像中已预置工具协议支持，无需额外配置。
在Cursor中启用Agent模式并绑定Ollama模型
第一步：打开Cursor设置 → 搜索“agent” → 勾选“Enable Agent Mode”
第二步：进入“AI Provider”设置页 → 将Provider类型改为“Ollama” → 在Model字段填入你确认可用的模型名（如llama3.2:3b-instruct-q8_0）→ 端口保持默认11434
第三步：点击“Test Connection”，看到绿色对勾且下方显示“Agent ready”字样才算成功。如果提示“model not found”，说明模型名拼写错误或未真正pull到本地；如果提示“timeout”，大概率是Ollama服务没跑起来或防火墙拦截了11434端口。
第四步：新建一个空文件，输入“列出当前目录下所有.py文件”，按下Cmd+K（Mac）或Ctrl+K（Win），等待几秒——若出现带文件名的代码块并自动高亮，说明Agent已激活并能执行shell工具。
