Skip to Content
aicentos
客户端接入

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_URLhttps://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 不代你登录。

相关链接