国产模型接入教程
Pi · 模型接入

选择模型供应商

下方展示当前供应商的完整配置,切换后查看对应方案。

配置实操 / macOS · Linux · Windows

Pi 接入通义千问

在终端中选择供应商与模型,使用自定义入口连接百炼。

5 个步骤约 9 分钟文档核对 2026-10-29
开始第一步
接入配置示意OpenAI Compatible
Pi通义千问
MODEL
当前方案支持的千问 Model ID
BASE URL
按百炼所用地域与方案选择兼容入口
AUTH
对应方案的百炼 API Key
已安装客户端 模型权限与额度 原配置已备份

配置速查

接口与凭据必须对应同一方案
配置项填写内容注意
客户端Pi CLI不是 VS Code 插件
模型选择/model使用当前账号可用的模型
自定义入口~/.pi/agent/models.json地址、协议、Key 与模型须匹配
01

安装 Pi

使用 Pi 官方安装方式,或运行以下 npm 命令。安装后执行 pi --version。

按官方文档核对,未使用付费 Key 做端到端实测。先在测试项目运行,再核对供应商控制台用量;聊天成功不代表工具调用和全部联网功能都可用。

终端
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
pi --version
02

先检查内置供应商

启动 pi,使用 /login 查看可用供应商,再用 /model 选择模型。若内置入口适合你的百炼方案,优先使用内置连接。套餐与按量入口不能混用。

03

自定义百炼入口

内置列表不包含所需入口时,备份 ~/.pi/agent/models.json,再按官方 Custom Models 文档添加供应商。baseUrl 填百炼对应方案地址,api 选择 openai-completions,models 中的 id 从当前方案支持列表复制。

凭据通过官方认证方式或环境变量提供。不同版本的配置字段可能变化,参考下方官方文档,不把真实 Key 提交到仓库。

04

选择模型并验证

重新启动 Pi,通过 /model 选择刚配置的供应商和模型。在测试目录核对下面任务的文件引用,并到百炼控制台检查用量。

复制到 Pi
请只读当前项目:说明启动命令、入口文件和测试命令,每条结论引用实际文件路径;找不到就写未找到。不要修改文件,也不要安装依赖。
05

排错和恢复

401 先检查认证,404 检查入口和协议,模型不出现则检查配置语法与客户端版本。恢复时还原备份,并用 /logout 移除不再使用的供应商凭据。

TROUBLESHOOTING

卡在哪一步?按错误定位。

401 / 403

凭据、套餐或模型权限不匹配

检查 Key 来源、地域和套餐;检查当前进程是否读取了旧认证。

404

地址或 API 协议不匹配

使用本文对应协议的 Base URL,不手工追加请求路径。

429

额度或调用频率限制

到供应商控制台核对余额、套餐与限流,降低并发后重试。

工具调用失败

文件权限、客户端版本或模型兼容性问题

先确认工作目录,验证一次只读文件任务,再增加其他能力。

完成前,确认这四项

  • 客户端版本可用,原配置已备份
  • 接口地址、Key 和模型属于同一产品方案
  • 只读任务引用了真实文件,并已核对调用用量
  • 没有提交真实 Key,能够还原原配置

官方参考来源

配置依据以下资料整理,验证任务与排查顺序为本站编辑建议。模型和客户端更新后,请重新核对接口与支持范围。

01https://github.com/earendil-works/pi/blob/main/packages/coding-agent/README.md02https://github.com/earendil-works/pi/blob/main/packages/coding-agent/docs/models.md03https://help.aliyun.com/en/model-studio/base-url
查看其他工具的接入方式