今天的目標

昨天講了觀念：Claude Code 是「手」，不是「嘴巴」。今天我們動手，讓你在 5 分鐘內親眼看到它自己做完一件事。

我不想讓你看示意圖，我要你自己跑一次。跑過一次，昨天那句「它會自己動手」你才會真的相信。

你需要準備什麼

只有兩樣：

1. 一個終端機（macOS 的 Terminal、Windows 的 WSL / PowerShell、任何 Linux shell 都行）
2. Node.js 18 以上

檢查 Node.js：

node --version

如果印出 v18.x 以上就過關。沒裝的話去 nodejs.org 裝一個 LTS 版本，或用你習慣的版本管理工具（nvm、fnm）。

沒有 Node.js 也可以——Claude Code 也有原生安裝方式（一行 curl 腳本）。但用 npm 裝最單純，我們先走這條。

第一步：安裝

npm install -g @anthropic-ai/claude-code

裝完驗證一下：

claude --version

有印出版本號就代表裝好了。整個過程通常不到一分鐘。

第二步：進到一個專案資料夾，啟動它

Claude Code 是「住在資料夾裡」的——你在哪個目錄啟動它，它就以那個目錄為工作範圍。

找一個你的專案（或隨便開一個新資料夾來玩）：

mkdir claude-hello && cd claude-hello
claude

第一次啟動它會要你登入（用你的 Anthropic 帳號授權，或設定 API key）。跟著畫面走完就好，這步只做一次。

登入完，你會看到一個等你輸入的提示符。恭喜，Agent 已經站在你的資料夾裡待命了。

第三步：那個「魔法時刻」

現在別客氣，直接給它一個真的要動手的任務，不要只是問問題。試試這句：

幫我做一個 hello.py，印出今天的日期，然後直接執行它給我看結果

按下 Enter，然後看它做什麼：

1. 它會說要建立 hello.py，並問你要不要允許（第一次會問）
2. 你允許之後，它把檔案寫進去
3. 它跑 python hello.py
4. 它把執行結果讀回來，貼給你看

你剛剛沒有自己打開編輯器、沒有自己存檔、沒有自己跑指令。你只出了一張嘴，它動了手。 這就是昨天說的差別，跑一次你就懂了。

打開資料夾看看，hello.py 真的在那裡——不是它「假裝」寫了，是真的寫進你的磁碟。

剛剛到底發生了什麼？

把這個小小的過程拆開，其實就是昨天講的 agent 迴圈：

• 感知：它讀了你的指令、看了目前資料夾（是空的）
• 決策：決定「要建一個 py 檔、寫這段 code、然後執行」
• 行動：真的建檔、真的跑指令
• 看結果：讀回 python 的輸出
• 回報：把結果整理給你

差別只在於——今天的任務很小。但同一個迴圈，換成「修一個 bug」「重構一個模組」「跑一輪測試再修到綠」，它照樣這樣走。任務的大小會變，迴圈不會變。

那些「要不要允許」的提問是什麼？

你會注意到，它每次要改檔、跑指令，第一次都會停下來問你。這是刻意的設計，不是它膽小。

Claude Code 預設把「有副作用的動作」（寫檔、執行指令）都當成需要你點頭的事。這是你和它之間的信任邊界：

• 剛開始你可能想每個動作都自己看一眼——很好，保持謹慎。
• 熟了以後，你可以告訴它「這類動作以後免問」（例如：讀檔、跑測試），把常用的安全動作放行，只在真正危險的動作（刪東西、推 git）才攔。

這個「信任邊界怎麼設」會是我們後面很重要的主題——因為當你要讓 agent 24 小時無人看管地工作時，這條線畫在哪裡，直接決定它能幫你多少、又不會闖多大的禍。

如果卡住了

• claude 指令找不到：npm 全域安裝的路徑可能不在你的 PATH。跑 npm config get prefix 看安裝位置，把它的 bin 加進 PATH。
• 登入卡住：確認你的網路能連到 Anthropic，或改用 API key 的方式設定。
• 它不肯跑指令：檢查是不是你在權限提問時選了拒絕；重開一次或明確跟它說「可以執行」。

今天的重點回顧

• 裝 Claude Code 只要一行 npm install -g @anthropic-ai/claude-code。
• 它「住在你啟動它的那個資料夾」，工作範圍就是那裡。
• 給它一個要動手的任務（不是問答），你會親眼看到「感知 → 決策 → 行動 → 看結果 → 回報」跑完一輪。
• 那些權限提問是信任邊界——後面讓 agent 無人看管工作時，這條線至關重要。

明天 Day 3：光會動手還不夠。我們要用一個叫 CLAUDE.md 的檔案，給你的 Agent 一個「靈魂」——讓它記得自己是誰、該遵守什麼規則、用什麼風格做事。這是把「通用工具」變成「你專屬助手」的關鍵一步。

Genos Lin 是一位技術創辦人，同時擔任多個 AI 導入客戶案的技術顧問。他目前維運一套由 39 個 Claude Code Agent 組成的自動化系統，用於產品開發、業務流程自動化與客戶服務。