← 帮助中心 · 通用网关

用 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-fast`、`newcclm-coding`

或者用命令行：

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

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-fast
newcclm-coding

不要把带密钥的导入链接放到公开页面

这个页面上的按钮是不含密钥的版本，可以公开。如果你要生成带密钥的版本，只放在「刚给某个用户发完密钥」那个页面上 —— 密钥在链接里等于明文。

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 配置 →