# Qwen

出典: https://docs.aicentos.com/ja/clients/qwen

Language: ja

> 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)
* キーの作成：[https://aicentos.com/keys](https://aicentos.com/keys)
* ウォレットのチャージ：[https://aicentos.com/wallet](https://aicentos.com/wallet)
* ドキュメントサイト：[https://docs.aicentos.com](https://docs.aicentos.com)

Qwen Code には Node.js 20+ が必要です。npm でグローバルインストールします：

```bash
npm install -g @qwen-code/qwen-code
qwen --version
```

## 設定値

| 項目       | 値                         |
| -------- | ------------------------- |
| auth タイプ | `openai`（OpenAI 互換プロトコル）  |
| baseUrl  | `https://aicentos.com/v1` |
| envKey   | キーを格納する環境変数名（カスタマイズ可能）    |
| モデル id   | コンソール「モデル広場」のモデル名         |

## 設定手順

`~/.qwen/settings.json` を編集します：

```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 を使います。

設定ファイルをまったく変更せず、環境変数だけで使うこともできます：

```bash
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 パスにしないでください。