Qwen
Qwen Code で aicentos を使う —— settings.json による OpenAI 互換 provider の設定
最終更新:
Qwen Code は settings.json の modelProviders を通じて、任意の OpenAI 互換エンドポイントを登録できます。baseUrl を aicentos に向ければ、Qwen Code 内で aicentos が接続しているモデルを利用できます。
準備
まずコンソールの「API キー」ページで、Qwen Code 専用のキーを作成してください(名前は qwen-code のようにすると使用量の追跡に便利です)。
- コンソール:https://aicentos.com
- キーの作成:https://aicentos.com/keys
- ウォレットのチャージ:https://aicentos.com/wallet
- ドキュメントサイト:https://docs.aicentos.com
Qwen Code には Node.js 20+ が必要です。npm でグローバルインストールします:
npm install -g @qwen-code/qwen-code
qwen --version設定値
| 項目 | 値 |
|---|---|
| auth タイプ | openai(OpenAI 互換プロトコル) |
| baseUrl | https://aicentos.com/v1 |
| envKey | キーを格納する環境変数名(カスタマイズ可能) |
| モデル id | コンソール「モデル広場」のモデル名 |
設定手順
~/.qwen/settings.json を編集します:
{
"env": {
"AICENTOS_API_KEY": "sk-あなたのキー"
},
"modelProviders": {
"openai": [
{
"id": "gpt-4o",
"name": "GPT-4o",
"baseUrl": "https://aicentos.com/v1",
"envKey": "AICENTOS_API_KEY"
}
]
},
"security": {
"auth": {
"selectedType": "openai"
}
},
"model": {
"name": "gpt-4o"
}
}idはサーバーに実際に送られるモデル ID で、コンソール内のモデル名と一致させてください。modelProvidersには平文のキーを書かず、envKeyは「どの環境変数からキーを取るか」の参照にすぎません。- キーの優先順位:システム環境変数 >
.envファイル(~/.qwen/.env)>settings.jsonのenvブロック。 - aicentos 側が Responses プロトコルを使う場合は、そのモデルに
"wireApi": "responses"を追加します。書かない場合はデフォルトで Chat Completions を使います。
設定ファイルをまったく変更せず、環境変数だけで使うこともできます:
export OPENAI_BASE_URL="https://aicentos.com/v1"
export OPENAI_API_KEY="sk-あなたのキー"
export OPENAI_MODEL="gpt-4o"テスト
qwen を起動し、/about で現在の endpoint とモデルが正しいか確認してから、簡単なプロンプトを 1 つ送ります。複数の provider エントリを設定した場合は、/model で切り替えられます。
注意事項
- グローバル設定は
~/.qwen/settings.jsonに置き、プロジェクトレベルの設定はプロジェクトルートの.qwen/settings.jsonに置きます。後者のほうが優先度が高くなります。 security.auth.selectedTypeは必ずopenaiにしてください。そうしないとカスタムエンドポイントは使われません。- 平文のキーをバージョン管理にコミットしないでください。
~/.qwen/.envまたはシステム環境変数を優先してください。 wireApiはローカルのルーティングメタデータにすぎず、リクエストボディには送られません。responsesに変更する前に、aicentos 側が/v1/responsesに対応しているか確認してください。- Base URL は
/v1までにし、完全な API パスにしないでください。