goose のインストールとカスタム Provider の設定

goose はコンピューター上で動作する汎用 AI アシスタントです。コーディングだけでなく、検索、執筆、自動化、データ整理にも利用できます。デスクトップ版、ターミナル、またはインターフェースから使用でき、デスクトップ版とターミナル版では同じモデル設定を共有します。反復的なコーディング作業の処理に適しており、GitHub、データベース、ファイルにも接続できます。

インストール前の準備

goose には Desktop と CLI の2つのインストール方法があります。Desktop はウィンドウを備えたデスクトップ版で、CLI はターミナルにコマンドを入力して使用するバージョンです。どちらも Provider やモデルなどの基本設定を共有します。Provider は、「どのモデルサービスを使用するかを goose に伝える」接続設定と考えることができます。

ウィンドウが必要

goose Desktop

macOS では zip をダウンロード
または brew cask
Linux ではインストーラーを使用

ターミナルだけでよい

goose CLI

download_cli.sh
または Homebrew CLI
その後 goose session

Windows

まず環境を選ぶ

Git Bash または MSYS2
PowerShell も使用可能
コマンドが見つからなければ PATH に追加

macOS ではダウンロードまたは Homebrew を使用できます。Linux のデスクトップ版では、各ディストリビューション用のインストールパッケージを使用します。Windows では、まず案内されているターミナル環境を確認してください。

開始前に、現在のモデル一覧にあるモデル ID を用意してください。モデル ID は、モデルサービスが特定のモデルを識別するために使用する名前です。使用時には完全な文字列をコピーする必要があります。

インストールと初回起動

ウィンドウを使用する場合

macOS では、次の2つのインストール方法が案内されています。

インストールページからダウンロードします。ページには macOS Silicon 版と macOS Intel 版があります。ダウンロード後に zip を展開し、中にあるアプリケーションを実行します。
または Homebrew を使用します。

brew install --cask block-goose

同じアプリケーションがダウンロードされ、更新もあわせて管理できます。

Apple Mac M3 で、起動してもウィンドウが表示されない場合は、~/.config が読み書き可能か確認してください。goose はこのディレクトリにログを書き込みます。

Linux のデスクトップ版はインストールページからダウンロードします。DEB（Ubuntu/Debian）、RPM（RHEL/Fedora）、Flatpak が用意されています。Debian または Ubuntu では、DEB をダウンロードし、その保存先ディレクトリへ移動して sudo dpkg -i (filename).deb を実行した後、アプリケーションメニューから goose を開きます。(filename) は実際のファイル名に置き換えてください。

Windows のデスクトップ版はインストールページからダウンロードし、zip を展開して中にあるアプリケーションを実行します。

ターミナルだけを使用する場合

macOS と Linux では、次を実行します。

curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash

インストール中に対話形式の設定を行わない場合は、先頭に CONFIGURE=false を追加します。

curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash

macOS では、次のコマンドも使用できます。

brew install block-goose-cli

インストール済みの CLI を更新するには、次を使用します。

goose update

Windows では、次の3つの環境のいずれかが必要です。Git Bash（Git for Windows に付属し、推奨とされています）、MSYS2、または Windows 10/11 に付属する PowerShell です。Git Bash と MSYS2 では、上記と同じ download_cli.sh を使用します。PowerShell では、先にスクリプトをダウンロードしてから実行します。

Invoke-WebRequest -Uri "https://raw.githubusercontent.com/aaif-goose/goose/main/download_cli.ps1" -OutFile "download_cli.ps1"
.\download_cli.ps1

goose が PATH にないと表示された場合は、インストールページの案内に従って ~/.local/bin または %USERPROFILE%\.local\bin を現在のシェル設定に追加し、ターミナルを開き直してください。PATH は、ターミナルがプログラムの場所を検索するために使用するディレクトリの集合です。追加されていない場合、プログラムがインストール済みでも、名前を直接入力して実行できないことがあります。

2026-10-09 時点の CLI バージョンは 1.54.0 です。インストールスクリプトは、デフォルトでプログラムを ~/.local/bin に配置します。環境変数 GOOSE_BIN_DIR を使うと、このディレクトリを変更できます。変更した場合、スクリプトはシェル設定へ自動的に書き込まないため、そのディレクトリが PATH にないことを示すメッセージがターミナルに表示されます。そのディレクトリを PATH に追加するか、完全なパスを使って実行してください。

初回使用時に、goose から Provider の設定を求められます。組み込みのプロバイダー設定はひとまずスキップし、次のセクションに従ってカスタム Provider を追加できます。ターミナルで作業対象のディレクトリへ移動し、次を実行します。

goose session

OmniProxy から接続情報を取得する

自分の OmniProxy から、アドレス、キー、モデル名を用意します。カスタム Provider の公式例では base_url が /v1/chat/completions まで指定されているため、ここでも同じ形式を使用します。

API URL:  https://your-omniproxy-origin.example/v1/chat/completions
API Key:  <YOUR_OMNIPROXY_API_KEY>
Models:   OmniProxy の現在のモデル一覧からコピーし、複数ある場合は半角カンマで区切る

モデル名は OmniProxy の現在の一覧から完全な文字列をコピーし、スラッシュもそのまま残してください。2026-10-09 時点で、プロバイダーのドキュメントにある比較用の2つの ID は、Grok の grok-4.7 と OpenAI のドキュメントにある gpt-6-luna です。gpt-6-luna は Chat Completions をサポートします。Chat Completions での関数呼び出しは、reasoning_effort が none の場合にのみサポートされます。一覧にない名前は、そのままコピーして使用しないでください。

ツールの設定を入力する

カスタム Provider では、OpenAI、Anthropic、または Ollama 互換形式を使用します。互換形式とは、ツールが特定の共通インターフェースに従ってリクエストを送信する方式です。OmniProxy に接続する場合は、OpenAI Compatible を選択します。

デスクトップ版

左上のボタンをクリックしてサイドバーを開きます。
Settings をクリックします。
Models をクリックします。
Configure providers をクリックします。
ウィンドウ下部の Add Custom Provider をクリックします。
Provider Type で OpenAI Compatible を選択します。Display Name には OmniProxy と入力できます。API URL には前のセクションのアドレスを入力します。キーが必要な場合は、API Key を要求する設定にチェックを入れ、OmniProxy のキーを入力します。Available Models にモデル名を入力し、複数ある場合は半角カンマで区切ります。
Create Provider をクリックします。

現在、デスクトップ版ではこのウィンドウ内でカスタムリクエストヘッダーを定義できません。リクエストヘッダーが必要な場合は、作成後に設定ファイルを編集してください。

ターミナル

次を実行します。

goose configure

Custom Providers を選択し、続いて Add A Custom Provider を選択します。API Type には OpenAI Compatible を選び、画面の指示に従って、名前、API URL、キーが必要かどうか、モデル名、ストリーミング応答に対応するかどうかを入力します。

Windows で手動設定するときにキーチェーンエラーが発生した場合は、keyring に保存するか確認された際に保存しない方を選び、代わりに環境変数を使用します。その後、goose configure を再度実行してください。キーチェーンは、システムがキーを保存するために使用する小規模な安全なストレージです。

設定ファイル

案内されているディレクトリは次のとおりです。

macOS と Linux：~/.config/goose/custom_providers/
Windows：%APPDATA%\Block\goose\config\custom_providers\

ファイルは次の例を参考に作成できます。名前、アドレス、モデルを自分のものに置き換え、キーは api_key_env で指定した環境変数に保存してください。実際のキーをファイル内に直接書き込まないでください。

{
  "name": "omniproxy",
  "engine": "openai",
  "display_name": "OmniProxy",
  "api_key_env": "OMNIPROXY_API_KEY",
  "base_url": "https://your-omniproxy-origin.example/v1/chat/completions",
  "models": [
    { "name": "grok-4.7", "context_limit": 128000 },
    { "name": "gpt-6-luna", "context_limit": 128000 }
  ],
  "supports_streaming": true,
  "requires_auth": true
}

context_limit には、例にならって数値を1つ設定します。実際のコンテキスト上限はモデルと OmniProxy によって決まるため、この例の数値をそのモデルの公式な上限として扱わないでください。使用前に次を実行します。

export OMNIPROXY_API_KEY="<YOUR_OMNIPROXY_API_KEY>"

作業ディレクトリへ移動した後、次を実行します。

goose session --provider omniproxy --model grok-4.7

--model は一覧にある完全な ID に置き換えてください。goose session に start サブコマンドはありません。--provider と --model は、環境変数 GOOSE_PROVIDER、GOOSE_MODEL として指定することもできます。ゲートウェイがキーを検証しない場合でも、OMNIPROXY_API_KEY には値が必要です。ローカルでのみ使用する任意のプレースホルダー文字列でも構いません。2026-10-09 時点では、この方法でファイルを読み取れました。

ウィンドウ

Settings

サイドバーの Settings
Models ページ
Add Custom Provider

ターミナル

goose configure

Custom Providers を選択
次に追加を選択
種類は OpenAI Compatible を選択

ファイル

custom_providers

macOS と Linux では ~/.config
Windows では APPDATA
base_url は公式の例に合わせる

3つの方法はいずれも同じ種類の設定を書き込みます。Provider の種類には OpenAI Compatible を選択します。

実際のタスクで確認する

通常のファイルが置かれているディレクトリへ移動し、前のセクションの goose session を実行します。指定したファイルの1行目を読み取るよう依頼してください。設定が保存されたという表示だけではなく、ファイルの内容が返される必要があります。

ファイルの読み取りやコマンドの実行には、セッション内で Developer 拡張機能が必要です。Developer 拡張機能は、goose がローカルファイルやコマンドを扱うためのツールモジュールと考えることができます。通常、デフォルト設定に含まれています。ファイル用ツールがないと回答された場合は、コマンドに次を追加します。

--with-builtin developer

--no-profile は同時に追加しないでください。この引数を指定すると、デフォルトの拡張機能が無効になります。

2026-10-09 に goose 1.54.0 を使用したテストでは、指定したファイルの1行目を読み取れました。最初の応答には1分ほどかかる場合があります。

続いて、OmniProxy の呼び出し履歴で接続元とモデル名を確認します。

起動

セッションを開始できる

goose session
Provider は先ほど追加したもの
モデル名が一覧にある

タスク

実際に処理を実行した

例：現在のディレクトリを一覧表示
応答を確認する
保存成功だけで判断しない

記録

ゲートウェイで確認できる

アドレスはドキュメントの例に合わせる
キーをリポジトリに書き込まない
モデル ID が一覧と一致している

Provider を保存した後、実際のセッションを1回実行して確認する必要があります。

よくあるエラー

goose コマンドが見つからない：インストールページの案内に従ってインストール先ディレクトリを PATH に追加し、ターミナルを開き直してください。
M3 のデスクトップ版でウィンドウが表示されない：~/.config の読み取り・書き込み権限を確認してください。
キーチェーンでエラーが発生する：keyring には保存せず、環境変数を使用してください。
モデルが一覧にない：デスクトップ版では Use custom model を選び、モデル名を手動で入力できます。goose configure ではカスタムモデル名を入力できません。ターミナルを使う場合はデスクトップ版に切り替えるか、設定内の GOOSE_MODEL を直接変更してください。
アドレスに接続できない：API URL が例と同じく /v1/chat/completions まで指定されており、OmniProxy が稼働していることを確認してください。
ファイルを読み取れないと表示される：Developer 拡張機能を追加し、--no-profile は使用しないでください。
unsupported Responses role: system が返される：通常、アドレスに問題はありません。モデル一覧にある別の完全な ID に変更してください。

公式リファレンス

インストールについては Install goose、カスタム Provider については goose providers を参照してください。例で使用したモデル ID については、xAI モデルページと GPT-6 Luna を参照してください。

プレースホルダーをすべて独自の設定値に置き換えてください。実際のキーを公開しないでください。

保存された結果や HTTP 200 だけでは完全なエージェント互換性が証明されません。OmniProxy の呼び出し記録でソースとモデルを確認してください。

公式ソース · goose ↗