Crush

Crushの設定はBashです — crushrcに`provider add kunavo --type openai-compat --base-url "https://api.kunavo.com/v1"`を1行追加すると、CharmのターミナルエージェントをClaudeとGPTで動かせます。

# A crushrc is Bash, not a settings file. Everything here is executed.
provider add kunavo \
  --type openai-compat \
  --base-url "https://api.kunavo.com/v1" \
  --api-key "${KUNAVO_API_KEY:?set KUNAVO_API_KEY}"

model add kunavo/claude-sonnet-5 \
  --name "Claude Sonnet 5" \
  --context-window 1000000 \
  --default-max-tokens 32000 \
  --price-input 1.4 \
  --price-output 7

model add kunavo/claude-haiku-4-5 \
  --name "Claude Haiku 4.5" \
  --context-window 200000 \
  --default-max-tokens 16000 \
  --price-input 0.7 \
  --price-output 3.5

model large kunavo/claude-sonnet-5
model small kunavo/claude-haiku-4-5

手順

1. /app/keysでキーを作成してコピーしてください。キーは一度しか表示されません。KUNAVO_API_KEYとしてエクスポートするか、設定内でパスワードマネージャーから読み込んでください。
2. 上記のブロックを~/.config/crush/crushrcに記述します。Crushはまず./.crushrc、次に./crushrc、その次にグローバル設定を読み込むため、プロジェクトの設定でマシン全体の設定を上書きできます。一方、クローンしたリポジトリに設定ファイルが含まれている場合もあります。
3. crushを起動し、ctrl+lを押してモデルピッカーを開きます。上記のmodel largeとmodel smallの行で両方のスロットがすでに固定されているため、ピッカーは初期設定ではなく、モデルの切り替えに使います。
4. IDを手動で登録したくない場合: openai-compatプロバイダーのモデルリストが空のとき、または--discover-models trueを指定したときに、自動検出が実行されます。KunavoはGET /v1/modelsを返すため、リストは自動で作成されます。競合があれば、独自のmodel addフィールドが優先されます。
5. 範囲を限定したタスクを1つ実行し、/app/billingでアカウントに記録された請求額を確認してください。ターミナルに表示される金額は、入力した--price-*の数値を使った計算結果です。請求額を確認するには台帳を参照してください。

Crushの「Custom Providers」セクションで2026年9月21日に確認しました。サードパーティの設定は変更されます。ここに記載されたフィールド名が表示内容と一致しなくなった場合は、このページではなく、そのページを正しい情報源としてください。

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

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

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