← 帮助中心 · 桌面 / 终端

用 Pi 连接 Newcclm

Pi 是一个开源的终端编码 Agent（@earendil-works/pi-coding-agent）。它支持自定义 OpenAI 兼容供应商，加一条配置就能用上我们的档位。

两条路，选一条就行：
· 用 magpie 管理 —— 点一个链接就配好，还能同时管别的 Agent → magpie 接入
· 直接配 Pi —— 就是下面这份说明

1. 添加自定义供应商

在 Pi 的配置里加一个 provider 条目：

填这几个值

Provider IDnewcclm

Base URLhttps://sccclm.com/v1

协议OpenAI 兼容

模型newcclm-fast · newcclm-coding

2. 写入配置

Pi 的供应商写在它的 models.json 里（在 Pi 的配置目录下）：

{
  "providers": {
    "newcclm": {
      "type": "openai-compatible",
      "baseURL": "https://sccclm.com/v1",
      "apiKeyEnv": "NEWCCLM_API_KEY",
      "models": [
        { "id": "newcclm-fast",   "name": "Newcclm 快速" },
        { "id": "newcclm-coding", "name": "Newcclm 增强" }
      ],
      "compat": {
        "maxTokensField": "max_tokens"
      }
    }
  }
}

字段名可能随 Pi 版本变化。 上面用的是通用写法。如果你的 Pi 版本报配置无效，看它自己的文档里「自定义供应商 / custom provider」那一节，或者直接在我们的 magpie 接入页里配 —— 那种方式不用手写这个文件。

3. 设置环境变量

export NEWCCLM_API_KEY="YOUR_API_KEY"

Windows 上用 set NEWCCLM_API_KEY=...，或写进系统环境变量。

4. 选择模型

在 Pi 里切换到我们的档位。具体命令看 Pi 自己的帮助（/model 或启动参数）。

模型名	什么时候用
`newcclm-coding`	编码建议用这个 —— 针对长文件和工具调用调过
`newcclm-fast`	快速任务、批量处理

5. 不要这样配

Base URL 不要漏 /v1，也不要叠加

# 错误
https://sccclm.com
https://sccclm.com/v1/v1
https://sccclm.com/v1/chat/completions

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

不要选 Anthropic 协议

Pi 支持多协议，但我们只提供 OpenAI 兼容。选 Anthropic 会连不上。

不要填真实模型名

# 错误
gpt-4o
glm-5.3-flash

# 正确
newcclm-fast
newcclm-coding

不要把密钥写进配置文件明文

上面用的是 apiKeyEnv（从环境变量读），比直接写在文件里安全。如果 Pi 的版本只支持明文写 key，记得那个文件不要提交到 git。

6. 测一下

配置前先用这条确认接口通不通：

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

还是不行？

1. 你的 Pi 版本号（pi --version）
2. 报的完整错误
3. 上面那条 curl 的输出

← 返回帮助中心 · magpie 接入 →