Skip to Content
aicentos

Qwen

Qwen Code で aicentos を使う —— settings.json による OpenAI 互換 provider の設定

最終更新:

Qwen Code は settings.json の modelProviders を通じて、任意の OpenAI 互換エンドポイントを登録できます。baseUrl を aicentos に向ければ、Qwen Code 内で aicentos が接続しているモデルを利用できます。

準備

まずコンソールの「API キー」ページで、Qwen Code 専用のキーを作成してください(名前は qwen-code のようにすると使用量の追跡に便利です)。

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

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

設定値

項目値
auth タイプopenai(OpenAI 互換プロトコル)
baseUrlhttps://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 パスにしないでください。