クイックスタート
👏 Qwen Code へようこそ!
このクイックスタートガイドでは、わずか数分で AI を活用したコーディング支援を使い始められます。最後まで読むと、一般的な開発タスクで Qwen Code を活用する方法が理解できます。
始める前に
以下の準備が整っていることを確認してください:
- ターミナルまたはコマンドプロンプトが開いていること
- 作業対象のコードプロジェクト
- Qwen Code アカウント
ステップ 1: Qwen Code のインストール
Qwen Code をインストールするには、以下のいずれかの方法を使用してください:
クイックインストール(推奨)
Linux / macOS
curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.sh | bashWindows(管理者権限で CMD を実行)
curl -fsSL -o %TEMP%\install-qwen.bat https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen.bat && %TEMP%\install-qwen.batインストール後は環境変数を確実に反映させるため、ターミナルを再起動することを推奨します。
手動インストール
前提条件
Node.js 20 以降がインストールされていることを確認してください。nodejs.org からダウンロードできます。
NPM
npm install -g @qwen-code/qwen-code@latestHomebrew(macOS, Linux)
brew install qwen-codeステップ 2: アカウントにログインする
Qwen Code を使用するにはアカウントが必要です。qwen コマンドでインタラクティブセッションを開始すると、ログインが求められます:
# You'll be prompted to log in on first use
qwen# Follow the prompts to log in with your account
/authQwen OAuth を選択し、アカウントにログインしてプロンプトに従って確認してください。ログインが完了すると認証情報が保存され、次回以降はログイン不要になります。
Qwen アカウントで初めて Qwen Code を認証すると、「.qwen」というワークスペースが自動的に作成されます。このワークスペースは、組織内のすべての Qwen Code 利用状況に対するコスト追跡と管理を一元的に提供します。
セッションを開始せずに qwen auth を実行して、ターミナルから直接認証を設定することもできます。現在の設定はいつでも qwen auth status で確認できます。詳細は Authentication ページを参照してください。
ステップ 3: 最初のセッションを開始する
任意のプロジェクトディレクトリでターミナルを開き、Qwen Code を起動します:
# optiona
cd /path/to/your/project
# start qwen
qwenセッション情報、最近の会話、最新の更新が表示される Qwen Code のウェルカム画面が表示されます。利用可能なコマンドを確認するには /help と入力してください。
Qwen Code とチャットする
最初の質問をしてみる
Qwen Code がファイルを分析し、要約を提供します。より具体的な質問をすることもできます:
explain the folder structureQwen Code 自身の機能について質問することもできます:
what can Qwen Code do?Qwen Code は必要に応じてファイルを読み取るため、手動でコンテキストを追加する必要はありません。また、Qwen Code は自身のドキュメントにもアクセスできるため、機能や能力に関する質問にも回答できます。
最初のコード変更を行う
次に、Qwen Code に実際のコーディングを行わせてみましょう。簡単なタスクを試してみてください:
add a hello world function to the main fileQwen Code は以下の手順で処理します:
- 適切なファイルを検索する
- 提案された変更を表示する
- 承認を求める
- 編集を適用する
Qwen Code はファイルを修正する前に必ず許可を求めます。変更を個別に承認するか、セッション中に「すべて承認」モードを有効にできます。
Qwen Code で Git を使用する
Qwen Code を使えば、Git 操作を会話形式で実行できます:
what files have I changed?commit my changes with a descriptive messageより複雑な Git 操作をプロンプトで指示することもできます:
create a new branch called feature/quickstartshow me the last 5 commitshelp me resolve merge conflictsバグ修正や機能追加を行う
Qwen Code はデバッグや機能実装に優れています。
自然言語で希望を記述します:
add input validation to the user registration formまたは既存の問題を修正します:
there's a bug where users can submit empty forms - fix itQwen Code は以下の処理を行います:
- 関連するコードを特定する
- コンテキストを理解する
- 解決策を実装する
- テストが利用可能な場合は実行する
その他の一般的なワークフローを試す
Qwen Code を活用する方法は多岐にわたります:
コードのリファクタリング
refactor the authentication module to use async/await instead of callbacksテストの作成
write unit tests for the calculator functionsドキュメントの更新
update the README with installation instructionsコードレビュー
review my changes and suggest improvements覚えておいてください:Qwen Code はあなたの AI ペアプログラマーです。頼りになる同僚に話すように、達成したい目標を説明すれば、それを実現する手助けをしてくれます。
必須コマンド
日常開発で最も重要なコマンドは以下の通りです:
| コマンド | 説明 | 例 |
|---|---|---|
qwen | Qwen Code を起動する | qwen |
/auth | 認証方法を変更する(セッション内) | /auth |
qwen auth | ターミナルから認証を設定する | qwen auth |
qwen auth status | 現在の認証ステータスを確認する | qwen auth status |
/help | 利用可能なコマンドのヘルプ情報を表示する | /help または /? |
/compress | チャット履歴を要約に置き換えて Token を節約する | /compress |
/clear | ターミナル画面のコンテンツをクリアする | /clear(ショートカット:Ctrl+L) |
/theme | Qwen Code のビジュアルテーマを変更する | /theme |
/language | 言語設定の表示または変更 | /language |
→ ui [language] | UI インターフェースの言語を設定する | /language ui zh-CN |
→ output [language] | LLM の出力言語を設定する | /language output Chinese |
/quit | Qwen Code をすぐに終了する | /quit または /exit |
コマンドの完全なリストは CLI リファレンス を参照してください。
初心者向けプロのヒント
リクエストは具体的に
- 例:「バグを直して」
- 改善例:「認証情報を入力した後に画面が真っ白になるログインバグを修正して」
ステップバイステップで指示する
- 複雑なタスクはステップに分割します:
1. create a new database table for user profiles
2. create an API endpoint to get and update user profiles
3. build a webpage that allows users to see and edit their informationまずは Qwen Code にコードを探索させる
- 変更を加える前に、Qwen Code にコードを理解させます:
analyze the database schemabuild a dashboard showing products that are most frequently returned by our UK customersショートカットで時間を節約する
?キーを押して利用可能なすべてのキーボードショートカットを表示するTabキーでコマンドを補完する↑キーでコマンド履歴を表示する/を入力してすべてのスラッシュコマンドを表示する
ヘルプの入手方法
- Qwen Code 内:
/helpと入力するか、「〜するにはどうすればいいですか?」と質問する - ドキュメント:ここです!他のガイドも参照してください
- コミュニティ:ヒントやサポートについては GitHub Discussion に参加してください