Claude Code｜桌面版安裝與第一個任務

桌面版讓你用視窗選取專案、交代工作並檢查檔案變更。本篇從安裝與 Code 分頁開始，以本機待辦清單做一個小修改，帶你走過選環境、確認資料夾、檢查差異和開啟預覽。完成後，你會知道「Claude 說完成」之外，還要在哪裡看實際成果。

請準備支援的作業系統、桌面版所需的訂閱資格，以及練習專案起始版。桌面 App 內含 Code 所需元件，不要求先另外安裝 CLI；若想在終端機輸入 claude，仍需安裝獨立 CLI。練習網站使用 Node.js，則是另一項專案需求。

安裝官方桌面 App

閱讀完整文字說明

桌面版安裝與第一個任務，以流程和文件圖形呈現教學重點。

由本篇來源的官方桌面入門頁進入下載，選擇符合電腦系統與處理器的版本。macOS、Windows 以及目前官方列出的 Linux beta 有不同安裝途徑；Linux 讀者應另外核對發行版與功能限制，不要直接使用 Windows 安裝檔。安裝後開啟 Claude 並登入預期帳號。

進入 App 後辨認 Chat、Cowork 與 Code 分頁。一般聊天能回答程式問題，但本篇需要的是能對專案採取行動的 Code 工作階段。如果點 Code 出現升級或重新登入提示，先處理帳號資格，不必因此重新下載練習檔。組織帳號也可能由管理員控制可用功能。

選擇 Local 與練習資料夾

在 Code 的新任務區選 Local，再以 Select folder 或相應資料夾選擇功能，指定已解壓縮的專案根目錄。根目錄應直接包含 package.json，不是 ZIP 所在的下載目錄，也不是包住專案的上一層。送出任務前再看一次所選位置，避免修改另一份同名材料。

模型選單決定這個工作階段使用哪個可用模型；權限選單則影響它能如何讀檔、修改或執行工具。兩者解決不同問題。本次先選容易檢查提案的模式，並明確下只讀要求。各版本的顯示名稱可能調整，以目前選單與權限教學的行為說明對照。

先認識專案再做小修改

第一次任務先請 Claude 列出檔案與啟動方式，確認工具真的讀到你的材料。你可以點回覆中的檔案路徑，查看 README 或程式碼。若回覆說這是 React 專案，卻沒有 package.json 依賴作為依據，要求它回到檔案重新核對，因為本練習是原生 HTML、CSS 與 JavaScript。

請閱讀這個待辦清單專案，回報實際工作目錄。
說明 index.html、app.js、model.js 與 tests 各自負責什麼。
列出啟動和測試指令，這一輪先不修改檔案。

確認資料夾正確後，選一個容易目視驗收的任務，例如改頁面主標題。一次只改這個文字，讓你熟悉差異畫面。你也可以要求它先指出應修改哪個標籤，再進行修改；這能看出它是否分清楚瀏覽器分頁標題與網頁中看得到的主標題。

請把頁面中可見的主標題改為「我的今日待辦」。
只修改這項顯示文字，保留原本新增、勾選和刪除功能。
完成後執行既有測試，開啟本機預覽，核對主標題與三種操作。
回報修改檔案、實際測試結果，以及尚未驗證的部分。

閱讀差異與處理提案

依權限模式，Claude 可能先展示修改提案等你接受，也可能先寫入檔案再讓你檢查。注意畫面中的差異指標，例如增加與刪除行數，點開後逐檔閱讀。刪除行表示舊內容，新增行表示新內容；一行文字修改也可能因格式變動出現多行差異，要判斷原因而不是只看數字。

這次合理的差異應集中在標題文字。如果同時出現套件升級、資料儲存重寫或無關文件刪除，就請 Claude 說明與任務的關係，並縮回本次範圍。使用介面的拒絕或評論功能前，也要看清楚它是拒絕尚未套用的提案，還是正在處理已寫入檔案的結果。

開啟預覽並親自驗證

請 Claude 啟動開發伺服器並在 Browser 預覽區開啟。若環境無法自動啟動，查看終端機紀錄中的錯誤，依 README 補齊 Node.js 等需求，再重試。不要只要求重新截圖；如果伺服器根本沒有執行，畫面也不會變成新的結果。

確認頁面顯示「我的今日待辦」，新增兩筆不同文字，將第一筆勾選，再刪除第二筆。這個順序同時確認文字修改沒有破壞基本互動。原始起始版的資料只保存在目前頁面記憶體，重新整理會清空；這是已知設計，不要誤認成此次修改造成的錯誤。

記錄測試與畫面驗證各自的結果。例如「npm test 通過四項；本機預覽確認主標題、新增、勾選、刪除」比「一切正常」更容易追查。若只有測試能執行，就清楚保留瀏覽器尚未驗證的狀態，稍後自己補查。

排除第一次常見問題

看不到 Code 時，先查 App 版本、帳號資格與組織限制；看到專案但讀不到檔案，先查選取位置與檔案存取授權；看得到差異但預覽沒變，先確認預覽連到的伺服器是否從同一工作目錄啟動。這三種問題分屬介面、檔案與執行環境，不應用同一個重裝動作處理。

本篇小練習是把標題改成自己想要的文字，再重做差異與功能檢查。完成判準是你能指出改了哪個檔案、哪一段文字、測試如何執行，以及預覽從哪個環境產生。下一篇桌面日常流程會把這套檢查方式擴展到多次工作階段。

回 Claude Code 教學總目錄

• AI 工具
• 教學
• Claude Code