# Paseo

来源: https://docs.aicentos.com/clients/paseo

Language: zh-CN

> 在 Paseo 里接入 aicentos —— 它不直连模型，要在底层 CLI 或 provider env 里配

Paseo 是编排层：桌面端、移动端、Web 和 `paseo` CLI 都在，但**它自己不带 agent**，只负责运行你已安装并登录好的编码 CLI（Claude Code、Codex、OpenCode、Pi 等）。所以「在 Paseo 里接入 aicentos」实际上是让被托管的那个 CLI 走 aicentos。

## 准备工作

先装 Paseo，并至少准备一个底层 CLI：

```bash
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`：

```json
{
  "agents": {
    "providers": {
      "aicentos-claude": {
        "extends": "claude",
        "label": "aicentos",
        "env": {
          "ANTHROPIC_BASE_URL": "https://aicentos.com",
          "ANTHROPIC_API_KEY": "sk-你的-API-Key"
        }
      }
    }
  }
}
```

改完重载：

```bash
paseo reload
```

然后在 Paseo 里把会话的 provider 选成 `aicentos`。

如果你托管的是 OpenAI 协议的 CLI（例如 Codex），把 `env` 换成对应 CLI 自己的变量（`OPENAI_BASE_URL`、`OPENAI_API_KEY`），Base URL 用 `https://aicentos.com/v1`。

## 测试

```bash
paseo run --provider aicentos-claude "用一句话自我介绍"
```

能返回即通。也可以直接在桌面端新建会话、看模型标签是否显示你配的 provider。

## 注意事项

* **Paseo 本身没有模型配置**。找不到 Base URL 输入框是正常的，去底层 CLI 或 `env` 里找。
* 官方文档只给了 Anthropic 兼容的字段示例，OpenAI 兼容端点的写法没有明文规定，按底层 CLI 的变量名来写、以实测为准。
* `env` 会覆盖底层 CLI 已保存的登录态，配错会导致原本能用的会话也失败，建议新开一个 provider 而不是改默认那条。
* 必须先完成底层 CLI 的认证，Paseo 不代你登录。

## 相关链接

* [Paseo 自定义 provider 文档](https://paseo.sh/docs/custom-providers)
* [paseo 仓库](https://github.com/getpaseo/paseo)