# 如何在終端機執行 Qwen Code 並設定編輯模式

> 安裝 Qwen Code、在專案中啟動、透過 auth 連接模型、Plan、Auto-Edit、Auto 與 YOLO 模式、本機模型，以及專案保護。

Source: https://ailoot.ai/blog/zh-hant-tw/qwen-code-terminal-auto-edit/
Canonical: https://ailoot.ai/blog/zh-hant-tw/qwen-code-terminal-auto-edit/
Language: zh-Hant-TW
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-153
Revision: sha256-8861e6af13631f6145bcb771158eb8af90fcb70f718444681c62de12dbd25095


問題通常是這樣的：要怎麼讓 Qwen 在主控台正常運作，並自行撰寫程式碼？這個問題背後往往藏著失望：有人安裝了 Qwen Code，提出問題後，收到的卻只有文字和一段程式碼，還得手動複製；明明先前說好它會像代理程式一樣進入專案，自己把事情全做完。

Qwen Code 確實就是這樣一個完整的代理程式。它可以開啟和編輯檔案，也能自行執行命令。行為取決於生效的核准模式：Ask Permissions 會要求確認，Auto-Edit 與 Auto 則允許更自主工作。請查看狀態列，不要假設叫 Default 的模式就是開箱預設。以下依序說明安裝、在專案中啟動、四月變更後如何連接模型，以及如何切換到代理程式不必多問就能編輯程式碼的模式。本文內容均已依據 Qwen 官方文件核對，資料截至 2026 年 8 月 30 日。

模型與代理程式實用資源：[Ailoot 文件](https://ailoot.ai/docs/)。



## 「Qwen Code 會自己寫程式」是什麼意思？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="重要重點">

重要重點

Qwen Code 是在終端機中運作的 AI 代理程式。它會讀取整個專案、自行開啟及編輯檔案、執行命令，並檢查結果。瀏覽器聊天只會提供文字，讓你手動搬到專案中。代理程式則直接在程式碼資料夾內工作。官方將它描述為「存在於終端機中的開源 AI 程式設計代理程式」。

</div>

差異很簡單。瀏覽器聊天會以文字回答問題。你閱讀答案、複製程式碼、貼進檔案、自己執行、自己找出錯誤，再把問題帶回聊天視窗。你成了聊天與專案之間的搬運工。

代理程式的運作方式不同。你用一般文字交代任務，例如「新增意見回饋表單」或「修正這個錯誤」。接著它會檢視專案結構、找出相關檔案、進行修改，並執行檢查。文件說得很清楚：代理程式會制定計畫、撰寫程式碼，並確認程式能正常運作。

問題容易令人困惑，原因就在這裡。「Qwen 不會自己寫程式」幾乎總是表示兩種情況之一：使用者開的是瀏覽器聊天，而不是終端機代理程式；或代理程式確實在執行，但設定成每次編輯都要先徵求許可的模式。前者只要安裝 Qwen Code 就能解決；後者則需切換模式。以下會說明這兩種解法。

## 如何在終端機安裝 Qwen Code？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="重要重點">

重要重點

只要一個命令就能安裝。macOS 和 Linux 可使用 Qwen 官方安裝程式或 npm（需要 Node.js 22 或更新版本）。Windows 則使用 PowerShell 命令。安裝後請重新啟動終端機，否則可能找不到 `qwen` 命令。安裝免費，而且每個人的步驟都一樣；開始使用模型後才會產生費用。

</div>

最快的方法是使用官方安裝程式，它會自動選擇適合你系統的版本。

在 macOS 和 Linux 上，開啟終端機並貼上這一行：

```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
```

另一種方式是使用 npm，適合已經安裝 npm 的情況。這需要 Node.js 22 或更新版本：

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

安裝後請重新啟動終端機。安裝程式會將 `qwen` 命令加入系統路徑，但終端機必須重新啟動才會識別它；這是「我明明安裝了，卻找不到命令」最常見的原因。若要確認安裝成功，請執行：

```bash
qwen --version
```

如果看到版本號，代表代理程式已安裝完成，可以在專案中啟動。

## 如何在專案中執行 Qwen Code？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="重要重點">

重要重點

使用 `cd` 命令進入專案資料夾，再輸入 `qwen`。代理程式的終端機介面就會開啟。第一次執行時，它會請你透過 `/auth` 選單連接模型。之後就能用一般文字輸入任務，代理程式會檢視專案並開始工作。關鍵是從專案資料夾啟動，代理程式才能看到所有檔案。

</div>

首先，進入存放程式碼的資料夾。這很重要：代理程式會在啟動時所在的資料夾中工作，也只能看到該資料夾的內容。

```bash
cd path-to-your-project
qwen
```

代理程式介面會直接在終端機中開啟。第一次執行時，它會引導你連接模型；下一節會說明這個步驟。模型連接完成後，可以先用一般文字輸入任務，看看代理程式能存取哪些內容：

```
這個專案是做什麼的？
```

代理程式會讀取檔案、了解專案結構，並提供有用的回答。接著你可以請它撰寫和編輯程式碼，例如「新增登出按鈕」、「把這個檔案拆成兩個」，或「找出測試失敗的原因」。它會找到相關位置並自行修改。

還有第二種啟動方式：使用單一命令，不開啟介面。這適合腳本和自動化任務：

```bash
qwen -p "重新閱讀 README 並更新命令清單"
```

它會執行任務後結束，不會進入對話。初期不需要用到這個功能，但之後可能會派上用場。

## 為什麼代理程式已經啟動，卻沒有自行工作？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="重要重點">

重要重點

若 Ask Permissions 生效，Qwen Code 會在編輯與指令前等待確認。此外，必須先連接模型，它才能編輯檔案：Alibaba 已於 2026 年 4 月 15 日關閉透過 qwen.ai 提供的免費存取；若沒有連接模型的使用權限，代理程式就無法思考任務。「只是在那裡等」最常見的兩個原因，是尚未連接模型，或啟用了會要求確認的謹慎模式。

</div>

第一個障礙是模型存取權。過去 Qwen Code 提供免費存取：登入 qwen.ai 帳戶後，代理程式就能使用，不需要信用卡。這種存取方式稱為 Qwen OAuth，現在已停止提供。授權文件明確指出：免費的 Qwen OAuth 方案已於 2026 年 4 月 15 日停用；先前儲存的登入資料可能還能短暫使用，但伺服器會拒絕新的請求。「使用 qwen.ai 登入」選項也已從選單中移除。

因此，若要讓代理程式開始思考任務，你必須先連接模型。下一節會介紹連接方式，包括付費和免費的本機選項。



第二個原因比較不明顯，也更令人沮喪。模型已連接，代理程式也有回應，卻不編輯任何檔案，只顯示打算做什麼，然後等待。Ask Permissions 本來就會在編輯與指令前要求確認，這不能證明每次啟動的普遍預設。若要讓它自行工作，就得切換模式。原問題的答案會在下方兩節說明。

## 免費存取關閉後，如何連接模型？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="重要重點">

重要重點

第一次執行時，輸入 `/auth` 會開啟有三個選項的選單。Alibaba ModelStudio 是官方付費選項（個人使用者可選擇每週有使用額度的 Coding Plan）。第三方供應商可透過金鑰連接 DeepSeek、Kimi 等服務。Custom Provider 可透過 Ollama 等工具連接你自己的模型或本機模型。只有最後一種選項，也就是本機模型，不需信用卡即可免費使用。

</div>

在代理程式中輸入命令：

```
/auth
```

畫面會出現有三個主要選項的選單。以下說明各選項的功能。

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` 比較簡單；想儲存所有設定時，再回頭編輯這個檔案即可。

若想了解四月之後還有哪些免費選項，請參閱[免費 Qwen Code 文章](https://ailoot.ai/blog/zh-hant-tw/qwen-code-free-limits/)。

## 要啟用哪種模式，代理程式才會自行編輯程式碼？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="重要重點">

重要重點

Qwen Code 的五模式文件在快速參考中把 Auto 標為預設，但 Ask Permissions 章節仍有舊的初始模式措辭。這份無版本頁面不能證明每種安裝的預設，請查看工作階段生效模式；Auto 使用分類器核准或封鎖受評估動作。若要讓它不經提示就編輯檔案，請使用 Auto-Edit。若你願意讓它完全不詢問就編輯和執行命令，則可使用 YOLO，但僅限自己的專案，並務必謹慎。模式就是在「每件事都要詢問」和「自行工作」之間切換的開關。

</div>

核心概念是：存取模式決定代理程式能多自主地行動。模式共有五種，從最謹慎到最寬鬆依序排列。

| 模式 | 編輯檔案 | 執行命令 | 適用情況 |
|----|----|----|----|
| Plan | 否，唯讀 | 否 | 了解專案並制定計畫，但不做任何變更 |
| Ask Permissions | 需確認 | 需確認 | 不熟悉或重要的程式碼，希望查看每個步驟時 |
| Auto-Edit | 自動 | 需確認 | 需要大量小幅修改，但仍要自行管理命令時 |
| Auto | 依安全性評估決定 | 依安全性評估決定 | 有安全措施的長時間自主工作 |
| YOLO | 自動 | 自動 | 自己的專案，且你信任代理程式可以全權處理 |

如果代理程式只顯示修改內容並等待，很可能是處於 Ask Permissions 模式（舊版稱為 Default）。接著你必須手動確認每次編輯和每個命令，因此感覺代理程式沒有自行工作。

如果要讓它不經提示就編輯檔案，請切換到 Auto-Edit。編輯會自動進行，但執行命令前它仍會詢問；這是合理的保護措施，可避免在錯誤位置執行 `rm`。

Auto 會用內部評估器處理需評估的動作。請查看安裝版本與生效狀態後明確選擇；Ask Permissions 設定保留的 `default` 是相容名稱，不能證明它是啟動模式。

YOLO 是限制最少的模式。代理程式會自行編輯檔案、執行命令，全程不會詢問。文件建議僅在可信任的個人專案和自動化工作流程中使用。在工作專案中很容易得到不想要的結果，因此只有在頭腦清楚時才啟用，而且最好在副本上使用。

## 如何在工作階段中切換模式？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="重要重點">

重要重點

留在代理程式中按 Shift+Tab（Windows 上按 Tab），模式就會依序切換：Plan、確認、Auto-Edit、Auto、YOLO，然後回到 Plan。畫面底部的狀態列會顯示目前模式。實用的工作流程是先用 Plan 檢視任務，再切換到 Auto-Edit 或 Auto，讓代理程式開始工作。

</div>

進行任務時也能隨時切換模式。按 Shift+Tab 前往下一個模式。Windows 上按一般的 Tab 鍵也有相同作用。切換順序是 Plan、確認、Auto-Edit、Auto、YOLO，然後回到 Plan。

介面底部的狀態列會一直顯示目前模式。交付大型任務前，請養成先查看狀態列的習慣，免得你只想檢視計畫，卻啟動了 YOLO。

適合初學者的工作流程分成三步：

1.  在 Plan 模式啟動代理程式，請它分析任務並提出計畫。它不會動到任何內容，只會讀取程式碼並說明打算採取的行動。
2.  閱讀計畫；如果你同意，按 Shift+Tab 切換到 Auto-Edit 或 Auto。
3.  告訴它繼續執行。接著代理程式就會自行編輯檔案，你可以同步檢查結果。

這種方法能消除初學者最主要的擔憂——代理程式會不會立刻把一切弄壞。你可以先在安全模式檢查計畫，之後再讓它繼續執行。





## 不用信用卡的本機模型

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="重要重點">

重要重點

可以使用本機模型。Qwen Code 能透過 Ollama 或類似程式，使用直接在你電腦上執行的模型；只要從 `/auth` 選單將它連接為 Custom Provider 即可。你不必使用 Alibaba 雲端服務。開放模型可免費下載，不需要信用卡，而且專案資料不會離開你的電腦。缺點是需要效能足夠的電腦，否則代理程式思考會很慢。

</div>



透過 Ollama 或 vLLM 在電腦上安裝開放模型，再從 `/auth` 選單將它連接為 Custom Provider。之後，代理程式使用的就是你自己電腦上的模型，而不是 Alibaba 雲端服務。不需要信用卡或金鑰，也沒有請求數量限制。若想了解哪些開放模型能勝任程式設計工作，請參閱[免費程式設計模型評測](https://ailoot.ai/blog/zh-hant-tw/free-coding-models/)。

需要考量的是硬體。能夠寫出品質還不錯的程式碼的模型需要大量視訊記憶體。搭載高效能顯示卡的電競電腦可以勝任，但一般筆記型電腦可能無法容納模型；即使可以執行，每次回應的思考時間也可能太長，不如改找其他選擇。

本機執行的另一個好處是資料隱私。所有程式碼都留在你的電腦上，不會傳送到他人的伺服器。對敏感專案而言，這比省下訂閱費更重要。

## 如何避免代理程式破壞專案？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="重要重點">

重要重點

做好三件事。用 git 版本控制專案，只要一個命令就能復原代理程式的任何修改。從 Plan 模式開始任務，在讓代理程式繼續之前先閱讀計畫。不要在工作專案啟用 YOLO，只在副本和小型實驗中使用。如此一來，代理程式的自主性就能成為助力。

</div>

只要自主代理程式照著你的需求工作，它就很方便。為避免失誤造成損失，請養成三個習慣。

第一，使用 git。如果專案有版本控制，就能查看代理程式所做的每項修改，也能復原任何一項。沒有 git 時使用自主代理程式確實有風險：它一旦改了東西，就沒有辦法還原先前版本。使用 git，只要一個簡短命令就能復原。

第二，從 Plan 模式開始。在讓代理程式接手大型任務前，先要求它在不會修改任何內容的模式下制定計畫。先閱讀並了解它打算做什麼，再切換到編輯模式。

第三，謹慎使用 YOLO。在這個模式下，代理程式會自行執行命令，包括刪除檔案的命令。對工作專案而言，這太寬鬆了。只在臨時副本和小型任務中使用 YOLO，確保出錯也不會造成影響。

這三個習慣能解決最主要的擔憂——「我用 vibe coding 寫了程式，結果把它弄壞了」。若想進一步了解 vibe coding 中如何復原變更，請參閱[另一篇評測](https://ailoot.ai/blog/zh-hant-tw/claude-code-undo-changes/)。內容談的是 Claude Code，但使用 git 的原則完全相同。

## 要開始執行自己的任務，可以怎麼做？

<div class="aside" data-semantic="key-takeaway" role="note" aria-label="重要重點">

重要重點

安裝 Qwen Code，進入專案資料夾並執行 `qwen`，然後透過 `/auth` 連接付費模型或經由 Ollama 使用本機模型。接著從 Plan 模式開始，閱讀計畫，再按 Shift+Tab 切換到 Auto-Edit，讓代理程式工作。請以 git 管理專案。第一次設定整個流程大約需要 20 分鐘。

</div>

以下是整個流程的簡短清單，請從上到下依序操作：

1.  用一個命令安裝 Qwen Code，然後重新啟動終端機。
2.  使用 `cd` 進入專案資料夾並執行 `qwen`。
3.  透過 `/auth` 連接模型：選擇付費方案；若無法刷卡，就透過 Ollama 使用本機模型。
4.  在 Plan 模式交代任務並閱讀代理程式的計畫。
5.  按 Shift+Tab 切換到 Auto-Edit 或 Auto，讓它開始工作。
6.  使用 git 管理專案，這樣就能復原任何修改。

簡單來說，「Qwen 不會自己寫程式」幾乎總是因為模型尚未連接，或代理程式處於確認模式。前者可在 `/auth` 選單中解決；後者則按 Shift+Tab，直到切換到 Auto-Edit。完成後，代理程式就能在終端機中真正自主工作。

若想將 Qwen 與其他代理程式比較，看看哪個適合你的任務，請參閱[Claude Code 替代工具評測](https://ailoot.ai/blog/zh-hant-tw/claude-code-alternatives/)。Qwen 也列在其中，你可以比較各工具適用的情境。

<div class="section" role="doc-bibliography" aria-label="來源">

### 來源

- [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 選單、免費 Qwen OAuth 方案於 2026 年 4 月 15 日終止、settings.json、Custom Provider
- [Qwen Code — 存取模式（Approval Mode）](https://qwenlm.github.io/qwen-code-docs/en/users/features/approval-mode/) — 五種模式：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/) — 安裝及首次在專案中啟動

</div>

實用資源：[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將這些營運經驗用於API存取，讓客戶的產品、代理、應用程式及自動化流程使用AI功能。