Coding Agent のセットアップ

Goose のセットアップ：API Key、Base URL、モデル

BetterToken API Key と Base URL で Goose を設定し、developer 拡張機能を有効にしてテキストとファイル読み取りを確認します。

Goose の OpenAI provider を使って BetterToken に接続します。GPT モデルを使った macOS のテストでは、Goose 1.55.0 が /v1/responses 経由でテキストリクエストとファイル読み取りのツール呼び出しを完了しました。

主な設定

項目	値
API Key	`OPENAI_API_KEY` に設定する BetterToken API Key
Base URL	`OPENAI_HOST` に設定する `https://bettertoken.ai`（`/v1` なし）
モデル	`GOOSE_MODEL` に設定する `YOUR_MODEL_ID`
Provider	`GOOSE_PROVIDER=openai`

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

実行前に YOUR_API_KEY と YOUR_MODEL_ID を置き換えます。

export GOOSE_PROVIDER="openai"
export GOOSE_MODEL="YOUR_MODEL_ID"
export OPENAI_API_KEY="YOUR_API_KEY"
export OPENAI_HOST="https://bettertoken.ai"

OPENAI_HOST にはサイトのルートを指定します。provider が OpenAI でも、このフィールドに /v1 を追加しないでください。

ファイルにアクセスするには goose configure を実行し、Toggle Extensions を選んで developer を有効にします。developer 拡張機能がファイルとシェルのツールを提供します。

同じターミナルで次のコマンドを実行します。

goose run --no-session --max-turns 4 -t "Reply with only: OK"

最終回答が OK であることを確認します。ファイルアクセスを個別に確認するには、プロジェクト内で Goose を実行し、既知のファイルを読み取るよう依頼します。ツールの結果と最終回答の両方を確認してください。

GOOSE_MODEL をモデル広場にある別の正確な Model ID に設定し、新しい実行を開始します。

症状	確認事項
認証に失敗する	Goose を実行しているターミナルで `OPENAI_API_KEY` を確認します。
リクエスト URL が違う	`OPENAI_HOST` を `https://bettertoken.ai` に設定し、`/v1` やエンドポイントのサフィックスを付けないでください。
ファイルツールを使えない	`goose configure` で組み込みの developer 拡張機能を有効にします。
リクエストが引き続き Responses を使う	Goose 1.55.0 のテストでは `OPENAI_BASE_PATH=v1/chat/completions` を指定しても、対象モデルのリクエストは `/v1/responses` のままでした。実際のリクエストパスを確認してください。

テストしたテキストとファイル読み取りのリクエストでは /v1/responses が使われました。provider 名や環境変数名だけでは、別のモデルで Goose がどのプロトコルを選ぶかは判断できません。