客户端接入
Paseo
在 Paseo 里接入 aicentos —— 它不直连模型,要在底层 CLI 或 provider env 里配
最后更新于:
Paseo 是编排层:桌面端、移动端、Web 和 paseo CLI 都在,但它自己不带 agent,只负责运行你已安装并登录好的编码 CLI(Claude Code、Codex、OpenCode、Pi 等)。所以「在 Paseo 里接入 aicentos」实际上是让被托管的那个 CLI 走 aicentos。
准备工作
先装 Paseo,并至少准备一个底层 CLI:
npm install -g @getpaseo/cli
paseo桌面端与移动端从官网下载。注意 Docker 镜像不含任何 agent CLI,容器部署要自己装。
需要填写的配置
Paseo 的 provider 定义在 ~/.paseo/config.json 的 agents.providers.<id>,字段是 extends、label、env、models。它支持的是给底层 CLI 注入环境变量,官方示例都是 Anthropic 兼容协议:
| 字段 | 值 |
|---|---|
extends | 底层 CLI,例如 claude |
env.ANTHROPIC_BASE_URL | https://aicentos.com |
env.ANTHROPIC_API_KEY | 控制台创建的 Key |
models | 控制台「模型广场」中的模型名 |
配置步骤
编辑 ~/.paseo/config.json:
{
"agents": {
"providers": {
"aicentos-claude": {
"extends": "claude",
"label": "aicentos",
"env": {
"ANTHROPIC_BASE_URL": "https://aicentos.com",
"ANTHROPIC_API_KEY": "sk-你的-API-Key"
}
}
}
}
}改完重载:
paseo reload然后在 Paseo 里把会话的 provider 选成 aicentos。
如果你托管的是 OpenAI 协议的 CLI(例如 Codex),把 env 换成对应 CLI 自己的变量(OPENAI_BASE_URL、OPENAI_API_KEY),Base URL 用 https://aicentos.com/v1。
测试
paseo run --provider aicentos-claude "用一句话自我介绍"能返回即通。也可以直接在桌面端新建会话、看模型标签是否显示你配的 provider。
注意事项
- Paseo 本身没有模型配置。找不到 Base URL 输入框是正常的,去底层 CLI 或
env里找。 - 官方文档只给了 Anthropic 兼容的字段示例,OpenAI 兼容端点的写法没有明文规定,按底层 CLI 的变量名来写、以实测为准。
env会覆盖底层 CLI 已保存的登录态,配错会导致原本能用的会话也失败,建议新开一个 provider 而不是改默认那条。- 必须先完成底层 CLI 的认证,Paseo 不代你登录。