Goose APIキーのセットアップ

Goose APIキー: config.yamlで自分のキーを設定

以下のブロックをconfig.yamlに貼り付け、~/.bashrcに自分のAPIキーを設定すると、GooseでClaudeモデルを利用できます。従量課金制です。

~/.config/goose/config.yamlyaml
config
GOOSE_PROVIDER: openai
GOOSE_MODEL: claude-haiku-4-5-20251001
OPENAI_HOST: https://api.aicodewith.ai
OPENAI_BASE_PATH: v1/chat/completions

セットアップ手順

後でターミナルで使用するためにこのキーを保存

サインインすると、このコマンドにはあなたのキーが含まれます。コピーして一度実行すると、ツールはテスト済みの場所にキーを保存します。

bash
for rc in "$HOME/.zshrc" "$HOME/.bashrc"; do
  touch "$rc"
  echo 'export OPENAI_API_KEY=sk-***' >> "$rc"
done

サインアウトした訪問者にはプレースホルダーのみが表示されます。サインインすると、あなたのキーが入力されます。 Sign in · コンソールでキーを取得

コピーすると、コマンドがクリップボードに置かれるだけです。まだターミナルで実行するか、ツールの設定にキーを貼り付ける必要があります。 APIキーの取得方法

これらの手順はLinux(bash)でテスト済みです。macOSとWindowsはまだテストされていないため、記載していません。

  1. Goose がまだない場合は?インストールします(インストール済みならスキップ)

    curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash を実行し、次に goose --version を実行します。バージョン番号が表示されればインストール済みです。

    Goose のインストール: `curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | CONFIGURE=false bash`(CONFIGURE=false は対話式セットアップをスキップします)。`~/.local/bin/goose` にインストールされます。`goose --version` は 1.54.0 を表示します。
  2. 設定を config.yaml に貼り付け

    ~/.config/goose/config.yaml を開き、このページの上部にあるブロックを貼り付けて保存します。これらをエクスポートする必要はもうありません。

    ~/.config/goose/config.yaml 内のエンドポイント
  3. APIキーを ~/.bashrc に設定

    echo 'export OPENAI_API_KEY=sk-***' >> ~/.bashrc を実行し、sk-*** を自分のAPIキーに置き換えます(APIキーを取得)。~/.bashrc の最終行がその行になっているはずです。

    ~/.bashrc の最終行が export OPENAI_API_KEY=sk-***(ここではマスク)であることを確認
  4. 新しいターミナルを開いて Goose をテスト

    新しいターミナルを開き、goose run --no-session --quiet --max-turns 1 -t "Reply with exactly: OK" を実行します。OK と返れば、Goose が APIキーを使用しています。

    確認: ターミナルを閉じて新しいものを開き、goose run --no-session --quiet --max-turns 1 -t "Reply with exactly: OK" を実行します。OK の返答があれば設定完了です。
  5. OK が返らない場合は?エラーを照合

    ターミナルに表示されたエラーを、下のよくあるエラーと照合してください。それぞれに原因と修正方法が記載されています。

  6. Goose のモデルを切り替える: GOOSE_MODEL を変更

    config.yaml の GOOSE_MODEL の後ろにあるモデル名を、新しいモデルIDに正確に置き換えます。モデルIDはモデルと料金にあります。

よくあるエラー

キー未設定: https://api.aicodewith.ai/v1/chat/completions で認証に失敗しました。ステータス: 401 Unauthorized。レスポンス: {"error":"请在请求中提供有效的 API Key。"}

表示内容

error: このエラーが発生しました: 認証エラー: https://api.aicodewith.ai/v1/chat/completions で認証に失敗しました。ステータス: 401 Unauthorized。レスポンス: {"error":"请在请求中提供有效的 API Key。"}。
(日本語: 「リクエストに有効な API Key を指定してください。」)
原因
ターミナルに OPENAI_API_KEY がありません。~/.bashrc にないか、追加したが新しいターミナルを開いていないためです
直し方
ステップ3のとおりにキーを ~/.bashrc に設定し、新しいターミナルを開きます

ステップ 3 に戻る:API キーを ~/.bashrc に設定する →

キー未設定: 新しいターミナルに OPENAI_API_KEY がありません。goose run --no-session --quiet --max-turns 1 -t "Reply with exactly: OK" を実行すると、次の内容が2回表示されます: error: Ran into this error: Authentication error: Authentication failed for https://api.aicodewith.ai/v1/chat/completions. Status: 401 Unauthorized. Response: {"error":"请在请求中提供有效的 API Key。"}. (日本語: 「リクエストに有効な API Key を指定してください。」) に続いて Please retry if you think this is a transient or recoverable error.

キーが間違っている: https://api.aicodewith.ai/v1/chat/completions で認証に失敗しました。ステータス: 401 Unauthorized。レスポンス: {"error":"请在请求中提供有效的 API Key。"}

表示内容

error: このエラーが発生しました: 認証エラー: https://api.aicodewith.ai/v1/chat/completions で認証に失敗しました。ステータス: 401 Unauthorized。レスポンス: {"error":"请在请求中提供有效的 API Key。"}。
(日本語: 「リクエストに有効な API Key を指定してください。」)
原因
~/.bashrc の OPENAI_API_KEY が間違っている。エラーはキーなしの場合と同じ
直し方
コンソールからもう一度キーをコピーし、~/.bashrc の最後の行を修正して、新しいターミナルを開きます

ステップ 3 に戻る:API キーを ~/.bashrc に設定する →

キーが間違っている: tail -n 1 ~/.bashrc に export OPENAI_API_KEY=sk-wrong が表示されます。goose run --no-session --quiet --max-turns 1 -t "Reply with exactly: OK" を実行すると、次の内容が2回表示されます: error: Ran into this error: Authentication error: Authentication failed for https://api.aicodewith.ai/v1/chat/completions. Status: 401 Unauthorized. Response: {"error":"请在请求中提供有效的 API Key。"}. (日本語: 「リクエストに有効な API Key を指定してください。」) — キーなしの場合と同じ

404 "不支持的请求路径" (未対応のリクエストパス)

表示内容

404 "不支持的请求路径" (未対応のリクエストパス)
原因
OPENAI_BASE_PATH が間違っている(たとえば nope/chat/completions)。そのためリクエストは https://api.aicodewith.ai/nope/chat/completions に送信されます
直し方
v1/chat/completions に戻します

ステップ 2 に戻る:設定を config.yaml に貼り付ける →

よくあるエラー: OPENAI_BASE_PATH が間違っている(ここでは nope/chat/completions)と、リクエストが https://api.aicodewith.ai/nope/chat/completions に送信され、404(未対応のパス)が返ります。v1/chat/completions に戻してください。注: このリレーは /v1 をすでに含む HOST も受理しました(テスト済み)が、その方法で不正な設定を検出できるとは限りません

FAQ

Goose で自分の API キーを使うにはどうすればよいですか?

~/.config/goose/config.yaml で GOOSE_PROVIDER: openai、OPENAI_HOST: https://api.aicodewith.ai、OPENAI_BASE_PATH: v1/chat/completions を設定し、~/.bashrc に export OPENAI_API_KEY=your key を追加します。

Goose の OPENAI_HOST に /v1 を含めるべきですか?

いいえ。OPENAI_HOST を https://api.aicodewith.ai に設定し、/v1 は OPENAI_BASE_PATH に入れます。

Goose が 401 を返します。どうすればよいですか?

ターミナルに OPENAI_API_KEY がないか、キーが間違っています。修正方法は上記の「よくあるエラー」を参照してください。

Goose がモデルを見つけられません。どうすればよいですか?

GOOSE_MODEL が AI Code With Model ID と完全に一致していることを確認してください。

出典

関連リンク