ドキュメント

ドキュメント

Qoder

単体のQoderデスクトップアプリでは、Provider → Customから任意のBase URLを指定できます。3つのフィールドと手入力したモデルIDを設定すれば、Qoderから1つのキーでClaudeとGPTを利用できます。これらのモデルはQoder独自のカタログには掲載されていません。

Qoder Settings → Models → + Add → Provider → Customでは、OpenAI互換のBase URL、API Key、手入力のModel IDsを指定します — スタンドアロンQoderデスクトップアプリからClaudeとGPTに接続できます。どちらも独自カタログにはありません。

Qoder Settings → Models → + Add → Provider → Custom
Qoder Settings -> Models -> + Add -> Provider -> Custom

Provider              OpenAI Compatible     <- under "Custom", not a preset
API type              Chat Completions API  <- asked only for OpenAI Compatible
Base URL              https://api.kunavo.com/v1
API Key               sk-kn-...
Model ID              claude-sonnet-5       <- typed by hand
  Add Model ID        claude-opus-5
  Add Model ID        claude-haiku-4-5

Next ->
Display name              Kunavo · Sonnet 5
Supported Context Windows pick from what the model supports
Default Context Window    one of the values picked above
Vision                    on for models that take image input
Thinking Mode             on for reasoning models, then pick effort levels

Validate and Add Model
これは単体のQoderアプリであり、Qoder IDEではありません。「Qoder」はそれぞれ別のドキュメントが用意された製品群であり、任意のエンドポイントについて記載があるのは単体のデスクトップアプリだけです。カスタムモデルのページでは、OpenAI CompatibleとAnthropic CompatibleをCustomの下で選べます。2026年9月5日のリリースノート0.1.8では、「Personalプランで、OpenAI互換またはAnthropic互換の任意のモデルサービス向けカスタムBase URLがBYOKで利用可能になりました」として導入されています。Qoder IDEのカスタムモデルページには名前付きプロバイダーだけが列挙され、Base URLという文字列は一度も出てきません。画面にそのフィールドが表示されない場合は、別のQoder製品を開いている可能性があります。
Base URLには/v1のサフィックスを含めます。Qoderのページでは「モデルサービスから提供された正確なBase URLを入力してください」と案内し、形式の例としてhttps://api.example.com/v1を示しています。つまり、OpenAI互換エンドポイントでは、オリジンだけではなく/v1ルートがフィールドに求められます。Anthropic方式のクライアントとは逆で、そちらはhttps://api.kunavo.comを指定するとクライアント側でルートが追加されます。
QoderではAnthropic Compatibleカスタムプロバイダーも選択でき、Kunavoは/v1/messagesにも応答します。ただし、ドキュメントにはBase URLの例が1つ掲載されているだけで、各プロトコルでどのルートが追加されるかは説明されていません。そのため、このタイプでhttps://api.kunavo.comとhttps://api.kunavo.com/v1のどちらが必要かは確定できません。OpenAI互換のパスについては、Qoder自身の例で確認できます。代わりにAnthropicタイプを選ぶ場合は、両方の形式を試してください。Qoderのトラブルシューティング一覧でも、まさにこの点から確認するよう案内しています。「Base URLが完全であること、選択した互換プロトコルとAPIタイプがエンドポイントに一致していること」。
KunavoはQoder内でセッションを実行していません。ここにある情報はクライアントの実行テストではありません。フィールドは下記の日付時点におけるQoder自身のページから転記し、エンドポイント側の情報にはKunavoが公開しているインターフェースを使用しています。接続の組み合わせを実際に確認するのは、QoderのValidate and Add Modelボタンです。この処理は当社側ではなく、お使いのマシンで実行されます。
まだキーをお持ちですか?Kunavoアカウントを作成し、キーを作成します(sk-kn-で始まります)。$10からクレジットを追加すると、呼び出しはその残高から支払われ、失敗した呼び出しは課金されません。ダッシュボードを開くと、Qoder設定が表示されます。

手順

  1. /app/keys でキーを作成してコピーします。キーは一度だけ表示されます。
  2. Qoder Settingsを開き、左側のナビゲーションでModelsを選択して、+ Addをクリックします。
  3. Providerを開き、Customの下にあるOpenAI Compatibleを選択します。その上にあるプリセットプロバイダーは選ばないでください。続けてAPIタイプとしてChat Completions APIを選択します。
  4. Base URL、API Key、少なくとも1つのModel IDを入力します。Qoderのドキュメントにはこのフィールド用のモデル一覧取得機能が記載されていないため、IDを手入力してください。同じエンドポイントにモデルを追加する場合は、その都度Add Model IDをクリックします。
  5. Nextをクリックし、Qoderが推定できない機能を設定します。Display name、Supported Context Windows、これらの値から選んだDefault Context Windowに加え、モデルが対応している場合はVisionとThinking Modeのトグルも設定します。
  6. Validate and Add Modelをクリックします。Qoderのモデルセレクターのページによると、追加したモデルは「タスク、Agent、自動化のモデルセレクターで利用可能になります」。

単体Qoderアプリのカスタムモデルページで2026年9月21日に確認しました。サードパーティの設定は変更されます。ここに記載されたフィールド名が表示内容と一致しなくなった場合は、このページではなく、そのページを正しい情報源としてください。

これが短い概要です。完全な手順 — モデルの選択、実際のセッション費用、失敗するケース — はQoderとClaude Codeの比較 — Qoderの種類、エンドポイント、料金にあります。

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

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

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

モデル IDKunavo 入力 / 出力Qoderでの位置付け
claude-sonnet-5$1.40 / $7.00タスクとAgentのセレクターで既定の作業モデルとして使用
claude-opus-5$3.50 / $17.50誤った計画のコストがトークンより大きくつく、大規模なリファクタリング
claude-haiku-4-5$0.70 / $3.50件数がコストを左右する、大量の自動化実行
gpt-5-6-sol$2.00 / $12.00同じキーと同じエンドポイントを使い、別のファミリーからセカンドオピニオンを得る
請求は月額料金なしの前払い残高からトークン単位で行われます — 請求を参照してください。繰り返し送られるコンテキスト(エディターやチャットクライアントが送る内容の大半)では、プロンプトキャッシュのほうがモデル選択より請求額を大きく左右します。

QoderにBase URLフィールドがない場合の理由

Qoderの3つの環境はいずれも独自のAPIキーを使うBYOKについて説明していますが、自分で選んだエンドポイントを指定できると記載しているのは1つだけです。今使っている環境から上記の設定がそもそも可能かどうかは、この一点で決まります。そのため、設定ファイルに触れる前に確認する価値があります。なお、CLIのページでは設定ファイルに触れないよう明記されています。

画面カスタムBase URLの記載製品自身のページに記載された内容
Qoder(単体アプリ)はいProvider一覧のCustomの下にOpenAI CompatibleとAnthropic Compatibleがあり、Base URL、API Key、手入力のModel IDを設定できます。このページです。
Qoder IDEいいえカスタムモデルページには「対象: Individualsプランのユーザー」と記載され、Alibaba Cloud Model Studio、DeepSeek、Z.ai、Kimi、MiniMax、Xiaomi MIMOというプロバイダー名が列挙されています。Base URLという文字列はありません。
Qoder CLIドキュメントのページには記載なし/modelの下にCustomタブがあり、Add custom model...を選択できますが、このページにはBase URLの記載がなく、「settings.jsonでBYOKを手動設定しないでください」と警告されています。

CLIは、独自のリリースノートとドキュメントの内容が一致しないため、分かりにくい製品です。2026年9月11日のリリースノート1.1.50では、「Personalエディションのユーザーは、CustomページからカスタムURLエンドポイントを使用するBYOKモデルを一元的に設定・管理できるようになりました」と記載されています。一方、その後も残っているカスタムモデルページでは、代わりにカタログについて説明されており、「利用可能なプロバイダー、モデル、認証情報のフィールドは、現在のアカウントで利用できるBYOKカタログによって決まります」と記されています。これら2つの資料とIDEのページはいずれも、Individualプランを機能利用の条件としています。そのため、Customタブが表示されない場合や、エンドポイントフィールドが表示されない場合に確認すべきなのは、設定ファイルではなく、アカウントのプランと、そのアカウントのカタログで提供される内容です。CLIのページでは設定ファイルを手動で編集しないよう案内されており、いずれにせよ、このファイルはカタログから再生成されます。

よくある質問

Qoderにカスタムプロバイダーを追加するには?

単体のQoderデスクトップアプリで、Qoder Settingsを開き、左側のナビゲーションでModelsを選択して、+ Addをクリックします。次にProviderを開き、Customの下にある「OpenAI Compatible」または「Anthropic Compatible」を選択します。OpenAIタイプでは、Chat Completions APIまたはResponses APIも選択します。Base URL、API Key、少なくとも1つのModel IDを入力します。同じエンドポイントにモデルを追加する場合はAdd Model IDを使用します。Nextをクリックし、Display name、Supported Context Windows、Default Context Window、Vision、Thinking Modeを設定してから、Validate and Add Modelをクリックします。Qoderは保存前に接続を検証します。

QoderのBase URLの末尾には/v1が必要ですか?

OpenAI互換エンドポイントの場合は必要です。Qoderのカスタムモデルページでは、モデルサービスから提供された正確なBase URLを入力するよう案内し、形式の例としてhttps://api.example.com/v1を示しています。そのため、フィールドにはオリジンだけではなく/v1ルートが必要です。Kunavoの場合はhttps://api.kunavo.com/v1です。Anthropic Compatibleタイプについては、別の例が掲載されておらず、どのルートを追加するかも明記されていません。そのため、ドキュメントだけではこのケースは確定できません。まず/v1ルートを試し、検証に失敗する場合はオリジンだけの形式を試してください。

QoderにCustomタブやBase URLフィールドが表示されないのはなぜですか?

Qoderの3つの環境ではBYOKのルールが異なるためです。任意のBase URLが記載されているのは単体のQoderデスクトップアプリだけです。Qoder IDEのカスタムモデルページには名前付きプロバイダーが列挙され、Base URLの記載はありません。Qoder CLIのページでは、利用可能なプロバイダー、モデル、認証情報フィールドは、現在のアカウントで利用できるBYOKカタログによって決まると記載されています。また、IDEとCLIのページはいずれも、この機能の利用対象をIndividualプランに限定しています。フィールドが見つからない場合は、開いているQoder製品と、アカウントのプランやカタログで可能なことを確認してください。CLIのページでは、settings.jsonでBYOKを手動設定しないよう明確に警告されています。

Anthropicアカウントがなくても、QoderでClaudeモデルを使えますか?

カスタムプロバイダー経由なら使えます。Qoderの組み込みカタログは別の仕組みです。モデルセレクターのページには、Qwen、DeepSeek、GLM、Kimi、MiniMaxのモデルが列挙されており、Claude、GPT、Geminiのモデル名はありません。そのため、これらを利用するには、ドキュメントに記載された方法としてBYOKを使用します。ここでの「OpenAI Compatible」は通信プロトコルの選択肢であり、ベンダーの選択肢ではありません。入力したModel IDは、設定したBase URLで解決されるため、そのエンドポイントが提供していればClaude IDも使用できます。認証情報には、Anthropicのものではなく、そのエンドポイントのものを使用します。

Qoderでカスタムモデルを使う場合も、Qoder Creditsを消費しますか?

Qoderのカスタムモデルページによると、カスタムモデルの料金はプロバイダーのAPIアカウントに直接請求され、Qoder Creditsは使用されません。例外はRepo Wikiです。固定モデルを使用するため、別途請求され、生成時にメッセージが表示されます。Kunavo側の料金は、月額料金なしで、前払い残高からトークンごとに差し引かれます。また、保存済みのカスタムモデルに対するQoderのEdit操作で更新できるのはAPIキーだけです。Base URLを変更するには、エントリーを削除して再度追加する必要があります。

KunavoはQoder内でこの設定をテストしましたか?

いいえ。KunavoはQoderのどの環境でもセッションを実行しておらず、このページは実行時の互換性レポートではありません。フィールド名とその順序は、表示されている日付時点におけるQoder自身のカスタムモデルページから転記したものです。エンドポイント側にはKunavoが公開しているAPIを記載しています。重要な確認はお使いのマシンで行います。QoderのValidate and Add Modelボタンは、保存前にBase URL、キー、Model IDの組み合わせをテストします。同じbase URLとキーを使って通常のcurlを実行すれば、問題がエンドポイント側かクライアント側かを切り分けられます。