ターミナルでQwen Codeを実行し、編集モードを設定する方法

質問はこんな感じです。Qwenをコンソールで正しく動かして、自分でコードを書かせるにはどうすればよいのでしょうか。たいてい、その裏には失望があります。Qwen Codeをインストールして質問したものの、返ってきたのは文章とコードの断片だけ。それを手作業でコピーしなければならなかった。プロジェクトに入ってすべてを自分でこなすエージェントだと説明されていたのに、です。

まさにそれがQwen Codeです。本格的なエージェントで、ファイルを開き、編集し、自分でコマンドを実行できます。動作は承認モードによります。Ask Permissionsは確認を求め、Auto-EditとAutoはより自律的に動けます。Defaultという名前から初期状態を推測せず、ステータス行を確認してください。以下では、インストール、プロジェクト内での起動、4月の変更後のモデル接続、不要な確認を求めずにエージェントがコードを編集するモードへの切り替えを順に説明します。すべて2026年8月30日時点のQwen公式ドキュメントに照らして確認しました。

モデルとエージェントに関する実用的な資料：Ailootドキュメント。

「Qwen Codeが自分でコードを書く」とはどういう意味？#

違いは簡単です。ブラウザーのチャットは質問に文章で答えます。回答を読んで、コードをコピーし、ファイルに貼り付け、自分で実行し、自分でエラーを見つけて、チャットに戻します。チャットとプロジェクトの間を取り持つのはあなたです。

エージェントは違う方法で動きます。「問い合わせフォームを追加して」「このエラーを修正して」のように、自然な言葉でタスクを伝えます。すると、プロジェクトの構成を調べ、関係するファイルを見つけ、編集し、確認を実行します。ドキュメントにも、エージェントは計画を立て、コードを書き、動作することを確かめると明記されています。

質問に混乱が生じるのはここです。「Qwenが自分でコードを書かない」というのは、ほとんどの場合、ブラウザーのチャットを開いていてターミナルのエージェントを使っていないか、エージェントは動いているものの、編集のたびに許可を求めるモードになっているかのどちらかです。前者はQwen Codeをインストールすれば解決し、後者はモードを切り替えれば解決します。どちらの方法も以下で説明します。

ターミナルにQwen Codeをインストールする方法#

手早い方法は公式インストーラーです。システムに合ったバージョンが自動で選ばれます。

macOSとLinuxでは、ターミナルを開いて次の1行を貼り付けます。

curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash

Windowsでは、次のPowerShellコマンドを使います。

irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex

2つ目の方法はnpmです。すでにインストールしている場合に使えます。Node.jsのバージョン22以降が必要です。

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

インストール後、ターミナルを再起動します。インストーラーはシステムのパスにqwenコマンドを追加しますが、再起動するまでターミナルには反映されません。「インストールしたのにコマンドが見つからない」という問題が起きる最も一般的な理由です。正しくインストールされたか確認するには、次を実行します。

qwen --version

バージョン番号が表示されれば、エージェントのインストールは完了しており、プロジェクトで起動できます。

プロジェクトでQwen Codeを実行する方法#

まず、コードがあるフォルダーに移動します。エージェントは起動したフォルダー内で動作し、その中身だけを見るため、これは重要です。

cd path-to-your-project
qwen

エージェントの画面がターミナル内に開きます。初回はモデルの接続を案内されます。接続方法は次のセクションで説明します。モデルを接続したら、まずは自然な言葉でタスクを渡し、何にアクセスできるか確かめてみましょう。

このプロジェクトは何をするものですか？

エージェントはファイルを読み、構成を理解して、役に立つ回答を返します。その後、「ログアウトボタンを追加して」「このファイルを2つに分けて」「テストが失敗する理由を調べて」のように、コードを書いたり編集したりするよう依頼できます。エージェントは関係する箇所を見つけ、自分で変更します。

画面を使わず、コマンド1つで起動する方法もあります。スクリプトや自動化されたタスクに便利です。

qwen -p "READMEを読み直して、コマンド一覧を更新してください"

会話を続けずにタスクを実行して終了します。最初のうちは使う必要はありませんが、後で役立つので覚えておくとよいでしょう。

エージェントは起動しているのに自分で作業しないのはなぜ？#

最初のつまずきはモデルへのアクセスです。以前のQwen Codeでは無料アクセスが提供されていました。qwen.aiアカウントでログインすれば、カードなしでエージェントを使えました。このアクセスはQwen OAuthと呼ばれていましたが、提供が終了しました。認証ドキュメントには、無料のQwen OAuthプランは2026年4月15日に終了し、以前に保存したログイン情報は短期間使える可能性があるものの、サーバーは新しいリクエストを拒否すると明記されています。「qwen.aiでサインイン」するオプションもメニューから削除されました。

そのため、エージェントにタスクを考えさせるには、モデルを接続する必要があります。次のセクションでは、有料と無料のローカル接続方法を説明します。

2つ目の理由は見えにくく、さらにもどかしいものです。モデルは接続されていてエージェントも応答するのに、ファイルを編集せず、何をするつもりかを示すだけで待っている。Ask Permissionsでは編集やコマンドごとに確認するため、想定された動作です。すべての導入環境で同じ起動時既定値という証拠ではありません。自分で作業させるには、モードを切り替える必要があります。元の質問への答えは、その2つ先のセクションにあります。

無料アクセス終了後にモデルを接続する方法#

エージェント内で、次のコマンドを入力します。

/auth

3つの主な選択肢があるメニューが開きます。それぞれの機能を説明します。

Alibaba ModelStudioは、Qwenの開発元が提供する公式オプションです。個人開発者向けに、固定料金で週ごとの利用枠があるCoding Plan、チーム向けの従量課金制Token Plan、既存のModelStudioキーを接続するオプションを用意しています。Qwenの「ネイティブ」モデルを使う有料アクセスです。

サードパーティープロバイダーでは、組み込みのプロバイダーを選び、キーを使って接続できます。公式リストにはDeepSeek、Grok、MiniMax、Z.AI、Kimi、ModelScopeなどが含まれています。プロバイダーからキーを取得して入力すれば、エージェントはそのプロバイダーのモデルを使います。

Custom Providerでは、自分のサーバー、プロキシ、ローカルエンジンを接続します。ここから、Ollamaを使って自分のコンピューター上で動作するモデルを接続できます。OpenAI、Anthropic、Geminiの形式に対応しているため、ほぼどのようなアクセス方法でも利用できます。

キーと設定を~/.qwen/settings.jsonファイルに手動で入力することもできます。このファイルには、利用可能なモデルを指定するmodelProvidersフィールド、キーそのものを記述するenv、起動時に有効にするプロトコルを指定するsecurity.auth.selectedType、デフォルトのモデルを指定するmodel.nameがあります。その後はqwenを起動すると設定が使われ、質問されることはありません。初回は/authから進めるほうが簡単です。設定をまとめて保存したくなったら、ファイルを使うとよいでしょう。

4月以降に無料で使えたものについては、無料のQwen Codeに関する記事をご覧ください。

エージェントに自分でコードを編集させるには、どのモードを有効にすればよい？#

基本的な考え方は、アクセスモードによってエージェントの自律性が決まるということです。モードは慎重なものから自由度の高いものまで5つあります。

エージェントが編集内容を表示して待っているだけなら、おそらくAsk Permissionsモードです（古いバージョンではDefaultと呼ばれていました）。このモードでは編集とコマンドのたびに手動で確認する必要があるため、エージェントが自分で何もしていないように感じます。

確認なしでファイルを編集させたい場合は、Auto-Editに切り替えます。編集は自動で行われますが、コマンドの実行前には引き続き確認を求めます。誤った場所でrmを実行してしまうことを防ぐ、理にかなった安全策です。

Autoは評価が必要な操作に内部の評価器を使います。導入版と現在の状態を確認して、意図的に選んでください。Ask Permissions設定に残るdefaultは互換用の名前で、起動時のモードを証明しません。

YOLOは最も自由度の高いモードです。エージェントは何も確認せず、自分でファイルを編集してコマンドを実行します。ドキュメントでは、信頼できる個人プロジェクトや自動化されたワークフローでのみ使うよう説明しています。仕事のプロジェクトでは意図しない結果になりやすいため、冷静な判断ができるときに、できればコピー上でのみ有効にしてください。

セッション中にモードを切り替える方法#

タスクの途中でもモードを切り替えられます。Shift+Tabを押すと次のモードに進みます。Windowsでは通常のTabキーでも同じです。Plan、確認、Auto-Edit、Auto、YOLOの順に切り替わり、最後にPlanへ戻ります。

現在のモードは、画面の下部にあるステータス行に常に表示されます。大きなタスクを渡す前に確認する習慣をつけましょう。計画を見たいだけなのに、YOLOを起動する事態を防げます。

初心者向けのワークフローは3つのステップです。

1. Planモードでエージェントを起動し、タスクを分析して計画を提案するよう依頼します。何にも触れず、コードを読むだけで、これから行うことを説明します。
2. 計画を読み、納得できたらShift+Tabを押してAuto-EditまたはAutoに切り替えます。
3. 続行するよう伝えます。エージェントはあなたが結果を確認する中で、自分でファイルを編集するようになります。

この方法なら、初心者が最も不安に感じる「エージェントがいきなり全部を壊す」という事態を避けられます。安全なモードで先に計画を確認してから、実行に進ませるのです。

バイブコーディングの手法は、特定のツールではなく方法そのものが軸になります。QwenでもClaudeでも、下で動くモデルは変更できます。モデルを切り替えても成果を維持するための基盤は、AIクローン、Second Brain、コンテキストエンジニアリングの3つです。これらを組み合わせれば、結果を予測しやすくなり、その場限りの幸運に頼らずに済みます。

カードなしで使えるローカルモデル#

OllamaまたはvLLMを使ってオープンモデルをコンピューターにインストールし、/authメニューからCustom Providerとして接続します。これでエージェントは、Alibabaのクラウドではなく自分のマシン上のモデルを使います。カードもキーも不要で、リクエスト制限もありません。コーディングをこなせるオープンモデルについては、無料のコーディングモデルのレビューをご覧ください。

注意点はハードウェアです。十分なコードを書けるモデルは、多くのビデオメモリーを使います。高性能なグラフィックカードを搭載したゲーミングPCなら実用的ですが、一般的なノートパソコンではモデルが収まらないか、回答を考えるのに時間がかかりすぎて、別の方法を探すほうがよいかもしれません。

ローカルで実行するもう1つの利点は、データのプライバシーです。コードはすべて自分のコンピューターに残り、他者のサーバーには送信されません。機密性の高いプロジェクトでは、サブスクリプション料金を節約することよりも大切です。

エージェントによるプロジェクトの破損を防ぐには？#

自律的なエージェントは、望みどおりに動いている限り便利です。失敗が損失につながらないよう、3つの習慣を守りましょう。

まず、gitを使います。プロジェクトをバージョン管理していれば、エージェントが行った変更をすべて確認し、どの変更も元に戻せます。gitを使わずに自律的なエージェントを使うのは本当に危険です。何かを変更されても、以前のバージョンに戻す方法がありません。gitがあれば、短いコマンド1つで元に戻せます。

次に、Planモードで始めます。エージェントに大きなタスクを任せる前に、何にも触れないモードで計画を立てるよう依頼します。計画を読んで、エージェントが何をするつもりか理解してから、編集に切り替えましょう。

最後に、YOLOの使用には注意します。このモードでは、ファイルを削除するコマンドも含めて、エージェントが自分でコマンドを実行します。仕事のプロジェクトには自由度が高すぎます。失敗しても問題にならない複製や小さなタスクに限って使いましょう。

この3つの習慣が、「バイブコーディングをしたら壊してしまった」という最大の不安に対処します。バイブコーディングで変更を元に戻す方法については、別のレビューをご覧ください。Claude Codeについての記事ですが、gitを使う原則はまったく同じです。

自分のタスクを始めるには？#

全体の手順を短くまとめました。上から順に進めてください。

1. Qwen Codeをコマンド1つでインストールし、ターミナルを再起動します。
2. cdでプロジェクトフォルダーに移動し、qwenを実行します。
3. /authでモデルを接続します。カードで支払えない場合は、有料プランまたはOllama経由のローカルモデルを選びます。
4. Planモードでエージェントにタスクを伝え、計画を読みます。
5. Shift+TabでAuto-EditまたはAutoに切り替え、作業させます。
6. 変更を元に戻せるように、プロジェクトをgitで管理します。

要するに、「Qwenが自分でコードを書かない」のは、ほとんどの場合、モデルが接続されていないか、エージェントが確認を求めるモードになっているからです。前者は/authメニューで、後者はShift+Tabを押してAuto-Editに切り替えることで解決します。その後は、エージェントが本当にターミナル内で自律的に作業します。

タスクに合うエージェントを他と比較したい場合は、Claude Codeの代替ツールに関するレビューをご覧ください。Qwenもほかのエージェントと並んでいるので、用途に合うものを確認できます。

バイブコーディング全体の進め方では、特定のエージェントよりも手法が重要です。AIクローン、Second Brain、コンテキストエンジニアリングを組み合わせます。下で動くツールは変更できますが、手法は変わりません。実用的な資料：Ailootドキュメント。

その他の資料とツール：Ailoot。