Claude Code 深度實戰：從 CLI 工具到 AI 架構師的進化之路

Cursor 和 Windsurf 主要在 IDE 中運行，Anthropic 選擇了不同的方向：終端機（Terminal）。

Claude Code (CC) 的定位不只是代碼補全工具，而是系統級代理（System Agent）。它不僅僅是幫你寫幾行函數，它擁有權限（Permissions）、它能規劃（Plan）、它能自我糾錯（Self-Correction），甚至能管理其他 AI 子代理（Subagents）。

這篇文章不是一份枯燥的說明書，而是一份實戰架構指南。我們將跳過基礎的「如何對話」，直接切入如何利用 Claude Code 改變你的開發生命週期。

核心觀念重構：為什麼是終端機？

很多人第一反應是：「為什麼我要放棄 VS Code 的圖形介面回到黑底白字的終端？」

答案是權限與邊界。

IDE 插件受限於編輯器的沙箱，而 Claude Code 直接運行在 Shell 中。這意味著它可以：

1. 執行命令：直接跑 npm test，看到報錯後自動修復，再跑，直到通過。
2. 文件操作：不僅是寫代碼，還能移動文件、重構目錄結構、修改系統配置。
3. 工具鏈整合：Git、Docker、Database，只要終端能觸達的地方，它都能觸達。

它的功能已經超出了聊天機器人的範疇。

---

一、環境配置：超越 npm install

雖然官方安裝很簡單，但在實際生產環境中，我們需要更穩健的配置，特別是考慮到 API 成本和網絡環境。

1.1 基礎安裝與別名

不要每次都打 claude，這不符合極客精神。

# 全局安裝
npm install -g @anthropic-ai/claude-code

# 建議在 .zshrc 或 .bashrc 加入別名
alias cc='claude'
alias cc-danger='claude --dangerously-skip-permissions' # 慎用，但在可控環境下效率極高

1.2 模型策略與成本控制

Claude Code 默認使用最強的 Sonnet 或 Opus 模型，這在處理複雜架構時很有用，但用來改個變量名就太奢侈了。我們可以通過環境變量靈活切換，甚至接入兼容 OpenAI 格式的國產模型（如 DeepSeek、Qwen）來降低成本。

多環境配置示例：

# ~/.zshrc 配置範例

# 1. 官方主力配置 (高性能)
export ANTHROPIC_API_KEY="sk-ant-..."

# 2. 國內模型轉發配置 (高性價比 - 適用於簡單任務)
# 使用智譜 GLM 或 Moonshot Kimi 作為後端
alias cc-lite='export ANTHROPIC_BASE_URL="https://open.bigmodel.cn/api/anthropic" && export ANTHROPIC_MODEL="glm-4.7" && claude'

# 3. 本地模型 (隱私優先)
# 如果你有本地運行的 Ollama + 兼容層
alias cc-local='export ANTHROPIC_BASE_URL="http://localhost:8000" && claude'

💡 實戰建議： 日常 CRUD 和簡單 Bug 修復使用 cc-lite，涉及架構重構或複雜邏輯時切換回官方 cc。

---

二、CLAUDE.md：項目的記憶系統

這是 Claude Code 的重要功能。CLAUDE.md 不是普通的文檔，它是你項目的記憶植入。

當你接手一個新項目，或者 Claude 第一次進入你的倉庫，它是一張白紙。CLAUDE.md 告訴它：「我們是誰，我們怎麼做事。」

2.1 什麼是有效的 CLAUDE.md？

不要只放 Readme 的內容。有效的 CLAUDE.md 應該包含行為準則。

❌ 錯誤示範：

# 項目介紹
這是一個電商後台。

✅ 正確示範（生產級）：

# Project Context & Rules

## 核心架構
- **Backend**: NestJS + TypeORM (PostgreSQL)
- **Frontend**: Next.js 14 (App Router)
- **State**: Zustand (禁止使用 Redux)

## 行為準則 (Crucial)
1. **測試驅動**: 修改邏輯前，必須先運行 `npm run test:unit`，確保環境綠色。
2. **類型安全**: 禁止使用 `any`，遇到類型困難請使用 Generic 或 Zod 驗證。
3. **提交規範**: 使用 Conventional Commits (feat, fix, chore)。
4. **錯誤處理**: 所有 Async 函數必須被 `try-catch` 包裹，並記錄到 Logger。

## 常用命令
- 啟動開發: `npm run dev`
- 數據庫遷移: `npm run migration:run`

2.2 自動進化機制

最酷的玩法是讓 Claude 自己維護這個文件。當 Claude 犯錯時（例如它用了 any），你糾正它，並命令它：

“你剛才犯了類型錯誤，請把『禁止使用 any』這條規則更新到 CLAUDE.md 中，確保下次不再犯。”

這樣，你的項目文檔會隨著開發進程自動進化，新加入的團隊成員（和 AI）都能受益。

---

三、主要架構：Skills, MCP 與 Subagents

Claude Code 的強大在於它的擴展性。它不是孤立的，它有手（Skills）、有眼（MCP）、還有分身（Subagents）。

3.1 MCP (Model Context Protocol)：連接萬物

MCP 是 Anthropic 推出的開放標準，讓 AI 能連接外部數據。

必裝的 MCP Servers：

MCP Server	用途	實戰場景
Chrome DevTools	瀏覽器控制	”打開 localhost:3000，點擊登錄按鈕，截圖給我看報錯信息。“
GitHub	倉庫管理	”讀取這個 Issue 的內容，並創建一個 PR 來修復它。“
PostgreSQL	數據庫操作	”檢查 users 表中最近註冊的 10 個用戶，分析他們的註冊來源。“
Filesystem	文件增強	允許 AI 更安全、高效地操作文件系統。

配置示例 (~/.claude/mcp.json)：

{
  "mcpServers": {
    "chrome-devtools": {
      "command": "npx",
      "args": ["chrome-devtools-mcp@latest"]
    },
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "your_token"
      }
    }
  }
}

3.2 Subagents：並行開發

這是 Claude Code 的重要特性。你可以召喚多個「子代理」並行工作。每個子代理都有獨立的上下文窗口（Context Window），互不干擾。

場景：全棧功能開發

你對主代理說：

“我要開發一個用戶評論功能。請啟動三個 Agent：

1. DB Agent: 設計數據庫 Schema 並生成遷移文件。
2. Backend Agent: 編寫 NestJS 的 API 接口。
3. Frontend Agent: 使用 React 編寫評論組件。 執行完畢後，向我匯報。”

Claude 會自動分配任務，並行執行。這比單線程對話效率高出數倍，且避免了上下文過長導致的問題。

---

四、高級工作流：Plan Mode 與 TDD

4.1 Plan Mode（架構師模式）

在寫代碼之前，先思考。按下 Shift+Tab 兩次，進入 Plan Mode。

在這個模式下，Claude 不會執行任何寫入操作，它會：

1. 掃描現有代碼庫。
2. 分析依賴關係。
3. 起草實施計劃。

實戰對話：

User: (Plan Mode) 我想把現有的 Express 後端遷移到 Fastify，請評估風險並給出計劃。 Claude: (分析中…) 檢測到使用了大量 Express 中間件。 Plan:

1. 創建適配層兼容 Express 中間件。
2. 替換路由定義。
3. … User: 批准計劃。 Claude: (退出 Plan Mode，開始執行)

這避免了 AI 一上來就修改代碼，導致項目跑不起來的問題。

4.2 TDD（測試驅動開發）閉環

Claude Code 適合的工作流就是 TDD。因為它能看懂報錯。

Workflow:

1. User: “幫我為 AuthService 寫一個測試用例，要求密碼必須包含特殊字符，否則拋出異常。”
2. Claude: 寫好測試 (auth.spec.ts)。
3. User: “運行測試。” (!npm test) -> 失敗 (Red)。
4. User: “實現代碼以通過測試。”
5. Claude: 修改 auth.service.ts。
6. User: “運行測試。” -> 通過 (Green)。
7. User: “重構代碼，保持測試通過。” -> 重構 (Refactor)。

這個循環是 Claude Code 能夠獨立完成高質量代碼的關鍵。

---

五、實用技巧與黑科技

5.1 Headless 模式與 CI 集成

Claude Code 可以通過管道（Pipe）接收輸入，這意味著你可以把它集成到 CI/CD 流程中。

自動 Code Review 腳本：

# 在 CI 環境中運行
git diff origin/main...HEAD | claude -p "你是一個資深架構師。請審查這段代碼變更，重點關注：1. 安全漏洞 2. 性能問題。如果沒有問題，輸出 'LGTM'，否則列出具體修改建議。" > review_report.md

5.2 終端多開策略

Claude Code 的創始人 Boris Cherny 分享過一個技巧：不要等待 AI。

在終端中開啟 3-5 個 Tab，分別運行不同的 Claude 實例：

• Tab 1: 負責修復 Bug A。
• Tab 2: 負責重構模塊 B。
• Tab 3: 負責寫文檔。

利用系統通知（System Notifications），當某個 Tab 完成任務需要你確認時，它會彈窗提醒。這樣你就從「寫代碼的人」變成了「代碼經理」，同時指揮多個 AI 工作。

5.3 Slash Commands (自定義指令)

將常用的 Prompt 封裝成命令。

在 .claude/commands/deploy-check.md 中寫入：

請執行以下部署前檢查：
1. 運行 `npm run lint`
2. 運行 `npm run test`
3. 檢查 `git status` 是否乾淨
如果一切正常，輸出 "Ready to Deploy"。

然後在對話中只需輸入 /deploy-check 即可觸發。

---

六、批判性思考：Claude Code 的局限

雖然 Claude Code 很強，但我們必須保持清醒：

1. 上下文遺忘：雖然支持 200K token，但項目一大，它仍然會「忘記」之前的約定。定期使用 /compact 命令壓縮上下文是必須的。
2. 破壞性操作：儘管有權限確認，但它偶爾會誤刪文件。Git 是你的救生圈。在讓 Claude 執行大規模重構前，務必 git commit。
3. 成本陷阱：Opus 模型非常昂貴。如果不加節制地在 Plan Mode 中進行深度思考，一天的 API 費用可能高達數十美元。請善用 /cost 命令監控。

總結

Claude Code 代表了一種趨勢：開發環境的 Agent 化。

它不再是 IDE 裡的一個側邊欄插件，而是接管了你的 Shell，接管了你的工作流。它要求開發者具備更強的「架構描述能力」和「驗收能力」，而不是單純的「代碼編寫能力」。

現在就開始：

1. 安裝 Claude Code。
2. 在項目根目錄創建一個 CLAUDE.md。
3. 嘗試用 Plan Mode 解決一個積壓已久的 Issue。

這可能就是你與未來編程方式的第一次親密接觸。

---

參考資料 / References:

• Claude Code Official Documentation
• Anthropic Skills Repository
• Model Context Protocol (MCP)
• knqiufan - Claude Code 完全指南