Cursor / Cline 接入国产大模型实操指南：用 DeepSeek、通义千问和 GLM 替代 OpenAI

2026-09-11 13:31 4 阅读

为什么国产大模型值得用于编程辅助

2026 年，国产大模型在代码生成、补全和调试等任务上的表现已经不输海外主流模型。更重要的是，它们在实际使用体验上具备明显优势：

延迟更低：国内直连 API 延迟通常在 200–500 毫秒之间，而通过代理访问海外模型往往需要 2–5 秒，差距显著。
成本更优：以 DeepSeek V4 Flash 为例，输出价格约为 ¥2/百万 tokens，同级别海外模型折算后贵 3–5 倍。
连接稳定：无需翻墙，避免了 SSL 握手失败、超时或突然断连等问题。

对于高频使用的编码辅助场景，这些优势直接转化为更流畅的开发体验。

核心问题：格式不兼容

Cursor 和 Cline 都基于 OpenAI 的 API 协议设计，只能识别 /v1/chat/completions 这类标准接口。但国产厂商的 API 各自为政：

DeepSeek 使用自己的请求结构
通义千问通过阿里云百炼提供服务
智谱 GLM 有独立的路径和参数命名

这意味着你不能简单地把 https://api.deepseek.com 填进 Cursor 的设置里就指望它能工作——协议对不上，请求会直接失败。

解决办法是引入一个中间层：API 聚合网关。

方案一：用 API 网关统一转换（推荐）

什么是 API 网关？

你可以把它理解成一个“翻译官”。Cursor 或 Cline 只需向网关发送标准 OpenAI 格式的请求，网关再根据目标模型自动转换成对应厂商的协议，并将响应转回 OpenAI 格式返回。

这样一来，前端工具完全无感，后端却能灵活切换任意支持的模型。

部署 One API 网关

目前最成熟的开源方案是 One API。部署非常简单：

# 下载最新版二进制（Linux 示例）
wget https://github.com/songquanpeng/one-api/releases/latest/download/one-api-linux-amd64.tar.gz
tar -xzf one-api-linux-amd64.tar.gz
chmod +x one-api

# 启动服务，默认端口 3000
./one-api --port 3000

首次运行会自动创建 SQLite 数据库。访问 http://你的服务器IP:3000，用默认账号 root / 123456 登录，务必立即修改密码。

添加国产模型渠道

在网关后台的「渠道」页面，依次添加以下模型：

DeepSeek V4

渠道类型：DeepSeek (type=36)
Base URL：https://api.deepseek.com
模型名：deepseek-chat（Pro 版）或 deepseek-v4-flash
API Key：从 DeepSeek 开放平台获取

通义千问

渠道类型：阿里云百炼 (type=17)
Base URL：https://dashscope.aliyuncs.com/compatible-mode/v1
模型名：qwen-plus 或 qwen-max
API Key：在阿里云百炼控制台的 API Key 管理中创建

智谱 GLM

渠道类型：智谱 GLM (type=16)
Base URL：https://open.bigmodel.cn/api/paas/v4
模型名：glm-4-plus、glm-4-air 或免费的 glm-4-flash
API Key：从智谱开放平台获取

注意：每个渠道的“模型名”必须与后续客户端调用时指定的名称一致。

配置 HTTPS（必须）

Cursor 和 Cline 强制要求 API 地址使用 HTTPS。即使你在本地测试，也建议配好证书，避免后续迁移麻烦。

使用 Nginx 反向代理并申请免费证书：

server {
    listen 443 ssl;
    server_name api.yourdomain.com;

    ssl_certificate     /path/to/fullchain.pem;
    ssl_certificate_key /path/to/privkey.pem;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_http_version 1.1;
        proxy_set_header Upgrade $http_upgrade;
        proxy_set_header Connection "upgrade";
    }
}

推荐用 acme.sh 工具自动申请 Let's Encrypt 证书，支持全自动续期。

方案二：直连 OpenAI 兼容地址（快速尝鲜）

部分厂商已提供原生 OpenAI 兼容接口，可跳过网关直接使用：

厂商	兼容地址	备注
DeepSeek	`https://api.deepseek.com/v1`	官方原生支持
硅基流动	`https://api.siliconflow.cn/v1`	支持多模型
通义千问	`https://dashscope.aliyuncs.com/compatible-mode/v1`	阿里云百炼兼容模式

这种方式适合只想试用单一模型的用户。但缺点也很明显：无法同时使用多个模型，也没有故障转移能力——一旦该 API 出问题，整个工具就瘫痪了。

在 Cursor 中配置国产模型

打开 Cursor → Settings → Models：

关闭 “Use OpenAI API” 或 “Use Cursor AI”
选择 “Custom API provider”
填写以下信息：
- API Provider: OpenAI Compatible
- Base URL: https://api.yourdomain.com/v1（你的网关地址）
- API Key: 在网关「令牌」页面创建的 Token（不是厂商 Key！）
- Model ID: 如 deepseek-chat

常见错误排查

Base URL 末尾不要多加 /v1，否则会变成 /v1/v1/...
Model ID 必须与网关中渠道配置的模型名完全一致
首次配置后建议重启 Cursor，确保缓存刷新

模型选型建议

日常补全：deepseek-v4-flash —— 快、便宜、够用
复杂重构/Debug：deepseek-chat 或 qwen-max —— 推理强、上下文长
免费体验：glm-4-flash —— 完全免费，适合轻量任务

在 Cline 中配置国产模型

Cline（VS Code 插件或独立应用）同样支持 OpenAI Compatible 模式：

API Provider: OpenAI Compatible
Base URL: https://api.yourdomain.com/v1
API Key: 网关生成的 Token
Model: deepseek-chat
Max Tokens: 8192（根据模型调整）
Temperature: 0.1（编程任务推荐低随机性）
Context Window: 128000（视模型支持情况）

Cline 特有注意事项

必须使用新版 One API（≥ v0.6.0），旧版本对流式响应（streaming）处理有 bug，会导致输出重复或错乱
单次对话消耗较大，建议为 Cline 专用 Token 设置较高额度（如 500 万 tokens/月）
超时时间：Cline 默认 60 秒，若使用 DeepSeek Pro 处理长上下文，可在网关层将超时延长至 120 秒

进阶：多渠道自动容灾

网关的最大价值在于多渠道冗余。例如，你可以为 deepseek-chat 同时配置三个渠道：

DeepSeek 官方（优先级 1）
硅基流动（优先级 2）
API2D 中转（优先级 3）

当官方 API 出现 5xx 错误或超时时，网关会自动降级到下一个可用渠道，整个过程对 Cursor/Cline 透明。开发者完全感知不到后端切换，体验零中断。

配置方法：在 One API 后台为同一模型名添加多个渠道，并设置不同权重或优先级即可。

安全建议

保护管理后台：不要将网关管理界面暴露在公网，建议加 HTTP Basic Auth 或 IP 白名单
最小权限 Token：给客户端使用的 Token 只开放必要模型，禁止访问管理接口
设置用量上限：防止 API Key 泄露后被恶意刷量
开启日志监控：关注 429（限流）和 500（服务错误）等异常状态，及时处理

结语

通过 API 网关接入国产大模型，不仅解决了协议兼容问题，还带来了低延迟、低成本和高可用性。花 10 分钟搭好 One API，你就能在 Cursor 和 Cline 中自由切换 DeepSeek、通义千问、GLM 等 50+ 模型，彻底告别翻墙和高昂账单。2026 年，国产模型已经准备好成为你日常编码的主力助手。