Claude Code 桌機版剛打開時，最容易讓人困惑的不是提示詞，而是左側的 Project、聊天裡跑出的 Artifacts，以及你電腦上的專案資料夾，到底有沒有連在一起。
這三個東西名字很像，功能卻不同。若一開始沒弄清楚，很容易把聊天工作區當成程式碼資料夾，或把做好的 Artifact 當成已經能正式上線的網站。這篇用新手角度帶你建立第一個安全的 Claude Code 桌機工作流：先釐清範圍，再做小型原型，最後才寫進可版本控管的專案。
我的建議很簡單：Project 用來整理脈絡，Artifact 用來快速看想法，真正要長期維護的程式碼，一律回到本機專案資料夾和 Git。
先分清楚：Project、Artifact、專案資料夾不是同一件事
| 你看到的名稱 | 它真正做什麼 | 適合拿來做什麼 | 不要把它當成 |
|---|---|---|---|
| Claude Project | Claude 帳號中的獨立工作區，可放聊天紀錄、知識檔案與專屬指令。 | 整理品牌資料、需求、文件、長期討論脈絡。 | 正式程式碼的 Git 專案。 |
| Artifact | 可獨立檢視、修改、分享的文件、設計、小工具或單頁原型。 | 快速做流程圖、表單雛形、互動頁面、提案文件。 | 已部署、已測試的正式產品。 |
| 本機專案資料夾 | Claude Code 真正讀取與修改檔案的工作目錄。 | 網站、外掛、App、Git、測試與部署流程。 | 隨便選整台電腦或含敏感資料的大資料夾。 |
Claude 官方把 Project 定義成有自己聊天紀錄、知識庫與指令的工作區；Claude Code 則是從你選定的本機資料夾啟動，按需要讀取檔案，不必把整包程式碼上傳到聊天裡。兩者可以互補，但不要假設它們會自動同步或彼此取代。
開始前：先準備一個不會害怕改壞的小專案
第一次用桌機版，我不建議直接打開客戶正式網站、公司共用磁碟，或整個 Desktop。先建立一個獨立測試資料夾，例如 claude-code-starter；裡面放一個你願意練習修改的小型網頁或測試專案。
- 安裝並登入 Claude Desktop，確認你的方案可使用 Claude Code。
- 在本機建立一個新的空資料夾，或複製一個可安全實驗的專案。
- 從 Claude Code 開啟該資料夾；桌機版會要求你確認要使用的工作目錄。
- 第一次先請它「只讀取、不要修改」，認識專案後再做小改動。
- 有 Git 的話先建立 repository，讓每一輪修改都有回頭路。
你可以先這樣問：
請先不要修改任何檔案。
用 5 點說明這個專案做什麼、入口檔在哪裡、
目前可以怎麼啟動或測試；不確定的地方請直接標示。這個提示詞看起來很普通，但它會養成一個好習慣：先理解，再授權修改。Claude Code 在變更檔案或執行指令前會要求確認；新手先保留這個確認步驟，不要一開始就開自動同意。
Project 怎麼用：把反覆交代的背景變成固定上下文
如果你做的是長期專案，例如品牌官網改版、WordPress 外掛、內容工作流，可以建立 Claude Project，把品牌介紹、功能需求、色彩規範、既有文件與常用語氣放進去。之後每一次聊天不用從零開始解釋。
桌機的 Claude 工作區也能圍繞本機資料夾建立專案脈絡。不過真正交給 Claude Code 修改的範圍，還是以你這次開啟並確認的資料夾為準。對剛入門的人，我會這樣分工：
- Claude Project：放「為什麼要做、誰要用、規格長什麼樣」。
- 本機專案資料夾：放「實際程式碼、設定檔、測試、Git 紀錄」。
- Claude Code 對話：處理「這一輪要改什麼、怎麼驗證、要不要採用」。
想更穩定地讓 Claude Code 理解專案，不要只靠聊天記憶。請在專案根目錄建立 CLAUDE.md。官方建議第一次在專案執行 /init 來產生這份檔案，Claude Code 會在每次工作階段開始時自動讀取它。
# CLAUDE.md
## 專案目標
這是一個品牌官網，優先維持手機版可讀性與表單轉換。
## 常用指令
- npm run dev
- npm run test
- npm run build
## 修改規則
- 修改前先說明預計影響的檔案
- 不要碰 .env、金流與正式環境設定
- 完成後要列出測試結果與人工確認項目CLAUDE.md 不需要一開始寫得很長。把最常犯錯、最不希望 AI 碰、最常用的測試指令先寫進去，就已經很有價值。若你還沒看過完整基礎設定，可先讀Claude Code 完整教學：從安裝到 AI 開發工作流。
Artifacts 怎麼用：先把想法做成看得見的原型
Artifact 很適合做「先看再決定」。它可以是文件、流程圖、單頁 HTML、簡單 Dashboard 或互動小工具，會在對話旁獨立開啟，方便你持續修改與分享。桌機版的優勢，就是你不用先開一個完整專案，先把使用者看得到的東西做出來。
例如你想做一個網站報價表單，可以先給 Claude 這個任務：
請做一個單頁的網站架設需求表單 Artifact。
要有產業、預算區間、網站目標、聯絡方式四個欄位，
手機版也要好填，先不要串接任何真實 API 或寄信服務。看到原型後，你可以調整文案、欄位順序、色彩與互動。但要記得：Artifact 是驗證想法的好工具，不是生產環境。真的要上線時，請再交代 Claude Code：
把剛才確認的表單需求實作到目前專案。
先列出會新增或修改的檔案，再開始動手。
不要放入真實金鑰；完成後執行既有測試，
並告訴我還需要人工測試哪些送出流程。Claude 官方也提醒，Artifacts 需要在設定中開啟 Cloud code execution 與 file creation；要分享前也應該確認內容沒有客戶資料、金鑰或不該公開的文字。把它想成可視化草稿和可分享成果，比把它當成程式碼正式倉庫更準確。
我建議的新手流程：Artifact 到 Git 專案，分兩段走
- 用 Project 收背景：整理需求、受眾、品牌資料與限制。
- 用 Artifact 看成果：先做文案、畫面或互動雛形，跟人確認方向。
- 開啟本機專案資料夾：只給 Claude Code 這一個專案的範圍。
- 先請它盤點：了解架構、啟動方式、測試與既有規則。
- 加入 CLAUDE.md：把常用指令、禁止事項、驗收標準寫下來。
- 小步修改：一次只做一個功能，看 diff 後再確認。
- 執行測試、人工看畫面：功能測試通過不代表手機畫面一定沒問題。
- Git commit：確認這一步沒問題才留下一個可回復的版本。
這套流程的精神和我前面整理的GitHub Vibe Coding 版本控管教學是一樣的：AI 可以跑得很快，但人要保留任務邊界、審查點與回復路線。若你的任務偏文件、資料整理與本機日常工作，也可以延伸看Claude Cowork 本機工作流。
初學者最常犯的 5 個錯誤
- 一次開太大的資料夾：不要把整個使用者家目錄、Desktop 或含客戶資料的共用資料夾丟進去。
- 把機密寫進提示詞：API Key、密碼、金流資訊與客戶名單，不應放入 Prompt、Artifact 或
CLAUDE.md。 - 看見畫面就以為能上線：Artifact 可用來驗證體驗，正式產品仍要處理程式架構、環境變數、測試與部署。
- 跳過 diff 與測試：AI 的摘要很好看，不代表每個改動都符合預期。要看檔案差異，也要跑專案原本的測試。
- 不做 Git commit：每完成一個清楚的小功能就 commit；改壞時，你才有一個知道能回去的版本。
常見問題 FAQ
Claude Project 和 Claude Code 的專案資料夾有什麼差別？
Claude Project 是保存聊天、知識與指令的工作區；Claude Code 的專案資料夾則是本機實際程式碼所在位置。前者幫你保存脈絡，後者才是 AI 修改檔案、跑測試與配合 Git 的工作範圍。
Artifacts 可以直接當正式網站上線嗎？
Artifact 很適合快速驗證單頁畫面、文件與小工具。若要變成正式網站，仍要把確認的需求與程式碼放入本機專案，處理版本控管、真實串接、測試與部署，不要只把 Artifact 當成成品。
第一次用 Claude Code 要選哪個資料夾？
選一個獨立、可安全測試的專案根目錄，不要一開始選整個 Desktop 或使用者家目錄。範圍越清楚，資料風險越低，Claude 也越不容易誤改不相關的檔案。
一定要會 Git 才能用 Claude Code 嗎？
不用才可以開始，但很建議第一天就建立 Git repository。AI 改檔速度快，Git 能讓你查看差異、保留版本、回復錯誤；這比事後靠記憶找回檔案可靠得多。
CLAUDE.md 要寫什麼？
先寫專案目標、啟動與測試指令、程式規範、不能碰的檔案，以及完成後的驗收標準。它是給 Claude Code 的專案簡報，內容短但明確，比每次在對話裡重新交代更有效。
結論：先讓 AI 幫你做小事，再把流程做成習慣
Claude Code 桌機版真正好用的地方，不是讓你一句話生出整套系統，而是讓你把「想法、原型、程式碼、驗證」放進一條看得懂的流程。Project 幫你保留背景，Artifact 幫你看見成果，本機專案加 Git 則幫你把成果留在自己手上。
第一次就從一個小改動開始：請 Claude 先讀專案、建立 CLAUDE.md、改一個不重要的文字，再看 diff、測試、commit。這樣用幾次後，你才會真的知道哪些工作可以放心交給 AI，哪些地方仍然需要你當最後的決策者。
