Claude Code 入門:從零到能上線的工作流

2026年5月2日

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 整合有完整說明——那些才是真正讓生產力指數成長的地方。先收藏起來,熟練之後再回去翻。