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

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

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

模型與代理程式實用資源：Ailoot 文件。

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

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

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

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

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

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

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

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

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

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

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

qwen --version

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

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

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

cd path-to-your-project
qwen

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

這個專案是做什麼的？

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

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

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

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

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

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

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

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

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

在代理程式中輸入命令：

/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 文章。

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

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

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

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

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

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

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

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

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

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

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

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

不用信用卡的本機模型#

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

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

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

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

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

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

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

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

這三個習慣能解決最主要的擔憂——「我用 vibe coding 寫了程式，結果把它弄壞了」。若想進一步了解 vibe coding 中如何復原變更，請參閱另一篇評測。內容談的是 Claude Code，但使用 git 的原則完全相同。

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

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

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 替代工具評測。Qwen 也列在其中，你可以比較各工具適用的情境。

實用資源：Ailoot 文件

更多資源與工具：Ailoot。