Qwen コードのカスタム API セットアップ

TokenHub OpenAI 互換モデルを Qwen Code 設定に追加し、CLI から安全に選択します。

Qwenコードとは何ですか?

Qwen Code は、構成可能なプロバイダー、モデル、スキル、リポジトリ ワークフローを備えたコマンドライン コーディング エージェントです。

この Qwen コード ガイドでは、環境ベースの TokenHub API キーを使用して現在の modelProviders.openai 構成を使用します。資格情報を共有設定から除外し、読み取り専用タスクから開始します。永続的なセットアップは、modelProviders.openai の下のユーザー設定ファイルに存在しますが、実際の API キーは envKey によって参照される環境に残ります。共有プロジェクト構成にシークレットが含まれないようにし、security.auth.selectedType とデフォルト モデルを確認し、JSON または環境変数を変更した後に CLI を再起動します。

Qwen Code は TokenHub の OpenAI compatible 互換 API ゲートウェイ経由でモデルリクエストを送信できます。公式のインストール手順はそのまま使い、API key、Base URL、モデル ID だけを置き換えます。

このガイドで使う TokenHub endpoint は https://us-api.tokenhub.com/v1/chat/completions です。

使う場面

小さなリポジトリや検証用プロジェクトから始めます。まずは読み取り、コード説明、計画作成を試し、その後で編集や自動化タスクを有効にします。

インストールまたは起動

まず Qwen Code 公式ドキュメント に従ってインストールまたは起動します。画面名が違う場合は現在の公式ドキュメントを優先してください。

CLI ツールの場合、TokenHub 認証情報を追加する前に実行ファイルが使えることを確認します:

qwen --version

TokenHub 認証情報を準備

TokenHub API key を作成し、TokenHub のモデル一覧からこのツールに適したモデルを選びます。

export TOKENHUB_API_KEY="sk-..."

キーはローカル shell、IDE のシークレット保存領域、またはツールの安全な API key 欄に保存します。リポジトリにはコミットしないでください。

TokenHub プロバイダーを設定

Models、Providers、API Keys、OpenAI Compatible などの設定画面で次の値を入力します。

Provider の値

項目
プロバイダーOpenAI Compatible または Custom
Base URLhttps://us-api.tokenhub.com/v1
API KeyTOKENHUB_API_KEY の値
モデルqwen3-coder-plus または別の TokenHub model ID

設定ファイルの場所

項目
User config~/.qwen/settings.json
Project config.qwen/settings.json
Provider fieldsmodelProviders.openai, security.auth.selectedType, model.name
{
  "modelProviders": {
    "openai": {
      "protocol": "openai",
      "models": [
        {
          "id": "qwen3-coder-plus",
          "name": "TokenHub / qwen3-coder-plus",
          "baseUrl": "__API_BASE_URL__/v1",
          "envKey": "TOKENHUB_API_KEY"
        }
      ]
    }
  },
  "security": {
    "auth": {
      "selectedType": "openai"
    }
  },
  "model": {
    "name": "qwen3-coder-plus"
  }
}

インストール済みバージョンが少し違う schema を書き出す場合は、まず対話式設定で生成し、同じ TokenHub 値(Base URL、API key、model ID)を保持してください。

ツールが chat、edit、apply、fast model を分けている場合、最初のテストでは同じ TokenHub モデルを使います。動作確認後にコスト、レイテンシ、推論力で分けます。

一時環境変数はデバッグ用

一時変数は key、ネットワーク、モデル名の確認にだけ使います。確認後は同じ値を上の永続設定に移してください。

export TOKENHUB_API_KEY="sk-..."
export OPENAI_API_KEY="$TOKENHUB_API_KEY"
export OPENAI_BASE_URL="__API_BASE_URL__/v1"
export OPENAI_MODEL="qwen3-coder-plus"

接続を確認

まず読み取り専用のプロンプトで、モデルが文脈を読めること、ファイルを変更しないことを確認します。その後、編集や Agent タスクを試します。

このプロジェクトの README を読み、3 文で要約してください。ファイルは変更しないでください。

プロンプトが成功したら、TokenHub のリクエストログでモデル名、endpoint、token 使用量、課金グループを確認します。

トラブルシューティング

症状対処
401 または認証失敗TOKENHUB_API_KEY が有効で、同じ terminal、IDE、クライアントプロファイルに保存されているか確認します。
404 またはモデルが見つからないTokenHub ワークスペースに存在し、選択したプロトコルに対応するモデル ID を使います。
endpoint が違う上記の Base URL と完全に一致させます。OpenAI 互換ツールは通常 /v1 が必要で、Claude 互換ツールは通常不要です。
リクエストがタイムアウトするhttps://us-api.tokenhub.com へのネットワーク、プロキシ設定、ワークスペースの allowlist を確認します。
別のモデルが使われるchat、edit、apply、fast、autocomplete など全てのモデル欄を再確認します。

モデルの選び方

用途モデルの方向性理由
複雑なタスクツール対応の推論モデル計画、複数手順、長いコンテキストに向いています。
日常的な利用バランス型モデル品質、速度、コストのバランスを取れます。
要約と軽い作業高速・低コストモデル要約や簡単な反復のコストを抑えます。
TokenHub のモデルを見る

Qwen コードのカスタム API に関するよくある質問

Qwen コードが依然としてデフォルトのサービスで開始されるのはなぜですか?

security.auth.selectedType が openai であり、アクティブなモデルが modelProviders.openai に表示されていることを確認します。

プロバイダー キーは tokenhub または openai にする必要がありますか?

現在の公式のmodelProviders.openai設定を使用します。 TokenHub は、baseUrl と envKey を介して接続されます。未検証のプロバイダーキーを作成しないでください。

プロジェクト設定ファイルに TokenHub API キーを含めることはできますか?

それを避けてください。 envKey、ベース URL、およびモデル ID を共有構成に保持し、実際のキーをローカル環境またはシークレット マネージャーに保存します。

TokenHub モデルを Qwen コードに追加するにはどうすればよいですか?

~/.qwen/settings.json の modelProviders.openai 配下にモデルを追加し、envKey で TOKENHUB_API_KEY を参照し、デフォルトと同じモデルを選択します。

Qwen Code エージェントの機能を検証するにはどうすればよいですか?

読み取り専用のリポジトリの質問から始めて、TokenHub ログでリクエストを確認し、ツールの呼び出し、編集、コマンドを個別にテストします。

参考資料

この設定は TokenHub と公式ドキュメントに基づいており、最終確認日は 2026-09-04。