← 返回部落格
·9 min 閱讀

Claude Code 實戰：用 CLI 讓 AI 直接改你的程式碼

Claude CodeCLI開發工具工作流程

Claude Code 是什麼

Claude Code 是 Anthropic 官方推出的命令列介面工具。與網頁版最大的不同是：Claude Code 可以直接讀取你的專案檔案、執行終端指令、修改程式碼，甚至幫你建立 git commit。

簡單來說，它讓 AI 從「你問我答」變成「直接動手幫你做」。

安裝與設定

安裝

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

第一次使用

在你的專案目錄中直接輸入：

claude

第一次啟動會引導你登入 Anthropic 帳號。登入後，Claude Code 會自動讀取當前目錄的檔案結構，準備開始工作。

權限控制

Claude Code 在執行任何可能影響你檔案的操作前，都會先徵求你的同意。你可以根據需求設定不同的權限模式：

  • 預設模式：每次讀寫檔案或執行指令都需要確認
  • 自動允許模式：可以設定哪些操作自動允許，減少確認次數

這個設計讓你在享受 AI 效率的同時，保持對專案的完全掌控。

實際使用場景

場景一：快速理解陌生的程式碼

剛接手一個專案，想快速了解架構：

這個專案的整體架構是什麼？
主要的資料流是怎麼走的？

Claude Code 會掃描專案的目錄結構、讀取關鍵檔案（如 package.json、設定檔、進入點），然後給你一個清晰的架構概覽。這比自己一個一個檔案翻快太多了。

場景二：新增功能

假設你想在現有的 Next.js 專案中新增一個部落格功能：

幫我在這個 Next.js App Router 專案中新增一個
blog 功能，使用 MDX 檔案作為文章來源，需要文章
列表頁和文章內容頁，支援 frontmatter metadata。

Claude Code 會：

  1. 分析你現有的專案結構和技術堆疊
  2. 安裝必要的套件（經你同意）
  3. 建立所需的檔案和目錄
  4. 撰寫完整的程式碼
  5. 確保新功能與現有程式碼的風格一致

整個過程中，每一步你都可以看到它要做什麼，決定是否允許。

場景三：除錯

遇到 bug 時，直接描述問題：

執行 npm run build 時，/blog/[slug] 頁面出現
「Cannot read properties of null (reading 'useState')」
的錯誤。幫我找出原因並修復。

Claude Code 會讀取相關的程式碼檔案、分析錯誤原因、提出修復方案，然後直接修改程式碼。你只需要確認修改是否合理。

場景四：重構

想要改善程式碼品質但又怕改壞東西：

這個檔案裡有很多重複的邏輯，幫我重構一下，
把共用的部分抽出來。確保功能不變。

Claude Code 在重構時會特別注意不改變原有的行為，而且它能一次處理多個檔案的連動修改。

場景五：撰寫測試

幫 src/lib/posts.ts 寫單元測試，
涵蓋正常情況和邊界案例。

Claude Code 會根據函式的實際邏輯，生成有意義的測試案例，而不只是表面的 coverage。

高效使用的技巧

善用 CLAUDE.md

在專案根目錄建立一個 CLAUDE.md 檔案，寫下專案的重要資訊：

# 專案說明

這是一個使用 Next.js 16 + TypeScript 開發的工作室網站。

## 技術堆疊
- Next.js App Router
- Tailwind CSS v4
- MDX for blog posts

## 開發規範
- 使用繁體中文撰寫所有使用者介面文字
- 元件風格保持一致：rounded-2xl, border-foreground/10
- 所有頁面都需要包含 SEO metadata

Claude Code 每次啟動時都會讀取這個檔案，確保它的所有操作都符合你的專案規範。

具體描述需求

越具體的描述，得到的結果越精確：

# 不夠具體
幫我加一個搜尋功能

# 具體描述
在 /blog 頁面加上搜尋功能：
- 搜尋框放在文章列表上方
- 即時過濾（keyup 觸發，不需要送 API）
- 搜尋範圍：標題和 description
- 沒有結果時顯示「找不到符合的文章」

分階段執行大型任務

遇到較大的改動，建議分步驟進行：

# 第一步
先幫我規劃一下這個功能的實作方案，
列出需要新增和修改的檔案。

# 確認方案後
好，按照這個方案開始實作第一部分：
資料模型和 API 端點。

# 完成後
繼續實作前端頁面的部分。

這樣你可以在每個階段檢視方向是否正確，避免走錯路後要大幅返工。

利用 git 作為安全網

在讓 Claude Code 做大幅修改前，先確保目前的狀態已經 commit。這樣如果結果不理想，可以輕鬆回退：

git add -A && git commit -m "before claude refactor"
claude
# 讓 Claude Code 做修改
# 如果不滿意：
git checkout .

與其他工具的搭配

VS Code 整合

Claude Code 可以搭配 VS Code 的終端使用。你在終端中與 Claude 對話，它修改的檔案會即時反映在編輯器中。

Git 工作流程

Claude Code 可以幫你建立 commit，甚至撰寫 PR 描述：

幫我把目前的修改建立一個 commit，
commit message 要清楚描述這次的變更。

它會分析 diff，寫出有意義的 commit message。

常見問題

Claude Code 會不會把我的程式碼傳到外部？

對話內容會傳送到 Anthropic 的伺服器進行處理，但 Anthropic 不會使用你的對話內容來訓練模型。如果你的專案有嚴格的隱私要求，建議閱讀 Anthropic 的資料使用政策。

適合什麼規模的專案？

從小型的個人專案到中大型的企業應用都適用。Claude Code 會根據你的專案大小和複雜度調整它的分析策略。

會不會改錯程式碼？

有可能，這就是為什麼每次修改都需要你確認。建議養成習慣：讓 Claude Code 修改後，先 review diff 再繼續。

結語

Claude Code 改變了開發者與 AI 互動的方式——不再是複製貼上的來回，而是讓 AI 直接在你的開發環境中工作。它最適合那些「知道要做什麼，但不想花時間在重複性的實作細節上」的場景。

試著從一個小任務開始，感受一下這種新的開發方式。