認証

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

Qwen OAuth（推奨）：ブラウザで qwen.ai アカウントにサインインします。
OpenAI互換API：APIキーを使用します（OpenAIまたは任意のOpenAI互換プロバイダ／エンドポイント）。

オプション1：Qwen OAuth（推奨・無料）👍

最もシンプルなセットアップを行いたい場合や、Qwenモデルを使用する場合はこちらを選択してください。

仕組み：初回起動時にQwen Codeがブラウザのログインページを開きます。ログイン完了後、資格情報はローカルにキャッシュされるため、通常再度ログインする必要はありません。
要件：qwen.ai アカウント＋インターネット接続（少なくとも初回ログイン時）。
利点：APIキー管理不要、資格情報の自動更新。
コストとクォータ：無料で、60リクエスト／分および2,000リクエスト／日のクォータがあります。

CLI を起動してブラウザの指示に従ってください：


qwen

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

OpenAI モデルや、OpenAI 互換の API を提供する他のプロバイダー（例：OpenAI、Azure OpenAI、OpenRouter、ModelScope、阿里云百炼、またはセルフホスト型の互換エンドポイント）を使用したい場合に選択してください。

クイックスタート（インタラクティブ、ローカル利用推奨）

CLI で OpenAI 互換オプションを選択すると、以下の情報を入力するよう求められます：

API キー
ベース URL（デフォルト: https://api.openai.com/v1）
モデル（デフォルト: gpt-4o）

注意: CLI では確認のためにキーがプレーンテキストで表示されることがあります。ターミナルが録画・共有されていないことを確認してください。

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


 
# 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. .qwen/.env
2. .env
見つからない場合、ホームディレクトリをフォールバック先とします：
- ~/.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管理外にしてください）。
認証情報を確認のために出力する場合、ターミナルの出力を機密情報として扱ってください。

認証