AI 概論初階班第一堂 Part 2：10-20 分鐘動手裝 Claude Code（含踩坑）

能力	ChatGPT 網頁	Cursor IDE	Claude Code CLI
讀你本機檔案	✗	✓	✓
跨多個檔案改動	✗	△	✓
跑 shell 指令	✗	✗	✓
自己驗證結果	✗	△	✓
不用綁某個 IDE	✓	✗	✓
Claude Pro 吃到飽	✗	✗	✓
適合後端 / DevOps	△	△	✓

ChatGPT 是聊天視窗，你貼 code 進去它回答，它不會碰你的檔案。Cursor 是把 AI 塞進 VSCode fork，適合前端開發。Claude Code 是 CLI 裡的一個 agent — 它等你給目標，然後自己決定要讀什麼檔、要跑什麼指令、要改什麼檔案，做完回報結果。

三者的核心差異是誰在動手：

ChatGPT → 你動手（複製貼上）
Cursor → 一起動手（半自動）
Claude Code → 它動手（你只負責下目標）

🚀 從 0 開始：一行 curl 搞定

這一段的重點：你什麼前置都不用先裝。不用 Node.js、不用 Docker、不用 brew、不用註冊 API key。只要：

一台電腦（macOS / Linux / Windows 都行）

任何一個終端機

Claude Pro（或以上）訂閱帳號

macOS / Linux / WSL

打開 terminal，貼這一行：

curl -fsSL https://claude.ai/install.sh | bash

就這樣。裝好之後打 claude 就會進入互動模式。

Windows PowerShell

irm https://claude.ai/install.ps1 | iex

Windows 原生模式還需要 Git for Windows（因為 Claude Code 內部會呼叫 Git Bash 執行 shell 指令）。WSL 模式不用裝。

Windows CMD（如果你在用 CMD 而不是 PowerShell）

curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

怎麼判斷自己在 CMD 還是 PowerShell：看 prompt 開頭。PS C:\ 是 PowerShell，C:\ 沒 PS 是 CMD。

其他安裝方式（看情況）

macOS Homebrew 用戶：brew install --cask claude-code
Windows WinGet 用戶：winget install Anthropic.ClaudeCode
Linux apt / dnf / apk：Anthropic 有提供官方簽名 repo
進階：npm 全域安裝：npm install -g @anthropic-ai/claude-code（需要 Node.js 18+，官方警告不要 sudo）

企業內訓現場我 90% 的時間都推薦 native installer（那行 curl）。理由：

沒有 Node.js 版本衝突問題

自動背景更新

單一 binary，好清乾淨

不需要 npm / Homebrew 這些前置工具

裝完驗證

claude --version
# 有輸出版本號就成功

更進階的健檢：

claude doctor
# 會檢查環境、權限、設定檔

登入 Claude Pro

第一次跑 claude 會跳出一個 URL 要你登入帳號，貼回瀏覽器授權完就好。登完回到 terminal 就會看到 Claude Code 的歡迎畫面，游標在等你輸入。

整個過程正常不超過 2 分鐘。如果你卡了 10 分鐘還沒進到這一步，不要自己 Google — 直接找我或同梯學員問，90% 是小問題。

🧪 第一個任務：讓它讀你的專案

很多人安裝好 Claude Code 的第一句話是：「寫一個 hello world」。錯。

這個任務對 agent 來說太弱了，你根本看不出它和 ChatGPT 的差別。第一個任務一定要叫它讀你的專案，才會觸發它的 agent 能力。

在互動模式輸入：

幫我讀過整個專案，告訴我架構長怎樣。
要包含：用了哪些框架、主要的資料夾分工、
有沒有看起來可能是技術債的地方。

你會看到 Claude Code 自己跑：

先跑 find . -type f -name "*.md" 找文件

cat README.md 理解專案定位

ls src/ 看資料夾結構

grep -r "import" --include="*.ts" 找依賴

最後整合成一份架構報告回給你

第一次看到它自己這樣跑，你才會信「agent」不是 marketing 話術。

企業內訓現場我一定讓學員親眼看到這個過程。看過一次，腦袋就回不去了。

✏️ 第二個任務：讓它動手改檔案

讀只是第一層。第二層是叫它改。第二個任務我固定出這題：

把 README.md 的英文部分翻成繁體中文，
保留所有程式碼區塊和連結不變，
翻完存回原檔。

這個任務能測三件事：

讀：它會先 cat README.md

改：它會用內部的 Edit/Write 工具改檔案

驗：它會再讀一次確認寫入成功

全程你不用碰鍵盤。這才是 agent — 它自己決定 workflow，你只給目標。

踩坑提醒：第一次它可能會問你「確定要覆寫 README.md 嗎？」— 這是內建的安全確認，按 y 就好。後面跑熟了可以開 auto-accept 模式（之後的課會教）。

✅ 下課前 checklist

這堂課 20 分鐘結束前，每個學員必須達到這三件事：

Claude Code 可以跑：claude --version 有回應
跑過一個讀檔任務：不是 hello world，是叫它讀完你的專案
跑過一個改檔任務：叫它翻譯或重寫某個檔案

做到才算從 0 變 1。做不到下課前舉手，我不會讓任何人帶著「我回去自己試」離開教室 — 那句話的實際意義就是不會試。

💥 企業內訓常見踩坑

帶過這麼多場，80% 的卡關都在這幾個點：

坑 1：curl 被公司網路擋

公司 proxy 擋了 claude.ai 或 downloads.claude.ai 的 https。

解法：改用手機熱點跑一次安裝（之後工作時照常走公司網路），或問 IT 把這兩個 domain 加 whitelist。企業授課前我通常會先請窗口確認網路可達。

坑 2：Windows 沒裝 Git for Windows

Native installer 裝完後打 claude 卻跳 bash not found。

Error: Claude Code requires Git for Windows for running shell commands.

原因：Windows 版 Claude Code 內部呼叫 Git Bash 來跑 shell 指令（find、grep 這些 POSIX 工具 Windows 沒內建）。

解法：去 git-scm.com/downloads/win 裝 Git for Windows，重新打開 terminal。

坑 3：Claude Pro 登入卡住

打 claude 第一次會彈 URL，部分學員的瀏覽器會攔截 localhost redirect。

解法：不要用 Safari，開 Chrome 或 Firefox 貼 URL，登完就會自動跳回 terminal。

坑 4：想用 npm 裝卻跳 EACCES

如果你堅持走 npm 路線（因為公司只允許 npm），安裝時跳：

npm ERR! code EACCES
npm ERR! syscall access

原因：macOS / Linux 的全域 npm 目錄需要 sudo 寫入，而官方強烈警告不要 sudo。

解法：改 npm prefix 到 home 目錄：

mkdir -p ~/.npm-global
npm config set prefix ~/.npm-global
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc

更好的解法：別用 npm 了，改用 native installer，一行 curl 完事。

⏱️ 為什麼這堂課只排 20 分鐘

學員常問：「這麼重要的工具，一堂課只給 20 分鐘夠嗎？」

夠。

我排課的邏輯是：工具本身的門檻不高，難的是觀念和工作流。20 分鐘完成安裝和第一次試跑，剩下 30 分鐘才是這堂課真正的重點 — 第一個真實工作任務（下一篇會寫）。

很多線上課程把「安裝 Claude Code」拉成一整堂課，其實是在填時間。真實的狀況是：官方現在一行 curl 就能裝完，如果你看完這篇 20 分鐘能讀完、親手跑一次，就可以直接進入每天上班用它幫你做事的階段。

5-6 年 Java 後端經驗教會我一件事：工具不是目的，解題才是。工具愈簡單、跳進解題愈快愈好。

❓ 你卡在哪一步

留言告訴我你下課前卡在哪：

curl 指令跑不動（網路或權限問題）

Windows 裝完 claude 不能跑

登入 Claude Pro 失敗

不知道要叫它做什麼

已經跑起來了（報告一下）

我會一個一個回。企業內訓上過 10-50 場，幾乎每個學員都踩過上面至少一個坑，你不孤單。

下一篇（Part 3，20-50 分鐘）：第一個真實工作任務 — 用 Claude Code 重構一段 legacy 程式碼。

不怕死，只怕不過癮。

📌 目錄

🎯 第一堂後半段的教學目標

🔥 為什麼不能只看 Demo

⭐ Claude Code 是什麼

⚖️ Claude Code vs ChatGPT vs Cursor 比較