Claude Code 是 Anthropic 官方的終端機 CLI。它在你的 shell 裡跑、直接改檔案、執行指令、跟你現有的 dev 工具串在一起。比起「在聊天框複製貼上」的工作流,Claude Code 是真的能在你的 codebase 上迭代——讀檔、跑測試、改完丟 commit。
這篇是從零到生產力的最短路徑。
安裝
用 npm 安裝:
npm install -g @anthropic-ai/claude-code
然後驗證:
claude
第一次跑會要你登入,登入完之後 session 會持續。
真正重要的 mental model
把 Claude Code 想成一個有無限耐性、又能存取整個 repo 的 junior engineer。這個框架會改變你下 prompt 的方式:
- 不要逐步指示。 描述目標跟限制就好。
- 引用具體檔案。 路徑、function 名、行號——任何能讓模型錨定在你 codebase 的東西都丟過去。
- 不對就回擊。 第一次寫錯,明確講哪裡錯,不要重來。
實戰工作流
熟練的人最後幾乎都會收斂到這個 loop:
Step 1:先計畫,再動手
碰檔案前,先讓 Claude 把要改的內容列出來。「讀這三個檔,告訴我 auth check 在哪」遠勝於「幫我修 auth bug」。
Step 2:小、可 review 的 diff
一次只做一片。一個你真的會讀的 50 行 diff,比一個你只是滑過去的 500 行 diff 有價值。
Step 3:跑起來看
每次改完,跑 test 或 dev server。Claude Code 可以幫你跑——而且它會看到 output,這才是重點。
什麼時候該開 Agent
Claude Code 主要是一個模型扛整段對話。如果是獨立的搜尋(「找出所有呼叫 getUser 的地方」),或你不想讓 2000 行的檔案污染主 context,就 spawn subagent。Explore agent 特別適合做唯讀的探勘。
常見地雷
- Prompt 太空泛。 「幫我寫得更好」沒用。「把
src/app/page.tsx的 bundle size 壓到 gzip 後 150kb 以下」才會有真的 diff。 - 跳過驗證。 Test suite 過了才是修好的訊號。相信測試,不要相信模型的自信。
- Context 越塞越多。 長 session 會累積雜訊。不相關的任務開新 session。
下一步
官方文件對 slash commands、hooks、MCP 整合有完整說明——那些才是真正讓生產力指數成長的地方。先收藏起來,熟練之後再回去翻。