第一次聽到「Claude CLI」，很多人以為只是把聊天機器人搬進終端機。其實大家口中的 Claude CLI，通常就是 Anthropic 的 Claude Code：你在專案資料夾執行 claude 後，它能讀取目前工作目錄的檔案、協助查程式碼、執行你核准的指令，並提出修改方案。
這篇不假設你已經是工程師。我會用一個小型網站專案，帶你完成第一次安全的 Claude Code CLI 工作階段：確認安裝、進到正確資料夾、請它先讀不改、建立專案規範，最後用 Git 留下可回復的紀錄。若你連安裝都還沒做完，可先看 Claude Code 安裝教學。
先理解：Claude CLI 是在「目前資料夾」裡工作
Claude Code 不會神奇地知道你想改哪個專案。你在哪一個資料夾輸入 claude，那個資料夾就是它本次最主要的工作範圍。因此第一個習慣不是打指令，而是確認你所在的位置。
- 不要一開始就在整個「桌面」、使用者家目錄或客戶所有網站的上層資料夾啟動。
- 第一次練習請用複製檔或新的測試資料夾，不要直接碰正式站。
- 有程式碼的專案，先用 Git 建立版本紀錄；做錯時才有明確的退路。
mkdir claude-cli-playground
cd claude-cli-playground
git init上面三行會建立一個練習資料夾、進入它，並初始化 Git。若你已經有專案，將 cd claude-cli-playground 換成真正的專案路徑即可。想先看目前在哪裡，可以輸入 pwd；想列出檔案則用 ls。
安裝、確認版本與登入
官方目前提供原生安裝方式。macOS、Linux 與 WSL 可在終端機執行下列指令；Windows 則在 PowerShell 執行。安裝後先以 claude --version 確認終端機找得到指令。完整的 Windows、Homebrew 與 PATH 排除方法，站上另一篇安裝文有逐步截圖說明。
| 環境 | 建議的第一步 |
|---|---|
| macOS / Linux / WSL | curl -fsSL https://claude.ai/install.sh | bash |
| Windows PowerShell | irm https://claude.ai/install.ps1 | iex |
| Homebrew 使用者 | brew install --cask claude-code |
claude --version
claude第一次執行 claude，依畫面引導登入你的 Anthropic 帳號即可。若你已開啟介面但要重新登入，可輸入 /login。若看到 command not found，通常是安裝完成後尚未重開終端機，或安裝位置還沒加入 PATH；先關閉並重新開啟終端機，再試一次。
第一次對話：先請它盤點，不要急著叫它改
新手最常見的失誤不是不會寫 prompt，而是一開始就給出「幫我做好網站」這種太大的任務。第一輪先讓 Claude Code 認識專案，並明確限制它只能閱讀、不可以修改。這一步會讓後面的討論具體很多。
claude
請先不要修改任何檔案。用條列說明目前資料夾裡的檔案用途；
如果這是空資料夾，請建議我做一個最小的靜態網站結構。如果你是在剛建立的練習資料夾，它會告訴你目前是空的，並建議結構。接著再把工作拆小，先要求它說明計畫，而不是直接寫一大包功能。
請建立一個只有 index.html、style.css、app.js 的個人介紹頁。
先告訴我會新增哪些檔案、每個檔案的用途與實作順序，
我確認後再寫入。這種 prompt 有三個關鍵：範圍清楚、檔案清楚、先規劃後執行。Claude 建議新增或修改檔案時，先看內容與 diff；不合理就要求它調整。你不是把控制權交出去，而是把它當成會做事、但需要交代工作的協作者。
權限怎麼看？第一次請維持「每一步都確認」
Claude Code 會把讀檔、編輯、執行命令分開處理。特別是寫入檔案、安裝套件、刪除檔案或執行 shell 指令時，請讀完它要做的事再核准。官方文件也提供不同權限模式；可用 Shift+Tab 在模式間切換。第一次使用最適合保留需要確認的工作方式，或先切到 Plan 模式，把任務變成設計與檢查，而不是立刻動手。
| 看到的動作 | 新手該怎麼判斷 |
|---|---|
讀取 index.html、列出檔案 | 通常是了解現況，仍要確認路徑是否正確。 |
| 修改 CSS、建立新檔 | 先看它要改哪些檔案，確認沒有超出本次任務。 |
npm install、執行測試 | 確認套件名稱與指令用途，再批准。 |
| 刪除檔案、改環境變數、部署 | 先停下來檢查；正式環境不要因為一句模糊指令就批准。 |
安全不是完全不讓 AI 動手，而是讓每次「會影響專案的動作」都有看得懂的範圍、理由與回復方式。
新手先記住這 5 個斜線指令
在 Claude Code 的對話中輸入 /，就能看到可用指令。剛開始不需要背一整張指令表，先把下面五個用熟就好。
| 指令 | 什麼時候用 |
|---|---|
/help | 忘記功能、想查看目前版本支援什麼時。 |
/init | 請 Claude 分析專案，建立初版 CLAUDE.md。 |
/clear | 上一個任務已結束，避免舊話題干擾下一件事。 |
/compact | 對話很長時壓縮上下文，保留重點繼續工作。 |
/exit | 離開這次 Claude Code 工作階段。 |
做完第一個任務，就建立 CLAUDE.md
當專案有了幾個檔案與固定習慣後，輸入 /init。Claude Code 會根據專案建立初版 CLAUDE.md，把常用指令、技術堆疊與規範留下來。之後每次新工作階段，它都能更快理解你的專案，不必一再從零說明。
## 每次修改前
- 先說明預計修改的檔案與原因
- 不要直接刪除既有功能
- 完成後執行可用的測試或檢查
## 介面規範
- 使用繁體中文
- 優先維持手機版可讀性
- 不新增未經確認的套件這不是一份越長越好的百科，而是一份能讓 AI 穩定遵守的專案備忘錄。想深入設定範圍、專案層級與多人協作，可接著看 CLAUDE.md 專案規範設定教學。
最後一關：用 Git 看 diff，再決定要不要 commit
AI 幫你修改完成，不代表任務就結束。回到終端機，先看變更，再測試，再留下版本紀錄。這會讓你敢嘗試，也能在發現問題時清楚回頭。
git status
git diff
git add index.html style.css app.js
git commit -m "建立個人介紹頁初版"git diff 是新手很值得養成的習慣：它會顯示這次到底改了什麼。確認頁面正常、內容符合預期後再 commit。若你正開始用 AI 做網站或小工具，推薦把 GitHub 管理 Vibe Coding 程式碼 一起看完；它會把本機的改動變成可追蹤、可協作的專案歷程。
新手最容易卡住的 4 件事
- 找不到
claude指令：重開終端機後再測；還是不行再檢查 PATH，不要急著重複安裝好幾次。 - 在錯的資料夾啟動：先用
pwd、ls確認，尤其不要把整個客戶網站資料夾當作練習場。 - 一次要求太多：把「做完整網站」拆成盤點、頁面結構、元件、樣式、測試五個小任務。
- 把 API Key 貼進對話：金鑰、密碼與正式環境設定不應直接貼出；改用環境變數與忽略檔，並先確認它將讀取的範圍。
結語：先把流程跑順，再追求速度
第一次使用 Claude CLI 的目標，不是一天做出大產品，而是建立一個你看得懂、能掌控的開發節奏：在正確資料夾啟動，先要求分析，逐步核准修改，查看 diff，最後 commit。這套流程學會後，無論你做網站、寫腳本，或用 Claude Code 協助整理既有專案，底子都一樣穩。
若你偏好桌面介面來整理專案與可交付成果，也可以延伸閱讀 Claude Code 桌機版 Project 與 Artifacts 新手教學；終端機適合直接和專案協作，桌機版則適合將成果梳理成更好分享的工作區。
常見問題
Claude CLI 和 Claude Code 是同一個東西嗎？
一般口語裡的 Claude CLI，多半就是指官方的 Claude Code 命令列工具；你在終端機執行的命令是 claude。它的重點是直接在專案資料夾中協助閱讀、修改與執行開發工作。
完全不會寫程式，也能用 Claude CLI 嗎？
可以從小任務開始，例如建立靜態頁面、說明既有檔案或修改一段文案。但你仍要知道專案放在哪裡、每次修改了什麼，並學會看 git diff。AI 能降低起步門檻，不能取代你對成果的確認。
第一次要直接開啟自動批准嗎？
不建議。第一次先保留需要確認的權限方式，尤其是新增套件、刪除檔案、讀取設定檔與執行 shell 指令。等你清楚某個專案的操作範圍後，再視情況調整。
為什麼一定要在專案根目錄執行 claude？
因為目前資料夾決定了 Claude Code 優先理解與操作的範圍。在根目錄啟動，檔案關係、設定與 Git 紀錄比較完整；在錯的上層資料夾啟動，則容易讓任務範圍變得太大。
每次開新工作階段都要重新說明專案嗎？
不用從零開始。完成初步盤點後可用 /init 建立 CLAUDE.md，把專案慣例、測試方式與修改原則寫進去；下次進入同一專案時，再針對本次任務補充即可。
