認証

Qwen Code は2つの認証方法をサポートしています。CLI を実行する方法に合ったものを選択してください。

• Qwen OAuth (推奨): ブラウザで qwen.ai アカウントを使用してサインインします。
• OpenAI 互換 API: API キー (OpenAI または任意の OpenAI 互換プロバイダー / エンドポイント) を使用します。

オプション 1: Qwen OAuth (推奨 & 無料) 👍

Qwen モデルを使用しており、最も簡単なセットアップを行いたい場合にこちらをご利用ください。

• 仕組み: 最初の起動時に、Qwen Code がブラウザのログインページを開きます。ログインが完了すると、認証情報はローカルにキャッシュされるため、通常は次回以降のログインは不要です。
• 必要条件: qwen.ai アカウント + インターネット接続（初回ログイン時のみ最低限必要）
• 利点: API キー管理が不要、認証情報の自動更新
• 料金と割当: 無料で、1分あたり60リクエスト、1日あたり2,000リクエストの割当があります。

CLI を起動し、ブラウザでの処理に従ってください：

qwen

オプション 2: OpenAI 互換 API (API キー)

OpenAI モデルまたは OpenAI 互換 API を提供する任意のプロバイダ (例: OpenAI、Azure OpenAI、OpenRouter、ModelScope、Alibaba Cloud Bailian、またはセルフホスト型の互換エンドポイント) を使用したい場合にご利用ください。

推奨: コーディングプラン (サブスクリプション制) 🚀

qwen3-coder-plus モデルのより高い利用割当で予測可能なコストを望む場合にご利用ください。

• 仕組み: 固定の月額料金でコーディングプランに登録し、Qwen Code を専用エンドポイントとサブスクリプション API キーを使用するように設定します。
• 必要条件: Alibaba Cloud Bailian  からの有効なコーディングプランサブスクリプション。
• メリット: より高い利用割当、予測可能な月額コスト、最新の qwen3-coder-plus モデルへのアクセス。
• 料金と割当: プランによって異なります (下記表参照)。

コーディングプランの価格とクォータ

コーディングプランのクイックセットアップ

CLIでOpenAI互換オプションを選択する際は、以下の値を入力してください：

• APIキー: sk-sp-xxxxx
• ベースURL: https://coding.dashscope.aliyuncs.com/v1
• モデル: qwen3-coder-plus

注: コーディングプランのAPIキーは sk-sp-xxxxx の形式であり、標準のAlibaba Cloud APIキーとは異なります。

環境変数による設定

以下の環境変数を設定して、Coding Plan を使用します。

export OPENAI_API_KEY="your-coding-plan-api-key"  # 形式: sk-sp-xxxxx
export OPENAI_BASE_URL="https://coding.dashscope.aliyuncs.com/v1"
export OPENAI_MODEL="qwen3-coder-plus"

サブスクリプションオプションやトラブルシューティングなど、Coding Plan の詳細については、完全な Coding Plan ドキュメント を参照してください。

その他の OpenAI 互換プロバイダー

他のプロバイダー (OpenAI、Azure、ローカル LLM など) を使用している場合は、以下の設定方法を使用してください。

コマンドライン引数による設定

 
# API キーのみ
qwen-code --openai-api-key "your-api-key-here"
 
# カスタムベース URL (OpenAI 互換エンドポイント)
qwen-code --openai-api-key "your-api-key-here" --openai-base-url "https://your-endpoint.com/v1"
 
# カスタムモデル
qwen-code --openai-api-key "your-api-key-here" --model "gpt-4o-mini"

環境変数による設定

これらをシェルプロファイル、CI、または .env ファイルで設定できます。

export OPENAI_API_KEY="your-api-key-here"
export OPENAI_BASE_URL="https://api.openai.com/v1"  # 省略可能
export OPENAI_MODEL="gpt-4o"                        # 省略可能

.env / .qwen/.env による環境変数の永続化

Qwen Code は最初に見つかった .env ファイルから環境変数を自動的に読み込みます（複数のファイル間で変数はマージされません）。

検索順序:

1. 現在のディレクトリから / に向かって上方向に探索:
   1. .qwen/.env
   2. .env
2. 何も見つからない場合、ホームディレクトリにフォールバック:
   • ~/.qwen/.env
   • ~/.env

他のツールから Qwen Code の変数を分離するため、.qwen/.env の使用を推奨します。一部の変数（DEBUG や DEBUG_MODE など）は、qwen-code の動作に干渉しないようにプロジェクトの .env ファイルから除外されます。

例:

 
# プロジェクト固有の設定（推奨）
```bash
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 UI で以下を実行します：

/auth

非対話型 / ヘッドレス環境（CI、SSH、コンテナ）

非対話型ターミナルでは通常、OAuthブラウザログインフローを完了できません。 代わりに、環境変数経由でOpenAI互換API方式を使用してください：

• 少なくとも OPENAI_API_KEY を設定してください。
• 必要に応じて OPENAI_BASE_URL と OPENAI_MODEL も設定できます。

非対話型セッションでこれらのいずれも設定されていない場合、Qwen Code はエラー終了します。

セキュリティに関する注意点

• APIキーをバージョン管理にコミットしないでください。
• プロジェクトローカルのシークレットには .qwen/.env を使用してください（そして、それを Git から除外してください）。
• 認証情報を表示して検証する場合、ターミナル出力は機密情報として扱ってください。