Skip to Content
CLI認証

認証の設定

Qwen Code では、AI モデルにアクセスするための認証方法が 2 つ用意されています。利用目的に応じて最適な方法を選択してください。

  1. Qwen OAuth（推奨）：

    • qwen.ai アカウントでログインする場合に使用します。
    • 初回起動時に、Qwen Code は qwen.ai の認証ページへリダイレクトします。認証が完了すると、資格情報がローカルにキャッシュされるため、次回以降は Web ログインをスキップできます。
    • 必要条件：
      • 有効な qwen.ai アカウント
      • 初回認証時にインターネット接続が必要
    • メリット：
      • Qwen モデルへのシームレスなアクセス
      • 資格情報の自動更新
      • API キーの手動管理が不要

    クイックスタート：

    # Qwen Code を起動し、OAuth フローに従ってください
qwen

    CLI が自動的にブラウザを開き、認証プロセスをガイドします。

    qwen.ai アカウントで認証するユーザー向け：

    クォータ：

    • 1 分あたり 60 リクエスト
    • 1 日あたり 2,000 リクエスト
    • トークン使用量の制限なし

    料金： 無料

    注意： モデルごとの具体的なクォータは設定されていません。共有体験の品質を保つため、モデルのフォールバックが発生する場合があります。

  2. OpenAI 互換 API：

    • OpenAI またはその他の互換プロバイダの API キーを使用します。
    • この方法により、API キーを通してさまざまな AI モデルを利用できます。

    設定方法：

    a) 環境変数による設定：

    export OPENAI_API_KEY="your_api_key_here"
export OPENAI_BASE_URL="your_api_endpoint"  # 任意
export OPENAI_MODEL="your_model_choice"     # 任意

    b) プロジェクトの .env ファイルによる設定：
    プロジェクトのルートディレクトリに .env ファイルを作成してください：

    OPENAI_API_KEY=your_api_key_here
OPENAI_BASE_URL=your_api_endpoint
OPENAI_MODEL=your_model_choice

    サポートされているプロバイダ：

認証方法の切り替え

セッション中に認証方法を切り替えるには、CLIインターフェースで /auth コマンドを使用します：

 
# CLI内で以下を入力:
/auth

これにより、アプリケーションを再起動せずに認証方法を再設定できます。

.env ファイルによる環境変数の永続化

プロジェクトディレクトリまたはホームディレクトリに .qwen/.env ファイルを作成できます。通常の .env ファイルでも動作しますが、Qwen Code の変数を他のツールと分離するために .qwen/.env を推奨します。

重要: 一部の環境変数（DEBUG や DEBUG_MODE など）は、qwen-code の動作に干渉するのを防ぐため、プロジェクトの .env ファイルからは自動的に除外されます。qwen-code 固有の変数には .qwen/.env ファイルを使用してください。

Qwen Code は以下の検索順序で 最初に見つけた .env ファイルから自動的に環境変数を読み込みます：

  1. カレントディレクトリ から始めて / に向かって上位ディレクトリを探索し、各ディレクトリで以下をチェック：
    1. .qwen/.env
    2. .env
  2. ファイルが見つからない場合、ホームディレクトリ をフォールバック先とします：
    • ~/.qwen/.env
    • ~/.env

重要: 検索は 最初に見つけた ファイルで停止します—複数のファイルにまたがって変数が マージされることはありません。

例

プロジェクト固有のオーバーライド（プロジェクト内にいるときに優先される）：

mkdir -p .qwen
cat >> .qwen/.env <<'EOF'
OPENAI_API_KEY="your-api-key"
OPENAI_BASE_URL="https://api-inference.modelscope.cn/v1"
OPENAI_MODEL="Qwen/Qwen3-Coder-480B-A35B-Instruct"
EOF

ユーザー全体の設定（すべてのディレクトリで利用可能）：

mkdir -p ~/.qwen
cat >> ~/.qwen/.env <<'EOF'
OPENAI_API_KEY="your-api-key"
OPENAI_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"
OPENAI_MODEL="qwen3-coder-plus"
EOF

非対話モード / ヘッドレス環境

Qwen Code を非対話環境で実行する場合、OAuth ログインフローは使用できません。
代わりに、環境変数を使って認証を設定する必要があります。

CLI は自動的に非対話型ターミナルでの実行を検出し、設定されている場合は
OpenAI 互換の API メソッドを使用します：

  1. OpenAI 互換 API:
    • OPENAI_API_KEY 環境変数を設定します。
    • カスタムエンドポイントを使用する場合、オプションで OPENAI_BASE_URL と OPENAI_MODEL を設定できます。
    • CLI はこれらの認証情報を使用して、API プロバイダーに対して認証を行います。

ヘッドレス環境での実行例:

非対話セッションでこれらの環境変数がいずれも設定されていない場合、CLI はエラーで終了します。

Qwen Code をプログラム的に、または自動化ワークフローで使用する方法について詳しく知るには、
Headless Mode Guide を参照してください。

Last updated on
はじめにOpenAI 認証