Claude Code 教學：從安裝到第一次真正派上用場

本文重點

• Claude Code 跑在終端機裡，能直接讀寫檔案、執行指令、看錯誤再修正。
• 一定要在 git 版控的專案裡用。先 commit，再讓它動手。
• 寫一份 CLAUDE.md 說明專案慣例，效果勝過每次重複交代。
• 它最擅長的不是寫新功能，而是在你不熟的程式碼裡找東西、改東西。

它和聊天視窗的差別

在網頁上問 AI 程式問題，流程是：你複製程式碼 → 貼上 → 它給建議 → 你貼回編輯器 → 執行 → 出錯 → 再複製錯誤訊息回去問。

Claude Code 把這個迴圈收進終端機裡。它能自己讀檔案、自己改、自己跑測試、看到錯誤自己修。你要做的是描述目標，然後審查結果。

這就是AI Agent在寫程式這個領域的具體樣貌——差別不在模型多聰明，而在它有沒有手可以動。

安裝與啟動

1. 1

   安裝

   依照 Anthropic 官方文件的指示安裝 Claude Code CLI。安裝方式會隨版本調整，直接看官方文件最保險。

2. 2

   登入

   第一次執行時會引導你登入 Claude 帳號。訂閱方案的額度和 API 計費是兩套系統，登入哪個帳號就用哪邊的額度。

3. 3

   進入專案目錄

   切換到你的專案根目錄再啟動。它的工作範圍以啟動時的目錄為準，這也是第一道安全邊界。

4. 4

   開始對話

   直接用中文描述你要做什麼。不需要先講規格，講目標就好。

最值得先做的一件事：寫 CLAUDE.md

在專案根目錄放一份 CLAUDE.md，寫下這個專案的慣例。Claude Code 每次啟動都會讀它。

值得寫進去的內容：

• 專案在做什麼、主要目錄結構
• 用什麼套件管理工具、測試怎麼跑
• 程式風格慣例（縮排、命名、要不要寫註解）
• 有哪些地方不要動
• 常用指令

這件事的投資報酬率很高。沒有它，你每次都要重新交代一遍「這個專案用 pnpm 不是 npm」；有了它，這些變成預設。

實際上最好用的場景

在陌生的程式碼裡找東西。 「這個錯誤訊息是從哪裡拋出來的」「使用者登入的流程經過哪些檔案」——它會自己搜尋、自己追，比你一個個開檔案快得多。

大範圍的機械性修改。 把某個 API 的呼叫方式全面換掉、統一命名慣例、補上缺漏的型別。這種工作無聊但容易出錯，正好交給它。

寫測試。 給它一個既有函式，請它補測試案例。它通常會想到你沒想到的邊界條件。

看懂別人的程式碼。 請它解釋一段複雜邏輯在做什麼，比自己讀快很多。

沒那麼好用的場景

需求還沒想清楚的新功能。 你講不清楚要什麼，它也做不出你要的。這種時候先自己想，或先用對話釐清，不要急著讓它寫。

牽涉大量業務脈絡的判斷。 「這個折扣規則該怎麼算」這類問題，答案在你的商業邏輯裡，不在程式碼裡。

你完全看不懂的領域。 它產出的東西你無法審查，等於把風險全部接下來。

熟悉之後可以用的進階功能

基本操作順了之後，這幾個功能能讓它處理更大範圍的工作，而不是每次都從頭交代。

Slash commands（斜線指令）。 把重複交代的指令存成一個檔案，之後打 /指令名稱 就能重複執行，不用每次重打一長串描述。適合「每次開始工作前先跑一遍」的固定流程，例如檢查測試、產生 PR 說明。

Subagents（子代理）。 讓 Claude Code 把一部分工作丟給另一個獨立的對話視窗去做，做完只把結果帶回來，不佔用主線的上下文視窗。適合「需要大量搜尋、但搜尋過程本身不重要」的工作，例如在陌生的大型專案裡找出某個函式的所有呼叫點。

Hooks（掛勾）。 在特定事件發生時自動執行你指定的指令，例如每次它要執行指令前先跑一次 lint。這是把你原本要口頭提醒的規則，變成系統自動執行的規則。

三個常見的踩雷點

讓它一次做太多。 「重構整個模組」這種指令，結果通常是大量你來不及審查的改動。拆小，一次一件事，每件事做完就 commit。

不看它做了什麼就接受。 它會犯錯，而且錯的時候看起來和對的時候一樣有把握——這是幻覺在程式碼上的表現。每次改動都該過目。

在沒有版控的地方用。 這一條再說一次，因為它是唯一一個會讓你真的損失東西的錯誤。