Skip to Content
ユーザーガイドクイックスタート

クイックスタート

👏 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 | bash

Windows(管理者権限で 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
Note

インストール後は環境変数を確実に反映させるため、ターミナルを再起動することを推奨します。

手動インストール

前提条件

Node.js 20 以降がインストールされていることを確認してください。nodejs.org  からダウンロードできます。

NPM

npm install -g @qwen-code/qwen-code@latest

Homebrew(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 /auth

Qwen OAuth を選択し、アカウントにログインしてプロンプトに従って確認してください。ログインが完了すると認証情報が保存され、次回以降はログイン不要になります。

Note

Qwen アカウントで初めて Qwen Code を認証すると、「.qwen」というワークスペースが自動的に作成されます。このワークスペースは、組織内のすべての Qwen Code 利用状況に対するコスト追跡と管理を一元的に提供します。

Tip

セッションを開始せずに 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 structure

Qwen Code 自身の機能について質問することもできます:

what can Qwen Code do?
Note

Qwen Code は必要に応じてファイルを読み取るため、手動でコンテキストを追加する必要はありません。また、Qwen Code は自身のドキュメントにもアクセスできるため、機能や能力に関する質問にも回答できます。

最初のコード変更を行う

次に、Qwen Code に実際のコーディングを行わせてみましょう。簡単なタスクを試してみてください:

add a hello world function to the main file

Qwen Code は以下の手順で処理します:

  1. 適切なファイルを検索する
  2. 提案された変更を表示する
  3. 承認を求める
  4. 編集を適用する
Note

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/quickstart
show me the last 5 commits
help 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 it

Qwen 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
Tip

覚えておいてください:Qwen Code はあなたの AI ペアプログラマーです。頼りになる同僚に話すように、達成したい目標を説明すれば、それを実現する手助けをしてくれます。

必須コマンド

日常開発で最も重要なコマンドは以下の通りです:

コマンド説明
qwenQwen Code を起動するqwen
/auth認証方法を変更する(セッション内)/auth
qwen authターミナルから認証を設定するqwen auth
qwen auth status現在の認証ステータスを確認するqwen auth status
/help利用可能なコマンドのヘルプ情報を表示する/help または /?
/compressチャット履歴を要約に置き換えて Token を節約する/compress
/clearターミナル画面のコンテンツをクリアする/clear(ショートカット:Ctrl+L
/themeQwen Code のビジュアルテーマを変更する/theme
/language言語設定の表示または変更/language
ui [language]UI インターフェースの言語を設定する/language ui zh-CN
output [language]LLM の出力言語を設定する/language output Chinese
/quitQwen 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 schema
build a dashboard showing products that are most frequently returned by our UK customers

ショートカットで時間を節約する

  • ? キーを押して利用可能なすべてのキーボードショートカットを表示する
  • Tab キーでコマンドを補完する
  • キーでコマンド履歴を表示する
  • / を入力してすべてのスラッシュコマンドを表示する

ヘルプの入手方法

  • Qwen Code 内/help と入力するか、「〜するにはどうすればいいですか?」と質問する
  • ドキュメント:ここです!他のガイドも参照してください
  • コミュニティ:ヒントやサポートについては GitHub Discussion  に参加してください
Last updated on