Cursor / Claude Code / Cherry Studio 接入自定义 AI 网关指南
主流 AI 工具都支持自定义 API——这意味着你可以把它们指向自己的网关(如 4-4 AI),统一用一套密钥和计费。本文覆盖三个最常用工具的配置方法,以及通用的报错排查思路。
前置条件:你已有一个 API 密钥。还没有的话,先看《5 分钟接入统一 AI API》完成注册和建钥。本文以 4-4 AI 的 Base URL(
https://www.4-4.vip/v1)为例,其他 OpenAI 兼容网关同理。Cursor
Cursor 的对话模型可以走自定义 OpenAI 兼容接口:
- 打开
Settings → Models(或Models设置页); - 在
OpenAI API Key区域展开配置:填入网关密钥(sk-...); - 勾选/填写
Override OpenAI Base URL:https://www.4-4.vip/v1; - 在模型列表中添加你在网关里可用的模型名(与网关渠道名称完全一致,区分大小写);
- 点击 Verify 验证通过后,在对话底部切换到自定义模型即可。
注意:Cursor 内置的 Tab 补全、Composer 部分功能走 Cursor 自有服务,不受此配置影响;自定义模型主要用于 Chat 对话场景。
Claude Code
Claude Code 使用 Anthropic 协议。接入网关的前提是网关支持 Anthropic 协议端点(/v1/messages)——基于 new-api 生态的网关(含 4-4 AI)支持该协议转换,Claude 协议的请求会被转换后路由到实际模型渠道。
通过环境变量配置(在启动 claude 的终端中):
export ANTHROPIC_BASE_URL="https://www.4-4.vip"
export ANTHROPIC_AUTH_TOKEN="sk-你的网关密钥"
# 启动
claude
Windows PowerShell 对应写法:
$env:ANTHROPIC_BASE_URL = "https://www.4-4.vip"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的网关密钥"
两个细节:① ANTHROPIC_BASE_URL 不带 /v1 后缀(Anthropic 协议路径由工具自动拼接);② 如果希望 Claude Code 使用非 Claude 系模型,需确认网关渠道已配置对应模型映射,模型名用网关侧的名称。
Cherry Studio
Cherry Studio 对自定义 OpenAI 兼容服务商的支持最直接:
设置 → 模型服务,添加/选择一个 OpenAI 兼容提供商;- API 地址填
https://www.4-4.vip/v1(部分版本会自动补全 /v1,注意不要重复); - API 密钥填网关密钥;
- 在模型管理中手动添加可用模型名,保存后在对话中选择。
通用规律:任何 OpenAI 兼容工具
市面上大量工具(LobeChat、Open WebUI、沉浸式翻译、各类 IDE 插件)的配置套路一致,记住三件套:
| 配置项 | 值 | 常见坑 |
|---|---|---|
| Base URL | https://www.4-4.vip/v1 | 有的工具要带 /v1,有的不要——报 404 时先试加/去掉 /v1 |
| API Key | 网关密钥(sk-...) | 前后空格、密钥过期、额度用尽 |
| 模型名 | 网关渠道中的名称 | 必须与网关侧完全一致,不能用工具预设里不存在的名字 |
报错排查手册(速查)
401 Unauthorized
- 密钥复制带了空格/换行 → 重新复制;
- 密钥被禁用或额度耗尽 → 到网关控制台令牌页检查;
- Authorization 头格式错误 → 必须是
Bearer sk-...。
404 Not Found
- Base URL 路径不对 → 在"带 /v1"与"不带 /v1"之间切换测试;
- 工具请求的协议端点网关不支持 → 确认网关是否支持该协议(OpenAI /v1/chat/completions 或 Anthropic /v1/messages)。
400 Model Not Found / 无可用渠道
- 模型名与网关渠道不一致 → 到控制台模型/渠道页核对名称;
- 渠道被禁用或分组无权限 → 检查令牌的模型范围与分组设置。
流式输出中断 / 无响应
- 公司代理缓冲了 SSE → 换直连网络测试;
- 工具超时设置过短 → 调大超时;长文本任务优先确认网关侧无强制超时。
常见问题(FAQ)
接入网关后数据安全吗?
你的请求会经过网关转发到上游模型渠道。选择网关时确认其日志与隐私策略;对敏感数据,在网关侧关闭对话日志存储或使用支持数据不落盘的渠道。
一个工具能同时配多个网关吗?
多数工具支持多服务商配置并随时切换(如 Cherry Studio、Cursor)。给不同工具用不同令牌,还能分别统计用量与设置额度上限。
为什么推荐统一走网关而不是每工具直连各服务商?
三个理由:密钥集中管理(泄露面收窄)、统一计费与用量可视(不用在多个平台对账)、模型可随时替换(供应商解耦,切换只改网关配置)。