Cursor / Claude Code / Cherry Studio 接入自定义 AI 网关指南

工具接入 · 2026-11-20 · 约 7 分钟读完

主流 AI 工具都支持自定义 API——这意味着你可以把它们指向自己的网关(如 4-4 AI),统一用一套密钥和计费。本文覆盖三个最常用工具的配置方法,以及通用的报错排查思路。

前置条件:你已有一个 API 密钥。还没有的话,先看《5 分钟接入统一 AI API》完成注册和建钥。本文以 4-4 AI 的 Base URL(https://www.4-4.vip/v1)为例,其他 OpenAI 兼容网关同理。

Cursor

Cursor 的对话模型可以走自定义 OpenAI 兼容接口:

  1. 打开 Settings → Models(或 Models 设置页);
  2. 在 OpenAI API Key 区域展开配置:填入网关密钥(sk-...);
  3. 勾选/填写 Override OpenAI Base URL:https://www.4-4.vip/v1;
  4. 在模型列表中添加你在网关里可用的模型名(与网关渠道名称完全一致,区分大小写);
  5. 点击 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 兼容服务商的支持最直接:

  1. 设置 → 模型服务,添加/选择一个 OpenAI 兼容提供商;
  2. API 地址填 https://www.4-4.vip/v1(部分版本会自动补全 /v1,注意不要重复);
  3. API 密钥填网关密钥;
  4. 在模型管理中手动添加可用模型名,保存后在对话中选择。

通用规律:任何 OpenAI 兼容工具

市面上大量工具(LobeChat、Open WebUI、沉浸式翻译、各类 IDE 插件)的配置套路一致,记住三件套:

配置项值常见坑
Base URLhttps://www.4-4.vip/v1有的工具要带 /v1,有的不要——报 404 时先试加/去掉 /v1
API Key网关密钥(sk-...)前后空格、密钥过期、额度用尽
模型名网关渠道中的名称必须与网关侧完全一致,不能用工具预设里不存在的名字

报错排查手册(速查)

401 Unauthorized

404 Not Found

400 Model Not Found / 无可用渠道

流式输出中断 / 无响应

常见问题(FAQ)

接入网关后数据安全吗?

你的请求会经过网关转发到上游模型渠道。选择网关时确认其日志与隐私策略;对敏感数据,在网关侧关闭对话日志存储或使用支持数据不落盘的渠道。

一个工具能同时配多个网关吗?

多数工具支持多服务商配置并随时切换(如 Cherry Studio、Cursor)。给不同工具用不同令牌,还能分别统计用量与设置额度上限。

为什么推荐统一走网关而不是每工具直连各服务商?

三个理由:密钥集中管理(泄露面收窄)、统一计费与用量可视(不用在多个平台对账)、模型可随时替换(供应商解耦,切换只改网关配置)。

相关文章

4-4 AI 快速开始:5 分钟接入统一 AI API OpenAI 兼容接口,一把密钥接入 GLM、DeepSeek、Qwen 等主流大模型。三语言可运行示例。 AI 应用 Token 成本优化的 7 个工程实践 模型分级路由、上下文裁剪、缓存、监控——7 个可落地的降本实践,附代码示例。
准备好接入了吗?

一把密钥统一接入 GLM、DeepSeek、Qwen 等主流模型,统一计费、用量可视化。

查看模型与定价 注册体验