踏出第一步：打開終端機

1.1　終端機是什麼？為什麼工程師愛用打字？↑ 回本章選單

平常你用電腦，是滑鼠點圖示：想開資料夾就用滑鼠雙擊那個黃色的小夾子。這很直覺，但有個限制——你只能做「畫面上有按鈕」的事。

終端機換了一種方式：你用打字下命令。打一行字、按 Enter，電腦就照做。它看起來樸素（通常就是個深色視窗加閃爍的游標），但威力很大，因為：

• 精準：一句話就能講清楚要對「哪個檔案」做「什麼事」。
• 可重複：同一串指令可以存起來、重跑，不用每次手動點。
• 這本書走終端機這條路：Claude Code 其實也有 IDE 外掛、桌面版和網頁版可以用，但終端機版本功能最完整——官方稱它是「the full-featured CLI」。先學會打開這扇門，你才能跟著這本書一路往下讀。✅官方

1.2　Windows 怎麼開：Windows Terminal → PowerShell↑ 回本章選單

Windows 的新手主線只走一條：先開 Windows Terminal，再選 PowerShell 分頁。本書後面的 Windows 指令都以這個組合為準；不需要為了本教學安裝 WSL，也不要在 PowerShell、CMD、WSL 之間混貼指令。

怎麼打開 Windows Terminal 的 PowerShell 分頁

1. 1
   ✋動手做

   打開 Windows Terminal

   按鍵盤左下角的 Windows 鍵（或點開始按鈕），直接打字輸入 Windows Terminal，點開搜尋到的那一項。

   ✅ 預期會看到

   螢幕上打開一個新視窗，視窗上方有分頁列（tab bar），分頁列右側有一個大大的「＋」符號。

2. 2
   ✋動手做

   確認開啟的是 PowerShell 分頁

   看目前分頁裡的提示字元；如果不是 PowerShell，按分頁旁的下拉箭頭 ˅，從清單選 PowerShell。

   ✅ 預期會看到

   游標前面那行字開頭是 PS C:\Users\你的名字>——注意開頭那個 PS。如果沒看到 PS（只顯示 C:\Users\你的名字>），代表你開到了 CMD，切回 PowerShell 分頁再繼續。

另一條路：按 Windows 鍵 ＋ X

搜尋框哪天不管用，或你就是喜歡快捷鍵，還有第二招：按 Windows 鍵 ＋ X，畫面下方（開始按鈕的位置）會跳出選單。如果你的電腦已經裝了 Windows Terminal，選單裡會看到「終端機」；如果還沒裝，選單會顯示「Windows PowerShell」，直接選它一樣能用。開啟後一樣確認是 PowerShell 分頁再繼續；不要改去 CMD 或 WSL 視窗。✅官方

如果之後常常要用，可以趁 PowerShell 分頁開著的時候，對工作列上的圖示按右鍵，選「釘選到工作列」，下次點一下就能直接開，不用再重新搜尋一次。

1.3　Mac 怎麼開：Terminal 在哪？↑ 回本章選單

Mac 的終端機叫「終端機」（英文 Terminal），它本來就裝好了，最快的打開方式是用 Spotlight 搜尋：

1. 1
   ✋動手做

   打開 Spotlight，搜尋終端機

   按 Command（⌘）＋空白鍵，打字輸入 Terminal 或中文「終端機」。

   ✅ 預期會看到

   畫面上方跳出一個搜尋框（這就是 Spotlight），輸入後最上面一項會顯示「終端機」，旁邊有一個黑色方形圖示。

2. 2
   ✋動手做

   按 Enter 開啟

   確認最上面那項是「終端機」後，按 Enter。

   ✅ 預期會看到

   一個新視窗打開，深色背景、有一個閃爍的游標，最後一行類似 你的電腦名稱:~ 你的帳號名稱$——看到這行字，代表終端機已經準備好讓你打指令了。

如果你發現自己每次都要重新 Spotlight 搜尋，可以趁終端機開著的時候，對 Dock 上它的圖示按右鍵 → 選項 → 「在 Dock 中保留」，之後點一下 Dock 就能直接開，不用再搜尋一次。

1.4　Linux 怎麼開↑ 回本章選單

如果你用 Linux，那你多半已經知道終端機在哪了，這裡快速帶過。多數桌面環境（如 Ubuntu 的 GNOME）有兩種開法：

• 快捷鍵：按 Ctrl ＋ Alt ＋ T。Ubuntu 官方文件明載這個快捷鍵會直接開啟預設終端機。✅官方
• 從應用程式選單：搜尋「Terminal」或「終端機」並點開——這條路徑不依賴快捷鍵是否綁定，任何發行版都能用。

快捷鍵在不同發行版、不同桌面環境不一定綁定同一組按鍵；這裡沒有一一查證每個發行版的預設值，如果按了沒反應，直接改用上面「從應用程式選單」那條路徑就好。🧪推論

1.5　五個保命指令↑ 回本章選單

終端機開好了，來練五個最常用的指令。它們就像走路、轉彎這種基本動作，學會就能在電腦裡「移動」。這五個指令在 Windows、Mac、Linux 三個系統上打法幾乎一模一樣，下面直接照抄就好；只有 ls 這一個指令三個系統有點小差異，會用分頁讓你切換查看——切換一次，翻到別章也會記得你選的系統。

① cd　走進某個資料夾（change directory）

想從現在的位置「走進」某個資料夾，用 cd 加上資料夾名字。三個系統都一樣：

# 走進名叫 Documents 的資料夾
cd Documents

想回上一層（退回外面那個資料夾），打 cd ..（兩個點代表「上一層」）。

三個系統「再按一次 Tab」的差異：

② ls　看看這裡面有什麼

想知道目前這個資料夾裡裝了哪些檔案和子資料夾，用這個指令。Mac、Linux，以及 Windows Terminal 裡的 PowerShell 都照打 ls：

# 列出目前資料夾的內容
ls

想看隱藏檔可以加 -la（ls -la）：Mac 和 Linux 都支援，但 Windows Terminal 的 PowerShell 不支援這個旗標。

③ pwd　我現在到底在哪？

走著走著迷路了？這個指令會印出你「目前所在的完整路徑」，像在地圖上點「你的位置」：

# 印出目前所在的完整路徑
pwd

執行後會印出一長串路徑，Mac／Linux 長得像 /Users/你的名字/Documents，Windows 長得像 C:\Users\你的名字\Documents——那就是你目前的位置。

「路徑」就是「怎麼走到某個檔案或資料夾」的地址，有兩種寫法。相對路徑是「從你現在的位置開始算」，像前面 cd Documents，是從你目前所在的地方走進去；絕對路徑是「從最頂端開始算的完整地址」，不管你現在在哪都對。

還有一個好用的縮寫：~（波浪號）代表你的個人目錄（每個系統帳號自己的起始資料夾）。Mac、Linux，以及 Windows Terminal 裡的 PowerShell，打 cd ~ 都能直接跳回去，不用打完整路徑。✅官方

之後你會常常在設定檔路徑裡看到這個符號，例如 ~/.claude/，指的就是這裡。

④ mkdir　開一個新資料夾（make directory）

要建立一個新資料夾，用 mkdir 加上你想取的名字。三個系統都一樣：

# 建立一個叫 my-project 的資料夾
mkdir my-project

想一次建立「資料夾裡面還有資料夾」的巢狀結構，三個系統處理方式不同：

⑤ 清空畫面（clear）

畫面被一堆文字塞滿、看了眼花？把它清乾淨。Mac、Linux，以及 Windows Terminal 裡的 PowerShell 都用 clear：

# 清空畫面（也可以按 Control + L）
clear

三個平台的預設行為對照（打 cd documents、實際資料夾叫 Documents）：

1. 三個平台都「保留大小寫」——名字原樣存著，不會被系統改掉。
2. 兩個「不分大小寫」的平台都可以手動改嚴：macOS 格式化時選 APFS (Case-sensitive)；Windows 用 fsutil.exe file setCaseSensitiveInfo <path> enable（需系統管理員權限）。都不是預設。
3. 三個平台裡只有 Linux 預設會失敗——但程式遲早會跑在 Linux（伺服器、CI、Docker），所以「大小寫照著打」仍是該養成的習慣。

1.6　最關鍵的一步：走進你的專案資料夾↑ 回本章選單

這是整章最重要的一招。之後你要用 Claude Code，第一件事幾乎都是「先用 cd 走進你的專案資料夾」，這樣它才知道要對哪個專案動工。

1. 1
   ✋動手做

   走進你的專案資料夾

   假設你的專案放在「文件」資料夾底下、名叫 my-project，先選你的系統再打對應的指令。斜線方向兩邊不同：Windows 走反斜線 \，Mac 和 Linux 走正斜線 /——這是各自檔案系統原本就有的寫法，不是誰新支援誰，記住各自的習慣寫法就好。（小知識：Windows 的檔案 API 本來就會自動把正斜線換成反斜線，所以偶爾打成 / 通常也吃得下；唯一的例外是打 \\?\ 開頭的特殊路徑，那種寫法會關掉這個自動轉換。新手用不到 \\?\，看到再說就好。✅官方）

   Windows Mac Linux
2. 2
   ✋動手做

   打 pwd，確認自己真的到了

   走進去之後，打這個指令，跟自己核對一下：

   pwd

   複製

   ✅ 預期會看到

   螢幕上印出的路徑，最後一段應該是 my-project——Mac／Linux 會看到類似 /Users/你的名字/Documents/my-project，Windows 會看到類似 C:\Users\你的名字\Documents\my-project。看到這樣就代表你真的走到專案資料夾裡了。

1.7　打字打不動？終端機常見小狀況↑ 回本章選單

練習過程難免手滑，或跑出意料外的畫面，這很正常，不是你電腦壞了。下面整理新手最容易卡住的幾種狀況，照著對就好。

另外兩種常見狀況，三個系統回應的訊息長得不太一樣，但意思都一致——對照你看到的那一句：

三句話意思都一樣：這個指令或路徑打錯字了，或這個系統根本沒有這個東西。檢查拼字、注意大小寫，通常就能抓到；不確定資料夾裡有什麼，先用 ls／dir 看清楚，再照實際看到的名字打一次。

1.8　來源與查證邊界↑ 回本章選單

本章 34 條具體主張已於 2026-08-04 完成逐條查證。