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)。給不同工具用不同令牌,還能分別統計用量與設定額度上限。
為什麼推薦統一走閘道而不是每工具直連各服務商?
三個理由:金鑰集中管理(洩露面收窄)、統一計費與用量可視(不用在多個平台對帳)、模型可隨時替換(供應商解耦,切換只改閘道配置)。