goose

Settings → Models → Configure providers → OpenAI: Host URLにはベアオリジンを入力します。goose自身がリクエストパス（v1/chat/completions）を付加するためです。

# goose Desktop → Settings → Models → Configure providers → OpenAI
API Key           sk-kn-...
Host URL          https://api.kunavo.com
Organization ID   (leave blank)
Project           (leave blank)

# …or as environment variables, which goose CLI reads too:
OPENAI_API_KEY=sk-kn-...
OPENAI_HOST=https://api.kunavo.com

# OPENAI_BASE_PATH is left unset on purpose. Its default is
# v1/chat/completions, which is the path Kunavo serves — that default is
# exactly why Host URL above carries no /v1.

手順

1. /app/keys でキーを作成してコピーします。キーは一度だけ表示されます。
2. goose Desktopの場合：サイドバー → 設定 → モデル → プロバイダーを設定 → OpenAI。CLIの場合：goose configure → プロバイダーを設定 → OpenAI。
3. API KeyとHost URLを入力します。Organization IDとProjectは空欄のままにします。gooseのドキュメントでは、これらはOpenAIのアカウントで利用状況の追跡やリソース管理に使うものとされており、Kunavoには入力する同等の値がありません。［Submit］をクリックします。
4. モデルを選択します。gooseの注記では、goose configureは「カスタムモデル名の入力に対応していない」と明記されています。表示されたリストに使いたいIDがない場合は、goose Desktopで入力するか、config.yaml内でGOOSE_MODELを設定してください。後者はそのプロセスに対してファイルの設定を上書きします。
5. セッションを開始し、ファイルを操作するタスクを与えてください。gooseはほぼすべての処理でツール呼び出しを利用します。プロバイダーページでも、ツール呼び出しに対応しないモデルは「チャット補完しかできず」、拡張機能を無効にする必要があると説明されています。そのため、最初にファイルを読み書きさせると、挨拶させるより多くのことを確認できます。

gooseのConfigure LLM Providerページで2026年9月29日に確認しました。サードパーティの設定は変更されます。ここに記載されたフィールド名が表示内容と一致しなくなった場合は、このページではなく、そのページを正しい情報源としてください。

クライアントをデバッグする前に確認すること

1回のリクエストで、失敗の原因がエンドポイント、キー、設定ファイルのどれかを特定できます。これがJSONを返すなら、同じベースURLとキーがgooseで機能します。

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

フィールドに入力するモデルID

すべてのテキストモデルにはモデルIDでアクセスできます。現在の一覧はGET /v1/models、価格付きのカタログはモデルページにあります。料金は100万トークンあたりのUSDで、入力 / 出力の順です。

もう1つの方法：Kunavoのプロバイダーファイル

gooseはcustom_providersディレクトリ内のJSONファイルからもプロバイダー定義を読み込みます。この方法でプロバイダーを追加すると、OpenAIという項目を流用せず、プロバイダー選択画面に専用の項目が追加され、独自のキーと保存済みモデル一覧を使えます。Kunavoはkunavo.com/goose/kunavo.jsonでファイルを公開しています。最新のカタログから生成されるため、モデル一覧にはKunavoが現在提供しているモデルが記載され、キーではなくキー用の環境変数名が含まれています。

# macOS / Linux — goose reads every JSON file in this directory
mkdir -p ~/.config/goose/custom_providers
curl -fsSL https://kunavo.com/goose/kunavo.json \
  -o ~/.config/goose/custom_providers/kunavo.json

# The file names the variable; the key itself never goes in the file
export KUNAVO_API_KEY=sk-kn-...
goose session start --provider kunavo

Windowsではディレクトリは%APPDATA%\Block\goose\config\custom_providers\です。goose Desktopでは、プロバイダーがConfigure providersの下にKunavoとして表示されます。キーは環境変数の代わりにキーチェーンへ保存できます。

1. エンドポイント。 このファイルではbase_urlにhttps://api.kunavo.com/v1を設定しています。gooseのドキュメントでは、このフィールドに/v1のベースURLを指定するのか、例にある完全な/v1/chat/completionsを指定するのかが説明されていません。ソースコードで確認すると、derive_base_pathはいずれも同じv1/chat/completionsパスに変換されます。
2. GPTのIDはResponses APIを使います。 gooseはgpt-5またはgpt-6で始まるモデルIDを/v1/responsesに、それ以外を/v1/chat/completionsに送ります。Kunavoは両方に対応しているため、このファイル内のClaudeとGPTのIDを1つのキーで利用できます。
3. ツール呼び出しに対応したモデルのみを掲載しています。 gooseはほぼすべてのターンでツールに依存するため、同じキーで呼び出せる画像、動画、音声モデルも、このファイルには含めていません。

このページのほかの部分と同じ注意事項が当てはまります。これはgooseのドキュメントとソースから読み取った内容であり、実行して確認したものではありません。プロバイダーを手動で設定したい場合は、プロバイダーを設定 → カスタムプロバイダーを追加でも同じ項目を入力します。タイプはOpenAI Compatible、API URLはhttps://api.kunavo.com/v1、ご自身のsk-kn-キー、そしてカンマ区切りのモデル一覧です。