Aider

環境変数を 2 つ設定し、プレフィックスを付けます。OPENAI_API_BASE を https://api.kunavo.com/v1 に、OPENAI_API_KEY をお使いの sk-kn-… キーに設定し、Aider を --model openai/<id> で実行します。リポジトリにも Aider のインストール環境にも変更は必要ありません。

export OPENAI_API_BASE=https://api.kunavo.com/v1
export OPENAI_API_KEY=sk-kn-...

# The openai/ prefix is required — it tells Aider to speak the OpenAI
# protocol to OPENAI_API_BASE instead of resolving the id as a known model.
aider --model openai/claude-sonnet-5

手順

1. /app/keys でキーを作成してコピーします。キーは一度だけ表示されます。
2. Aider を起動するシェルで OPENAI_API_BASE と OPENAI_API_KEY をエクスポートするか、以下のように ~/.aider.conf.yml に記述します。
3. リポジトリ内で aider --model openai/claude-sonnet-5 を使って Aider を起動します。
4. Aider は起動時に解決したモデルを表示します。その行に指定した ID が表示されれば、エンドポイントは正しく設定されています。

Aider によるこの設定の解説は、OpenAI 互換 API のページをご覧ください。

シェルプロファイルに設定しない方法

同じ 2 つの値を Aider の設定ファイルにも記述できます。プロジェクトごとにエンドポイントを切り替える場合は、こちらの方が適しています。

# ~/.aider.conf.yml — same two values, without exporting them each shell.
openai-api-base: https://api.kunavo.com/v1
openai-api-key: sk-kn-...
model: openai/claude-sonnet-5

Aider のデバッグ前に確認する

リクエストを 1 回送ると、障害の原因がエンドポイント、キー、Aider のモデル解決のどれなのかを切り分けられます。JSON のモデル ID 一覧が返れば、同じベース URL とキーが Aider で機能します。残る原因は openai/ プレフィックスです。

# Settles whether a failure is the endpoint, the key, or Aider.
# A JSON list of model ids means the same base URL will work in Aider.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

選ぶモデル

Kunavo のすべてのテキストモデルは openai/<id> として利用できます。全一覧は モデルのページにあり、GET /v1/models から最新の一覧を取得できます。料金は入力 / 出力それぞれ 1M トークンあたりの USD です。