Skip to main content
Cursor 的补全与智能代理功能均在云端运行，而非您的本地机器，因此它们无法直接访问 localhost 上的模型或您局域网内的模型——必须借助 公网 HTTPS 端点。Tokios 在 https://api.tokios.com/v1 提供了此类端点：只需将连接器与您的模型配对，注册一个部署名称，随后把该 URL 连同 sk-tok-… 令牌提供给 Cursor 即可。无需维持 ngrok 隧道，也无需开放无验证端口。

​
前置条件

  • 已运行且与本地模型成功配对的 Tokios 连接器——参见 连接器安装
  • 已注册的模型部署名称——参见 注册模型
  • 有效的 Tokios API 密钥（sk-tok-…）——参见 API 密钥管理
  • 已安装 Cursor

​
为何 Cursor 无法直接使用本地主机地址

Cursor 发出的模型请求源自其云端后端，而非您电脑上的代码编辑器进程。该后端无法访问 127.0.0.1 或您家庭/办公网络内的设备——它仅能调用公网上可通过 HTTPS 访问的端点。正因如此，直接将 Cursor 指向 http://localhost:11434 或局域网 IP 均无法奏效；任何可行的配置方案——包括 Tokios——都必须在本地模型前增设公网 HTTPS 地址。

​
将 Cursor 指向 Tokios

1

打开 Cursor 的模型设置页面

按下 Cmd 与 , 键（macOS）或 Ctrl 与 , 键（Windows/Linux）以打开设置界面，随后在侧边栏中选择 Models。不同版本的 Cursor 中字段名称可能有所差异，若与下方描述不符，请自行核对。
2

修改基础 URL 设置

将 Override OpenAI Base URL 字段的值设为：
请务必保留 /v1 后缀——Cursor 会自动把 /chat/completions 附加到此处填写的内容之后。
3

将您的部署实例添加为自定义模型

Add a custom model using the public deployment name you registered in the Models tab — for example, gemma-tunnel. This is the value Cursor sends in the model field; it is not Ollama’s, llama.cpp’s, vLLM’s, or LM Studio’s local model id.
4

粘贴您的 Tokios API 令牌

将 sk-tok-… 令牌填入 Cursor 内对应自定义模型的 API 密钥栏位即可。每次请求时 Cursor 都会以 Bearer 令牌的形式发送该值。
请将 gemma-tunnel 替换为您注册的部署名称，并将 sk-tok-YOUR_KEY 替换为您自己的令牌。切勿将二者写入任何共享配置文件中。
此设置仅对 Cursor 的聊天与智能代理面板生效（即 Cmd/Ctrl+L）。至于自动补全与内联编辑功能，无论此设置如何，它们始终运行于 Cursor 自带的模型之上，因此这些 2 功能无法调用您本地的模型。

​
为何此方案优于使用 ngrok 隧道

Cursor 的纯云端架构正是导致人们普遍采用 ngrok http 11434 配合 OLLAMA_HOST=0.0.0.0（或 OLLAMA_ORIGINS=*）来实现 Ollama 可访问性的根本原因。这种组合确实可行，但会导致你的模型在没有任何身份验证的情况下暴露在外，且每次重新建立隧道时 URL 都会发生变化——任何发现该 URL 的人都能调用你的模型。 Tokios 的连接器仅支持出站连接，因此你的模型不会开启任何入站端口，且所有发往模型的请求都会携带限定范围的 sk-tok-… 令牌而非无任何验证信息。
  • 杜绝未授权访问——连接器仅向 Tokios 发起连接，不会监听任何端口，且所有请求都必须携带有效的令牌方可通过。
  • URL 稳定不变——https://api.tokios.com/v1 在重启后也不会发生变化，因此只需在 Cursor 中设置一次即可。
  • 令牌权限可控——令牌的权限可限定于特定部署场景，一旦发生泄露也能立即撤销，且无需改动本地模型或连接器配置。

​
故障排查

Cursor 发送的 API 密钥缺失、格式有误或已被撤销。请确认你输入的 sk-tok-… 密钥完整无误且不含多余空格，随后前往 Keys 页面查看该密钥的当前状态。
Cursor 发送的 model 数值与已注册的部署信息不匹配。请确认 Cursor 中填写的自定义模型名称与 Models 页面显示的公开名称完全一致——该名称并非本地 Ollama/llama.cpp/vLLM/LM Studio 模型的实际 ID。
对应部署所使用的连接器处于离线状态或已达到并发上限。请查看 Connectors 页面：连接器状态需显示为 Online，且运行该连接器的设备必须处于开机状态且可正常访问。

​
后续步骤

兼容的客户端

关于其他兼容 OpenAI 与 Anthropic 标准的客户端，请查阅基础 URL 及 API 密钥的部署说明。

API 密钥

为团队成员及各类代理创建、设定权限范围并定期轮换 sk-tok-… 类型的令牌。