# Paseo

出典: https://docs.aicentos.com/ja/clients/paseo

Language: ja

> Paseo で aicentos に接続する —— モデルに直結せず、下層の CLI か provider の env で設定します

Paseo はオーケストレーション層です。デスクトップ版、モバイル版、Web、`paseo` CLI が揃っていますが、**それ自体は agent を内蔵しておらず**、すでにインストールしてログイン済みのコーディング CLI（Claude Code、Codex、OpenCode、Pi など）を実行する役割だけを担います。したがって「Paseo で aicentos に接続する」とは、実際にはホストされる側の CLI を aicentos に向けることを意味します。

## 準備

まず Paseo をインストールし、下層の CLI を少なくとも 1 つ用意します：

```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`  | コンソールで作成したキー           |
| `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 に保存済みのログイン状態を上書きするため、設定を誤ると元々使えていたセッションも失敗します。デフォルトの 1 件を書き換えるのではなく、新しい provider を追加することをおすすめします。
* 先に下層 CLI の認証を済ませておく必要があります。Paseo が代わりにログインすることはありません。

## 関連リンク

* [Paseo カスタム provider ドキュメント](https://paseo.sh/docs/custom-providers)
* [paseo リポジトリ](https://github.com/getpaseo/paseo)