localhost 或私有局域网上的模型——它们需要一个 公共 HTTPS 端点。Tokios 在 https://api.tokios.com/v1 为您提供该端点:将连接器与模型配对,注册一个部署名称,然后让 Cursor 使用该 URL 和 sk-tok-… API 密钥即可。无需保持 ngrok 隧道开启,无需开放无认证的端口。
前提条件
为什么 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 替换为您自己的密钥。切勿将二者提交到共享配置文件中。为什么这比 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 中设置一次。 - 作用域受限的密钥——密钥可以限定到特定部署,如果泄露可以立即撤销,无需触及您的本地模型或连接器。
故障排除
401 错误
401 错误
Cursor 发送的 API 密钥缺失、格式错误或已被撤销。确认您粘贴了完整的
sk-tok-… 密钥且没有多余空白,并在 Keys 标签页检查其状态。404 错误
404 错误
Cursor 发送的
model 值与已注册的部署不匹配。确认 Cursor 中的自定义模型名称与 Models 标签页上的公共名称完全一致——而不是您的 Ollama/llama.cpp/vLLM/LM Studio 本地模型 id。503 错误
503 错误
该部署的连接器离线或已达到并发上限。检查 Connectors 标签页——连接器需要显示为 Online,且运行它的机器需要仍然在线并可访问。
后续步骤
兼容的客户端
查看其他兼容 OpenAI 和 Anthropic 的客户端的基础 URL 和密钥设置。
API 密钥
为队友和智能体创建、限定范围和轮换
sk-tok-… 密钥。