mini-SWE-agent

mini-SWE-agentにはベースURL用の環境変数がありません — YAML設定のmodel.model_kwargs.api_baseにエンドポイントを記述し、miniがそのままlitellm.completionに渡します。

# mini has no base-URL environment variable and no settings UI. The endpoint
# goes in an agent config file, under model.model_kwargs — which mini's docs
# describe as "directly passed to litellm.completion".
model:
  model_name: "openai/claude-sonnet-5"
  model_kwargs:
    custom_llm_provider: "openai"
    api_base: "https://api.kunavo.com/v1"   # keep the /v1
  litellm_model_registry: "kunavo-registry.json"   # see "Cost tracking" below

# The key does not live in this file. With custom_llm_provider: "openai",
# litellm reads OPENAI_API_KEY, and mini documents two ways to set it:
#
#   export OPENAI_API_KEY=sk-kn-...          # environment, wins over .env
#   mini-extra config set OPENAI_API_KEY sk-kn-...   # mini's own .env
#
# Then run it:  mini -c kunavo.yaml
# Or make it the default:  mini-extra config set MSWEA_MINI_CONFIG_PATH kunavo.yaml

手順

1. /app/keys でキーを作成してコピーします。キーは一度だけ表示されます。
2. パスが存在するように、一度インストールして実行します。pip install mini-swe-agent、続いてminiです。初回実行時に.envとエージェント設定の保存場所が表示され、mini-extra config setupの案内もあります。
3. litellmが探す場所にキーを設定します。export OPENAI_API_KEY=sk-kn-...を使用するか、mini-extra config set OPENAI_API_KEY sk-kn-...で永続化してください。miniは「環境変数は.envファイルに設定された変数より優先される」と説明しています。変更したばかりのキーが変わっていないように見える場合、通常はこれが原因です。
4. 上記の YAML を他のエージェント設定と同じ場所にあるkunavo.yamlとして保存し、以下のセクションの料金レジストリも追加してください。レジストリがないと、不適切な回答ではなく、コスト計算エラーで実行が停止します。
5. mini -c kunavo.yamlで起動します。1 回の実行だけ ID を上書きするにはmini -c kunavo.yaml -m openai/claude-haiku-4-5を使います。mini はconfirmモードで開き、各コマンドの実行前に承認を求めます。新しいエンドポイントで初回実行する際の適切なデフォルトです。
6. あいさつではなく、実際にコマンドを実行するタスクを与えてください。miniのv2ではネイティブのツール呼び出しがデフォルトで、付属のプロンプトも「すべての応答で、コマンドを実行するために少なくとも1度は'bash'ツールを使用する必要がある」と求めています。そのため、実際のツール呼び出しが1回往復して初めて、この組み合わせが動作するとわかります。ツール呼び出しが空、または不正な形式で返る場合も、miniには従来のテキスト解析方式が引き続き付属しています。mini -c mini_textbased.yaml、またはご自身のファイル内のmodel_class: litellm_textbasedを使用してください。

mini-SWE-agent のローカルモデルガイドで2026年9月21日に確認しました。サードパーティの設定は変更されます。ここに記載されたフィールド名が表示内容と一致しなくなった場合は、このページではなく、そのページを正しい情報源としてください。

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

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

# 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で、入力 / 出力の順です。

ここでは省略できないコスト追跡

mini の同梱mini.yamlにはcost_limit: 3.（ドル建ての、1 回の実行あたりの上限額）が設定されており、この上限は litellm のコスト計算機によって適用されます。コスト計算機は、レジストリでモデル ID を照合して実行コストを算出します。Kunavo の ID はそのレジストリに登録されていないため、多くの人が最初に目にするのは不適切な回答ではなくエラーです。mini のトラブルシューティングページでは、これをException: This model isn't mapped yet. model=…, custom_llm_provider=…として示しています。

対処方法は2つありますが、同等ではありません。グローバルスイッチのMSWEA_COST_TRACKING="ignore_errors"（ファイルではcost_tracking: "ignore_errors"）は、ガードを修復するのではなく取り除くもので、miniは「注意：支出を管理できなくなる可能性があります！」と警告しています。もう一方はlitellmに料金を伝える方法で、設定ブロックのlitellm_model_registryが指しているのはこちらです。以下の料金は、このサイトの現行カタログ料金をlitellmのトークン単位の形式に変換したものです。

{
  "claude-sonnet-5": {
    "input_cost_per_token": 0.0000014,
    "output_cost_per_token": 0.000007,
    "litellm_provider": "openai",
    "mode": "chat"
  },
  "claude-opus-5": {
    "input_cost_per_token": 0.0000035,
    "output_cost_per_token": 0.0000175,
    "litellm_provider": "openai",
    "mode": "chat"
  },
  "claude-haiku-4-5": {
    "input_cost_per_token": 0.0000007,
    "output_cost_per_token": 0.0000035,
    "litellm_provider": "openai",
    "mode": "chat"
  }
}

1. モデル名は大文字と小文字を区別して完全一致で照合されます。また、mini のサンプルでは、プロバイダープレフィックスを付けない名前をキーとしてエントリを指定しています。そのため、設定にopenai/claude-sonnet-5と書かれていても、ここではclaude-sonnet-5を使用します。
2. litellm_providerは、プレフィックスとcustom_llm_providerに一致している必要があります。miniは明確に警告しています。「custom_llm_providerを使用する場合、またはモデル名にプロバイダーのプレフィックスが付いている場合（例：openai/…）、これは設定内のlitellm_providerとも一致している必要があります！」
3. 設定キーの代わりにLITELLM_MODEL_REGISTRY_PATHからパスを指定することもできます。バッチランナーで便利です。例：LITELLM_MODEL_REGISTRY_PATH=kunavo-registry.json mini-extra swebench …
4. これらの料金は予算の計算に使う値であり、請求額ではありません。実際の請求額は Kunavo の残高に記録される金額です。カタログの料金が変わったら値をコピーし直すか、GET /v1/modelsで確認してください。