Claude Code介紹和使用建議

Claude Code是由 Anthropic 推出的生成式 AI 程式助理，不僅能幫你寫程式、查文件、修 bug，甚至還能幫你整理 Git 記錄、整合團隊工具，是開發者最佳拍檔。

Cloud Code 可以做什麼

分析 Git 歷史

  • 自動分析 commit 記錄，幫你查出參數是誰加的、為什麼改、相關背景脈絡。
  • 無需額外提示，它會自己「幫你總結」。

整合 GitHub Issue

  • Claude 可以自動拉取 GitHub Issue 資訊，並讀出脈絡，協助你釐清問題或任務內容。

參與 Weekly Standup

  • 你可以問它：「我這週交付了什麼？」
  • Claude 會自動從你的 Git 日誌中整理出成果摘要。

有效使用流程：從 Q&A 到整合工具

  • 新手建議先從 Codebase Q&A 開始：比起直接改程式碼，先問問題（像「這個變數在哪裡定義？」）更容易上手，快速熟悉程式邏輯與架構。
  • 逐步導入工具：等你熟悉後，就可以進一步請 Claude 幫你「編輯程式碼」，並使用其內建工具，例如 bash、測試指令等。
  • 不必一個個指定工具：只要下目標，Claude 會自己判斷該用哪些工具，幫你串成完整流程。
  • 寫功能前先規劃設計：Claude 最強的能力在於「思考」，你可以先請它幫你規劃實作策略，再確認後由它代碼實作。
  • 告訴 Claude 你的 CLI 工具：你只要講「我們團隊有一個叫 build-image 的自定義指令」，它之後就能幫你正確下命令。
  • 一次設定全部工具（建議）：在進入一個新專案時，建議一次告訴 Claude 這個專案會用到哪些工具，這樣它在處理任務時會更有效率。

安裝Claude Code

請先確認你的系統符合以下條件：

步驟 1：安裝 Claude Code CLI

開啟 Terminal（Mac/Linux）或 WSL 的 Ubuntu 終端機，執行：

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

安裝完成後，輸入以下指令確認版本：

claude --version

步驟 2：設定 API 金鑰驗證

安裝好後，必須連結你的 Anthropic 帳號：

claude auth login

或是將 API 金鑰寫入環境變數（適合自動化流程）：

export ANTHROPIC_API_KEY="你的-api-金鑰"

第一次執行 claude auth login 時，系統會開啟瀏覽器讓你登入並授權。

步驟 3：開始第一個專案

  1. 建立新的專案資料夾並切換進去： mkdir my-claude-project cd my-claude-project
  2. 啟動 Claude： claude

善用 CLAUDE.md

在 Claude Code 的運作中，CLAUDE.md 是建立上下文（context）最核心的元素之一。良好的 CLAUDE.md結構設計，能顯著提升 Claude 的理解力與團隊間的協同效率。

建議開發者各自維護 .cloud.local.md，記錄自己常用的 workflow、debug 技巧或指令，不簽入 Git，但可被 Claude 使用。

撰寫原則如下:

  • 保持簡潔明確：寫入常用指令、關鍵檔案與系統架構說明。避免冗長、過度複製 Readme 或歷史資訊，否則會稀釋 Claude 的關注焦點。
  • 依目錄嵌套設計：每個子模組（如 /api, /frontend, /infra）都可以放一份 Cloud.MD，Claude 會在該區域操作時自動讀取該目錄的說明。
  • 保留個人版：建議開發者各自維護 .cloud.local.md，記錄自己常用的 workflow、debug 技巧或指令，不簽入 Git，但可被 Claude 使用。

高階上下文管理技巧

組織層級的共享 CLAUDE.md

  • 公司可建立統一的 enterprise.CLAUDE.md（如專案政策、資安規範、CI/CD 標準），並在每個 repo 中引用。
  • 有助於新進工程師快速了解開發規範。

結合 Slash 指令與情境切換

  • Claude 支援 /commands 格式，例如 /deploy, /check-access，這些可事先存於專案或個人記憶中，讓 prompt 更精準。

階層式配置架構建議

├── CLAUDE.md（全域策略）
├── .CLAUDE.local.md（個人筆記）
├── frontend/
│   └── CLAUDE.md（UI 工具說明）
├── backend/
│   └── CLAUDE.md（API 路由與框架設定）
└── infra/
    └── CLAUDE.md（Terraform、MCP 配置）

MCP 與資源共享建議

  • 集中配置一次，團隊共享：MCP 伺服器（如 puppeteer, PostgreSQL 查詢機器人等）可部署在某一個共用專案中，設定好後所有開發者即可使用。

可用資源範例

  • puppeteer-mcp: 自動產生截圖／ PDF 報告。
  • llm-lint-mcp: 代碼風格與品質審查。
  • qa-mcp: 單元測試結果解析與修復建議。

建議導入流程

階段重點行動
團隊導入初期建立統一的 Cloud.MD 與 MCP server，並教育每位成員撰寫 .CLAUDE.local.md
日常工作中透過 Claude 自動解析 commit、Issue、CI/CD log，提升團隊溝通效率
每週協作在 weekly stand-up 前，使用 Claude 整理每人當週交付與貢獻，快速對齊進度
長期優化定期檢視 Cloud.MD 內容，清理無效資訊、合併重複區段、補充新工具配置

善用 Cloude.MD 與其延伸機制，就像是幫你的 AI 工程夥伴安裝了「專案經驗記憶體」。不僅可以快速上手大型專案、減少重複溝通，還能真正讓 Claude 成為團隊知識管理與效率最佳化的幫手。