Claude Code 完整使用指南：用 AI 加速程式開發

什麼是 Claude Code？

Claude Code 是 Anthropic 推出的 CLI（命令列）工具，讓你直接在終端機中與 Claude 互動。它能讀取你的程式碼、執行指令、編輯檔案，就像一個 AI 結對程式夥伴坐在你旁邊。

Claude Code 的核心優勢

直接存取程式碼：不用複製貼上，Claude 能直接讀取和編輯你的檔案
執行終端指令：可以跑測試、安裝套件、git 操作
理解專案脈絡：自動分析專案結構和相依關係
多檔案編輯：跨檔案的重構和修改一次完成

安裝與設定

步驟 1：安裝 Claude Code

使用 npm 全域安裝：

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

步驟 2：登入認證

在終端機執行：

claude

首次執行會引導你登入 Anthropic 帳號或設定 API key。

步驟 3：進入專案目錄

切換到你的專案資料夾後啟動：

cd your-project && claude

常用指令與功能

基本對話

直接輸入問題或需求即可：

> 這個專案是做什麼的？

> 幫我找到處理使用者認證的程式碼

> src/api/auth.py 這個檔案有什麼問題？

程式開發

> 幫我在 models.py 加一個 UserProfile model

> 幫我寫這個 function 的單元測試

> 重構 utils.py，把重複的程式碼抽成共用函式

偵錯與修復

> 跑 pytest 看看有哪些測試失敗，然後修復它們

> 這個 error log 是什麼原因？幫我修

> 分析為什麼這個 API 回應這麼慢

Git 操作

> /commit（自動生成 commit message 並提交）

> 幫我看看目前的 git diff，有沒有問題

> 建一個新的 feature branch 叫 add-search

CLAUDE.md：讓 Claude 更了解你的專案

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

專案概述：這是什麼專案、用了什麼技術
開發規範：程式碼風格、命名規則
常用指令：如何跑測試、如何建構
架構說明：目錄結構、重要模組

Claude Code 每次啟動都會讀取這個檔案，就像給新同事一份 onboarding 文件。

進階使用技巧

1. 善用 Slash Commands

/help：查看所有可用指令
/commit：智慧提交程式碼
/clear：清除對話歷史
/compact：壓縮對話歷史，節省 token

2. 多檔案操作

Claude Code 最強大的功能之一是跨檔案操作：

> 把所有 API endpoint 從 class-based views 改成 function-based views

> 在所有 model 加上 created_at 和 updated_at 欄位

Claude 會自動找到相關檔案並一一修改。

3. 權限控制

Claude Code 執行指令前會請你確認，避免誤操作：

編輯檔案前會顯示差異
執行 shell 指令前會詢問許可
可以設定自動允許特定操作

4. 搭配 CI/CD

Claude Code 可以整合到開發流程中：

PR Review：自動分析 Pull Request 的程式碼品質
Bug 修復：給它 error log，讓它自動找到問題並修復
文件生成：自動為新功能生成文件

實際工作流程範例

場景：修復一個 Bug

1️⃣ claude — 啟動 Claude Code

2️⃣ > 使用者回報登入後被登出，幫我查看 auth middleware 的問題

3️⃣ Claude 分析程式碼，找到 session 過期設定錯誤

4️⃣ Claude 提出修改建議，你確認後自動修改檔案

5️⃣ > 跑一下相關的測試確認修復沒問題

6️⃣ > /commit — 自動生成 commit message 並提交

全程不到 5 分鐘，傳統方式可能要 30 分鐘以上。