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 --versionTokenHub 認証情報を準備
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 URL | https://us-api.tokenhub.com/v1 |
| API Key | TOKENHUB_API_KEY の値 |
| モデル | qwen3-coder-plus または別の TokenHub model ID |
設定ファイルの場所
| 項目 | 値 |
|---|---|
| User config | ~/.qwen/settings.json |
| Project config | .qwen/settings.json |
| Provider fields | modelProviders.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 など全てのモデル欄を再確認します。 |
モデルの選び方
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。