Claude Code 實戰：CLI 安裝、開發流程與多步驟任務

Claude Code 和網頁版 Claude 的根本差異在這裡：

網頁版 Claude 知道你說了什麼，Claude Code 知道你的整個專案是什麼樣子。

它跑在你的 Terminal 裡，可以讀取本機所有檔案、執行 shell 指令、修改程式碼、跑測試。你說「幫我加一個登入功能」，它不是給你一段程式碼讓你自己貼，而是直接找到對的檔案、寫進去、跑測試確認沒有問題。

Claude Code 開發流程

安裝

需要 Node.js 18 以上。

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

驗證安裝：

claude --version

登入：第一次執行時會要求用 Claude 帳號登入（Pro 訂閱即可使用）。

基本使用

在你的專案目錄啟動：

cd your-project
claude

進入互動介面後，直接用自然語言下指令：

> 這個專案是做什麼的？
> 找出所有沒有錯誤處理的 async 函式
> 幫我在 src/auth/ 加一個密碼重設功能

Claude Code 會先讀取相關檔案，再告訴你它打算做什麼，確認後執行。

核心能力

讀取整個專案上下文

這是 Claude Code 最重要的能力。

網頁版 Claude 只知道你貼給它的程式碼片段。Claude Code 可以直接讀取你的整個專案目錄，理解檔案結構、函式之間的依賴關係、命名慣例。

> 這個 API 的認證邏輯在哪裡？
> 找出所有呼叫到 getUserById 的地方
> 這個函式和哪些其他模組有依賴關係？

執行指令

Claude Code 可以執行 shell 指令，並根據輸出繼續行動：

> 跑測試，如果有失敗的告訴我原因
> npm run build，如果有錯誤幫我修
> git status 然後告訴我有什麼未提交的變更

修改檔案

Claude Code 會直接編輯你的檔案，不是複製程式碼給你。每次修改前它會告訴你打算改什麼，你確認後才執行。

> 把所有用 var 的地方改成 const 或 let
> 幫 UserService 的所有公開方法加上 JSDoc 註解
> 把這個 callback 模式重構成 async/await

實際開發工作流

工作流一：新功能開發

> 我需要一個用戶頭像上傳功能：
> - 接受 JPG/PNG，最大 2MB
> - 上傳到 /uploads/avatars/ 目錄
> - 更新資料庫的 users.avatar_url 欄位
> - 舊頭像要刪除
> 
> 先看一下現有的檔案結構，然後告訴我你的計畫

Claude Code 會先看你的專案，提出實作計畫，你確認後它自己找對應的檔案修改。

工作流二：Debug

> 執行 npm test，看看哪些測試失敗，幫我修好

Claude Code 跑測試、看錯誤訊息、找原因、修改程式碼、再跑一次確認，整個循環自己處理。

工作流三：Code Review

> Review 最近的 git commit，找出潛在的問題：
> - 安全性漏洞
> - 效能問題
> - 沒有處理的 edge case
> - 不符合專案慣例的地方

工作流四：重構

> src/utils/ 下有很多重複的 helper 函式，
> 找出重複的部分，整合成共用模組，
> 並更新所有呼叫這些函式的地方

這種跨多個檔案的重構，在 Claude Code 裡比手動處理快很多。

CLAUDE.md：給專案的持久說明

在專案根目錄建立 CLAUDE.md，Claude Code 每次啟動都會讀取這個檔案。

這是告訴 Claude Code 關於你的專案的最好方式：

# 專案說明

這是一個用 Next.js + PostgreSQL 做的部落格後台。

## 技術棧
- Frontend: Next.js 14, TypeScript, Tailwind CSS
- Backend: Next.js API Routes
- Database: PostgreSQL (使用 Prisma ORM)
- 部署: Vercel

## 開發規範
- 所有新函式必須有 TypeScript 型別
- API 路由要有錯誤處理
- 資料庫查詢用 Prisma，不要直接寫 SQL
- 測試用 Jest，新功能要附帶測試

## 注意事項
- .env 檔案不要提交
- migrations 跑完要更新 schema.prisma 的註解

有了 CLAUDE.md，Claude Code 就知道你的專案用什麼技術、什麼規範，不需要每次重新說明。

常用指令

指令	說明
`claude`	在當前目錄啟動互動模式
`claude "指令"`	直接執行單一指令後退出
`claude --help`	查看所有選項
`/exit` 或 Ctrl+C	離開互動模式
`/clear`	清除對話歷史（保留專案上下文）

Skills：擴充 Claude Code 的能力

Claude Code 支援 Skills，讓你定義可以重複使用的自定義指令。

例如你常用的 commit 流程、部署流程、程式碼審查標準，都可以包成 Skill，之後用 /skill-name 直接呼叫。

Skills 存放在 .agents/skills/ 目錄，詳細設定方式見 Claude Code Skills 指南。

Claude Code vs 網頁版 Claude：怎麼選

場景	用哪個
快速問問題、寫一段程式碼	網頁版 Chat
需要讀取整個專案的上下文	Claude Code
要實際執行指令或測試	Claude Code
多步驟的開發任務	Claude Code
需要修改多個檔案	Claude Code
做網頁 UI 原型、SVG 圖表	網頁版 Cowork（Artifacts）

常見問題

Q：Claude Code 會不會亂改我的檔案？ 每次修改前 Claude Code 都會告訴你它打算做什麼，你確認後才執行。如果你用 git，建議在乾淨的分支上工作，方便 review 和回退。

Q：費用怎麼算？ Claude Code 包含在 Claude Pro 訂閱裡，不需要另外付費。使用量計入 Pro 的配額，一般開發使用不太會碰到上限。

Q：Claude Code 和 Cursor 有什麼不同？ Cursor 是整合 AI 的 IDE（基於 VS Code），有完整的編輯器界面，適合想要 AI 深度整合進編輯器的用戶。Claude Code 是命令列工具，更輕量，適合不想換編輯器或需要自動化執行複雜任務的場景。兩個可以並用。

Q：支援哪些程式語言？ 任何語言都支援，Claude Code 理解程式碼的能力不限語言。

小結

Claude Code 適合的是需要跨多個檔案、需要執行結果、需要和真實程式庫互動的開發工作。如果你只是要寫一段程式碼或問問題，網頁版 Chat 夠用。如果你要它真正動手做事，Claude Code 才是對的工具。

🔗 系列文章

這篇有幫助嗎？ Claude Code 不在瀏覽器裡——它在你的 Terminal，直接動你的程式碼。

—