クイックスタート
👏 Qwen Codeへようこそ!
このクイックスタートガイドでは、数分でAIによるコード支援を使い始めることができます。最後まで読めば、一般的な開発タスクでQwen Codeを使う方法がわかります。
始める前に
以下のものを準備してください:
- ターミナルまたはコマンドプロンプトを開いておくこと
- 作業するコードプロジェクトがあること
- Qwen Code のアカウントを持っていること
ステップ1:Qwen Codeをインストールする
Qwen Codeをインストールするには、以下のいずれかの方法を使用します:
NPM(推奨)
Node.js 20以上 が必要です。node -vでバージョンを確認できます。未インストールの場合は、以下のコマンドでインストールしてください。
すでにNode.jsまたはそれ以上のバージョンがインストールされている場合 は:
npm install -g @qwen-code/qwen-code@latestHomebrew(macOS、Linux)
brew install qwen-codeステップ 2: アカウントにログインする
Qwen Code を使用するにはアカウントが必要です。qwen コマンドでインタラクティブセッションを開始する際、ログインが必要になります:
# 初回使用時にログインを求められます
qwen
# プロンプトに従ってアカウントでログインしてください
/authQwen OAuth を選択し、アカウントにログインしてプロンプトに従って確認を行ってください。一度ログインすれば、認証情報が保存されるため再度ログインする必要はありません。
Qwen Code を Qwen アカウントで初めて認証する際、“.qwen” という名前のワークスペースが自動的に作成されます。このワークスペースは、組織内のすべての Qwen Code 使用量について、一元的なコスト追跡と管理を提供します。
再ログインやアカウントの切り替えが必要な場合は、Qwen Code 内で /auth コマンドを使用してください。
ステップ 3: 最初のセッションを開始する
任意のプロジェクトディレクトリでターミナルを開き、Qwen Code を起動します:
# オプション
cd /path/to/your/project
# qwen を開始する
qwenセッション情報、最近の会話、最新のアップデートとともに、Qwen Code のウェルカム画面が表示されます。利用可能なコマンドを確認するには /help と入力してください。
Qwen Code とのチャット
最初の質問をしてみる
Qwen Code はファイルを分析し、サマリーを提供します。さらに具体的な質問もできます:
explain the folder structureまた、Qwen Code 自身の機能についても質問できます:
what can Qwen Code do?Qwen Code は必要に応じてファイルを読み取ります - 手動でコンテキストを追加する必要はありません。また、Qwen Code は自身のドキュメントにもアクセスでき、その機能や能力に関する質問に答えることができます。
最初のコード変更を行う
では次に、Qwen Codeを使って実際にコードを書いてみましょう。簡単なタスクを試してみてください:
mainファイルにhello world関数を追加するQwen Codeは以下の処理を行います:
- 適切なファイルを探す
- 提案された変更内容を表示する
- 承認を求めます
- 編集を実行します
Qwen Codeはファイルを変更する前に必ず許可を求めます。個別の変更を承認することもできますし、セッション中に「すべて受け入れる」モードを有効にすることも可能です。
Qwen CodeでGitを使用する
Qwen Codeを使えば、Git操作も会話形式で行えます:
どのファイルを変更しましたか?変更内容を説明付きのメッセージでコミットしてくださいさらに複雑なGit操作もプロンプトで指示できます:
feature/quickstartという名前の新しいブランチを作成する直近の5つのコミットを表示するマージコンフリクトの解決を手伝ってくださいバグの修正または機能の追加
Qwen Code はデバッグと機能実装に精通しています。
自然言語で目的を記述してください:
ユーザー登録フォームにinputバリデーションを追加するまたは既存の問題を修正してください:
ユーザーが空のフォームを送信できるバグがあります - 修正してくださいQwen Code は以下を行います:
- 関連コードの特定
- コンテキストの理解
- ソリューションの実装
- 利用可能な場合はテストの実行
他の一般的なワークフローを試す
Claudeでの作業方法はいくつかあります:
コードのリファクタリング
認証モジュールをコールバックではなくasync/awaitを使用するようにリファクタリングしてくださいテストの作成
電卓機能のユニットテストを作成してくださいドキュメントの更新
READMEにインストール手順を追加してくださいコードレビュー
私の変更をレビューし、改善点を提案してください覚えておいてください:Qwen CodeはあなたのAIペアプログラマーです。役立つ同僚に対して話しかけるのと同じように、達成したいことを説明すれば、それに到達するお手伝いをしてくれます。
基本コマンド
日常的に使用する最も重要なコマンドは以下の通りです:
| コマンド | 機能 | 例 |
|---|---|---|
qwen | Qwen Code を起動 | qwen |
/auth | 認証方法を変更 | /auth |
/help | 利用可能なコマンドのヘルプ情報を表示 | /help または /? |
/compress | トークン節約のためにチャット履歴を要約に置き換え | /compress |
/clear | ターミナル画面の内容をクリア | /clear(ショートカット:Ctrl+L) |
/theme | Qwen Code の視覚テーマを変更 | /theme |
/language | 言語設定の確認または変更 | /language |
→ ui [language] | UI インターフェースの言語を設定 | /language ui ja-JP |
→ output [language] | LLM 出力の言語を設定 | /language output 日本語 |
/quit | Qwen Code を即時終了 | /quit または /exit |
すべてのコマンドの一覧については、CLI リファレンスをご参照ください。
初心者向けプロティップス
リクエストは具体的に
- 「バグを修正しろ」ではなく
- 「誤った認証情報入力後にユーザーが真っ暗画面を見るログインバグを修正しろ」というように具体的に
ステップバイステップの指示を使用する
- 複雑なタスクは以下のようにステップに分ける:
1. ユーザープロファイル用の新しいデータベーステーブルを作成する
2. ユーザープロファイルを取得・更新するためのAPIエンドポイントを作成する
3. ユーザーが自分の情報を表示・編集できるウェブページを構築するまずQwen Codeに探索させる
- 変更を行う前に、Qwen Codeにコードを理解させましょう:
データベーススキーマを分析する英国のお客様から最も頻繁に返品される商品を表示するダッシュボードを構築するショートカットで時間を節約
?を押して利用可能なすべてのキーボードショートカットを表示- コマンド補完にはTabを使用
- コマンド履歴には↑を使用
- すべてのスラッシュコマンドを見るには
/と入力
ヘルプを受ける
- Qwen Code 内で:
/helpと入力するか、「どうやって…」と尋ねてください - ドキュメント: ここにいます!他のガイドを参照してください
- コミュニティ: ヒントやサポートのために GitHub Discussion に参加してください