# ターミナルでQwen Codeを実行し、編集モードを設定する方法 > Qwen Codeのインストール、プロジェクト内での起動、authによるモデル接続、Plan、Auto-Edit、Auto、YOLOモード、ローカルモデル、プロジェクトの保護について。 Source: https://ailoot.ai/blog/ja/qwen-code-terminal-auto-edit/ Canonical: https://ailoot.ai/blog/ja/qwen-code-terminal-auto-edit/ Language: ja Publisher: Ailoot (https://ailoot.ai/) Translation: guide-153 Revision: sha256-be4fcb197db8f3fdc9c12995097520f5bc1372ae66d08cad1db8a8d1164adeb4 質問はこんな感じです。Qwenをコンソールで正しく動かして、自分でコードを書かせるにはどうすればよいのでしょうか。たいてい、その裏には失望があります。Qwen Codeをインストールして質問したものの、返ってきたのは文章とコードの断片だけ。それを手作業でコピーしなければならなかった。プロジェクトに入ってすべてを自分でこなすエージェントだと説明されていたのに、です。 まさにそれがQwen Codeです。本格的なエージェントで、ファイルを開き、編集し、自分でコマンドを実行できます。動作は承認モードによります。Ask Permissionsは確認を求め、Auto-EditとAutoはより自律的に動けます。Defaultという名前から初期状態を推測せず、ステータス行を確認してください。以下では、インストール、プロジェクト内での起動、4月の変更後のモデル接続、不要な確認を求めずにエージェントがコードを編集するモードへの切り替えを順に説明します。すべて2026年8月30日時点のQwen公式ドキュメントに照らして確認しました。 モデルとエージェントに関する実用的な資料：[Ailootドキュメント](https://ailoot.ai/docs/)。 ## 「Qwen Codeが自分でコードを書く」とはどういう意味？
重要なポイント Qwen Codeはターミナルで動くAIエージェントです。プロジェクト全体を読み込み、自分でファイルを開いて編集し、コマンドを実行して結果を確認します。ブラウザーのチャットでは、手作業で転記する文章が返ってきます。エージェントはコードフォルダー内で直接動作します。公式の説明は「ターミナル内で動作するオープンソースのAIコーディングエージェント」です。
違いは簡単です。ブラウザーのチャットは質問に文章で答えます。回答を読んで、コードをコピーし、ファイルに貼り付け、自分で実行し、自分でエラーを見つけて、チャットに戻します。チャットとプロジェクトの間を取り持つのはあなたです。 エージェントは違う方法で動きます。「問い合わせフォームを追加して」「このエラーを修正して」のように、自然な言葉でタスクを伝えます。すると、プロジェクトの構成を調べ、関係するファイルを見つけ、編集し、確認を実行します。ドキュメントにも、エージェントは計画を立て、コードを書き、動作することを確かめると明記されています。 質問に混乱が生じるのはここです。「Qwenが自分でコードを書かない」というのは、ほとんどの場合、ブラウザーのチャットを開いていてターミナルのエージェントを使っていないか、エージェントは動いているものの、編集のたびに許可を求めるモードになっているかのどちらかです。前者はQwen Codeをインストールすれば解決し、後者はモードを切り替えれば解決します。どちらの方法も以下で説明します。 ## ターミナルにQwen Codeをインストールする方法
重要なポイント コマンド1つでインストールできます。macOSとLinuxでは、公式Qwenインストーラーまたはnpmを使います（Node.js 22以降が必要です）。Windowsでは、PowerShellのコマンドを使います。インストール後はターミナルを再起動してください。そうしないと、`qwen`コマンドが見つからないことがあります。インストールは無料で、誰でも同じ手順です。費用が発生するのは、その後モデルにアクセスするときです。
手早い方法は公式インストーラーです。システムに合ったバージョンが自動で選ばれます。 macOSとLinuxでは、ターミナルを開いて次の1行を貼り付けます。 ```bash curl -fsSL https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.sh | bash ``` Windowsでは、次のPowerShellコマンドを使います。 ```powershell irm https://qwen-code-assets.oss-cn-hangzhou.aliyuncs.com/installation/install-qwen-standalone.ps1 | iex ``` 2つ目の方法はnpmです。すでにインストールしている場合に使えます。Node.jsのバージョン22以降が必要です。 ```bash npm install -g @qwen-code/qwen-code@latest ``` インストール後、ターミナルを再起動します。インストーラーはシステムのパスに`qwen`コマンドを追加しますが、再起動するまでターミナルには反映されません。「インストールしたのにコマンドが見つからない」という問題が起きる最も一般的な理由です。正しくインストールされたか確認するには、次を実行します。 ```bash qwen --version ``` バージョン番号が表示されれば、エージェントのインストールは完了しており、プロジェクトで起動できます。 ## プロジェクトでQwen Codeを実行する方法
重要なポイント `cd`コマンドでプロジェクトフォルダーに移動し、`qwen`と入力します。エージェントのターミナル画面が開きます。初回起動時に、`/auth`メニューからモデルを接続するよう求められます。その後は自然な言葉でタスクを書けば、エージェントがプロジェクトを調べて作業を始めます。大切なのは、エージェントがすべてのファイルを見られるよう、プロジェクトフォルダーから起動することです。
まず、コードがあるフォルダーに移動します。エージェントは起動したフォルダー内で動作し、その中身だけを見るため、これは重要です。 ```bash cd path-to-your-project qwen ``` エージェントの画面がターミナル内に開きます。初回はモデルの接続を案内されます。接続方法は次のセクションで説明します。モデルを接続したら、まずは自然な言葉でタスクを渡し、何にアクセスできるか確かめてみましょう。 ``` このプロジェクトは何をするものですか？ ``` エージェントはファイルを読み、構成を理解して、役に立つ回答を返します。その後、「ログアウトボタンを追加して」「このファイルを2つに分けて」「テストが失敗する理由を調べて」のように、コードを書いたり編集したりするよう依頼できます。エージェントは関係する箇所を見つけ、自分で変更します。 画面を使わず、コマンド1つで起動する方法もあります。スクリプトや自動化されたタスクに便利です。 ```bash qwen -p "READMEを読み直して、コマンド一覧を更新してください" ``` 会話を続けずにタスクを実行して終了します。最初のうちは使う必要はありませんが、後で役立つので覚えておくとよいでしょう。 ## エージェントは起動しているのに自分で作業しないのはなぜ？
重要なポイント Ask Permissionsが有効なら、編集やコマンド前に確認を待つためです。また、編集を行う前にモデルを接続する必要があります。Alibabaは2026年4月15日にqwen.ai経由の無料アクセスを終了したため、モデルに接続できていなければ、エージェントはタスクを考えることすらできません。「ただ待っている」状態になる一般的な理由は、モデルが未接続であること、または確認を求める慎重なモードが有効になっていることの2つです。
最初のつまずきはモデルへのアクセスです。以前のQwen Codeでは無料アクセスが提供されていました。qwen.aiアカウントでログインすれば、カードなしでエージェントを使えました。このアクセスはQwen OAuthと呼ばれていましたが、提供が終了しました。認証ドキュメントには、無料のQwen OAuthプランは2026年4月15日に終了し、以前に保存したログイン情報は短期間使える可能性があるものの、サーバーは新しいリクエストを拒否すると明記されています。「qwen.aiでサインイン」するオプションもメニューから削除されました。 そのため、エージェントにタスクを考えさせるには、モデルを接続する必要があります。次のセクションでは、有料と無料のローカル接続方法を説明します。 2つ目の理由は見えにくく、さらにもどかしいものです。モデルは接続されていてエージェントも応答するのに、ファイルを編集せず、何をするつもりかを示すだけで待っている。Ask Permissionsでは編集やコマンドごとに確認するため、想定された動作です。すべての導入環境で同じ起動時既定値という証拠ではありません。自分で作業させるには、モードを切り替える必要があります。元の質問への答えは、その2つ先のセクションにあります。 ## 無料アクセス終了後にモデルを接続する方法
重要なポイント 初回起動時に`/auth`コマンドを使うと、3つの選択肢があるメニューが開きます。Alibaba ModelStudioは公式の有料オプションです（個人ユーザーは週ごとの利用枠があるCoding Planを利用できます）。サードパーティープロバイダーは、DeepSeek、Kimiなどにキーで接続します。Custom Providerでは、Ollamaなどを通じて自分のモデルやローカルモデルを接続できます。カードなしで無料で使えるのは、最後のローカルモデルだけです。
エージェント内で、次のコマンドを入力します。 ``` /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に関する記事](https://ailoot.ai/blog/ja/qwen-code-free-limits/)をご覧ください。 ## エージェントに自分でコードを編集させるには、どのモードを有効にすればよい？
重要なポイント 5モードの公式早見表ではAutoを既定としますが、Ask Permissions節には古い初期モードの記述も残ります。版を明示しないページだけでは全導入環境の初期値は確定できません。現在のモードを確認してください。Autoは分類器で評価対象の操作を許可・拒否します。確認なしでファイルを編集させたい場合はAuto-Editを使います。編集とコマンド実行を一切確認せずに任せるならYOLOですが、自分のプロジェクトに限り、慎重に使ってください。モードを切り替えることで、「何でも確認する」状態と「自分で作業する」状態を切り替えられます。
基本的な考え方は、アクセスモードによってエージェントの自律性が決まるということです。モードは慎重なものから自由度の高いものまで5つあります。 | モード | ファイルを編集 | コマンドを実行 | 用途 | |----|----|----|----| | Plan | いいえ、読み取り専用 | いいえ | 何も変更せずにプロジェクトを理解し、計画を立てる | | Ask Permissions | 確認あり | 確認あり | 慣れていないコードや重要なコードで、すべての手順を確認したい場合 | | Auto-Edit | 自動 | 確認あり | 多数の小さな編集を行い、コマンドは自分で管理したい場合 | | Auto | 安全性評価に基づく | 安全性評価に基づく | 保護策を設けて長時間、自律的に作業させる場合 | | YOLO | 自動 | 自動 | エージェントにすべてを任せられる、自分のプロジェクト | エージェントが編集内容を表示して待っているだけなら、おそらくAsk Permissionsモードです（古いバージョンではDefaultと呼ばれていました）。このモードでは編集とコマンドのたびに手動で確認する必要があるため、エージェントが自分で何もしていないように感じます。 確認なしでファイルを編集させたい場合は、Auto-Editに切り替えます。編集は自動で行われますが、コマンドの実行前には引き続き確認を求めます。誤った場所で`rm`を実行してしまうことを防ぐ、理にかなった安全策です。 Autoは評価が必要な操作に内部の評価器を使います。導入版と現在の状態を確認して、意図的に選んでください。Ask Permissions設定に残る`default`は互換用の名前で、起動時のモードを証明しません。 YOLOは最も自由度の高いモードです。エージェントは何も確認せず、自分でファイルを編集してコマンドを実行します。ドキュメントでは、信頼できる個人プロジェクトや自動化されたワークフローでのみ使うよう説明しています。仕事のプロジェクトでは意図しない結果になりやすいため、冷静な判断ができるときに、できればコピー上でのみ有効にしてください。 ## セッション中にモードを切り替える方法
重要なポイント エージェントを使ったままShift+Tabを押すと（WindowsではTab）、Plan、確認、Auto-Edit、Auto、YOLO、Planの順にモードが切り替わります。現在のモードは画面下部のステータス行に表示されます。Planで始めてタスクを確認し、その後Auto-EditかAutoに切り替えてエージェントに作業させると便利です。
タスクの途中でもモードを切り替えられます。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つです。これらを組み合わせれば、結果を予測しやすくなり、その場限りの幸運に頼らずに済みます。 ## カードなしで使えるローカルモデル
重要なポイント はい、ローカルモデルを使えます。Qwen Codeは、Ollamaなどのプログラムを通じて、コンピューター上で直接動作するモデルを利用できます。`/auth`メニューからCustom Providerとして接続してください。Alibabaのクラウドは必要ありません。オープンモデルは無料でダウンロードでき、カードも不要です。プロジェクトのデータは自分のマシンから外に出ません。その代わり、十分に高性能なコンピューターが必要です。そうでないとエージェントの思考が遅くなります。
OllamaまたはvLLMを使ってオープンモデルをコンピューターにインストールし、`/auth`メニューからCustom Providerとして接続します。これでエージェントは、Alibabaのクラウドではなく自分のマシン上のモデルを使います。カードもキーも不要で、リクエスト制限もありません。コーディングをこなせるオープンモデルについては、[無料のコーディングモデルのレビュー](https://ailoot.ai/blog/ja/free-coding-models/)をご覧ください。 注意点はハードウェアです。十分なコードを書けるモデルは、多くのビデオメモリーを使います。高性能なグラフィックカードを搭載したゲーミングPCなら実用的ですが、一般的なノートパソコンではモデルが収まらないか、回答を考えるのに時間がかかりすぎて、別の方法を探すほうがよいかもしれません。 ローカルで実行するもう1つの利点は、データのプライバシーです。コードはすべて自分のコンピューターに残り、他者のサーバーには送信されません。機密性の高いプロジェクトでは、サブスクリプション料金を節約することよりも大切です。 ## エージェントによるプロジェクトの破損を防ぐには？
重要なポイント 3つのことを実践しましょう。プロジェクトをgitでバージョン管理すれば、エージェントの変更をコマンド1つで元に戻せます。タスクはPlanモードで開始し、エージェントに進めさせる前に計画を読みましょう。仕事のプロジェクトではYOLOを有効にせず、コピーや小規模な実験に限って使います。こうすれば、エージェントの自律性をうまく活用できます。
自律的なエージェントは、望みどおりに動いている限り便利です。失敗が損失につながらないよう、3つの習慣を守りましょう。 まず、gitを使います。プロジェクトをバージョン管理していれば、エージェントが行った変更をすべて確認し、どの変更も元に戻せます。gitを使わずに自律的なエージェントを使うのは本当に危険です。何かを変更されても、以前のバージョンに戻す方法がありません。gitがあれば、短いコマンド1つで元に戻せます。 次に、Planモードで始めます。エージェントに大きなタスクを任せる前に、何にも触れないモードで計画を立てるよう依頼します。計画を読んで、エージェントが何をするつもりか理解してから、編集に切り替えましょう。 最後に、YOLOの使用には注意します。このモードでは、ファイルを削除するコマンドも含めて、エージェントが自分でコマンドを実行します。仕事のプロジェクトには自由度が高すぎます。失敗しても問題にならない複製や小さなタスクに限って使いましょう。 この3つの習慣が、「バイブコーディングをしたら壊してしまった」という最大の不安に対処します。バイブコーディングで変更を元に戻す方法については、[別のレビュー](https://ailoot.ai/blog/ja/claude-code-undo-changes/)をご覧ください。Claude Codeについての記事ですが、gitを使う原則はまったく同じです。 ## 自分のタスクを始めるには？
重要なポイント Qwen Codeをインストールし、プロジェクトフォルダーに移動して`qwen`を実行し、`/auth`で有料モデルまたはOllama経由のローカルモデルを接続します。次にPlanモードで始めて計画を読み、Shift+Tabを押してAuto-Editに切り替え、エージェントに作業させます。プロジェクトはgitで管理しましょう。初回のセットアップ全体にかかる時間は約20分です。
全体の手順を短くまとめました。上から順に進めてください。 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の代替ツールに関するレビュー](https://ailoot.ai/blog/ja/claude-code-alternatives/)をご覧ください。Qwenもほかのエージェントと並んでいるので、用途に合うものを確認できます。
### 出典 - [Qwen Code — 公式GitHubリポジトリ（QwenLM/qwen-code）](https://github.com/QwenLM/qwen-code) — エージェントの説明、インストール、起動モード、プロバイダー一覧 - [Qwen Code — 認証ドキュメント](https://qwenlm.github.io/qwen-code-docs/en/users/configuration/auth/) — /authメニュー、2026年4月15日の無料Qwen OAuthプラン終了、settings.json、Custom Provider - [Qwen Code — アクセスモード（Approval Mode）](https://qwenlm.github.io/qwen-code-docs/en/users/features/approval-mode/) — 5つのモード：Plan / Ask Permissions / Auto-Edit / Auto / YOLO、Shift+Tabでの切り替え - [Qwen Code — 概要（Overview）](https://qwenlm.github.io/qwen-code-docs/en/users/overview) — 計画、コード作成、デバッグ、プロジェクト内の移動など、エージェントが行うこと - [Qwen Code — クイックスタート（Quickstart）](https://qwenlm.github.io/qwen-code-docs/en/users/quickstart/) — インストールとプロジェクトでの初回起動
バイブコーディング全体の進め方では、特定のエージェントよりも手法が重要です。AIクローン、Second Brain、コンテキストエンジニアリングを組み合わせます。下で動くツールは変更できますが、手法は変わりません。実用的な資料：[Ailootドキュメント](https://ailoot.ai/docs/)。 その他の資料とツール：[Ailoot](https://ailoot.ai/)。 ## ターミナルでQwen Codeを実行し、編集モードを設定する方法 | Ailoot：よくある質問 ### Qwen Codeが変更案を示して待つのはなぜですか？ ステータス行のモードを確認します。Ask Permissionsは確認待ち、Planは分析用です。Auto-Editは編集を許可しコマンド承認を保ちます。モデルの接続設定も必要です。 ### Defaultという名前なら、新規導入の起動モードだといえますか？ いいえ。古いDefault名はAsk Permissionsとの互換用に残り、資料の早見表はAutoを既定とします。名前から推測せず、導入版と現在のモードを確認してください。 ## Ailoot · 企業とそのプロジェクト群 Ailootは、蓄積した運営経験、幅広い顧客基盤、安定したサービス、継続的なKPI管理を基盤としています。 企業とそのプロジェクト群：数百万の顧客、毎月数十億規模の売上。 Ailootはこの運営経験を、お客様の製品、エージェント、アプリケーション、自動化でAI機能を利用するためのAPIアクセスに活かしています。