Qwen Code

Qwen Codeは~/.qwen/settings.jsonのmodelProvidersからエンドポイントを読み取ります — baseUrlとenvKeyを含む1つのエントリで、/modelピッカーにClaudeとGPTを追加できます。

{
  "modelProviders": {
    "openai": [
      {
        "id": "claude-sonnet-5",
        "name": "Claude Sonnet 5 (Kunavo)",
        "baseUrl": "https://api.kunavo.com/v1",
        "description": "Kunavo, OpenAI-compatible",
        "envKey": "KUNAVO_API_KEY"
      }
    ]
  },
  "env": {
    "KUNAVO_API_KEY": "sk-kn-..."
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "claude-sonnet-5"
  }
}

手順

1. /app/keys でキーを作成してコピーします。キーは一度だけ表示されます。
2. ~/.qwen/settings.jsonを開き（存在しない場合は作成し）、上記の4つのブロックを統合します。ドキュメントでは、プロジェクト設定とユーザー設定の間でマージ競合を避けるため、ユーザースコープのファイルでmodelProvidersを宣言するよう推奨しています。
3. 可能であれば、キーはenvより安全な場所に保管してください。Qwen Codeはprocess.env[envKey]からキーを読み取り、ドキュメントでは認証情報の取得元を優先度の高い順に、シェルのexport、.envファイル、settings.json内のenvブロックとしています。最後の方法については、平文での保存と明記されています。上記のenvブロックは最小限の動作設定であり、保管方法として最適な設定ではありません。
4. qwenを実行します。security.auth.selectedTypeがopenaiに設定され、model.nameが登録したidと一致していれば、対話形式の/auth手順は不要です。1ファイルの例に続けて、ドキュメントにもそのように明記されています。
5. 挨拶ではなく、ファイルを読み取って編集するタスクを与えてください。Qwen Codeはエージェントです。初回実行ではツール呼び出しとストリーミングを試すのが適切で、部分的にしか対応していないエンドポイントであれば、最初に問題が起きるのもこの部分です。
6. modelProviders.openaiの下にエントリーを追加すると、実行中に/modelでモデルを切り替えられます。これらの変更は実行中のセッションにホットリロードされます。providerProtocolは起動時に一度だけ読み込まれるため、変更を反映するには再起動が必要です。

Qwen Codeの認証ページ、オプション4：API Key（柔軟な設定）で2026年9月21日に確認しました。サードパーティの設定は変更されます。ここに記載されたフィールド名が表示内容と一致しなくなった場合は、このページではなく、そのページを正しい情報源としてください。

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

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

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

ドキュメントを読めばわかる、誤解されがちな3つの点

上記にリンクした認証ページとモデルプロバイダーのリファレンスに記載されている内容です。読まずに推測すると、どれもデバッグに実際の時間を費やすことになります。

1. modelProvidersのエントリーはCLIフラグより優先されます。ドキュメントに記載された優先順位を高い順に示すと、実行中のセッションで/authを通じて行った上書き、選択したモデルプロバイダーのenvKey、--openai-api-keyなどのCLI引数、環境変数、設定内のsecurity.auth.apiKeyです。多くの人はフラグが優先されると思いますが、実際はそうではありません。そのため、--openai-base-urlが無視されたように見えることがあります。
2. security.auth.apiKeyとsecurity.auth.baseUrlは非推奨です。リファレンスにはその旨が記載され、modelProvidersへの移行が推奨されています。古いチュートリアルに従ってこの2つのキーを編集すると、廃止に向かっている経路を使うことになります。
3. wireApiがリクエスト形式を選択し、不一致は検出されません。省略すると、上記の設定例で使われているChat Completionsになります。"wireApi": "responses"を設定するには、エンドポイントが実際にResponsesに対応している必要があります。ドキュメントには、リクエスト失敗時にエンドポイントの検出も自動フォールバックも行われないと明記されています。Kunavoは/v1/responsesと/v1/chat/completionsの両方に応答しますが、このページではどちらの組み合わせもテストしていないため、まずはデフォルト設定を使ってください。

無料枠について調べている方へ

現在も広く見られるQwen Codeの情報の多くは、1日の無料利用枠があるQwen OAuthログインについて説明しています。このオプションはすでに終了しています。ドキュメントによると、無料枠は2026年4月15日に終了しており、/authダイアログでQwen OAuthを選択することはできません。現在、同ダイアログに記載されているのは、Alibaba ModelStudio（サブメニューにCoding Plan、Token Plan、Standard API Keyがあります）、Third-party Providers、そして「ローカルサーバー、プロキシ、または未対応のプロバイダー」に接続するものとして説明されているCustom Providerの3つです。Kunavoはこの3つ目に該当します。また、ModelStudioのサブメニュー項目は、1つの請求に対する3種類の支払い方法ではありません。それぞれ異なるホストとキーを使うため、Token PlanのホストにCoding Planのキーを指定しても動作しません。