跳转到主要内容
Cursor 的补全和智能体功能通过 Cursor 的云端运行,而非您的本地机器,因此无法访问 localhost 或私有局域网上的模型——它们需要一个 公共 HTTPS 端点。Tokios 在 https://api.tokios.com/v1 为您提供该端点:将连接器与模型配对,注册一个部署名称,然后让 Cursor 使用该 URL 和 sk-tok-… API 密钥即可。无需保持 ngrok 隧道开启,无需开放无认证的端口。

前提条件

  • 已运行并与本地模型配对的 Tokios 连接器——参见连接器安装
  • 已注册的模型部署名称——参见注册模型
  • Tokios API 密钥(sk-tok-…)——参见API 密钥
  • 已安装 Cursor

为什么 Cursor 无法直接使用 localhost

Cursor 的模型请求来自 Cursor 的后端,而非您笔记本上的代码编辑器进程。该后端无法路由到 127.0.0.1 或家庭/办公网络中的机器——它只能调用公网上可通过 HTTPS 访问的端点。这就是为什么将 Cursor 指向裸 http://localhost:11434 或局域网 IP 不起作用,也是为什么任何可行的方案——包括 Tokios——都必须在本地模型前面放置一个公共 HTTPS URL。

将 Cursor 指向 Tokios

1

打开 Cursor 的模型设置

使用 Cmd+,(macOS)或 Ctrl+,(Windows/Linux)打开设置,然后在侧边栏中选择 Models。字段标签在不同 Cursor 版本之间可能有所不同,如果以下名称不匹配请检查您的版本。
2

覆盖基础 URL

将 Override OpenAI Base URL 设为:
保留 /v1 后缀——Cursor 会将 /chat/completions 追加到您在此处输入的内容之后。
3

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

添加自定义模型,使用您注册的公共部署名称——在 Models 标签页中注册——例如 gemma-tunnel。这是 Cursor 在 model 字段中发送的值;它不是 Ollama、llama.cpp、vLLM 或 LM Studio 的本地模型 id。
4

粘贴您的 Tokios API 密钥

将您的 sk-tok-… 密钥粘贴到 Cursor 中自定义模型的 API 密钥字段。Cursor 会在每个请求中将其作为 Bearer 令牌发送。
将 gemma-tunnel 替换为您注册的部署名称,将 sk-tok-YOUR_KEY 替换为您自己的密钥。切勿将二者提交到共享配置文件中。
该覆盖适用于 Cursor 的聊天和智能体面板(Cmd/Ctrl+L)。Tab 自动补全和内联编辑无论此设置如何,始终运行 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 密钥

为队友和智能体创建、限定范围和轮换 sk-tok-… 密钥。