Piでonomeoを使う設定方法

Piは、ターミナルで動く小型のコーディングエージェントで、追加のプロバイダーを1つのファイルから読み込みます。下の4つの手順で、このサイトをそのファイルに書き込むと、このサイトのモデルを使えます。

ターミナル向けの軽量コーディングエージェント。

入力する内容

OpenAI互換

OpenAI互換のツールには、次の情報を設定してください。

ベースURL

https://onomeo.com/v1

APIキー

モデル

APIキーをまだお持ちでない場合は、マイページで作成してからこのページに戻ってください。下の欄には自動で入力されます。マイページへ

手順

1
Piをインストールする
Windowsの場合は、Windowsキーを押してPowerShellと入力し、Enterキーを押します。macOSの場合は、ターミナルを開きます。下の1行を貼り付けて、Enterキーを押します。
```
npm install -g --ignore-scripts @earendil-works/pi-coding-agent
```
PiにはNode.js 22.19以降が必要です。npmが見つからない場合は、先にnodejs.orgからNode.js（LTS版）をインストールし、PowerShellを閉じて開き直してください。
2
設定を保存する
「コピー」を押し、コマンドを同じウィンドウに貼り付けて、Enterキーを押します。本サイトのアドレス、APIキー、モデルautoがPiのmodels.jsonに書き込まれます。
```
$f = "$HOME\.pi\agent\models.json"
if (-not (Test-Path $f)) {
New-Item -ItemType Directory -Force -Path (Split-Path $f) | Out-Null
[IO.File]::WriteAllText($f, @'
{
  "providers": {
    "onomeo": {
      "baseUrl": "https://onomeo.com/v1",
      "api": "openai-completions",
      "apiKey": "YOUR_API_KEY",
      "models": [
        { "id": "auto" }
      ]
    }
  }
}
'@)
Write-Host "Saved: $f" -ForegroundColor Green
} else { Write-Host "Config file already exists, left unchanged: $f" -ForegroundColor Yellow }
```
コマンド内の YOUR_API_KEY をご自分のAPIキーに置き換えてください。このブラウザでAPIキーを作成すると、ここに自動で入力されます。
ファイルが書き込まれると、最終行に緑色でSavedと表示されます。代わりに黄色の「Config file already exists, left unchanged」と表示された場合は、このコンピューターのPiにすでにカスタムモデルがあります。表示されたファイルを開き、「providers」の下に「onomeo」の部分を手動で追加してください。
3
Piを起動してモデルを確認する
先にプロジェクトのフォルダーへ移動します（例：cd D:\my-projectと入力してEnterキーを押します）。その後、下の1行を実行します。続けて/modelと入力してEnterキーを押すと、一覧にauto [onomeo]が表示されます。Enterキーを押して選びます。
```
pi
```
auto [onomeo]が本サイトです。使用中のモデルは右下に表示されます。
タスクを頼む
やってほしいことを入力し、Enterキーを押します。Piはそのフォルダー内のファイルを自分で読み書きします。
hello.pyの作成を頼んだ例です。ファイルを書き込み、その旨を報告しました。
1ステップは1回の呼び出しとして数えられ、長いステップは長さに応じて複数回として数えられます。2026年10月9日にPi 1.1.0で計測したところ、上記のタスクはautoで2回の呼び出しとなり、課金されませんでした。

接続できない場合

baseUrl の末尾の /v1 はそのままにして、その後ろには何も追加しないでください。/chat/completions はPiが自動で付けます。
モデルページにある別のモデルを追加するには、ファイルの "models" の一覧に { "id": "名前" } をもう1つ追加します。/model は開くたびにファイルを読み込み直します。
コーディングでは、リクエストのたびにファイル全体が送信されます。無料モデルでは課金されませんが、長いリクエストは複数回として数えられます。Claude、GPTなどの大型モデルは利用量に応じて課金され、残高の減りが早くなります。
401：APIキーが正しくありません。~/.pi/agent/models.json の "apiKey" を修正してください。402：残高が不足しています。Claude、GPTなどの大型モデルは利用量に応じて課金されます。料金ページでチャージするか、無料モデルに切り替えてください。
マイページの「マイプロバイダー」でご自分のプロバイダーのAPIキーを接続すると、"models" の一覧に { "id": "my/<プロバイダー>/<モデル>" } を追加して、ご自分の利用枠で回答させることができます。他の設定は変わらず、これらの利用にこのサイトでの課金は発生しません。

Piの公式ドキュメント

入力する内容

OpenAI互換

手順

Piをインストールする

設定を保存する

Piを起動してモデルを確認する

タスクを頼む

接続できない場合