← 幫助中心 · 通用網關

用 magpie 一次接進所有 Agent

magpie 是一個跑在你本機的網關，能在 OpenAI、Anthropic、Gemini 三種協議之間互轉。 用它接我們，只需要點一個鏈接 —— 之後 Claude Code、Codex、Pi、OpenCode、Cursor 等工具裏都會出現我們的模型。

這條路適合誰？ 手裏已經在用多個 Agent、願意裝一個本地網關的人。
如果你只是想用 AI 聊天、不折騰工具，直接用我們的命令行客戶端就行 —— 那個不用裝網關。

1. 一鍵接入（推薦）

點下面的按鈕。magpie 會彈出一個確認窗，**列出「提示詞和密鑰將發往哪裏」**，你點確認之後纔會添加 —— 在你點之前，什麼都不會保存。

Add to magpie

這個鏈接不含密鑰，所以可以公開分享。添加時 magpie 會讓你自己粘貼密鑰。

2. 手動添加（等價的做法）

不想用鏈接的話，在 magpie 裏手動加一個自定義供應商：

填什麼	值
名稱	`Newcclm`
OpenAI 兼容地址	`https://sccclm.com/v1`
Anthropic 兼容地址	留空（我們不提供 Anthropic 協議）
密鑰	你的 `sk-*`
模型	`newcclm`、`newcclm-fast`、`newcclm-coding`、`newcclm-free`

或者用命令行：

magpie import 'magpie://import?name=Newcclm&chat=https://sccclm.com/v1&models=newcclm,newcclm-fast,newcclm-coding,newcclm-free'

3. 添加後會怎樣

我們的模型會出現在每個 Agent 的模型選擇列表裏，寫作 newcclm/newcclm-fast （供应商id/模型名 的格式）。你可以：

單獨給某個 Agent 指定我們的模型
用 路由組 把我們的模型和別家同名模型合成一個（比如你既想用我們的、也想留一個官方帳號兜底）
用規則把某類對話（長上下文、壓縮上下文、某個項目目錄）優先發給我們
在 magpie 的「用量」頁看到經過它的 token 和費用

會話級生效。magpie 是把配置寫進 Agent 自己的設定檔（settings.json / config.toml 等）， 已經在跑的會話不會變 —— 開一個新會話才生效。

4. 不要這樣配

Anthropic 地址欄不要填我們的地址

我們只提供 OpenAI 兼容協議。把 https://sccclm.com/v1 填進 Anthropic 那一欄會連不上。留空即可 —— magpie 會自動做協議轉換。

OpenAI 地址必須帶 /v1

# 错误
https://sccclm.com

# 正确
https://sccclm.com/v1

不要填真實模型名

# 错误 —— 我们只认自己的档位名
gpt-4o
glm-5.3-flash

# 正确
newcclm
newcclm-fast
newcclm-coding
newcclm-free

不要把帶密鑰的導入鏈接放到公開頁面

這個頁面上的按鈕是不含密鑰的版本，可以公開。如果你要生成帶密鑰的版本，只放在「剛給某個用戶發完密鑰」那個頁面上 —— 密鑰在鏈接裏等於明文。

5. 測一下

先單獨確認我們的接口是通的，再看 magpie 的配置：

curl https://sccclm.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"newcclm-fast","messages":[{"role":"user","content":"你好"}]}'

Agent 報 502 / 連不上，但 magpie 的路由頁什麼都沒有

這是 magpie 文檔裏專門提到的一個坑：代理軟體把 127.0.0.1:3425 的請求接走轉去別處了，請求根本沒到 magpie。

只在「繞過列表」裏寫 127.0.0.1 不一定夠（Codex 這類 Agent 照樣會走代理）。在代理軟體里加兩條本地直連規則，放在其他規則前面：

# Surge
IP-CIDR,127.0.0.0/8,DIRECT,no-resolve
IP-CIDR6,::1/128,DIRECT,no-resolve

# Clash / mihomo 的 rules: 下
- IP-CIDR,127.0.0.0/8,DIRECT,no-resolve
- IP-CIDR6,::1/128,DIRECT,no-resolve

6. 怎麼撤銷

在 magpie 的模型選擇裏選回 Agent 自帶的模型，或者運行：

magpie claude default
magpie codex default

magpie 會刪掉它寫入的內容，並把你被替換過的值（比如原來的 ANTHROPIC_BASE_URL）恢復回去。

還是不行？

1. magpie 的「路由」页截图（看请求有没有到网关）
2. 上面那条 curl 的输出
3. 你用哪个 Agent、什么版本的 magpie

← 返回幫助中心 · DeepSeek Harness 配置 →