← 幫助中心 · 桌面 / 終端

用 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 · newcclm-fast · newcclm-coding · newcclm-free

2. 寫入配置

Pi 的供應商寫在它的 models.json 裏（在 Pi 的配置目錄下）：

{
  "providers": {
    "newcclm": {
      "type": "openai-compatible",
      "baseURL": "https://sccclm.com/v1",
      "apiKeyEnv": "NEWCCLM_API_KEY",
      "models": [
        { "id": "newcclm",        "name": "Newcclm 日常" },
        { "id": "newcclm-fast",   "name": "Newcclm 快速" },
        { "id": "newcclm-coding", "name": "Newcclm 增强" },
        { "id": "newcclm-free",   "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
newcclm-fast
newcclm-coding
newcclm-free

不要把密鑰寫進設定檔明文

上面用的是 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 接入 →