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 手把手教學:註冊 4-4 AI、建立 API 金鑰、使用 OpenAI 相容 Base URL 在 Python / Node.js / cURL 中統一接入 GLM、DeepSeek、Qwen 等大模型,含串流輸出與常 AI 應用 Token 成本優化的 7 個工程實務 從模型分級路由、上下文裁剪、提示詞快取到呼叫監控:7 個可直接落地的工程實務,系統性降低 AI 應用的 Token 成本,附程式碼範例。
準備好接入了嗎?

一把密鑰統一接入 GLM、DeepSeek、Qwen 等主流模型,統一計費、用量可視化。

查看模型與定價 註冊體驗